Advanced Datapack Mod

此mod旨在扩展数据包功能，目前处于早期开发阶段。 不要在正常游戏期间使用此模组。它可能会导致崩溃甚至坏档！

This mod is designed to extend datapack functionality and is currently in early development. Do not use this mod during regular gameplay. It may cause crashes or even corrupt your world!

Datapack功能介绍

1. 物品扩展

• 相比于原版数据包，增加了更多的物品扩展功能，能够使Minecraft通过数据包动态注册物品。
• 支持物品的自定义属性、耐久度等。
• 支持物品的自定义模型和纹理。(在资源包中定义)

2. 方块扩展(正在开发)

• 增加了更多的方块扩展功能。

3. 命令

• adm命令 [返回]mod 信息
  • item子命令
    • get <namespace> [返回]注册的物品列表 <namespace>非必选参数
    • disable <item> [禁用]指定adm物品 <item>必选参数(可用,正在完善中)
    • enable <item> [启用]指定adm物品 <item>必选参数(可用,正在完善中)
    • setclear [清除]正在被使用的已禁用物品会被清除 true->false;false->true(可用,正在完善中)
  • block子命令
    • get <namespace> [返回]注册的方块列表 <namespace>非必选参数
    • disable <block> [禁用]指定adm方块 <block>必选参数(可用,正在完善中)
    • enable <block> [启用]指定adm方块 <block>必选参数(可用,正在完善中)
  • debug子命令 [设置]debug模式 true->false;false->true
  • reload子命令 [重载]mod数据 (正在开发)

Datapack格式

在数据包的 data/<namespace>/item目录下新建<item_name>.json文件以定义物品。

这是一个示例

{
"food": {
    "canAlwaysEat": true,
    "nutrition": 80,
    "saturation": 3.0,
    "effects":[
      ["minecraft:night_vision",10,1]
    ]
},
"tool": {
    "type": "axe",
    "level": "stone",
    "attackDamage": 999,
    "attackSpeed": 0.1,
    "durability": 1
},
"replace": "barrier"  
}

其中food、tool和replace是可选的。

• food定义了物品的食物属性。
  • canAlwaysEat：是否总是可以食用。
  • nutrition：食物的饱食度。
  • saturation：食物的饱和度。
  • effects：食用后给予的效果，格式为[效果ID,持续时间(tick),效果等级]。
• tool定义了物品的工具属性。
  • type：工具类型，如axe、pickaxe、shovel、hoe、sword。
  • level：工具等级，如wood、stone、iron、diamond、netherite。
  • attackDamage：工具的攻击伤害。
  • attackSpeed：工具的攻击速度。
  • durability：工具的耐久度。
• replace定义了物品在客户端的展示物品，必须是一个(客户端)存在的物品ID，如minecraft:stone、minecraft:iron_ingot等(developing)。

在数据包的 data/<namespace>/block目录下新建<block_name>.json文件以定义方块。

这是一个示例

{
  "hardness": 1.0,
  "resistance": 10.0,
  "lightLevel": 0,
  "replace": "minecraft:stone",
  "require_tool": true,
  "has_item": true,
  "replaceable": false
}

其中hardness、resistance、lightLevel、replace、require_tool、tool和has_item是可选的。

• hardness：方块的硬度。
• resistance：方块的爆炸抗性。
• lightLevel：方块的光照等级。
• has_item：方块是否有对应的物品形式。(若有，则在data/<namespace>/item目录下新建同名的物品定义文件)
• replace定义了方块在客户端的展示方块，必须是一个(客户端)存在的方块ID，如minecraft:stone、minecraft:oak_planks等(developing)。
• require_tool：是否需要工具才能破坏方块。

ADM API

• cn.gcte.adm.api.ResReloadManager 资源重载管理器
  • public static void register(Consumer<ResourceManager> consumer) 注册listener, 该listener会在数据包刚开始加载时被调用。

    ResReloadManager.register(resourceManager -> {
        // 在这里处理资源刚加载
        // 举个例子
        LOGGER.info("Resource manager has been reloaded!");
    });
    

• cn.gcte.adm.api.GetBlockData 获得方块数据包资源(即data/<namespace>/block/<block_name>.json文件)。
  • public static String getAllData()获得DataList(json字符串)
• cn.gcte.adm.api.GetItemData 获得物品数据包资源(即data/<namespace>/item/<item_name>.json文件)。
  • public static String getAllData()获得DataList(json字符串)