使用 Arxcode 遊戲目錄

Warning

arxcode 是單獨維護的。

雖然 Arxcode 使用 Evennia，但它_不是 Evennia 本身的一部分；我們僅將此檔案作為向使用者提供的服務提供。此外，雖然 Arxcode 仍在積極維護（2022 年），但這些指令是基於截至 2018 年 8 月 12 日發布的 Arx 程式碼。它們可能不再能夠 100% 開箱即用。

Arxcode 錯誤應定向到 Arxcode github 問題追蹤器。

Arx - 清算之後 是一款大型且非常流行的基於 Evennia 的遊戲。 Arx 很大程度上以角色扮演為中心，依靠遊戲大師來推動故事發展。從技術上講，最好的描述可能是「a MUSH，但具有更多編碼系統」。 2018年8月，遊戲開發商Tehom慷慨地在github上發布了Arx的原始碼。對於想要挑選想法甚至想要建立起始遊戲的開發者來說，這是一個寶庫。

從原始程式碼執行 Arx 並不太難（當然，您將從空資料庫開始），但是 由於 Arx 的一部分是有機成長的，因此它並不遵循任何地方的標準 Evennia 正規化。 本頁介紹如何安裝和設定一些東西，同時使您的新的基於 Arx 的遊戲更好地匹配普通 Evennia 安裝。

正在安裝Evennia

首先，在磁碟機上留出一個資料夾/目錄以供後續操作使用。

您需要先按照 OS 的大部分 Git 安裝說明 安裝 Evennia。不同之處在於，您應該這樣做，而不是從上游Evennia克隆

git clone https://github.com/TehomCD/evennia.git

這是因為 Arx 使用 TehomCD 的較舊 Evennia 0.8 fork，特別是仍然使用 Python2。如果引用較新的 Evennia 文件，此細節很重要。

如果您是 Evennia 的新手，強烈建議您完整執行正常的安裝說明 - 包括初始化和啟動新的空遊戲並連線到它。 這樣您就可以確保 Evennia 作為基準正確工作。

安裝後，virtualenv 應該正在執行，並且您的預留資料夾中應該有以下檔案結構：

muddev/
   vienv/
   evennia/
   mygame/

這裡mygame是您在Evennia安裝期間建立的空遊戲，帶有evennia --init。前往 然後執行evennia stop以確保你的空遊戲沒有執行。我們會讓 Evenna 執行 Arx，所以原則上你可以刪除 mygame - 但擁有一個乾淨的遊戲也可能很好 來比較。

安裝 Arxcode

cd 到目錄的根目錄並從 github 克隆已發布的原始碼：

git clone https://github.com/Arx-Game/arxcode.git myarx

新資料夾 myarx 應該會出現在您已有的資料夾旁邊。您可以將其重新命名為 如果你想要別的東西。

cd 變為 myarx。如果您想了解遊戲目錄的結構，您可以在此處閱讀更多相關資訊。

清理設定

Arx 已將 evennia 的正常設定拆分為 base_settings.py 和 production_settings.py。它 還有自己的解決方案來管理設定檔案的“秘密”部分。我們將保留大部分 Arx 方式，但我們將刪除秘密處理並將其替換為正常的 Evennia 方法。

cd 到 myarx/server/conf/ 並在文字編輯器中開啟檔案 settings.py。頂部部分（內 """...""") 只是幫助文字。擦掉下面的所有東西，讓它看起來像這樣 （不要忘記儲存）：

from base_settings import *

TELNET_PORTS = [4000]
SERVERNAME = "MyArx"
GAME_SLOGAN = "The cool game"

try:
    from server.conf.secret_settings import *
except ImportError:
    print("secret_settings.py file not found or failed to import.")

注意：縮排和大小寫在 Python 中很重要。為了您自己的理智，請縮排 4 個空格（而不是製表符）。如果您想要 Evennia 中的 Python 初學者，[您可以檢視此處](Beginner-Tutorial-Python-basic- introduction)。

這將匯入 Arx 的基本設定並使用 Evennia-預設 telnet 連線埠覆蓋它們，並為遊戲命名。此口號會變更網站標題中遊戲名稱下顯示的子文字。您可以稍後根據自己的喜好調整這些。

接下來，在與 settings.py 檔案相同的位置建立新的空白檔案 secret_settings.py。 這可以只包含以下內容：

SECRET_KEY = "sefsefiwwj3 jnwidufhjw4545_oifej whewiu hwejfpoiwjrpw09&4er43233fwefwfw"

將長隨機字串替換為您自己的隨機 ASCII 字元。不應共享金鑰。

接下來，在文字編輯器中開啟 myarx/server/conf/base_settings.py。我們想要刪除/註解掉所有提及 decouple 套件的內容，Evennia 不使用該套件（我們使用 private_settings.py 來隱藏不應共享的設定）。

透過在行開頭新增 # 註解掉 from decouple import config：# from decouple import config。然後在檔案中搜尋 config( 並註解掉所有使用它的行。其中許多是特定於原始 Arx 執行的伺服器環境的，因此與我們無關。

安裝Arx依賴項

除了普通的 Evennia 之外，Arx 還有一些進一步的依賴項。從 cd: 開始到你的根目錄 myarx 資料夾。

如果您執行 Linux 或 Mac：編輯 myarx/requirements.txt 並註解掉該行 pypiwin32==219 - 僅在 Windows 上需要，在其他平臺上會發生錯誤。

確保您的 virtualenv 處於活動狀態，然後執行

pip install -r requirements.txt

將為您安裝所需的 Python 套件。

新增日誌/資料夾

Arx 儲存庫不包含 myarx/server/logs/ 資料夾 Evennia 期望用於儲存伺服器 日誌。新增起來很簡單：

# linux/mac
mkdir server/logs
# windows
mkdir server\logs

