從 ASCII 對映建立房間

本教學描述了基於預先繪製的地圖建立遊戲內地圖顯示。 它與Mapbuilder contrib一起使用。 它還詳細介紹如何使用批次程式碼處理器 進行進階建置。

Evennia 不要求其房間以「邏輯」方式定位。您的出口可以被命名 任何東西。你可以從「西」出口通往一個被描述為位於遙遠北方的房間。你 可以有一個房間在另一個房間內，出口通往同一個房間或描述空間 現實世界中不可能的幾何形狀。

也就是說，大多數遊戲確實以邏輯方式組織房間，如果沒有其他方法來保留房間 他們球員的理智。當他們這樣做時，遊戲就可以繪製地圖了。本教學將給出 一個簡單但靈活的遊戲內地圖系統範例，可進一步幫助玩家導航。我們將

為了簡化開發和錯誤檢查，我們將把工作分解為小塊，每個塊 建立在之前的基礎上。為此，我們將廣泛使用[批次程式碼處理器](Batch- Code-Processor)，因此您可能需要熟悉一下。

1. 規劃地圖 - 在這裡我們將提供一個小範例地圖以用於其餘部分 教學。

2. 製作地圖物件 - 這將展示如何製作靜態遊戲內「地圖」物件 人物可以拿起來看。

3. 構建地圖區域 - 這裡我們實際上將根據 我們之前設計的地圖。

