用 MCPyLib 做的專案
用到 MCPyLib 的專案,還有可以直接拿去跑的範例腳本。
Map Art 地圖畫
MCPyLib Map Art 把圖片轉成方塊,在遊戲地圖上顯示出來。地圖像素的顏色由方塊種類和它與北邊方塊的高低差決定,所以階梯模式調整高度後能用到 180 色,平面只有 60 色。


各模式的還原程度
| 模式 | PSNR (dB) | SSIM | 平均誤差 | 使用顏色數 |
|---|---|---|---|---|
| 平面 | 17.19 | 0.9629 | 60.61 | 29 |
| 平面+抖動 | 17.15 | 0.9430 | 60.91 | 36 |
| 階梯 | 29.48 | 0.9757 | 4.17 | 65 |
| 階梯+抖動 | 28.85 | 0.9584 | 4.59 | 99 |
PSNR、SSIM 越高,平均誤差越低,就越接近原圖。數值由專案的模擬器對上面的標誌量測。
用漸層看各模式的差異



畫面背後的方塊高度

- 離線模擬器,可預覽結果並計算 PSNR 與 SSIM
- 感知色彩比對與 Floyd–Steinberg 抖動
- 命令列、互動式選單與 tkinter 圖形介面
Terrain 地形生成
MCPyLib Terrain 先離線生成地形,再以區塊為單位呼叫 edit() 放進世界。
生成器輸出的陰影地形圖


- 高度圖脊狀多重碎形雜訊、領域扭曲與板塊抬升
- 侵蝕水滴模擬刻出山谷,熱力侵蝕形成碎石坡
- 水文D8 流量累積刻出河道並注入水
- 生態域從深海到雪峰共八個帶狀分區,地下還有礦脈
- 放置在運作中的伺服器上以區塊為單位呼叫 mc.edit()
範例腳本
取自儲存庫的 examples 資料夾,權杖都從 .env 檔讀取。
build_cabin.py
examples/buildings/build_cabin.py
在玩家旁蓋一棟 30 × 30 的小木屋,有隔間、閣樓、樓梯、家具與雙坡屋頂。
fill()setblock()teleport()
build_maze.py
examples/buildings/build_maze.py
用深度優先搜尋產生迷宮,可調整走道與牆的寬度,並以一次 edit() 呼叫蓋出來。
fill()edit()setblock()
build_structures.py
examples/buildings/build_structures.py
大量編輯範例並逐一計時:立方體、條紋混凝土塔、有命名箱子與告示牌的房屋,以及分別用兩種方法蓋的 50 × 50 平台。
edit()fill()
sand_cache_game.py
examples/games/sand_cache_game.py
小遊戲:封閉的石磚塔裡堆了 20 到 60 個沙子,最上層永遠是紅沙。
fill()setblock()
03_entity_control.py
examples/basics/03_entity_control.py
召喚豬、殭屍與村民,再停用 AI、傳送、設定速度、攻擊目標與自訂交易。
summon()setEntityAI()setVillagerTrades()
fill_vs_edit.py
examples/benchmarks/fill_vs_edit.py
效能數據背後的基準測試:在五種區域大小下比較 fill() 與 edit()。
fill()edit()