4.5 KiB
title, category, nav_order, tags, mentions
| title | category | nav_order | tags | mentions | |||||
|---|---|---|---|---|---|---|---|---|---|
| 最佳实践 | 通用指南 | 2 |
|
|
最佳实践
:::tip 提示 本文内容假定您已对JSON-UI系统有一定了解。如果您是JSON-UI的新手，请务必先阅读JSON-UI介绍和JSON-UI文档。 :::
最大化兼容性并减少UI崩溃的可能性
JSON-UI与其他附加包系统不同，因为JSON-UI没有版本控制。随着Mojang更新和修复JSON-UI系统，您对UI所做的任何修改都可能失效。幸运的是，您可以通过以下几种方法在Mojang更新原版UI时保持自定义UI的稳定性。
仅修改必要内容
最有效的防崩溃策略是只修改需要调整的部分。例如若只需要禁用经验条阴影，正确做法应是在资源包中向hud_screen.json文件添加：
{
"progress_text_label": {
"shadow": false
}
}
这种极简修改方式能显著降低未来更新导致UI崩溃的风险，同时保持文件整洁并大幅缩小体积。若您将整个原版UI文件复制到资源包中进行修改，说明您错误理解了JSON-UI的工作机制。
善用修改策略
使用wiki文档中的修改策略能有效降低更新风险。例如在HUD中添加自定义元素时，推荐使用修改数组操作而非直接插入控件：
::: code-group
{
"root_panel": {
"modifications": [
{
"array_name": "controls",
"operation": "insert_front",
"value": [
{
"custom_ui@namespace.custom_ui": {}
}
]
}
]
}
}
:::
这种策略性合并方式能提升与其他资源包的兼容性，并减少因原版控件结构调整导致的崩溃风险。
避免修改深层嵌套控件
修改嵌套层级过深的控件容易引发问题。推荐优先修改基础元素定义，必要时使用斜杠语法定位子控件：
::: code-group
{
"panel_with_label_and_bg/bg_image": {
"size": ["100%c", "100%c"]
},
"panel_with_label_and_bg/bg_image/label": {
"layer": -5
}
}
:::
使用单一入口点
合并自定义UI时建议集中到单个入口点。例如将多个自定义控件统一插入root_panel：
::: code-group
{
"root_panel": {
"modifications": [
{
"array_name": "controls",
"operation": "insert_front",
"value": [
{"custom_ui_1@ns1.control1": {}},
{"custom_ui_2@ns1.control2": {}}
]
}
]
}
}
:::
避免使用原版命名空间
开发大规模UI修改时，建议创建自定义命名空间并使用前缀（如wiki:namespace）来防止命名冲突。通过element@namespace.element语法引用其他命名空间的元素。
性能优化指南
JSON-UI是仅次于实体的性能消耗大户。以下策略可帮助提升UI性能表现：
减少操作符使用
操作符会显著增加计算开销。优化示例：
"$var": "(-2 * $number)" // 优于 "(2 * (-1 * $number))"
精简绑定数量
每个绑定都会产生性能开销。建议：
- 移除无效绑定
- 合并相似功能绑定
- 避免重复绑定相同数据
优化控件结构
通过以下方式减少控件数量：
- 删除无用控件或添加
"ignored": true - 合并相似控件
- 使用条件渲染替代多个独立控件
::: code-group
// 5个独立图像控件
"image_1@image_template": {
"$texture": "textures/ui/example_1",
"$binding_text": "1"
}
...
// 单个动态图像控件
"image": {
"type": "image",
"texture": "#texture",
"bindings": [
{
"binding_type": "view",
"source_property_name": "('textures/ui/example_' + #hud_title_text_string)",
"target_property_name": "#texture"
}
]
}
:::
注意："visible": false不会阻止控件计算，应优先使用"ignored": true彻底禁用控件。
通过系统性优化，可显著提升UI响应速度并降低资源消耗，为玩家提供更流畅的游戏体验。