我的世界中国版 Wiki

主题

JSON在我的世界基岩版中的应用 ​

在《我的世界》中，JSON用于提供一切自定义对象的数据。所有使用这种方式自定义的内容都被称为“数据驱动”的内容。我们可以在《我的世界》用数据驱动的方式定义物品、方块、实体、维度、生物群系、状态效果、魔咒、配方、战利品表、交易、音效、书本等各类内容，几乎涵盖了大部分可自定义的内容。

值得注意的是，数据驱动的方式只能定义一个对象的“初始状态”。如果要在游戏内运行时中动态地更改内容，你还需要脚本的辅助。这不在本教程的教学范围内，你可以参考《我的世界》开发者官网中找到相关内容。

找到JSON文件的位置 ​

image-20240921223305212

任意找到一个配置对象，在“资源管理”窗格中找到对应的文件，点击右键，并点击“打开文件所在位置”，便可以在资源管理器中打开相关文件所在的文件夹。

image-20240921223423372

文件名后缀为.json的文件便是JSON了。这里，我们以钻石苹果的战利品表为例，打开可以看到相关的JSON内容：

json
{
    "pools": [
        {
            "entries": [
                {
                    "functions": [
                        {
                            "count": {
                                "max": 1,
                                "min": 1
                            },
                            "function": "set_count"
                        },
                        {
                            "data": 0,
                            "function": "set_data"
                        }
                    ],
                    "name": "test:custom_food",
                    "type": "item",
                    "weight": 1
                }
            ],
            "rolls": 1
        }
    ]
}

这个JSON的效果和之前我们在编辑器中定义过的“100%掉落一个钻石苹果物品”的效果是一致的。准确的说，编辑器的属性窗格的作用就是可视化地编辑该文件。之后，《我的世界》会加载该文件，并实现我们的战利品表效果。

文件结构 ​

在文件所在位置的周围探索，你会发现有些JSON数据文件位于名为behavior_pack_xxxx的文件夹下，而有些位于resource_pack_xxxx文件夹下。前者被称为行为包，后者被称为资源包。不管在行为包还是资源包中，JSON数据文件一般都是成组地被分在不同的子文件夹下。比如战利品表就都位于loot_tables文件夹内，而网易的自定义方块则位于netease_blocks文件夹下。

这里，我们给出一些常用的文件夹名称及其内容物。

资源包内容
textures纹理
sounds音效、音乐
texts语言文件
materials材质
shaders着色器
models模型
entity实体客户端
attachables附着物
animations动画
animation_controllers动画控制器
render_controllers渲染控制器
netease_items_res中国版物品客户端
effects中国版特效（粒子）
particles国际版粒子
fog迷雾
uiJSON UI
行为包内容
entities实体服务端
netease_items_beh中国版物品服务端
netease_blocks中国版方块
netease_dimension中国版维度
netease_biomes中国版地物
netease_features中国版特征（地物）
netease_feature_rules中国版特征规则（地物规则）
netease_tab中国版物品分类
netease_group中国版物品分组
netease_recipes中国版配方
netease_effects中国版状态效果
netease_enchants中国版魔咒
netease_micro_blocks中国版微缩方块
netease_large_feature_pools中国版拼图结构池
netease_large_feature_rules中国版拼图规则
customBooks中国版书本
customAchievements中国版成就
animations服务端动画
animation_controllers服务端动画控制器
loot_tables战利品表
trading交易表
spawn_rules实体生成规则
structures结构
functions函数
storyline中国版蓝图
config中国版配置

当然，除了文件夹之外，还有一些零散的单独文件，比如不论是资源包还是行为包，都必须具有的最重要的文件manifest.json，被称为清单文件。这些零散的文件大家可以自行在附加包中探索，观察具体的结构。