4. 新遊戲目錄概述¶

到目前為止，我們已經「執行了遊戲」一點，並開始在 Evennia 中使用 Python 進行遊戲。是時候開始審視「遊戲之外」的情況了。

讓我們瀏覽一下您的遊戲目錄（我們假設它名為 mygame）。

檢視檔案時，忽略以 .pyc 結尾的檔案和 __pycache__ 資料夾（如果存在）。這是您永遠不需要接觸的內部 Python 編譯檔。檔案__init__.py也經常是空的並且可以被忽略（它們與Python套件管理有關）。

你可能已經注意到，當我們在遊戲中建立東西時，我們經常透過「python路徑」引用程式碼，例如

create/drop button:tutorial_examples.red_button.RedButton

這是編碼 Evennia 的一個基本面向 - 您建立程式碼，然後告訴 Evennia 該程式碼在哪裡以及何時應該使用。上面我們告訴它透過從 contrib/ 資料夾中提取特定程式碼來建立一個紅色按鈕。同樣的原則在任何地方都適用。因此，瞭解程式碼在哪裡以及如何正確指向它非常重要。

mygame/
- commands/ - 這包含所有自訂指令（使用者輸入處理程式）。您可以從此處新增自己的預設值並覆寫 Evennia 的預設值。
- server/ - 此資料夾的結構不應更改，因為 Evennia 需要它。
  - conf/ - 所有伺服器設定檔都位於此處。最重要的檔案是settings.py。
  - logs/ - 伺服器日誌檔案儲存在此。當你使用 evennia --log 時，你實際上是 tailing the files in this directory.
- typeclasses/ - this holds empty templates describing all database-bound entities in the game, like Characters, Scripts, Accounts etc. Adding code here allows to customize and extend the defaults.
- web/ - This is where you override and extend the default templates, views and static files used for Evennia’s web-presence, like the website and the HTML5 webclient.
- world/ - this is a “miscellaneous” folder holding everything related to the world you are building, such as build scripts and rules modules that don’t fit with one of the other folders.

server/ 子資料夾應保持原樣 - Evennia 期望如此。但是您可以更改遊戲目錄其餘部分的結構，以最適合您的喜好。也許您不想要單一世界/資料夾，而是更喜歡包含世界不同方面的多個資料夾？為您的 RPG 規則建立一個新資料夾「規則」？將您的指令與您的物件組合在一起，而不是將它們分開？這很好。如果你移動東西，你只需要更新 Evennia 的預設設定以指向新結構中的正確位置。

4.1. 指令/¶

commands/ 資料夾包含與建立和擴充 Commands 相關的 Python 模組 Evennia。這些在遊戲中體現出來，例如伺服器理解 look 或 dig 等輸入。

command.py（Python 路徑：commands.command） - 這包含用於設計新輸入指令的基類，或覆寫預設值。
default_cmdsets.py（Python 路徑：commands.default_commands）- a cmdset（指令集）將指令組合在一起。可以動態地向物件新增和刪除指令集，這意味著使用者可以根據自己的情況使用不同的指令集（或指令版本）在遊戲中。為了向遊戲新增新指令，通常會匯入新指令類從 command.py 並將其新增到此模組中的預設 cmdsets 之一。

4.2. 伺服器/¶

此資料夾包含執行 Evennia 所需的資源。與其他資料夾相反，該資料夾的結構應保持原樣。

evennia.db3 - 只有當您使用預設的 SQLite3 資料庫時，您才會擁有此檔案。該檔案包含整個資料庫。只需複製它即可進行備份。對於開發，您也可以在設定完所需的所有內容後製作副本，然後將其複製回「重設」狀態。如果刪除此檔案，您可以透過執行 evennia migrate 輕鬆地重新建立它。

4.2.1. 伺服器/日誌/¶

