地圖畫設定
本頁面詳細介紹地圖畫建造系統的各項設定選項，幫助您根據需求調整地圖畫建造的參數。
設定檔案位置
地圖畫設定位於 mapart.toml 檔案中，您可以使用任何文字編輯器開啟編輯，但是更建議使用 WebUI 介面進行編輯設定。
📁 Nullbot Mapart/
├── 📄 settings.toml # 主要配置檔案
├── 📄 mapart.toml # 地圖畫設定檔案
├── 📄 mapart-box.toml # 地圖畫材料位置設定檔案
├── 📄 cache/ # 快取目錄
└── 📄 nullbot_mapart.exe # 主程式基本設定
材料與位置設定
| 設定項目 | 預設值 | 說明 |
|---|---|---|
| materialstation | "" | 材料站，分流（數字）或傳送點（字串） |
| experiencefarm | "" | 經驗農場 |
| territoryowner | "" | 領土擁有者 |
| teleporttoterritory | false | 傳送至領土 |
說明
materialstation 可以設定為數字（分流）或字串（傳送點），例如："8" 或 "XXXXX_8"
偵測與安全設定
| 設定項目 | 預設值 | 說明 |
|---|---|---|
| overlapdetection | false | 重疊檢測 |
| skipifoverlapdetected | false | 如果檢測到重疊則跳過 |
| skipifendcityconflict | false | 如果檢測到終界城衝突則跳過 |
Discord Webhook 設定
位置: webhook
Webhook 基本設定
| 設定項目 | 說明 |
|---|---|
| url | Discord Webhook 位址 |
| avatarurl | Discord Webhook 頭像位址 |
| userid | Tag 使用者 ID |
警告通知設定
| 設定項目 | 預設值 | 說明 |
|---|---|---|
| discordwarnnotifications | true | 通過 Webhook 發送警告通知 |
| discordwarnnotificationsinterval | "30m" | 警告通知間隔，例如：30m、1h30m、4m37s |
重要提醒
Discord Webhook URL 包含敏感資訊，請勿分享給他人。
時間延遲設定
地圖操作延遲
| 設定項目 | 預設值 | 單位 | 說明 |
|---|---|---|---|
| readmapdelay | 200 | 毫秒 | 讀取地圖延遲 |
| printdelay | 0 | 毫秒 | 打印地圖延遲 |
| printmovedelay | 25 | 毫秒 | 打印地圖移動延遲 |
| printgroupdelay | 0 | 毫秒 | 打印地圖群組延遲 |
物品操作延遲
| 設定項目 | 預設值 | 單位 | 說明 |
|---|---|---|---|
| takedelay | 10 | 毫秒 | 拿取物品延遲 |
| updateslotdelay | 20 | 遊戲刻 | 更新物品欄延遲 |
| slowmodedelay | 5 | 遊戲刻 | 慢速模式延遲 |
伺服器操作延遲
| 設定項目 | 預設值 | 單位 | 說明 |
|---|---|---|---|
| changeserverdelay | 20 | 遊戲刻 | 切換伺服器延遲 |
| destroytimeout | 15 | 秒 | 破壞超時 |
遊戲刻說明
1 遊戲刻 = 1/20 秒 = 50 毫秒
效能與快取設定
快取設定
| 設定項目 | 預設值 | 單位 | 說明 |
|---|---|---|---|
| cachecapacity | 30 | 個 | 快取容量 |
| clearcachedelay | 5 | 遊戲刻 | 清除快取延遲 |
渲染效能設定
| 設定項目 | 預設值 | 單位 | 說明 |
|---|---|---|---|
| wingspan | 3 | 個 | 翼展 |
| rendermapmaxgoroutine | 1 | - | 渲染地圖最大協程數量 |
| previewinterval | 5 | 秒 | 預覽間隔 |
| rendermaptimeout | 60 | 秒 | 渲染地圖超時 |
資料保留設定
| 設定項目 | 預設值 | 說明 |
|---|---|---|
| retentionperiod | "1y" | 紀錄保留期限，例如：30d、1y、4h37m |
恢復建造設定
位置: resume
| 設定項目 | 預設值 | 單位 | 說明 |
|---|---|---|---|
| resume | false | - | 啟用恢復建造 |
| resumedelay | 10 | 秒 | 恢復建造延遲 |
時間格式說明
對於 duration 和 interval 欄位，請使用以下格式：
| 格式 | 說明 |
|---|---|
30s | 30 秒 |
5m | 5 分鐘 |
1h | 1 小時 |
30d | 30 天 |
1y | 1 年 |
1h30m45s | 1 小時 30 分鐘 45 秒 |
常見問題
Q: 什麼是翼展設定？
A: wingspan 設定控制建造範圍的寬度，較大的值會允許更寬的建造範圍，但可能會影響效能。
Q: 如何啟用恢復建造功能？
A: 在 resume 區塊中將 resume 設定為 true，並可調整 resumedelay 來控制恢復建造的延遲時間。
自動重啟腳本
如果您需要在 Nullbot Mapart 遇到錯誤時自動重啟，可以使用以下腳本：
bat
@echo off
cd /d "%~dp0"
start /b "" "nullbot_mapart.exe" -f
:loop
bot.exe
goto loop