方块

创建一个方块

编写配置文件

这里的newblock文件夹及命名空间的newblock和配置文件夹下的blocks.yml文件名是可以随意自定义

首先在/plugins/CraftEngine/resources/newblock/configuration/文件夹下创建一个blocks.yml文件 然后在blocks.yml里创建一个名为xiaomomi的方块

namespace: newblock

blocks:
  xiaomomi:
    default-state:
      block-state: minecraft:note_block:10
      model:
        path: "minecraft:block/custom/xiaomomi"

这里的block-state是方块替换原版的某个方块的状态使用规则具体参考mappings.yml

然后在/plugins/CraftEngine/resources/newblock/resourcepack/里添加方块的模型和材质 上面使用的是minecraft:block/custom/xiaomomi模型也就是我们需要把制作好的json模型文件xiaomomi.json放到/plugins/CraftEngine/resources/newblock/resourcepack/assets/minecraft/models/block/custom文件夹里面，最后把模型使用的图片放到对应位置就大功告成了

如果你不是很了解Minecraft的资源包结果可以参考WIKI

25KB

newblock.zip

archive

教程示例的方块

在游戏中查看效果

使用命令/ce reload重新生成资源包把/plugins/CraftEngine/generated/original.zip复制到客户端资源包文件夹加载

使用命令/ce setblock ~ ~ ~ newblock:xiaomomi即可把方块放置到玩家所处位置

游戏中的自定义方块

可使用配置项

default-state方块默认状态（必填）

block-state替换的原版方块状态使用mappings.yml管理（必填）

properties方块特性

• xx轴旋转

• yy轴旋转

• zz轴旋转

model方块模型（必填）

• path模型命名空间及路径（必填）

• generation插件生成配置

  • 具体参考WIKI

• overrides模型覆写（注意该功能已经在1.21.4移除）

  • 具体参考WIKI

settings方块设置

item绑定方块可以通过鼠标中键自动选取

hardness方块硬度

resistance爆炸抗性

push-reaction方块被推动特性

• NORMAL可以被正常推动拉动

• DESTROY推动拉动方块时破坏方块

• BLOCK不能被推动拉动

• IGNORE只能被推动，但是可以被方块黏着运动

• PUSH_ONLY只能被推动，但是不能被方块黏着运动

replaceable是否可以被其他方块替换

burnable是否可以被点燃

can-occlude是否可以遮挡天空光照

is-randomly-ticking是否受到游戏刻影响例如草方块蔓延

map-color地图上渲染的颜色参考这里

luminance方块自身发光亮度

instrument指定放到方块上的音符盒乐器

sounds方块产生的音效

• break破坏方块的声音

• step在方块上行走的声音

• place放置方块的声音

• hit挖掘方块的声音

• fall带有摔落伤害时摔落在方块上的声音

properties方块属性

axis轴

• type轴的类型

• default-value默认值

variants方块变种

axis=后面可以接x,y,z代表3种不同状态

• 参考前面的 方块默认状态 配置

参考配置

spirit_log:
  settings:
    item: default:spirit_log
    hardness: 2.0
    resistance: 2.0
    push-reaction: NORMAL
    replaceable: false
    burnable: true
    can-occlude: true
    is-randomly-ticking: false
    map-color: 16
    luminance: 8
    instrument: BASS
    sounds:
      break: minecraft:block.wood.break
      step: minecraft:block.wood.step
      place: minecraft:block.wood.place
      hit: minecraft:block.wood.hit
      fall: minecraft:block.wood.fall
  properties:
    axis:
      type: axis
      default-value: y
  default-state:
    block-state: minecraft:note_block:0
    model:
      path: "minecraft:block/custom/spirit_log"
      generation:
        parent: "minecraft:block/cube_column"
        textures:
          "end": "minecraft:block/custom/spirit_log_top"
          "side": "minecraft:block/custom/spirit_log"
  variants:
    axis=x:
      block-state: minecraft:note_block:1
      properties:
        x: 90
        y: 90
      model:
        path: "minecraft:block/custom/spirit_log_horizontal"
        generation:
          parent: "minecraft:block/cube_column_horizontal"
          textures:
            "end": "minecraft:block/custom/spirit_log_top"
            "side": "minecraft:block/custom/spirit_log"
    axis=z:
      block-state: minecraft:note_block:2
      properties:
        x: 90
      model:
        path: "minecraft:block/custom/spirit_log_horizontal"
        generation:
          parent: "minecraft:block/cube_column_horizontal"
          textures:
            "end": "minecraft:block/custom/spirit_log_top"
            "side": "minecraft:block/custom/spirit_log"

配置mappings.yml

添加可自定义方块

格式为被替换的方块状态: 替换成的方块状态

示例：

• minecraft:kelp[age=1]: minecraft:kelp[age=0]

使用可自定义方块

假设已经配置好了以下配置

mappings.yml

minecraft:weeping_vines[age=1]: minecraft:weeping_vines[age=0]
minecraft:weeping_vines[age=2]: minecraft:weeping_vines[age=0]
minecraft:weeping_vines[age=3]: minecraft:weeping_vines[age=0]
minecraft:weeping_vines[age=4]: minecraft:weeping_vines[age=0]
minecraft:kelp[age=1]: minecraft:kelp[age=0]
minecraft:kelp[age=2]: minecraft:kelp[age=0]
minecraft:kelp[age=3]: minecraft:kelp[age=0]
minecraft:kelp[age=4]: minecraft:kelp[age=0]
minecraft:kelp[age=5]: minecraft:kelp[age=0]
minecraft:kelp[age=6]: minecraft:kelp[age=0]
minecraft:kelp[age=7]: minecraft:kelp[age=0]
minecraft:kelp[age=8]: minecraft:kelp[age=0]
minecraft:kelp[age=9]: minecraft:kelp[age=0]

使用block-state选项使用时只需要填入minecraft:kelp:索引值，索引值是添加的相同方块下从上往下以0开始递增的数值，例如我想使用minecraft:kelp[age=5]作为自定义方块的被替换方块就填入minecraft:kelp:4即可

block-state: minecraft:kelp:4

配置blockstates.yml

格式为

minecraft:原版方块名称:
  状态=默认值:
    model: "命名空间:模型路径"

示例：

• minecraft:lightning_rod:
    facing=up,powered=false,waterlogged=false:
      model: "minecraft:block/lightning_rod"