模組是正式版功能,試玩版沒有。正式版推出後開放,內容可能在推出前調整。

建築藍圖(blueprints)

做一棟會自己出現在野外的建築:廢棄的小屋、古老的神龕、營地。裡面可以放守衛和寶箱,玩家走到才會觸發,世界地圖上會留下記號。

這能讓你做什麼#

一份藍圖就是一棟小建築。你決定它長什麼樣子(用方塊搭出來)、會出現在哪種地形、多常見,還能在裡面放守衛生物和寶箱。玩家在野外探索時,會隨機遇到你的建築,不用你一個一個手動擺。

一份藍圖由兩個部分組成:資料表裡的一筆(顏色、出現規則、生物、寶箱),加上一個「造型」,也就是這棟建築每個方塊在哪裡。造型可以直接寫在表裡,也可以放在另一個檔案(通常是 models/ 底下的 .json),在表裡用路徑指過去。

不想自己一格一格寫座標的話,可以用 MagicaVoxel 做好建築,直接匯入,見下面「匯入 .vox」與 遊戲內工具。每個模組最多 16 棟藍圖。

在編輯器裡#

在編輯器左欄「世界」底下的「藍圖」(還沒有的話,從最下面的「加入新的內容」加進來)。按「新增」加一棟。新的一筆先放一塊方塊,用下面的「到世界裡框一塊」或「匯入建築檔」換成真的建築。

表單最上面有兩個按鈕:

  • 「到世界裡框一塊」:編輯器先存檔,再帶你進一個創造模式的試玩世界。走到喜歡的建築或地形,框起來存成藍圖,見下面「框選」。
  • 「匯入建築檔」:匯入 MagicaVoxel 做好的 .vox。匯入存好後,要回到模組清單再打開編輯器,才會看到新的內容。見遊戲裡的小工具。

表單其餘的欄位:

  • 「名稱」。
  • 「方塊」:只讀,顯示「大小」和「方塊數」。方塊不在表單裡編,從世界裡框選或匯入。
  • 「落腳點」:建築的哪一格會對準地面上的位置,預設是底部正中間。
  • 「方塊的樣子」:每一種方塊的顏色或種類(「實心」「玻璃」「水」「挖空」「家具」),按「加一種」新增。換一個顏色,整棟建築跟著變。
  • 「出現的地方」:「地區」、「多常見」、「兩棟之間至少相距」、「離村莊至少」、「最大坡度」、「陷進地面」、「可以蓋在水下」。
  • 「守在裡面的生物」:最多 8 筆,每筆選「哪種生物」「位置」「幾隻」。
  • 「寶箱」:最多 4 個,每個選「位置」和「裡面的東西」(「物品」「最少」「最多」「機率」)。
  • 「地圖圖示」:找到之後在地圖上顯示的圖案(高塔、廢墟、營地、神壇、洞穴、房屋),不選就不顯示。

右邊是預覽,可以切換「由上往下看」和「從前面看」。白框是落腳點,紅點是生物,黃點是寶箱。

框選:把世界裡的地方存成藍圖#

  1. 1
    進去

    按「到世界裡框一塊」。畫面上方會寫「框選模式:走到想存的地方,用面板設兩個角」,右邊出現「框一塊建築」面板。按 Esc 放開滑鼠,才能點面板上的按鈕。

  2. 2
    設兩個角

    走到建築旁,分別設「第一個角」和「第二個角」,每個角可以按「我腳下」或「我看著的方塊」,再用「左右」「高」「前後」的 + 和 - 微調。場景裡會畫出黃色的框,面板顯示「框的大小」和「方塊數」。

  3. 3
    取名並存

    在「替這棟建築取名字」填名字,按「存成藍圖」。看到「已存好」之後,用「回編輯器」回去。

  • 大小有上限:長和寬最多 64 格,高最多 48 格,方塊最多 20000 個。超過時面板會告訴你,請框小一點。
  • 框裡有些地方還沒載入時,面板會提示「走近一點等畫面出來再存」。
  • 如果你是從編輯器剛新增的空白那一筆進來的,存下來的內容會換掉那一筆,保留它的名字。否則會新增一筆。
  • 新藍圖的出現地區預設是你存的時候站的那個地區,其他欄位用預設值,回編輯器再調。

