框架 - Framework

📙 关于：

框架（Framework）是一个用于辅助开发多平台模组的依赖库，包含注册系统、网络消息等内容。此外，框架还包含一些额外功能以进一步挖掘模组开发的潜力，相关内容如下。

🚀 开放模型格式

开放模型格式是对原版（Vanilla）JSON方块模型格式的扩展。它消除了在设计方块模型时的一些随意限制，这意味着现在你可以将元素旋转到任意角度，而不是以22.5度为增量。它还允许元素的定位和尺寸超出最大边界[-16,-16,-16]到[32,32,32]。以下是一个在载具模组中使用的直升机模型示例。


🔑 同步数据键

同步数据键是对《我的世界》实体数据访问器系统的一种改进。它允许你在无需编写复杂功能的情况下，为任何实体附加额外数据。使用框架的同步数据键的好处在于它提供的强大功能。正如其名所示，数据可以自动同步到客户端；这意味着你无需处理数据包。数据可以保存到实体中，以便在世界重载或服务器重启时仍能保留。与《我的世界》的系统不同，框架增加了一个选项，可让你的数据在角色死亡后仍能保留，而不是重置为默认值。还不信？看看下面的示例，了解这个系统是多么简单而强大。

一个记录鸡被玩家攻击次数的示例。

// 创建一个同步数据键
private static final SyncedDataKey<Chicken, Boolean> HIT_COUNT = SyncedDataKey.builder(SyncedClassKey.CHICKEN, Serializers.INTEGER)
   .id(new ResourceLocation("你的模组ID", "hit_count"))
   .defaultValueSupplier(() -> 0)
   .saveToFile()
   .syncMode(SyncMode.TRACKING_ONLY)
   .build();
// 在你的通用设置中调用此方法
FrameworkAPI.registerSyncedDataKey(HIT_COUNT);
// 当玩家攻击实体时的Forge事件
void onHitEntity(AttackEntityEvent event) {
if(event.getTarget() instanceof Chicken chicken) {
int newCount = HIT_COUNT.getValue(chicken) + 1;
HIT_COUNT.setValue(chicken, newCount);
}
}

📦 便捷登录数据包

Forge允许开发者创建登录数据包，但实现它需要大量代码。框架将所需代码精简为一个简单的注册方法，并会处理将你的数据发送到客户端的事宜。

📔 开发者：

通过阅读此处关于其功能的介绍，了解框架对你的开发有何益处。

🙋‍♀️ 需要支持？加入官方Discord服务器：

评论区不太适合提供支持，加入官方Discord服务器吧。你可以获得安装和配置模组、解决崩溃等方面的帮助！此外，你还能获取有关模组更新和开发的最新消息（比其他地方都早）。