COSMOGRIDMinecraft Plugins
Paper
NATURAL STRUCTURES

自然建築

依生態域、地形高度、坡度與生成機率，在新生成的區域放置自訂原版方塊建築。純伺服器端，玩家不需安裝 Mod 或資源包。

範例建築安裝資訊
內建範例
7 種自然建築
可擴充內容
結構 / NPC / 戰利品
客戶端需求
無
OVERVIEW

像原版結構一樣出現在探索路上

依照每座建築的生態域、Y 軸高度、坡度、地基與距離條件，在新區塊中選擇合適位置生成。

建築由原版方塊組成，藍圖使用 template.nbt。NPC、交易與戰利品表可以跟著結構資料夾一起管理，也可放在全域資料夾供多座建築共用。

純伺服器端生態域與地形判定隨機旋轉與鏡像內容熱重載
GENERATION SYSTEM

控制生成位置與伺服器負載

地形分析

依生態域、環境、高度、坡度、液體與地基條件判斷候選位置。

新區塊優先

預設只處理新生成區塊，避免建築突然覆蓋玩家已探索或建造的區域。

距離與重疊防護

可設定結構間距，並使用 Bounding Box 保留區阻止建築彼此重疊。

分 Tick 放置

限制每 tick 的生成工作與方塊修改數，大型結構會分批完成。

BUILT-IN EXAMPLES

七種內建範例建築

內建範例可以直接測試生成流程，也可以作為製作自訂建築、NPC 與戰利品表的參考。

7 × 6 × 9廢棄露營地平原與常見森林

小型探索景物、簡易帳篷與基礎補給箱。

9 × 6 × 13廢棄馬車平原、沙漠與惡地

破損貨車、木桶、貨箱與少量旅途物資。

17 × 11 × 19櫻花林日式神社櫻花樹林

鳥居、參道、主殿、神官 NPC 與神社戰利品。

23 × 11 × 23沙漠綠洲驛站沙漠

人工水池、市集棚、驛站主屋與交易 NPC。

21 × 16 × 21野外大圖書館平原與森林

多層藏書空間、地下附魔室、NPC 與戰利品。

9 × 7 × 9山間避難所草甸、雪坡與山峰

山區過夜小屋、工作設施與基礎食物補給。

17 × 11 × 17針葉林獵人小屋針葉林與雪地針葉林

獵人 NPC、交易、工作區、射箭靶與戰利品箱。

CONTENT FOLDERS

放入檔案即可擴充內容

新增建築不需要重新編譯插件。每座結構可以把設定、NBT、局部 NPC 與局部戰利品表放在同一個資料夾。

plugins/CosmoWorld/

修改或新增內容後，可先用 /cw scan 與 /cw validate 檢查，再執行 /cw reload 套用。

structures/
  my_structure/
    structure.yml
    template.nbt
    npcs/
    loot-tables/

npcs/
  shared_trader.yml

loot-tables/
  shared_loot.yml
結構設定

定義生態域、地形、機率、距離、旋轉、鏡像、NPC 與容器座標。

NBT 藍圖

使用原版結構方塊儲存 template.nbt，插件只放置方塊，不要求客戶端內容。

NPC

第一版支援村民與流浪商人，可設定職業、名稱、AI 與交易。

戰利品表

使用權重、數量與附魔池控制容器內容，並可在驗證階段檢查引用。

COMMANDS

內容檢查與結構管理

/cw scan掃描內容資料夾，但不套用 /cw validate [結構ID]驗證內容格式與交叉引用 /cw reload重新載入設定、語言檔與全部內容 /cw list列出目前已啟用的結構、NPC 與戰利品表 /cw place <結構ID> [旋轉] [--force]在玩家腳下手動生成結構 /cw locate <結構ID>尋找最近的指定結構實例 /cw info <實例ID>查看生成位置、範圍、旋轉與 NPC 資訊 /cw remove <實例ID> [--blocks]移除紀錄；加上 --blocks 才會刪除方塊 /cw npc respawn <實例ID>補回失蹤或生成失敗的 NPC
CONFIGURATION

自然生成與效能限制

以下使用 SQLite 作為安全範例。生成總開關、世界清單與每 tick 限制可透過 config.yml 調整。

config.yml

內容檔可以 /cw reload；變更資料庫類型仍需重新啟動伺服器。

generation:
  enabled: true
  generate-in-new-chunks-only: true
  maximum-placements-per-tick: 1
  maximum-blocks-per-tick: 5000
  prevent-structure-overlap: true

worlds:
  whitelist:
    - world

storage:
  type: SQLITE
  sqlite:
    file: cosmoworld.db
DOWNLOAD & INSTALLATION

下載與安裝

將插件放入 Paper 伺服器的 plugins 資料夾並完整重新啟動。首次啟動會建立設定、內容資料夾與內建範例。

插件版本支援環境檔案
v1.0.0Paper 26.1.2 · Java 25CosmoWorld.jar
  1. 01
    放入插件

    將 CosmoWorld.jar 複製到伺服器的 plugins 資料夾。

  2. 02
    啟動與驗證

    啟動伺服器後執行 /cw validate，確認範例結構與引用均可載入。

  3. 03
    探索新區塊

    自然生成預設只在新區塊運作；既有地圖需前往尚未生成的區域測試。

不可逆操作

/cw place --force 會略過部分位置檢查；/cw remove --blocks 會真正清除範圍內方塊，應限制權限並先備份世界。