進階:手寫 JSON#

下面是同一份內容寫在檔案裡的樣子。編輯器存檔時寫的就是這個格式;你也可以按編輯器上方的「開資料夾」,用外面的文字編輯器直接改,存檔後編輯器會同步過來。表單沒有的欄位,寫在檔案裡也會原樣保留。檔案放哪裡、怎麼登記,見模組資料夾與 mod.json。

藍圖的資料表放在 data/blueprints.json,並在 mod.json 的 content 裡寫 "blueprints": "data/blueprints.json"。

最小可用範例#

一間 5 格寬、4 格高的小屋:灰色地板、棕色牆(有一個門口)、藍色屋頂。裡面有一個箱子和兩隻野狼,只出現在草原和森林,在地圖上顯示成房子的圖示。這個範例只用原版的生物與物品,造型直接寫在表裡:

data/blueprints.json
[
  {
    "id": "hunter_hut",
    "name": "獵人小屋",
    "names": { "en": "Hunter's Hut", "zh-CN": "猎人小屋" },
    "anchor": [2, 0, 2],
    "palette": {
      "f": { "kind": "solid", "color": "#6e6a60" },
      "w": { "kind": "solid", "color": "#8a5a3c" },
      "r": { "kind": "solid", "color": "#3f6fa8" },
      "c": { "kind": "furn", "furn": "CRATE", "facing": 0 }
    },
    "blocks": {
      "size": [5, 4, 5],
      "blocks": [
      [0,0,0,"f"], [0,0,1,"f"], [0,0,2,"f"], [0,0,3,"f"], [0,0,4,"f"], [1,0,0,"f"], [1,0,1,"f"], [1,0,2,"f"], [1,0,3,"f"], [1,0,4,"f"], [2,0,0,"f"], [2,0,1,"f"], [2,0,2,"f"], [2,0,3,"f"], [2,0,4,"f"], [3,0,0,"f"], [3,0,1,"f"], [3,0,2,"f"], [3,0,3,"f"], [3,0,4,"f"], [4,0,0,"f"], [4,0,1,"f"], [4,0,2,"f"], [4,0,3,"f"], [4,0,4,"f"],
      [0,1,0,"w"], [0,1,1,"w"], [0,1,2,"w"], [0,1,3,"w"], [0,1,4,"w"], [1,1,0,"w"], [1,1,4,"w"], [2,1,0,"w"], [3,1,0,"w"], [3,1,4,"w"], [4,1,0,"w"], [4,1,1,"w"], [4,1,2,"w"], [4,1,3,"w"], [4,1,4,"w"], [3,1,3,"c"],
      [0,2,0,"w"], [0,2,1,"w"], [0,2,2,"w"], [0,2,3,"w"], [0,2,4,"w"], [1,2,0,"w"], [1,2,4,"w"], [2,2,0,"w"], [3,2,0,"w"], [3,2,4,"w"], [4,2,0,"w"], [4,2,1,"w"], [4,2,2,"w"], [4,2,3,"w"], [4,2,4,"w"],
      [0,3,0,"r"], [0,3,1,"r"], [0,3,2,"r"], [0,3,3,"r"], [0,3,4,"r"], [1,3,0,"r"], [1,3,1,"r"], [1,3,2,"r"], [1,3,3,"r"], [1,3,4,"r"], [2,3,0,"r"], [2,3,1,"r"], [2,3,2,"r"], [2,3,3,"r"], [2,3,4,"r"], [3,3,0,"r"], [3,3,1,"r"], [3,3,2,"r"], [3,3,3,"r"], [3,3,4,"r"], [4,3,0,"r"], [4,3,1,"r"], [4,3,2,"r"], [4,3,3,"r"], [4,3,4,"r"]
      ]
    },
    "place": {
      "biomes": ["GRASSLAND", "FOREST"],
      "rarity": 0.2,
      "minSpacing": 300,
      "awayFromVillages": 120,
      "maxSlope": 3,
      "allowUnderwater": false,
      "sinkInto": 1
    },
    "spawns": [ { "species": "WOLF", "at": [2, 1, 2], "count": 2 } ],
    "chests": [
      { "at": [3, 1, 3], "loot": [ { "item": "iron_ore", "min": 1, "max": 3, "chance": 0.8 } ] }
    ],
    "mapIcon": "house"
  }
]