4. 地圖程式碼 - 這會將地圖連結到該位置，因此我們的輸出如下所示：

   crossroads(#3)
   ↑╚∞╝↑
   ≈↑│↑∩  The merger of two roads. To the north looms a mighty castle.
   O─O─O  To the south, the glow of a campfire can be seen. To the east lie
   ≈↑│↑∩  the vast mountains and to the west is heard the waves of the sea.
   ↑▲O▲↑
   
   Exits: north(#8), east(#9), south(#10), west(#11)
   

今後我們將假設您的遊戲資料夾名稱為 mygame 並且您尚未修改 dkefault 指令。我們也不會在我們的地圖中使用顏色，因為它們 不顯示在檔案 wiki 中。

規劃地圖

讓我們從有趣的部分開始吧！ MUDs 中的地圖有許多不同的[形狀和 尺寸](http://journal.imaginary-realities.com/volume-05/issue-01/modern-interface-modern- mud/index.html)。有些看起來只是由線連線的盒子。其他人則有複雜的圖形 遊戲本身的外部。

我們的地圖將是遊戲中的文字，但這並不意味著我們僅限於普通字母表！如果 您曾在 Microsoft Word 中選擇過 Wingdings 字型 您會知道還有許多其他字元可供使用。建立遊戲時 Evennia 您有權存取 UTF-8 字元編碼 供您使用數千個字母、數字和幾何形狀。

對於本練習，我們從以下位置使用的特殊字元託盤複製並貼上 矮人要塞創造希望的東西 令人愉悅且易於理解的景觀：

≈≈↑↑↑↑↑∩∩
≈≈↑╔═╗↑∩∩   Places the account can visit are indicated by "O".
≈≈↑║O║↑∩∩   Up the top is a castle visitable by the account.
≈≈↑╚∞╝↑∩∩   To the right is a cottage and to the left the beach.
≈≈≈↑│↑∩∩∩   And down the bottom is a camp site with tents.
≈≈O─O─O⌂∩   In the center is the starting location, a crossroads
≈≈≈↑│↑∩∩∩   which connect the four other areas.
≈≈↑▲O▲↑∩∩   
≈≈↑↑▲↑↑∩∩
≈≈↑↑↑↑↑∩∩

根據遊戲風格和要求，製作遊戲地圖時需要考慮許多因素 你打算實施。在這裡，我們將顯示 5x5 周圍區域的字元圖 帳戶。這意味著確保每個可訪問位置周圍都有 2 個字元。好 這個階段的計劃可以在許多問題發生之前解決它們。

建立地圖物件

在本節中，我們將嘗試建立一個帳戶可以擷取並檢視的實際「地圖」物件 在。

Evennia 提供一系列預設指令 在遊戲中創造物件和房間。雖然易於訪問，但這些指令的用途非常廣泛 具體的、受限制的事物，因此不會提供盡可能多的實驗彈性（對於 進階異常請參閱FuncParser)。此外，輸入長 遊戲使用者端中一遍又一遍的描述和屬性可能會變得乏味；尤其是當 測試時，您可能想要一遍又一遍地刪除和重新建立內容。

為了克服這個問題，Evennia 提供了作為輸入檔的批次處理器 遊戲外建立的。在本教學中，我們將使用兩個可用批次中更強大的一個 處理器，批次程式碼處理器，使用 @batchcode 指令呼叫。 這是一個非常強大的工具。它允許您製作 Python 檔案作為您的藍圖 整個遊戲世界。這些檔案可以直接使用Evennia的Python API。批次程式碼允許 可以在您喜歡的任何文字編輯器中輕鬆編輯和建立，避免手動構建 遊戲內的世界線。

重要警告：@batchcode 的威力只能與 @py 指令相提並論。批次碼是這樣的 功能強大，應該僅為超級使用者保留。仔細想想 在讓其他人（例如 Developer-級別的員工）自己執行 @batchcode 之前 - 確保 你可以接受他們在你的伺服器上執行任意Python程式碼。

雖然是一個簡單的範例，但地圖物件是嘗試 @batchcode 的好方法。前往 mygame/world 並在其中建立一個名為 batchcode_map.py 的新檔案：

# mygame/world/batchcode_map.py

from evennia import create_object
from evennia import DefaultObject

# We use the create_object function to call into existence a 
# DefaultObject named "Map" wherever you are standing.

map = create_object(DefaultObject, key="Map", location=caller.location)

# We then access its description directly to make it our map.

map.db.desc = """
≈≈↑↑↑↑↑∩∩
≈≈↑╔═╗↑∩∩
≈≈↑║O║↑∩∩
≈≈↑╚∞╝↑∩∩
≈≈≈↑│↑∩∩∩
≈≈O─O─O⌂∩
≈≈≈↑│↑∩∩∩
≈≈↑▲O▲↑∩∩
≈≈↑↑▲↑↑∩∩
≈≈↑↑↑↑↑∩∩
"""

# This message lets us know our map was created successfully.
caller.msg("A map appears out of thin air and falls to the ground.")

以超級使用者登入您的遊戲專案並執行指令

@batchcode batchcode_map

這將載入您的 batchcode_map.py 檔案並執行程式碼（Evennia 將在您的 world/ 中查詢 自動資料夾，因此您無需指定它）。

地面上應該會出現一個新的地圖物件。您可以使用look map檢視地圖。讓我們 使用 get map 指令獲取它。萬一我們迷路了，我們就需要它！

建構地圖區域

我們剛剛使用批次程式碼建立了一個對我們的冒險有用的物件。但那上面的位置 地圖實際上還不存在——我們都被繪製好了無處可去！讓我們使用批次程式碼 根據我們的地圖建構一個遊戲區域。我們概述了五個區域：城堡、小屋、露營地、 沿海海灘和連線它們的十字路口。為此建立一個新的批次程式碼檔案 mygame/world，名為batchcode_world.py。

# mygame/world/batchcode_world.py

from evennia import create_object, search_object
from typeclasses import rooms, exits

# We begin by creating our rooms so we can detail them later.

centre = create_object(rooms.Room, key="crossroads")
north = create_object(rooms.Room, key="castle")
east = create_object(rooms.Room, key="cottage")
south = create_object(rooms.Room, key="camp")
west = create_object(rooms.Room, key="coast")

# This is where we set up the cross roads.
# The rooms description is what we see with the 'look' command.

centre.db.desc = """
The merger of two roads. A single lamp post dimly illuminates the lonely crossroads.
To the north looms a mighty castle. To the south the glow of a campfire can be seen.
To the east lie a wall of mountains and to the west the dull roar of the open sea.
"""

# Here we are creating exits from the centre "crossroads" location to 
# destinations to the north, east, south, and west. We will be able 
# to use the exit by typing it's key e.g. "north" or an alias e.g. "n".

centre_north = create_object(exits.Exit, key="north", 
                            aliases=["n"], location=centre, destination=north)
centre_east = create_object(exits.Exit, key="east", 
                            aliases=["e"], location=centre, destination=east)
centre_south = create_object(exits.Exit, key="south", 
                            aliases=["s"], location=centre, destination=south)
centre_west = create_object(exits.Exit, key="west", 
                            aliases=["w"], location=centre, destination=west)

# Now we repeat this for the other rooms we'll be implementing.
# This is where we set up the northern castle.

north.db.desc = "An impressive castle surrounds you. " \
                "There might be a princess in one of these towers."
north_south = create_object(exits.Exit, key="south", 
                            aliases=["s"], location=north, destination=centre)

# This is where we set up the eastern cottage.

east.db.desc = "A cosy cottage nestled among mountains " \
               "stretching east as far as the eye can see."
east_west = create_object(exits.Exit, key="west", 
                            aliases=["w"], location=east, destination=centre)

# This is where we set up the southern camp.

south.db.desc = "Surrounding a clearing are a number of " \
                "tribal tents and at their centre a roaring fire."
south_north = create_object(exits.Exit, key="north", 
                            aliases=["n"], location=south, destination=centre)

# This is where we set up the western coast.

west.db.desc = "The dark forest halts to a sandy beach. " \
               "The sound of crashing waves calms the soul."
west_east = create_object(exits.Exit, key="east", 
                            aliases=["e"], location=west, destination=centre)

# Lastly, lets make an entrance to our world from the default Limbo room.

limbo = search_object('Limbo')[0]
limbo_exit = create_object(exits.Exit, key="enter world", 
                            aliases=["enter"], location=limbo, destination=centre)

使用 @batchcode batchcode_world 應用這個新的批次程式碼。如果程式碼沒有錯誤我們 現在有一個漂亮的迷你世界可供探索。請記住，如果您迷路了，可以檢視我們的地圖 建立了！

遊戲內小地圖

現在我們有了一個風景和匹配的地圖，但我們真正想要的是一個顯示的迷你地圖 每當我們移動到一個房間或使用look指令時。

我們 可以 手動將地圖的一部分輸入到每個房間的描述中，就像我們製作地圖一樣 物件描述。但有些MUDs有幾萬個房間！此外，如果我們改變了我們的 在地圖上，我們可能必須手動更改許多房間描述以匹配 改變。因此，我們將製作一個中央模組來儲存我們的地圖。房間會參考這個 建立時的中心位置和地圖更改將在下次執行我們的時生效 批次程式碼。

為了製作我們的迷你地圖，我們需要能夠將完整地圖切割成多個部分。為此，我們需要將其 以一種允許我們輕鬆做到這一點的格式。幸運的是，Python 允許我們將字串視為列表 字元允許我們挑選出我們需要的字元。

mygame/world/map_module.py

# We place our map into a sting here.
world_map = """\
≈≈↑↑↑↑↑∩∩
≈≈↑╔═╗↑∩∩
≈≈↑║O║↑∩∩
≈≈↑╚∞╝↑∩∩
≈≈≈↑│↑∩∩∩
≈≈O─O─O⌂∩
≈≈≈↑│↑∩∩∩
≈≈↑▲O▲↑∩∩
≈≈↑↑▲↑↑∩∩
≈≈↑↑↑↑↑∩∩
"""

# This turns our map string into a list of rows. Because python 
# allows us to treat strings as a list of characters, we can access 
# those characters with world_map[5][5] where world_map[row][column].
world_map = world_map.split('\n')

def return_map():
    """
    This function returns the whole map
    """
    map = ""
    
    #For each row in our map, add it to map
    for valuey in world_map:
        map += valuey
        map += "\n"
    
    return map

def return_minimap(x, y, radius = 2):
    """
    This function returns only part of the map.
    Returning all chars in a 2 char radius from (x,y)
    """
    map = ""
    
    #For each row we need, add the characters we need.
    for valuey in world_map[y-radius:y+radius+1]:         for valuex in valuey[x-radius:x+radius+1]:
            map += valuex
        map += "\n"
    
    return map

設定完 map_module 後，讓我們將 mygame/world/batchcode_map.py 中的硬編碼地圖替換為 對我們的地圖模組的引用。確保匯入我們的map_module！

# mygame/world/batchcode_map.py

from evennia import create_object
from evennia import DefaultObject
from world import map_module

map = create_object(DefaultObject, key="Map", location=caller.location)

map.db.desc = map_module.return_map()

caller.msg("A map appears out of thin air and falls to the ground.")

以超級使用者登入 Evennia 並執行此批次程式碼。如果一切正常，我們的新地圖應該 看起來和舊地圖一模一樣 - 你可以使用 @delete 刪除舊地圖（使用數字來刪除舊地圖） 選擇要刪除的）。

現在，讓我們將注意力轉向我們的遊戲房間。讓我們使用 return_minimap 方法 上面建立的目的是為了在我們的房間描述中包含小地圖。這個有點多 複雜。

就其本身而言，我們必須滿足於地圖「高於」描述 room.db.desc = map_string + description_string，或透過顛倒順序來下面的地圖。 這兩個選項都不太令人滿意——我們希望在文字旁邊有地圖！為此 在解決方案中，我們將探索 Evennia 附帶的實用程式。藏在evennia\evennia\utils中 是一個名為 EvTable 的小模組。這是一個高階ASCII表 建立者供您在遊戲中使用。我們將透過建立一個包含 1 行和 2 行的基本表來使用它 列（一列用於我們的地圖，一列用於我們的文字），同時也隱藏了邊框。開啟批次檔案 再次

# mygame\world\batchcode_world.py

# Add to imports
from evennia.utils import evtable
from world import map_module

# [...]

# Replace the descriptions with the below code.

# The cross roads.
# We pass what we want in our table and EvTable does the rest.
# Passing two arguments will create two columns but we could add more.
# We also specify no border.
centre.db.desc = evtable.EvTable(map_module.return_minimap(4,5), 
                 "The merger of two roads. A single lamp post dimly " \
                 "illuminates the lonely crossroads. To the north " \
                 "looms a mighty castle. To the south the glow of " \
                 "a campfire can be seen. To the east lie a wall of " \
                 "mountains and to the west the dull roar of the open sea.", 
                 border=None)
# EvTable allows formatting individual columns and cells. We use that here
# to set a maximum width for our description, but letting the map fill
# whatever space it needs. 
centre.db.desc.reformat_column(1, width=70)

# [...]

# The northern castle.
north.db.desc = evtable.EvTable(map_module.return_minimap(4,2), 
                "An impressive castle surrounds you. There might be " \
                "a princess in one of these towers.", 
                border=None)
north.db.desc.reformat_column(1, width=70)   

# [...]

# The eastern cottage.
east.db.desc = evtable.EvTable(map_module.return_minimap(6,5), 
               "A cosy cottage nestled among mountains stretching " \
               "east as far as the eye can see.", 
               border=None)
east.db.desc.reformat_column(1, width=70)

# [...]

# The southern camp.
south.db.desc = evtable.EvTable(map_module.return_minimap(4,7), 
                "Surrounding a clearing are a number of tribal tents " \
                "and at their centre a roaring fire.", 
                border=None)
south.db.desc.reformat_column(1, width=70)

# [...]

# The western coast.
west.db.desc = evtable.EvTable(map_module.return_minimap(2,5), 
               "The dark forest halts to a sandy beach. The sound of " \
               "crashing waves calms the soul.", 
               border=None)
west.db.desc.reformat_column(1, width=70)

在我們執行新的批次程式碼之前，如果您像我一樣，您將擁有大約 100 張地圖 周圍有 3-4 個不同版本的房間，從地獄邊緣延伸出來。讓我們把它全部擦掉 從頭開始。在指令提示字元中，您可以執行 evennia flush 來清除資料庫並 重新開始。但是，它不會重設 dbref 值，因此如果您位於 #100，它將從那裡開始。 或者，您可以導航至 mygame/server 並刪除 evennia.db3 檔案。現在指揮 提示使用evennia migrate擁有一個全新製作的資料庫。

登入evennia並執行@batchcode batchcode_world，您將有一個小世界可供探索。

結論

現在您應該有一個對映的小世界，並對批次程式碼、EvTable 以及如何進行基本瞭解 可以輕鬆地將新的遊戲定義功能新增到Evennia。

您可以透過擴充套件地圖並建立更多房間來探索，輕鬆地根據本教學進行構建。為什麼 不要透過嘗試其他教學來為您的遊戲新增更多功能：[為您的世界新增天氣](Weather- Tutorial)、用 NPC 填充您的世界 或 實施戰鬥系統。