這儲存了伺服器日誌。當您執行 evennia --log 時，evennia 程式實際上正在尾隨並連線此目錄中的 server.log 和 portal.log 檔案。日誌每週輪換一次。根據您的設定，您也可以在此處找到其他日誌，例如 webserver HTTP 請求日誌。

4.2.2. 伺服器/conf/¶

這包含 Evennia 伺服器的所有設定檔。這些是常規 Python 模組，這意味著它們必須使用有效的 Python 進行擴充。如果您願意，您也可以為它們新增邏輯。

這些設定的共同點是，您通常不會直接透過 python 路徑匯入它們；相反，Evennia 知道它們在哪裡，並將在啟動時讀取它們以設定自身。

settings.py - 這是迄今為止最重要的檔案。預設情況下它幾乎是空的，而不是你預計會從 evennia/default_settings.py 複製並貼上您需要的變更。預設設定檔有大量檔案記錄。匯入/存取設定檔中的值是透過特殊方式完成的，如下所示：
```
  from django.conf import settings 
```
To get to the setting TELNET_PORT in the settings file you’d then do
```
  telnet_port = settings.TELNET_PORT
```
You cannot assign to the settings file dynamically; you must change the settings.py file directly to change a setting. See Settings documentation for more details.
secret_settings.py - 如果您要公開您的程式碼工作，您可能不想線上上分享所有設定。可能存在特定於伺服器的秘密，或者只是對您的遊戲系統進行微調，您希望對玩家保密。將此類設定放在這裡，它將覆蓋 settings.py 中的值並且不包含在版本控制中。
at_initial_setup.py - 當 Evennia 第一次啟動時，它會執行一些基本任務，例如建立超級使用者和 Limbo 房間。新增至此檔案可以為其新增更多操作以進行首次啟動。
at_search.py - When searching for objects and either finding no match or more than one match, it will respond by giving a warning or offering the user to differentiate between the multiple mat。
at_server_startstop.py - 這允許注入程式碼在每次伺服器以不同方式啟動、停止或重新載入時執行。
connection_screens.py - 這允許更改您首次連線到遊戲時看到的連線畫面。
inlinefuncs.py - Inlinefuncs 是可選且有限的“函式”，可以嵌入到傳送給玩家的任何字串中。它們被寫為 $funcname(args) 並用於根據接收它的使用者自訂輸出。例如，向人們傳送文字 "Let's meet at $realtime(13:00, GMT)! 會顯示每個看到該字串的玩家都在自己的時區給出的時間。新增到該模組的函式將成為遊戲中新的行內函數。另請參閱 FuncParser。
inputfuncs.py - 當伺服器收到 look 這樣的指令時，它會由 Inputfunc 處理，將其重定向到 cmdhandler 系統。但可能還有來自用戶端的其他輸入，例如按下按鈕或更新健康欄的請求。雖然已經涵蓋了大多數常見情況，但這是新增新函式來處理新型別輸入的地方。
lockfuncs.py - 鎖定及其元件 LockFuncs 限制對遊戲中事物的存取。 Lock func 在迷你語言中用來定義更複雜的鎖。例如，您可以使用 lockfunc 來檢查使用者是否攜帶給定物品、正在流血或具有一定的技能值。此模組中新增的函式將可在 lock 定義中使用。
mssp.py - Mud 伺服器狀態協定是線上 MUD 檔案/清單（您通常必須註冊）追蹤哪些 MUDs 目前線上、他們有多少玩家等的一種方式。雖然 Evennia 自動處理動態訊息，但您可以在此處設定有關遊戲的元資訊，例如遊戲主題、是否允許殺死玩家等等。這是 Evennia Game 目錄的更通用形式。
portal_services_plugins.py - 如果您想將新的外部連線協定新增至Evennia，則可以在此處新增它們。
server_services_plugins.py - 這允許覆蓋內部伺服器連線協定。
web_plugins.py - 這允許在啟動時將外掛新增到 Evennia webserver。

4.2.3. typeclasses/¶