造型裡每個方塊是 [x, y, z, "字母"]。字母要在 palette(色盤)裡有定義。座標從 0 開始:x 和 z 是水平方向,y 是往上。造型裡沒有列出來的位置不會動到原本的地形;同一格寫了兩次,以後面那個為準。

想把造型放到獨立的檔案時,表裡的 blocks 改成路徑,檔案內容就是同樣那一段 size 加 blocks:

text
"blocks": "models/hunter_hut.json"

{ "size": [5, 4, 5], "blocks": [ [0,0,0,"f"], [0,0,1,"f"], [0,1,0,"w"] ] }

欄位#

欄位範圍與意思
id(必要)本地名稱,規則同其他表
name、names(必要)建築名稱,最長 60 字。玩家發現它時會看到,地圖上也用這個名字
anchor[x, y, z],造型裡的哪一格對到世界上的放置點。不寫就是底層正中間。通常填底層正中間,例如 5 格寬就是 [2, 0, 2]
palette(必要)色盤:一個英文字母或數字對應一種方塊,最多 64 種。見下面「色盤」
blocks(必要)造型:檔案路徑,或直接內嵌 { "size": [寬, 高, 深], "blocks": [...] }
place出現規則,見下面「出現規則」。整個省略就全部用預設值
spawns最多 8 筆守衛生物,見下面「守衛與寶箱」
chests最多 4 個寶箱,見下面「守衛與寶箱」
mapIcon世界地圖上的圖示:tower 塔、ruin 遺跡、camp 營地、shrine 神龕、cave 洞穴、house 房子。不寫就不會在地圖上標記

色盤#

色盤的每個字母(一個英文字母或數字)對應一種「填法」:

`kind`意思需要的欄位
solid實心方塊color:"#rrggbb"
glass玻璃color
water水color
air挖空:把原本的地形挖掉無
furn家具furn:家具名稱;可加 facing(0 到 3,朝向)

furn 可用的家具名稱:TABLE、CHAIR、BED、BARREL、SHELF、STOOL、ANVIL、WEAPON_RACK、SCARECROW、CRATE、LANTERN、BRAZIER、FLOWER_BOX、HAY_BALE、SIGN、BANNER、FLAG、TROUGH、FENCE、STREET_LAMP、SIGN_INN、SIGN_SMITH、SIGN_STABLE、SIGN_STORE、SIGN_HOME、SIGN_MAP、SIGN_ANCHOR。顏色會照你寫的樣子畫出來,不會再被遊戲調暗或加上舊化。

建築怎麼出現在野外#

你不用指定建築在哪裡。世界生成時,遊戲會自己找適合的地方放,而且每個世界(種子)的位置都固定。每棟建築都會隨機轉成四個方向之一(轉 90 度的倍數)。這些由 place 控制:

欄位範圍與預設白話意思
biomesALL(預設)或清單:GRASSLAND、FOREST、DESERT、MESA、TUNDRA、OCEAN只會出現在這些地形。看的是建築放置點那一格的地形
rarity0.01 到 1,預設 0.15多常見。世界被切成邊長 minSpacing 的方格,每個方格有這個機率想放一棟。0.2 大約每五格有一格嘗試,數字越大越常見
minSpacing160 到 2000,預設 300方格的邊長,也是兩棟同一種建築之間大概至少隔多少格。越大,整個世界裡越少
awayFromVillages0 到 600,預設 120離村莊中心至少幾格,而且不會蓋在村莊範圍裡
maxSlope0 到 12,預設 3建築範圍內地面最多可以差幾格高。越小,越只出現在平地
allowUnderwatertrue/false,預設 false能不能蓋在水裡(水深最多 30 格)。不允許時,地面低於海平面的地方不會放
sinkInto0 到 8,預設 1底層往地下沉幾格。最低那一層會往下補實心地基直到碰到地面(最多 16 格),所以建在小凹地上也不會懸空

