建築藍圖(blueprints)
做一棟會自己出現在野外的建築:廢棄的小屋、古老的神龕、營地。裡面可以放守衛和寶箱,玩家走到才會觸發,世界地圖上會留下記號。
這能讓你做什麼#
一份藍圖就是一棟小建築。你決定它長什麼樣子(用方塊搭出來)、會出現在哪種地形、多常見,還能在裡面放守衛生物和寶箱。玩家在野外探索時,會隨機遇到你的建築,不用你一個一個手動擺。
一份藍圖由兩個部分組成:資料表裡的一筆(顏色、出現規則、生物、寶箱),加上一個「造型」,也就是這棟建築每個方塊在哪裡。造型可以直接寫在表裡,也可以放在另一個檔案(通常是 models/ 底下的 .json),在表裡用路徑指過去。
不想自己一格一格寫座標的話,可以用 MagicaVoxel 做好建築,直接匯入,見下面「匯入 .vox」與 遊戲內工具。每個模組最多 16 棟藍圖。
在編輯器裡#
在編輯器左欄「世界」底下的「藍圖」(還沒有的話,從最下面的「加入新的內容」加進來)。按「新增」加一棟。新的一筆先放一塊方塊,用下面的「到世界裡框一塊」或「匯入建築檔」換成真的建築。
表單最上面有兩個按鈕:
- 「到世界裡框一塊」:編輯器先存檔,再帶你進一個創造模式的試玩世界。走到喜歡的建築或地形,框起來存成藍圖,見下面「框選」。
- 「匯入建築檔」:匯入 MagicaVoxel 做好的
.vox。匯入存好後,要回到模組清單再打開編輯器,才會看到新的內容。見遊戲裡的小工具。
表單其餘的欄位:
- 「名稱」。
- 「方塊」:只讀,顯示「大小」和「方塊數」。方塊不在表單裡編,從世界裡框選或匯入。
- 「落腳點」:建築的哪一格會對準地面上的位置,預設是底部正中間。
- 「方塊的樣子」:每一種方塊的顏色或種類(「實心」「玻璃」「水」「挖空」「家具」),按「加一種」新增。換一個顏色,整棟建築跟著變。
- 「出現的地方」:「地區」、「多常見」、「兩棟之間至少相距」、「離村莊至少」、「最大坡度」、「陷進地面」、「可以蓋在水下」。
- 「守在裡面的生物」:最多 8 筆,每筆選「哪種生物」「位置」「幾隻」。
- 「寶箱」:最多 4 個,每個選「位置」和「裡面的東西」(「物品」「最少」「最多」「機率」)。
- 「地圖圖示」:找到之後在地圖上顯示的圖案(高塔、廢墟、營地、神壇、洞穴、房屋),不選就不顯示。
右邊是預覽,可以切換「由上往下看」和「從前面看」。白框是落腳點,紅點是生物,黃點是寶箱。
框選:把世界裡的地方存成藍圖#
- 1進去
按「到世界裡框一塊」。畫面上方會寫「框選模式:走到想存的地方,用面板設兩個角」,右邊出現「框一塊建築」面板。按 Esc 放開滑鼠,才能點面板上的按鈕。
- 2設兩個角
走到建築旁,分別設「第一個角」和「第二個角」,每個角可以按「我腳下」或「我看著的方塊」,再用「左右」「高」「前後」的 + 和 - 微調。場景裡會畫出黃色的框,面板顯示「框的大小」和「方塊數」。
- 3取名並存
在「替這棟建築取名字」填名字,按「存成藍圖」。看到「已存好」之後,用「回編輯器」回去。
- 大小有上限:長和寬最多 64 格,高最多 48 格,方塊最多 20000 個。超過時面板會告訴你,請框小一點。
- 框裡有些地方還沒載入時,面板會提示「走近一點等畫面出來再存」。
- 如果你是從編輯器剛新增的空白那一筆進來的,存下來的內容會換掉那一筆,保留它的名字。否則會新增一筆。
- 新藍圖的出現地區預設是你存的時候站的那個地區,其他欄位用預設值,回編輯器再調。
進階:手寫 JSON#
下面是同一份內容寫在檔案裡的樣子。編輯器存檔時寫的就是這個格式;你也可以按編輯器上方的「開資料夾」,用外面的文字編輯器直接改,存檔後編輯器會同步過來。表單沒有的欄位,寫在檔案裡也會原樣保留。檔案放哪裡、怎麼登記,見模組資料夾與 mod.json。
藍圖的資料表放在 data/blueprints.json,並在 mod.json 的 content 裡寫 "blueprints": "data/blueprints.json"。
最小可用範例#
一間 5 格寬、4 格高的小屋:灰色地板、棕色牆(有一個門口)、藍色屋頂。裡面有一個箱子和兩隻野狼,只出現在草原和森林,在地圖上顯示成房子的圖示。這個範例只用原版的生物與物品,造型直接寫在表裡:
[
{
"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:
"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 控制:
| 欄位 | 範圍與預設 | 白話意思 |
|---|---|---|
biomes | ALL(預設)或清單:GRASSLAND、FOREST、DESERT、MESA、TUNDRA、OCEAN | 只會出現在這些地形。看的是建築放置點那一格的地形 |
rarity | 0.01 到 1,預設 0.15 | 多常見。世界被切成邊長 minSpacing 的方格,每個方格有這個機率想放一棟。0.2 大約每五格有一格嘗試,數字越大越常見 |
minSpacing | 160 到 2000,預設 300 | 方格的邊長,也是兩棟同一種建築之間大概至少隔多少格。越大,整個世界裡越少 |
awayFromVillages | 0 到 600,預設 120 | 離村莊中心至少幾格,而且不會蓋在村莊範圍裡 |
maxSlope | 0 到 12,預設 3 | 建築範圍內地面最多可以差幾格高。越小,越只出現在平地 |
allowUnderwater | true/false,預設 false | 能不能蓋在水裡(水深最多 30 格)。不允許時,地面低於海平面的地方不會放 |
sinkInto | 0 到 8,預設 1 | 底層往地下沉幾格。最低那一層會往下補實心地基直到碰到地面(最多 16 格),所以建在小凹地上也不會懸空 |
還有幾條遊戲自己的規矩:原版的奇觀、道路、祭壇、洞穴、礦坑、競技場、線索地標、首領營地和據點永遠優先,你的建築會讓開,不會蓋在它們上面。你的兩種建築之間,清單裡排前面的優先。
守衛與寶箱#
| 欄位 | 範圍與意思 |
|---|---|
spawns[].species | 守衛生物:原版的、你自己物種表裡的,或 @別的模組/id。首領、坐騎、海裡的生物不行 |
spawns[].at | [x, y, z],造型裡的座標。守衛會出現在這個位置附近 |
spawns[].count | 1 到 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裡放了首領專屬的物品。 - 以為守衛每次靠近都會重生。每棟建築只會觸發一次。
相關頁面#
- 模組編輯器:不用手寫檔案,在遊戲裡用表單做模組。
- 遊戲內工具:不碰檔案匯入
.vox建築。 - 範本:「古老神龕」範本。
- 物種(species):做自己的守衛生物。
- 生成(spawns):讓生物在野外自己出現,不綁在建築上。
- 資料夾與 mod.json