API
Mga uri ng block
Puwedeng maging isa sa mga uri ng block ng laro ang isang block: hagdan na nagdudugtong sa mga sulok, pinto na dalawang block ang taas, bakod na kumakabit sa kapitbahay, chest, karatula, pananim, ore. Bigyan ito ng kind at gagawin itong parang block ng laro na ganoong uri, kasama ang hugis, mga state at gawi nito, pero sa texture mo.
Mga uri at materyal
block "jade_bricks" { hardness: 2, tool: "pickaxe" }
block "jade_stairs" { kind: "stairs", base: "jade_bricks", texture: "mymod:block/jade_bricks" }
block "jade_slab" { kind: "slab", texture: "mymod:block/jade_bricks" }
block "jade_wall" { kind: "wall", texture: "mymod:block/jade_bricks" }
block "willow_log" { kind: "pillar", material: "wood", sound: "wood" }
block "willow_door" { kind: "door", material: "wood", sound: "wood" }
block "jade_door" { kind: "door", material: "metal" }
block "willow_fence" { kind: "fence", material: "wood", texture: "mymod:block/willow_planks" }| Uri | Ano ito |
|---|---|
cube |
isang karaniwang block (ang default) |
pillar |
isang troso o haligi: nakahiga ito sa axis kung saan ito inilagay |
slab, stairs, wall, fence, fence_gate |
mga building block na kumakabit sa kapitbahay nila gaya ng sa laro. Kinukuha ng hagdan ang block na pinagawaan nito sa base |
door, trapdoor, button, pressure_plate |
dalawang block ang taas ng mga pinto; naka-on o naka-off ang pressure plate |
leaves, lantern, vine, ladder, carpet, bars, chain |
manipis ang mga rehas at pane at kumakabit sa kapitbahay nila; ang chain ay nakahiga sa axis kung saan ito inilagay |
plant, water_plant, crop |
mga halaman (sa ibaba) |
barrel, bookshelf, chiseled_bookshelf, shelf, composter, crafting_table, chest, furnace |
mga block na gumagana (sa ibaba) |
sign, hanging_sign |
mga karatula (sa ibaba) |
path, ore |
mga landas at ore (sa ibaba) |
Ang material ay stone (ang default), wood o metal, para sa mga uring mahalaga ito: nabubuksan ng kamay ang pinto o trapdoor na kahoy, redstone lang ang makabubukas sa metal. Ang mga slab, hagdan, bakod, button, plate at pillar ay ginagawa ring parang sa laro na gawa sa materyal na iyon.
Ano ang kinukuha nito sa block ng laro. Kapag walang sariling file, kinukuha ng block na may uri ang blockstate at mga model ng laro na may texture mo (bilang default textures/block/<id>.png), ang item nito, ang mga drop nito at ang mga tag nito: kumakabit ang mga bakod sa mga bakod, ang mga troso ay itinuturing na troso, isang item ang ibinabagsak ng pinto. Kapag gumagamit ng higit sa isang texture ang block ng laro, ginagamit ang texture mo na may parehong dulo kung mayroon ito ang mod: <id>_top.png at <id>_bottom.png para sa pinto, <id>_top.png para sa pillar, <id>_front.png at <id>_front_on.png para sa furnace. Kung may sarili itong mga model, loot o tag, ang mga iyon ang gagamitin. Gumagana ang hardness, sound, light at ang iba pang property ng Mga bloke, gamit at resipe gaya ng sa anumang block.
Mga halaman at pananim
block "glow_grass" { kind: "plant", hardness: 0, grows_on: ["#minecraft:dirt", "mymod:glow_moss"] }
block "reed" { kind: "water_plant", hardness: 0 }
block "rice" { kind: "crop", hardness: 0 }plant: iginuguhit bilang dalawang magkakrus na larawan, gaya ng damo, bulaklak, kabute o sapling. Walang bumabangga rito at kailangan nito ng lupa.water_plant: halamang nabubuhay sa ilalim ng tubig, gaya ng seagrass.crop: lumalaki ito sa mga edad na 0 hanggang 3 nang mag-isa at gamit ang bone meal. Mababasa angagestate nito gamit angblock.state("age"), at ang<id>_stage0.pnghanggang<id>_stage3.pngang mga texture nito sa bawat edad.
Inililista ng grows_on ang mga block na tinutubuan nito, mga id o tag gaya ng #minecraft:dirt. Kapag wala ito, tumutubo ang halaman kung saan tumutubo ang halaman ng laro na ganoong uri (ang crop sa farmland). Nasisira ang halamang nawalan ng lupa.
Mga block na gumagana
block "willow_barrel" { kind: "barrel", sound: "wood" }
block "willow_chest" { kind: "chest", sound: "wood" }
block "willow_bookshelf" { kind: "bookshelf", sound: "wood" }
block "jade_furnace" { kind: "furnace", hardness: 3.5, tool: "pickaxe" }Iniingatan nila ang mga item nila, binubuksan ang screen nila at gumagana gaya ng sa laro: 27 stack ang laman ng barrel, 6 na aklat ang chiseled bookshelf, 3 item ang shelf, napupuno ang composter, nagka-craft ang crafting table, nagsa-smelt ang furnace at nakasindi habang nasusunog.
Iginuguhit ang chest gamit ang textures/entity/chest/<id>.png, at ang dalawang magkatabi ay bumubuo ng double chest, na iginuguhit gamit ang <id>_left.png at <id>_right.png sa parehong folder. Ang layout nila ay gaya ng mga texture ng chest ng laro.
Mga karatula
block "willow_sign" { kind: "sign", sound: "wood" }
block "willow_hanging_sign" { kind: "hanging_sign", sound: "wood" }Nagsusulat ang mga manlalaro sa mga ito gaya ng sa laro. Kapag nagdeklara ka ng karatula, idineklara mo rin ang anyo nito sa dingding, ang block na inilalagay ng item nito sa dingding: kasama ng jade_sign ang jade_wall_sign, at kasama ng jade_hanging_sign ang jade_wall_hanging_sign. Ibinibigay mismo ng wall ang id na iyon. Ibinabagsak ng anyo sa dingding ang karatula. Nakabitin ang hanging sign sa ilalim ng block, at ang anyo nito sa dingding ay sa gilid ng isa.
Mga landas at ore
block "moss_path" { kind: "path", base: "minecraft:moss_block" }
block "jade_ore" { kind: "ore", hardness: 3, tool: "pickaxe", tier: "iron", xp: [1, 4] }Medyo mas mababa sa block ang path, gaya ng dirt path ng laro. Ginagawa ito ng pala mula sa base nito kapag may hangin sa itaas. Bumabalik ito sa base nito kapag tinakpan ito ng block, at ibinabagsak nito ang base nito.
Naglalabas ng experience ang ore kapag binasag nang walang silk touch: numero o [min, max] ang xp. Para ibagsak nito ang sarili kapag may silk touch at mas marami kapag may fortune, tingnan ang Mga drop sa Mga bloke, gamit at resipe.
Mga nakakabit na block
Kapag attached: true, nakakabit ang block sa block na pinaglagyan nito, at nasisira ito kapag nawala iyon. Gumagana ang mga property na ito sa anumang block, may uri man o wala.
block "crystal_shard" {
attached: true
states: ["facing_all"]
model: "block/crystal_shard"
}
block "glow_bulb" {
attached: true
floor_state: "standing"
states: ["standing"]
light: 12
}- Kapag may
"facing"o"facing_all"na state, nakaharap ito palayo sa humahawak dito: nakaharap din angfacing_allpataas at pababa, kaya puwedeng nasa sahig, dingding o kisame ang isang shard (tingnan ang Mga state ng block sa Mga bloke, gamit at resipe). - Ipinapangalan ng
floor_stateang isang toggle state na naka-on kapag nakatayo ang block sa sahig at naka-off kapag nakabitin sa kisame, gaya ng lantern. Ideklara rin ang toggle sastates.
Mga upuan at block na dalawa ang taas
block "stool" { seat: 9, shape: [[3, 0, 3, 13, 9, 13]] }
block "throne" {
model: "block/throne"
seat: 10
upper: "top"
states: ["facing", "top"]
}Hinahayaan ng seat ang mga manlalarong umupo sa block sa pamamagitan ng click ng walang lamang kamay, sa ganoong karaming pixel sa itaas ng ilalim nito (0 hanggang 16; mga 10 ang upuan). Kung may on_use ang block na kumukuha ng click, hindi uupo ang manlalaro.
Ginagawa ng upper na dalawang block ang taas ng block, gaya ng pinto o matangkad na upuan: ipinapangalan nito ang isang toggle state na naka-on sa itaas na kalahati nito. Kapag may espasyo sa itaas, parehong kalahati ang nailalagay, parehong nasisira kapag may isang nasira, at ang ibabang kalahati lang ang nagbabagsak nito. Sa ibabang kalahati inuupuan ang upuang dalawa ang taas. Ideklara rin ang toggle sa states. May sariling hitsura ang itaas na kalahati gaya ng anumang state: dito, ang models/block/throne_top.json.
Mga halaman sa isang hanay
block "glow_vine" {
plant: true
column: "hanging"
states: [{ shape: ["top", "middle", "bottom"] }]
}Pinapalaki ng column ang halaman sa isang hanay, gaya ng nakabitin na baging. Sinusundan ng shape state nito ang parehong halaman sa itaas at ibaba nito: bottom kapag wala sa ilalim, top kapag wala sa itaas, middle sa pagitan. Ideklara ito sa states bilang { shape: ["top", "middle", "bottom"] }; ang mga texture na <id>_middle.png at <id>_bottom.png ang hitsura nito roon.
hanging: nakabitin ito sa block sa itaas, na maaaring parehong halaman, dahon o block na matigas sa ilalim.standing: nakatayo ito sa lupa nito (grows_on) o sa parehong halaman.
Kapag wala ang sumusuporta rito, nasisira ito, at kasama nitong nawawala ang mga halamang nakabitin o nakatayo rito.
Mga property
| Property | Mga value | Default |
|---|---|---|
kind |
isa sa mga uri sa itaas | cube |
material |
stone, wood, metal |
stone |
base |
para sa hagdan at landas: ang block na pinagawaan nila, sa iyo o sa laro | — |
grows_on |
para sa mga halaman: mga id ng block at tag | ang lupa ng uri nito |
wall |
para sa mga karatula: ang id ng anyo sa dingding | jade_sign → jade_wall_sign |
xp |
para sa mga ore: numero o [min, max] |
— |
attached |
nakakabit sa block na pinaglagyan nito | false |
floor_state |
kasama ng attached: ang toggle na naka-on kapag nakatayo ito sa sahig |
— |
seat |
mga pixel sa itaas ng ilalim nito kung saan uupo ang mga manlalaro (0–16) | hindi upuan |
upper |
dalawang block ang taas: ang toggle na naka-on sa itaas na kalahati nito | — |
column |
hanging o standing |
— |
Sa Kotlin
block("jade_stairs") { kind = BlockKind.STAIRS; base = "jade_bricks"; texture = "mymod:block/jade_bricks" }
block("willow_door") { kind = BlockKind.DOOR; material = BlockMaterial.WOOD; sound = SoundGroup.WOOD }
block("glow_grass") { kind = BlockKind.PLANT; growsOn = listOf("#minecraft:dirt") }
block("jade_ore") { kind = BlockKind.ORE; xp = 1..4 }
block("crystal_shard") { attached = true; facingAll() }
block("throne") {
seat = 10
upper = "top"
facing()
toggle("top")
}
block("glow_vine") {
plant = true
column = Column.HANGING
choice("shape", "top", "middle", "bottom")
}Nasa BlockKind ang mga uri at nasa BlockMaterial ang mga materyal. Pareho ang pangalan ng iba pang property sa camelCase: growsOn, floorState, xp = 1..4, column = Column.HANGING. Idinedeklara ng facingAll() at choice(name, …) ang mga state.