還有幾條遊戲自己的規矩:原版的奇觀、道路、祭壇、洞穴、礦坑、競技場、線索地標、首領營地和據點永遠優先,你的建築會讓開,不會蓋在它們上面。你的兩種建築之間,清單裡排前面的優先。

守衛與寶箱#

欄位範圍與意思
spawns[].species守衛生物:原版的、你自己物種表裡的,或 @別的模組/id。首領、坐騎、海裡的生物不行
spawns[].at[x, y, z],造型裡的座標。守衛會出現在這個位置附近
spawns[].count1 到 6 隻
chests[].at[x, y, z],造型裡的座標
chests[].loot最多 8 行:item、min、max(1 到 16)、chance(0.01 到 1)。物品只能是遊戲裡真的有的,不能是首領專屬的掉落

寶箱的外觀要你自己在色盤用一個家具(例如 CRATE)擺在同樣的位置;chests 只決定裡面有什麼。

守衛與寶箱每個世界只會觸發一次:玩家第一次走到建築附近(約 24 格內)時,守衛才會出現,寶箱的東西會掉在寶箱旁邊的地上讓玩家撿,同時跳出「發現了某某」的通知,世界地圖上也會從此留下 mapIcon 的記號。之後同一棟建築不會再生一次。多人遊戲只有房主那邊生成,其他人一樣會看到通知與記號。

想用自己的生物當守衛,要把 物種 一起放進同一個模組。例如 "species": "ember_wolf"。

上限#

項目上限
每個模組的藍圖數16 棟
造型尺寸寬和深各 64,高 48
方塊數20,000 格
色盤64 種
守衛8 筆,每筆最多 6 隻
寶箱4 個,每個最多 8 行掉落

匯入 .vox#

在 MagicaVoxel 做好建築,存成 .vox。在遊戲的「創作模組」頁選「匯入建築」,選這個檔,遊戲會幫你轉成造型檔(存在 models/ 底下)和資料表裡的一筆。你只要選:

  • 放進哪個模組、建築名稱。
  • 會出現在哪些地形,以及可不可以在水裡。
  • 多常見(常見、偶爾、稀有)、兩棟至少隔多遠、離村莊至少多遠。

預覽圖是從上往下看的樣子。幾件要知道的事:

  • MagicaVoxel 的 z 軸是往上。匯入時會轉成遊戲的「高度」:你在 MagicaVoxel 裡往上疊的方向,在遊戲裡還是往上,模型不會被翻過來或鏡射。
  • 檔案裡有好幾個模型時,只用第一個。
  • 顏色超過 62 種時,會把最少用到的顏色併進最接近的顏色。
  • 模型四周的空白會被裁掉,放置點設在底層正中間。
  • 匯入的建築全是實心方塊,不含守衛、寶箱和地圖圖示。匯入後再打開 data/blueprints.json,自己加上 spawns、chests、mapIcon 就好。之後重新匯入同一個建築,你加的這些會被保留。
  • 尺寸上限和上面的「上限」一樣:最大 64 寬、64 深、48 高,最多 20,000 格。

另外,「創作模組」頁的「新模組」有一個「古老神龕」範本,是一個完整、可以直接改的藍圖例子,見 範本。

常見錯誤#

  • at 或 anchor 填成世界座標,或超出 size。它們一律是造型裡的座標,從 0 開始。
  • 色盤沒有定義方塊用到的字母。
  • 把 y 當成前後方向。y 是往上,水平方向是 x 和 z。
  • furn 寫了 COLLIDER,或打錯家具名稱。載入檢查會列出可用的名稱。
  • rarity 很低又 minSpacing 很大,結果走一整天都找不到。調高 rarity、調小 minSpacing 試試。
  • maxSlope 太小,建築幾乎找不到合適的地方。
  • 把 allowUnderwater 設成 false,又只選了 OCEAN:這樣不會有任何地方符合。
  • 寶箱的 loot 裡放了首領專屬的物品。
  • 以為守衛每次靠近都會重生。每棟建築只會觸發一次。