(xyzgrid)=
# XYZgrid
Gratch 2021 的貢獻
將 Evennia 的遊戲世界放置在 xy(z 是不同的地圖)座標網格上。
網格是透過繪製和解析 2D ASCII 地圖在外部建立和維護的,
包括傳送、地圖轉換和幫助尋路的特殊標記。
支援在每個地圖上非常快速的最短路徑尋路。還包括一個
快速檢視功能,僅檢視距離您有限的步數
目前位置(對於將網格顯示為遊戲中的更新地圖很有用)。
網格管理是在遊戲外使用新的evennia啟動器完成的
選項。
(examples)=
## 範例
```
#-#-#-# #
| / d
#-# | #
\ u |\
o---#-----#---+-#-#
| ^ |/
| | #
v | \
#-#-#-#-#-# #---#
|x|x| /
#-#-# #-
```
```
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#---#
/
@-
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Dungeon Entrance
To the east, a narrow opening leads into darkness.
Exits: northeast and east
```
(installation)=
## 安裝
1. XYZGrid 需要 `scipy` 函式庫。最簡單的就是獲得“額外”
Evennia 的依賴關係
pip install evennia[extra]
如果您使用`git`安裝,還可以
(cd to evennia/ folder)
pip install --upgrade -e .[extra]
這將安裝 Evennia 的所有可選要求。
2. 匯入並將 `evennia.contrib.grid.xyzgrid.commands.XYZGridCmdSet` 新增到
`CharacterCmdset` cmdset 在 `mygame/commands.default_cmds.py` 中。重新載入
伺服器。這使得 `map`、`goto/path` 和修改後的 `teleport` 和
`open` 遊戲中可用指令。
[add]: ../Components/Command-Sets
3. 編輯`mygame/server/conf/settings.py`並新增
EXTRA_LAUNCHER_COMMANDS['xyzgrid'] = 'evennia.contrib.grid.xyzgrid.launchcmd.xyzcommand'
PROTOTYPE_MODULES += ['evennia.contrib.grid.xyzgrid.prototypes']
這將新增在 `evennia xyzgrid