Evennia 的 Typeclasses 是 Evennia 特定的 Python 類，其例項將自身儲存到資料庫中。這允許角色保留在同一個地方，並且您更新的強度統計資料在伺服器重新啟動後仍然相同。

accounts.py（Python 路徑：typeclasses.accounts） - 帳號代表連結遊戲的玩家。它包含電子郵件、密碼和其他異常詳細資訊等資訊。
channels.py（Python 路徑：typeclasses.channels） - 頻道用於管理玩家之間的遊戲內通訊。
objects.py（Python 路徑：typeclasses.objects） - 物件代表在遊戲世界中擁有位置的所有事物。
characters.py（Python 路徑：typeclasses.characters） - 角色是物件的子類，由帳戶控制 - 它們是遊戲世界中玩家的化身。
rooms.py (Python-path: typeclasses.rooms) - Room 也是 Object 的子類別；描述離散位置。雖然傳統術語是“房間”，但這樣的位置可以是適合您的遊戲的任何位置和任何規模，從森林空地、整個星球或真正的地下城房間。
exits.py（Python 路徑：typeclasses.exits） - Exits 是 Object 的另一個子類別。出口將一個房間連線到另一個房間。
scripts.py（Python 路徑：typeclasses.scripts） - Scripts 是「不符合字元」的物件。它們在遊戲中沒有位置，可以作為任何需要資料庫永續性的基礎，例如戰鬥、天氣或經濟系統。它們還能夠在計時器上重複執行程式碼。

4.2.4. 網路/¶

此資料夾包含子資料夾，用於使用您自己的設計覆蓋 Evennia 的預設 Web 存在。除了 README 檔案或其他空資料夾的子集之外，大多數資料夾都是空的。請參閱Web 概述以瞭解更多詳細資訊（我們稍後也會在本初學者教學中回到 Web）。

media/ - 這個空資料夾是您可以放置自己的映像或希望 Web 伺服器提供服務的其他媒體檔案的位置。如果您要發布帶有大量媒體的遊戲（特別是如果您想要影片），您應該考慮重新指向 Evennia 以使用某些外部服務來為您的媒體提供服務。
static_overrides/ - “靜態”檔案包括字型 CSS 和 JS。在此資料夾中，您將找到用於覆蓋 admin（這是 Django Web 管理員）、webclient（這是 HTML5 webclient）和 website 的靜態檔案的子資料夾。向此資料夾新增檔案將取代預設 Web 狀態中的同名檔案。
template_overrides/ - 這些是HTML 檔案，分別用於webclient 和website。 HTML 檔案是使用 Jinja 範本編寫的，這意味著可以覆蓋 only particular parts of a default template without touching others.
static/ - 這是 Web 系統的工作目錄，不應手動修改。基本上，Evennia 會在伺服器啟動時從 static_overrides 複製靜態資料。
urls.py - 該模組將 Python 程式碼連結到您在瀏覽器中造訪的 URLs。

4.2.5. 世界/¶

該資料夾僅包含一些範例檔案。它旨在儲存遊戲實現的“其餘部分”。許多人以各種方式改變和重組它，以更好地適應他們的想法。

batch_cmds.ev - 這是一個 .ev 檔案，本質上只是按順序執行的 Evennia 指令的清單。這個是空的，可以擴充。教學世界就是用這樣的批次檔建構的。
prototypes.py - 原型是一種輕鬆改變物件而不改變其基礎 typeclass 的方法。例如，可以使用原型來告訴兩個妖精，雖然都是「妖精」類別（因此它們遵循相同的程式碼邏輯），但應該具有不同的裝備、統計資料和外觀。
help_entries.py - 您可以透過多種方式新增新的遊戲內說明條目，例如使用sethelp指令將它們新增至資料庫中，或（對於指令）直接從原始程式碼讀取協助。您也可以透過 python 模組新增它們。本模組是有關如何執行此操作的範例。