# JSON在我的世界基岩版中的应用
在《我的世界》中,JSON用于提供一切自定义对象的数据。所有使用这种方式自定义的内容都被称为“数据驱动”的内容。我们可以在《我的世界》用数据驱动的方式定义物品、方块、实体、维度、生物群系、状态效果、魔咒、配方、战利品表、交易、音效、书本等各类内容,几乎涵盖了大部分可自定义的内容。
值得注意的是,数据驱动的方式只能定义一个对象的“初始状态”。如果要在游戏内运行时中动态地更改内容,你还需要脚本的辅助。这不在本教程的教学范围内,你可以参考《我的世界》开发者官网中找到相关内容。
# 找到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 | 迷雾 |
ui | JSON 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 | 中国版配置 |
当然,除了文件夹之外,还有一些零散的单独文件,比如不论是资源包还是行为包,都必修具有的最重要的文件pack_manifest.json
,被称为清单文件。这些零散的文件大家可以自行在附加包中探索,观察具体的结构。
← 总览 JSON编辑工具与有效原则 →