用 MCPyLib 做的專案

用到 MCPyLib 的專案,還有可以直接拿去跑的範例腳本。

Map Art 地圖畫

MCPyLib Map Art 把圖片轉成方塊,在遊戲地圖上顯示出來。地圖像素的顏色由方塊種類和它與北邊方塊的高低差決定,所以階梯模式調整高度後能用到 180 色,平面只有 60 色。

原始標誌:黃色新月與箱子裡的橘子,旁邊寫著 Night Tangerine。同一個標誌以階梯模式加抖動模擬成 Minecraft 地圖畫,寬 1024 個方塊。
拖曳以比較原圖與模擬出的地圖. 1024 × 1024 方塊,不用伺服器就能模擬。

各模式的還原程度

模式PSNR (dB)SSIM平均​誤差使用​顏色數
平面17.190.962960.6129
平面+抖動17.150.943060.9136
階梯29.480.97574.1765
階梯+抖動28.850.95844.5999

PSNR、SSIM 越高,平均誤差越低,就越接近原圖。數值由專案的模擬器對上面的標誌量測。

用漸層看各模式的差異

以原圖模式呈現的 128 × 128 色彩漸層
原圖
以平面,60 色模式呈現的 128 × 128 色彩漸層
平面,60 色
以階梯+抖動,180 色模式呈現的 128 × 128 色彩漸層
階梯+抖動,180 色

畫面背後的方塊高度

階梯建築的灰階高度圖:越暗代表方塊越低。
每一列方塊都會比北邊的鄰居高一點或低一點。越暗越低。
  • 離線模擬器,可預覽結果並計算 PSNR 與 SSIM
  • 感知色彩比對與 Floyd–Steinberg 抖動
  • 命令列、互動式選單與 tkinter 圖形介面
GitHub 上的 MCPyLib Map Art

Terrain 地形生成

MCPyLib Terrain 先離線生成地形,再以區塊為單位呼叫 edit() 放進世界。

生成島嶼的等角方塊視圖,有沙灘、森林、岩石與積雪的山峰。
一格一格看這座島. 島嶼範例的真實高度與生態域資料,每 12 個方塊取樣一次。

生成器輸出的陰影地形圖

生成山脈的陰影地形圖:山脊積雪,還有岩石、森林與河流。
山脈:1024 × 1024 方塊,高度 Y 34 到 270,海平面 Y 32。
由高度圖影像生成的島嶼陰影地形圖。
由高度圖影像生成的島嶼:1024 × 1024 方塊,高度 Y 22 到 315。
  1. 高度圖脊狀多重碎形雜訊、領域扭曲與板塊抬升
  2. 侵蝕水滴模擬刻出山谷,熱力侵蝕形成碎石坡
  3. 水文D8 流量累積刻出河道並注入水
  4. 生態域從深海到雪峰共八個帶狀分區,地下還有礦脈
  5. 放置在運作中的伺服器上以區塊為單位呼叫 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()