設定資料庫並啟動

從 myarx 資料夾中，執行

evennia migrate

這將建立資料庫並將逐步完成所需的所有資料庫遷移。

evennia start

如果一切順利，Evennia 現在將啟動，執行 Arx！您可以使用 Telnet 使用者端在 localhost（或 127.0.0.1，如果您的平臺沒有別名 localhost）、連線埠 4000 上連線到它。或者，您可以使用網頁瀏覽器瀏覽至 http://localhost:4001 以檢視遊戲的網站並造訪網頁使用者端。

當您登入時，您將收到標準的 Evennia 問候語（因為資料庫為空），但您可以 嘗試 help 看看確實是 Arx 在執行。

附加設定步驟

使用上述evennia migrate步驟建立資料庫後第一次啟動Evennia時， 它應該為您建立一些起始物件 - 您的超級使用者帳戶，它會提示您 進入，一個起始房間（地獄邊境）和一個角色物件。如果由於某種原因這沒有 發生這種情況，您可能需要按照以下步驟操作。 第一次超級使用者登入時，您可能必須 執行步驟 7-8 和 10 建立並連線到您傳入的角色。

1. 使用您的超級使用者帳號登入遊戲網站。

2. 按 Admin 按鈕進入（Django-）管理介面。

3. 導航至 Accounts 部分。

4. 新增以新員工命名的新帳戶。使用佔位符密碼和虛擬電子郵件 地址。

5. 將帳戶標記為 Staff 並套用 Admin 許可權群組（這假設您已經在 Django 中設定了管理群組）。

6. 新增名為 player 和 developer 的 Tags。

7. 使用您的超級使用者帳號使用 Web 使用者端（或第三方 Telnet 使用者端）登入遊戲。移動到您希望新員工角色出現的位置。

8. 在遊戲使用者端中，執行 @create/drop <staffername>:typeclasses.characters.Character，其中 <staffername> 通常與您之前在管理員中建立的 Staffer 帳戶使用的名稱相同（如果您要為超級使用者建立角色，請使用您的超級使用者帳戶名稱）。這將建立一個新的遊戲角色並將其放置在您當前的位置。

9. 讓新的管理員玩家登入遊戲。

10. 讓新管理員用 @ic StafferName 操縱角色。

11. 讓新管理員更改其密碼 - @password <old password> = <new password>。

現在您已經有了一個角色和一個帳戶物件，為了讓某些指令正常執行，您可能還需要執行一些其他操作。您可以在ic（控制您的角色物件）時將這些作為遊戲內指令執行。

py from web.character.models import RosterEntry;RosterEntry.objects.create(player=self.player, character=self)

py from world.dominion.models import PlayerOrNpc, AssetOwner;dompc = PlayerOrNpc.objects.create(player=self.player);AssetOwner.objects.create(player=dompc)

這些步驟將為您提供「RosterEntry」、「PlayerOrNpc」和「AssetOwner」物件。 RosterEntry 即使在離線狀態下，也將角色和帳戶物件明確連線在一起，並且包含 有關角色目前在遊戲中的存在的附加資訊（例如他們屬於哪個「名單」） 中，如果您選擇使用活躍的角色名冊）。 PlayerOrNpc 是更多的角色擴充套件，以及對遊戲中不存在且僅由角色家庭的螢幕外成員的名稱代表的 NPC 的支援。它還允許成為組織的成員。 AssetOwner 儲存有關角色或組織的金錢和資源的資訊。

備用 Windows 安裝指南

由帕克斯貢獻

如果您因為某些原因無法使用適用於 Linux 的 Windows 子系統（將使用與上述相同的指令），則可以在 Anaconda for Windows 下執行 Evennia/Arx。這個過程有點棘手。

確保您有：

• 適用於 Windows 的 Git https://git-scm.com/download/win

• 適用於 Windows 的 Anaconda https://www.anaconda.com/distribution/

• VC++ Python 2.7 編譯器 https://aka.ms/vcpython27

  conda update conda conda create -n arx python=2.7 source activate arx

為事物設定一個方便的儲存位置。

cd ~
mkdir Source
cd Source
mkdir Arx
cd Arx

將下面的 SSH git clone 連結替換為您自己的 github 分支。 如果您根本不打算更改 Evennia，則可以使用 evennia/evennia.git 儲存庫而不是分叉的儲存庫。

git clone git@github.com:<youruser>/evennia.git
git clone git@github.com:<youruser>/arxcode.git

Evennia 本身就是一個軟體包，因此我們要安裝它及其所有內容 先決條件，切換到適當標示的分支後 阿爾克斯程式碼。

cd evennia
git checkout tags/v0.7 -b arx-master
pip install -e .

Arx 有一些自己的依賴項，所以現在我們要安裝它們 由於它不是一個包，我們將使用正常的需求檔案。

cd ../arxcode
pip install -r requirements.txt

git 儲存庫不包含空日誌目錄，如果您這樣做，Evennia 會不滿意 沒有它，所以當仍在 arxcode 目錄中時…

mkdir server/logs

現在點選https://github.com/evennia/evennia/wiki/Arxcode-installing-help並且 更改「清理設定」部分中的設定內容。

然後我們將建立我們的預設資料庫…

../evennia/bin/windows/evennia.bat migrate

…並進行第一次執行。您需要 winpty 因為 Windows 沒有 TTY/PTY 預設情況下，Python 控制檯輸入指令（用於第一個提示） run）會失敗，你最終會陷入一個不愉快的境地。未來的跑步，你應該 不需要winpty。

winpty ../evennia/bin/windows/evennia.bat start

完成此操作後，您的 Evennia 伺服器應該執行 Arxcode 在連線埠 4000 的本機上，webserver 位於 http://localhost:4001/.