Nullbot Mapart 文檔

Appearance

指令參考 ​

指令總覽 ​

Nullbot Mapart 提供豐富的指令集，涵蓋基本操作、自動化、地圖畫處理等功能。

參數類型規範 ​

類型格式描述範例
<int>整數32 位元整數123, -45
<float>浮點數雙精度浮點數123.45, -0.5
<string>字串單一字詞或引號包圍hello, "hello world"
<Option<string>>可選字串可省略的字串參數可留空或填入內容
<string(rest of line)>行剩餘內容接受整行剩餘文字支援 \" 跳脫
<string(auto)>自動解析字串單字或引號短語word 或 "quoted phrase"

指令分類 ​

基本資訊指令 ​

help ​

顯示指令幫助資訊

help

功能: 列出所有可用指令及其語法

position ​

顯示當前玩家位置

position

回傳: X, Y, Z 座標和朝向角度

inventory ​

顯示背包內容

inventory

功能: 列出背包中所有物品及其數量

screen ​

顯示當前開啟的屏幕

screen

功能: 檢查當前開啟的 GUI 介面

close ​

關閉開啟的屏幕

close

功能: 關閉當前開啟的 GUI 介面

cursor ​

顯示鼠標資訊

cursor

功能: 顯示鼠標位置和狀態

publicURL ​

顯示公開網址

publicURL

功能: 顯示當前可用的公開存取網址

方塊操作指令 ​

get_block ​

獲取指定座標的方塊資訊

get_block <x> <y> <z>

參數:

  • x, y, z: 目標座標

回傳: 方塊類型、狀態等詳細資訊

get_block_name ​

獲取指定座標的方塊名稱

get_block_name <x> <y> <z>

參數:

  • x, y, z: 目標座標

回傳: 方塊的本地化名稱

get_block_entity ​

獲取指定座標的方塊實體

get_block_entity <x> <y> <z>

參數:

  • x, y, z: 目標座標

回傳: 方塊實體的 NBT 資料

dig ​

挖掘指定座標的方塊

dig <x> <y> <z>

參數:

  • x, y, z: 要挖掘的方塊座標

功能: 模擬玩家挖掘動作

物品管理指令 ​

take ​

拿取指定物品

take <item_id>

參數:

  • item_id: 物品 ID 編號

功能: 從容器或地面拾取物品

use ​

在指定座標使用物品

use <x> <y> <z>

參數:

  • x, y, z: 使用物品的目標座標

功能: 模擬玩家右鍵使用物品

throw_all ​

丟棄所有物品

throw_all

功能: 將背包中所有物品丟棄到地面

repeat_open ​

重複使用物品

repeat_open <x> <y> <z> <count>

參數:

  • x, y, z: 目標座標
  • count: 重複次數

功能: 在指定位置重複使用物品

移動導航指令 ​

tp ​

傳送到指定座標

tp <x> <y> <z>

參數:

  • x, y, z: 目標座標（支援浮點數）

功能: 瞬間移動到目標位置

path_finder ​

標準路徑尋找

path_finder <x> <y> <z>

參數:

  • x, y, z: 目標座標

功能: 計算並執行到目標的最佳路徑

path_finder_fuzzy ​

模糊路徑尋找

path_finder_fuzzy <x> <y> <z>

參數:

  • x, y, z: 目標座標

功能: 使用模糊演算法尋找路徑，容錯性更高

astar ​

A* 演算法路徑尋找

astar <x> <y> <z>

參數:

  • x, y, z: 目標座標

功能: 使用 A* 演算法計算最佳路徑

astar_fuzzy ​

模糊 A* 路徑尋找

astar_fuzzy <x> <y> <z>

參數:

  • x, y, z: 目標座標

功能: A* 演算法的模糊版本

set_path_finder_algorithm ​

設定路徑尋找演算法

set_path_finder_algorithm <algorithm>

參數:

  • algorithm: 演算法名稱

可用演算法: A*, JSP

地圖處理指令 ​

render_litematic ​

渲染 Litematic 地圖

render_litematic <input_file> <output_file>

參數:

  • input_file: 輸入的 Litematic/nbt 檔案名稱
  • output_file: 輸出的圖片檔案名稱

功能: 將 Litematic 建築檔案轉換為圖片

scanning ​

掃描地圖收納盒

scanning <x1> <y1> <z1> <x2> <y2>

參數:

  • x1, y1, z1: 掃描區域起始座標
  • x2, y2: 掃描區域結束座標

功能: 掃描指定區域內的地圖物品

generate ​

生成材料區檔案

generate <x1> <y1> <z1> <x2> <y2> <z2> <filename>

參數:

  • x1, y1, z1: 區域起始座標
  • x2, y2, z2: 區域結束座標
  • filename: 輸出檔案名稱

功能: 根據參數生成材料區配置檔案

rename ​

重新命名地圖

rename

功能: 啟動地圖重新命名流程

自動化指令 ​

actionFlow ​

載入動作流程檔案

actionFlow <filename>

參數:

  • filename: 動作流程檔案名稱

功能: 從檔案載入並執行自動化動作序列

stopAction ​

停止當前動作流程

stopAction

功能: 中止正在執行的自動化動作

實體管理指令 ​

entity ​

顯示附近實體

entity

功能: 列出當前區域內的所有實體

entity_by_name ​

按名稱顯示實體

entity_by_name <entity_name>

參數:

  • entity_name: 實體名稱

功能: 搜尋並顯示指定名稱的實體

網路功能指令 ​

disconnect ​

從伺服器斷線

disconnect

功能: 安全斷開與 Minecraft 伺服器的連接

restartTunnel ​

重新啟動隧道

restartTunnel

功能: 重新啟動網路隧道服務

座標系統 ​

座標軸定義 ​

  • X 軸: 東西方向（正數為東方）
  • Y 軸: 垂直高度（海平面為 63）
  • Z 軸: 南北方向（正數為南方）

座標格式 ​

  • 整數座標: 100 64 -200
  • 浮點座標: 100.5 64.0 -200.3
  • 相對座標: 支援 ~ 符號（部分指令）

最佳實踐 ​

指令使用技巧 ​

  1. 批次操作: 使用 ActionFlow 進行複雜的批次操作
  2. 路徑最佳化: 根據地形選擇合適的路徑尋找演算法
  3. 錯誤處理: 使用 help 指令確認語法
  4. 安全操作: 在重要操作前使用 position 確認位置

自動化挖掘 ​

1. actionFlow <mining_script>           # 載入挖掘腳本
2. 監控執行狀態
3. stopAction                          # 必要時停止

路徑規劃 ​

1. position                            # 確認當前位置
2. astar <target_x> <target_y> <target_z>  # 計算路徑
3. 或使用 tp <x> <y> <z> 直接傳送

錯誤處理 ​

故障排除 ​

  1. 使用 help 確認指令語法
  2. 檢查參數格式是否正確
  3. 確認機器人連接狀態
  4. 查看系統日誌獲取詳細錯誤訊息

進階功能 ​

自動化腳本 ​

通過 actionFlow 指令可以執行複雜的自動化腳本，實現：

  • 大規模建築
  • 資源收集
  • 地圖處理
  • 批次操作

擴展性 ​

指令系統支援動態載入，可根據需要添加新的指令和功能模組。

Copyright © 2025 Nullbot Mapart