Apoli 是一款用于构建自定义能力、独特技能以及全新游戏机制的模组。所有功能均通过围绕模块化设计理念的数据包实现。它是 Overgrown's Origins 背后的核心引擎。
要开始使用,请在你的数据包中的 data/<namespace>/powers/ 目录下创建一个能力文件。
该模组具备以下特性:
- 能力系统:内置 100 多种能力类型,可赋予任意实体。它就像一套超级英雄能力的工具包(无需编写 Java 代码)。
- 类型化动作系统:涵盖实体、双实体、方块、物品及元数据动作。
- 全面的条件系统:支持 7 种上下文类型。
- 数据驱动的职业技能树:提供进度路径和可解锁的能力。
- 基于物理的绳索与抓钩系统:支持摆动、跳跃和收回动作。
- 实体伪装系统:允许变换生物和玩家的外观。
- 自定义实体:包括投射物、仆从以及玩家克隆体。
- 数据驱动按键绑定:完全通过数据包定义。
- 自定义配方与掉落函数:用于授予能力。
- 内置表达式引擎:用于基于数学计算的能力数值。
- 可选集成:支持 Trinkets、Curios、Accessories、Figura、Icarus 和 Hardcore Revival。
- 专为真实服务器设计:包含索引化的能力查找、针对大型数据包的分块网络同步,以及采用安全失败而非不同步的版本化协议。
适用于 Fabric 和 NeoForge,支持 1.20.1 和 1.21.1 版本。
有问题或需要报告 Bug?请加入 Discord 或在 GitHub 上提交 Issue。如果你希望支持开发,欢迎在 Ko-fi 进行捐赠。
Apoli is a mod for building custom powers, unique abilities, and entirely new game mechanics. All through data packs that are themed around modular design. It's the engine behind Overgrown's Origins.
To get started, create a power file under data/<namespace>/powers/ in your data pack.
The mod features:
- A power system with 100+ built-in ability types, grantable to any entity. Think of it as a toolkit for superpowers (No Java Required).
- A typed action system spanning entity, bi-entity, block, item, and meta actions.
- A comprehensive condition system across 7 context types.
- Data-driven skill trees for progression paths and unlockable abilities.
- A physics-based rope and grapple system (swing, leap, and reel).
- An entity disguise system for transforming mobs and players.
- Custom entities: projectiles, minions, and player clones.
- Data-driven keybindings, defined entirely through data packs.
- Custom recipes and loot functions that grant powers.
- A built-in expression engine for math-driven power values.
- Optional integration with Trinkets, Curios, Accessories, Figura, Icarus, and Hardcore Revival.
- Built for real servers: indexed power lookups, chunked network sync for large packs, and a versioned protocol that fails safely instead of desyncing.
Available for Fabric and NeoForge, on 1.20.1 and 1.21.1.
Questions or bug reports? Join the Discord or open an issue on GitHub. If you'd like to support development, Ko-fi donations are appreciated.
下载 Overgrown's Apoli
下载 Overgrown's Apoli
下载 Overgrown's Apoli
下载 Overgrown's Apoli
下载 Overgrown's Apoli
下载 Overgrown's Apoli
下载 Overgrown's Apoli
下载 Overgrown's Apoli
下载 Overgrown's Apoli
下载 Overgrown's Apoli
1.132.0
变更
Aggro At 可作用于任何实体上的任何生物
apoli:aggro_at 此前仅在目标为中立生物且行为者为玩家时生效。现在,目标可以是任何生物,而行为者可以是任何活体实体,因此该动作可以让一个生物攻击另一个生物。被玩家激怒的中立生物仍会获得相同时间的仇恨计时。在其他所有组合中,生物会立即转向攻击行为者,就像行为者刚刚击打了它一样,并锁定该目标,而不是重新游荡回最近的玩家。依赖记忆进行 AI 行为的生物(如猪灵和疣猪兽)也会将行为者存储为它们的攻击目标,持续 duration 刻。
{
"type": "apoli:area_of_effect",
"radius": 10,
"bientity_action": {
"type": "apoli:aggro_at",
"duration": 200
}
}
在生物上运行此配置,会使 10 格范围内的所有生物在十秒内攻击施放者。
修复
披风和鞘翅始终贴合身体
apoli:modify_model_parts 会单独移动每个身体部位,而披风和鞘翅仍停留在原版设定的位置,因此当能力让角色前倾、侧身或蹲下时,它们会悬停在玩家身后的空中。现在,无论能力对模型进行何种编辑(旋转、移动或缩放),披风和鞘翅都会跟随身体一起变化。
近距离锥形检测能命中视线所对的目标
apoli:raycast 的锥形区域以及 raycast 双实体条件的检测范围此前仅检查每个碰撞箱的中心点,因此当你直视某生物的头部时,位于你正前方的该生物可能会因处于狭窄的锥形区域之外而未被检测到。现在,只要实体的碰撞箱有任何部分位于锥形区域内,或者瞄准线穿过其碰撞箱,即视为命中。
1.131.0
新增
隐藏单个护甲部件
apoli:prevent_feature_render 新增了四个功能名称:armor_head、armor_chest、armor_legs 和 armor_feet。每个名称分别隐藏对应槽位的护甲,同时保留其他部件的渲染;而使用 armor 则会隐藏全部四件护甲。由于每个客户端在绘制实体时都会检查该实体上的能力状态,其他玩家也会看到隐藏的护甲部件。
{
"type": "apoli:prevent_feature_render",
"features": [
"armor_head"
]
}
克隆体支持自定义模型
来自 apoli:summon_clone 的克隆体现在会渲染其拥有的 custom_model_render 能力、纹理叠加层及几何结构。请通过动作的 powers 列表授予该能力。如果模型的骨骼名称与身体部位相对应,它将像跟随玩家一样跟随克隆体的姿态;render_as_overlay 则决定该模型是叠加在克隆体之上还是替换其身体。瘦型克隆体会使用 slim_texture_location 来指定其纹理叠加层。克隆体仍会像以前一样复制主人的纹理叠加层。
修复
拥有替换模型的克隆体不再隐形
持有不带 render_as_overlay 属性的几何结构 custom_model_render 的克隆体此前会隐藏其本体身体,且未渲染任何替代内容,导致其变得隐形。现在它会正确显示替换模型。
1.130.0
更新前须知
- 在 NeoForge 上,请同时更新客户端和服务器。网络版本已从 19 升至 20,因此 1.129 版本的客户端无法加入 1.130 版本的服务器。在 Fabric 上,两个版本的客户端仍可连接,且服务器会向旧版客户端发送旧的粒子数据包。
apoli:explode现在会向玩家播放爆炸音效并显示爆炸粒子效果。如果资源包添加了自定义的爆炸音效或粒子以弥补原本无声无息的效果,这些自定义效果现在会与真实效果叠加播放。
修复
爆炸可见可闻
apoli:explode(包括实体、双实体和方块动作)此前仅在服务器上执行爆炸逻辑,从未通知客户端。伤害判定和方块破坏正常生效,但没有人听到爆炸声或看到爆炸效果,且未被爆炸击中的玩家也不会受到击退效果。现在,服务器会向 64 格范围内的每位玩家发送与原版爆炸相同的爆炸数据包,并包含该玩家的击退数据。
性能优化
射线投射粒子线条合并为单一数据包
此前,带有 particle 配置的 raycast 会为线条上的每个点向附近每位玩家发送独立的粒子数据包。一条长度为 40 格、间距为 0.16 的线条,平均每位玩家需接收约 250 个数据包。现在,服务器发送一个包含线条起点、方向、长度和间距的 apoli:ray_particles 数据包,由客户端生成粒子效果。视觉效果和覆盖范围(线条周围 32 格内的玩家)保持不变。没有新通道的客户端仍会收到旧的粒子数据包。
1.129.0
更新前须知
apoli:explode(实体与双实体)中的damage_self字段现已生效。其默认值为true,因此若未指定该字段,当引爆实体位于爆炸范围内时,它会受到爆炸伤害。若要保留旧版行为,请添加"damage_self": false。- 由射线投射、弹射物及双实体动作触发的爆炸现在更常被归因于玩家,且归因的爆炸会遵循服务器的 PvP 和队伍规则。当设置
pvp=false时,玩家的爆炸不会伤害其他玩家。
新增
粘性弹射物
apoli:fire_projectile(作为能力或实体动作使用时)接受一个 sticky 对象参数,或传入 true 以使用默认值。从 texture_location 指定的纹理生成的弹射物在击中方块后会停止并停留在那里(如同箭矢一般),并在其持续时间结束后执行 bientity_action_on_expire。
| 字段 | 类型 | 默认值 | 描述 |
|---|---|---|---|
duration |
整数或表达式 | 1200 |
弹射物粘附直至过期的刻数。设为 0 则使其持续存在直到达到 lifetime 或其他条件将其移除。 |
depth |
浮点数或表达式 | 0 |
沿飞行路径深入击中点的距离。负值使其悬浮于表面之外。 |
block_condition |
方块条件 | 可选 | 仅允许通过此条件的方块容纳它。 |
bientity_action_on_stick |
双实体动作 | 可选 | 每次粘附时运行,拥有者作为执行者,弹射物作为目标。 |
粘附前仍会执行方块命中动作,且在粘附期间 lifetime 仍在计时。若配置了 reflective,弹射物会先反弹再粘附;return.after 可将已粘附的弹射物拔出;若弹射物所依附的方块被破坏,它将掉落并再次尝试粘附。
{
"type": "apoli:fire_projectile",
"texture_location": "example:textures/entity/sticky_bomb.png",
"speed": 1,
"sticky": {
"duration": 60
},
"bientity_action_on_expire": {
"type": "apoli:explode",
"power": 3,
"at_target": true,
"damage_self": false
}
}
修复
爆炸死亡信息
爆炸会将责任归因于造成爆炸的一方。此前,在射线投射或弹射物的 block_action_on_hit 中使用的 apoli:explode 方块动作,其击杀者名称为空(显示“自爆”)或归咎于最后攻击受害者的实体。通过 apoli:target_action 在目标上运行的 apoli:explode 会将责任归因于目标,而弹射物 bientity_action_on_hit 中的爆炸会将责任归因于弹射物本身并打印 entity.apoli.custom_projectile。现在,方块爆炸将责任归因于执行方块动作的实体,对双实体目标的实体爆炸将责任归因于该动作的执行者,而由弹射物引发的爆炸则将责任归因于其发射者。
damage_self
apoli:explode(实体与双实体)中的 damage_self: true 此前从未对引爆实体造成伤害。现已按照文档说明生效。
1.128.0
新增
apoli:equipped_accessory
一种实体条件,当实体在任何槽位或指定槽位中佩戴符合物品条件的饰品时判定为真。安装 Trinkets、Accessories 或 Curios 模组时会注册此功能。
| 字段 | 类型 | 默认值 | 描述 |
|---|---|---|---|
item_condition |
物品条件 | 可选 | 佩戴的饰品必须满足的条件。若未指定,则任何已装备的饰品均算作符合条件。 |
slots |
饰品槽位 | [] |
要检查的槽位。空列表表示所有槽位。 |
{
"type": "apoli:equipped_accessory",
"slots": "charm",
"item_condition": {
"type": "apoli:ingredient",
"ingredient": {
"item": "example:moon_charm"
}
}
}
apoli:equipped_item 中的饰品槽位
apoli:equipped_item 现支持 accessory_slot 字段(格式与 conjure_equipment 相同),同时 equipment_slot 变为可选参数。两者至少需指定一个,若同时指定,则任一槽位匹配物品即判定为真。"accessory_slot": "*" 用于检查所有饰品槽位。该字段不受模组依赖限制,因此即使未安装饰品模组,使用该字段的资源包仍可正常加载。
apoli:accessory_equipped_count 的物品条件
仅统计符合该条件的饰品。
饰品槽位过滤器中的 *
饰品槽位过滤器的任意部分均可使用 *,以匹配所有内容。
变更
隐身效果隐藏所有穿戴层
apoli:invisibility 配合 render_armor: false(默认值)将隐藏身体上的所有渲染层:包括原版护甲、鞘翅、披风、头盔槽位的头颅、Trinkets、Accessories 和 Curios 物品,以及其他模组绘制的图层(如背包和护目镜)。手持物品仍受 render_held_items 控制,Apoli 自身能力提供的图层仍会继续渲染。
加载错误指向具体问题
每个无法加载的能力、起源、图层、徽章、技能树、按键绑定、全局能力集和自定义效果都会记录其所属文件、资源包、JSON 路径、行号、列号以及包含错误值的代码行(并在错误值下方标记尖角符号)。这涵盖了编解码器错误(未知类型、缺失字段、错误的值类型)以及语法错误。丢失的可选字段会发出指向该字段的警告,且日志消息不再输出完整的对象内容。加载完成后,会有一行汇总各类错误和警告的数量;开启 /apoli:dev_mode 后,每次执行 /reload 时都会在聊天栏列出这些错误和警告(悬停查看详情,点击可复制文件路径)。
修复
兼容层导致饰品重复计数
当 Accessories 兼容层与真实的 Curios (NeoForge) 或 Trinkets (Fabric) 共存时,物品会被两套系统分别读取,导致计数翻倍且 apoli:action_on_accessory_change 触发两次。Apoli 现统一通过 Accessories 进行读取。
性能优化
饰品检查
equipped_accessory、accessory_equipped_count 以及 equipped_item 中的 accessory_slot 在扫描槽位时不再构建列表,且一旦比较结果确定,计数过程即刻停止。
1.127.0
新增
/apoli:key 长按
/apoli:key hold <targets> <key> 会按住按键,直到执行 /apoli:key release 或 /apoli:key clear 才会松开。该命令适用于玩家以及其他任何实体。它用于测试那些在按键按住期间运行的能力,例如 continuous(持续)类型的 apoli:action_on_key_press,或者带有 entity_action_released(实体释放动作)的能力。
apoli:key hold @s key.apoli.primary_active
apoli:key release @s key.apoli.primary_active
修复
玩家身上的强制按键
通过 apoli:force_key_pressed 或 /apoli:key press 为玩家强制设置的按键,无论 duration(持续时间)如何,在 Apoli 自身的能力中都被视为单次点击。现在,该按键会在客户端被视为在整个持续时间内处于按住状态,因此 continuous(持续)类能力会持续触发,按键以“按住”状态同步至服务器,并且在按住结束时执行 entity_action_released(实体释放动作)。
较短的强制覆盖较长的强制
当对一个已经强制生效的按键再次进行强制时,客户端保留了较长的持续时间,但服务器端使用了较新的持续时间。这导致在一次长按过程中插入的一次短按会在服务器上提前结束按住状态。现在,两端都会保留较长的持续时间,因此 press(按下)无法缩短 hold(按住)的时长。
幽灵方块重复放置问题
在已有 apoli:ghost_block(幽灵方块)的位置再次放置幽灵方块时,会保留首次放置时的计时器。这意味着即使方块被不断刷新,仍会在第一个方块的计时结束后消失。现在,计时器会从最近一次放置开始重新计算,而原始方块仍然是首次放置之前的那个方块。
性能
未加载区块中的幽灵方块
当区块卸载后耗尽的幽灵方块会立即在服务器线程上加载该区块以恢复原始方块,因此离开充满这类方块的区域会导致每个方块产生一次卡顿。现在,原始方块会在下一次区块加载时(加载后一秒钟内)恢复,并且仅在服务器停止运行时才会为这一目的加载区块。apoli:ghost_block 在未加载区块的位置也不会执行任何操作,而不再尝试加载它。
1.126.0
更新前须知
- 资源现在可以存储小数。整数类型的资源仍像以前一样正常工作并保存,但如果世界曾保存过带有小数的值,回退到旧版 Apoli 时会丢失小数部分。
- 网络格式已更改,因此客户端和服务器都需要版本 1.126.0。如果双方版本不匹配,登录时将被拒绝并显示提示信息。
apoli:edible_item上的consume_sound不再默认为entity.generic.eat。若未指定,物品将使用"eat"作为进食音效,使用"drink"作为饮用音效。
新增内容
发光方块
新的方块操作 apoli:glow 会高亮显示其运行的方块,而新的能力类型 apoli:block_glow 仅对该玩家可见地高亮显示其持有者周围的方块。"outline" 模式绘制发光效果的彩色轮廓,可穿透墙壁可见;"glow" 模式则以全亮度、被颜色着色后的方式,在所有元素前方绘制方块本身(包括方块实体)。
| 字段 | 生效范围 | 默认值 | 作用 |
|---|---|---|---|
red、green、blue(或 r、g、b) |
两者 | 1 |
颜色,取值范围为 0 到 1。 |
mode |
两者 | "outline" |
"outline"(描边)或 "glow"(发光)。 |
respect_bounding |
两者 | true |
跟随方块自身的形状,还是绘制一个完整的立方体。 |
entity_condition |
apoli:glow |
无 | 只有满足此条件的玩家才能看到发光效果。每秒检查几次,在服务器端运行。 |
duration |
apoli:glow |
20 |
刻数。设为 0 或更小值时,发光效果会持续到方块发生变化为止。 |
block_condition |
apoli:block_glow |
必需 | 哪些方块会发光。在玩家客户端运行。 |
distance |
apoli:block_glow |
16 |
搜索半径(以方块为单位),最大为 64。 |
当方块被挖掘或替换时,发光效果结束。由该动作产生的发光效果会随世界一起保存。
{
"type": "apoli:block_glow",
"block_condition": { "type": "apoli:block", "block": "minecraft:diamond_ore" },
"r": 0,
"g": 1,
"b": 1,
"distance": 25
}
random_chance 条件中的表达式
apoli:random_chance 条件(及其别名 apoli:chance)中的 chance 接受一个表达式,该表达式针对被检查的实体进行读取。当存在相关实体时,该条件和动作的方块版本会读取位于该方块后的实体。
变更
支持小数的资源
apoli:resource的值、min、max、start_value和on_change值均支持小数,apoli:resource条件中的compare_to也支持小数。apoli:modify_resource会写入修饰符计算出的精确小数,而不是四舍五入为整数。旧版apoli:change_resource的change字段同样保留小数,属性修饰符的值也会以完整精度读取。- 数值保留六位小数,因此连续加十次
0.1将恰好达到1,且max_action和on_change会在正确的时间触发。 /apoli:resource set和change命令支持小数,get命令在位置参数后可选地指定缩放比例(例如get @s mypack:mana 0 100),operation操作会保留分数部分。输出的数值会保留其小数部分。- 表达式会读取精确值。宏参数中,小数会填入如
2.5的值,而整数值则填入如5的值。 apoli:resource进度触发器支持小数边界。- 冷却时间仍按整刻计数。写入的小数值会被四舍五入到最接近的刻数。
HUD 进度条
进度条根据小数值的比例填充。进度条仅在达到最大值时显示为满,仅在达到最小值时显示为空,因此 1 中的 0.001 会显示为一丝痕迹,而 0.999 则会明显未满。
修复
edible_item 的 consume_sound
此前,consume_sound 仅在被食用后播放一次,导致正常的进食或饮水声音持续播放。现在它从第一口开始替换该声音。
宏中的极小数值
宏参数中小于 0.001 的小数会以科学计数法打印(如 5.0E-4),这会导致命令出错。现在它会正常打印为 0.0005。
1.125.0
适用于 Fabric 1.20.1、Fabric 1.21.1 和 NeoForge 1.21.1。同时更新 Origins 至 1.50.0 版本。
新增内容
Create 模组集成
已安装 Create(NeoForge 1.21.1 和 Fabric 1.20.1;Create 没有 Fabric 1.21.1 版本):
- 佩戴带有空气背箱的潜水头盔,可使拥有
apoli:water_breathing实体且具备suffocate_outside_water属性的玩家在陆地上呼吸。该机制会从背箱中每秒抽取 1 个单位的空气,抽气速率与 Create 在水下使用时的速率相同。 - 潜水靴会禁用
apoli:modify_swim_speed,包括由apoli:attribute_modify_transfer传递过来的游泳速度。 - 新增能力类型
apoli:create_goggles,可在不佩戴护目镜的情况下显示 Create 的护目镜覆盖层。它没有任何字段,始终处于注册状态,且在未安装 Create 时不起作用。 - 新增物品标签
apoli:create/diving_helmets、apoli:create/backtanks和apoli:create/diving_boots(所有条目均为可选),用于决定哪些物品算作潜水装备。
{
"type": "apoli:create_goggles",
"condition": {
"type": "apoli:sneaking"
}
}
修复
命中 Sable 或 Create Aeronautics 飞船的光线投射
Sable 将飞船的方块存储在约 2000 万格之外的存储区域,并在此处响应光线投射请求。apoli:raycast 曾将该响应作为世界坐标使用,因此在飞船上时,hit_x、hit_y、hit_z 和 distance 均指向距离 2000 万格的位置;command_at_hit 会在远处执行,而粒子轨迹和 command_along_ray 会在一个刻钟内跨越整个距离逐步执行,这会导致服务器卡顿。现在,对飞船的命中会被转换回光线实际触碰到的船体上的点。传送至命中点将落在甲板上,command_hit_offset 和 chain_direction: reflect 会跟随船体转向时的面变化,pierce 能够穿透飞船方块,且飞船会遮挡其背后的实体。方块操作和方块条件仍然获取飞船自身的方块。apoli:raycast 实体条件也以相同方式测量其方块距离。
绳索与相位问题
拥有 apoli:phasing 能力的施法者无法通过 raycast 端点将绳索附着到墙壁或飞船上,因为绳索的光线会询问每个方块对该施法者而言是否阻挡视线。现在,光线会以与施法者自身相同的方式检查方块。
飞船上的相机与调试模式
带有 collision 设置的 apoli:modify_camera 会在碰到船体时停止,而不是穿透进入船体内部。调试模式下,apoli:raycast 的操作和条件的轮廓线会在光线击中飞船的位置结束,而不是尝试绘制一条长达 2000 万格的线条。
1.124.0
更新前须知
apoli:sneaky和apoli:share_effects已被移除,使用它们的模组不再加载。这两个功能均可通过其他模组实现。
已移除:apoli:sneaky 和 apoli:share_effects
apoli:sneaky 和 apoli:share_effects 均为 Apoli 已有模组的组合。对于 Sneaky(潜行),在 apoli:visibility 上使用 apoli:scale 可使生物以平时 80% 的距离发现玩家。apoli:modify_label_render 会淡化名字标签,并在距离超过 32 格时将其隐藏,配合 apoli:distance 条件生效。apoli:replace_sound_emission 会在持有 apoli:on_block 时静音脚步声,而 apoli:prevent_game_event 会阻止 minecraft:step 震动。狐狸和“潜行时间”统计直接读取原版的潜行标志,因此这两项是该组合未覆盖的内容。
对于 Share Effects(共享效果),一个运行带有 apoli:transfer_effects 的 apoli:area_of_effect 的 apoli:action_over_time 可实现相同功能。该模组每两秒为持有者周围 8 格内的所有驯服宠物复制一份持有者的所有效果:
{
"type": "apoli:action_over_time",
"interval": 10,
"entity_action": {
"type": "apoli:area_of_effect",
"radius": {
"x": 8,
"y": 2,
"z": 8
},
"bientity_condition": {
"type": "apoli:all_of",
"conditions": [
{
"type": "apoli:owner"
},
{
"type": "apoli:target_condition",
"condition": {
"type": "apoli:tamed"
}
}
]
},
"bientity_action": {
"type": "apoli:transfer_effects",
"mode": "give",
"copy": true
}
}
}
性能优化:apoli:attribute
属性模组现在占用更少的内存和 CPU。它们每刻检查一次修饰符。这是登录后或重载后修饰符恢复的方式,也是修饰符跟随条件变化的方式。以前,它每刻为每个持有者的每个修饰符构建查找键、字符串和修饰符 ID,并且在 1.20.1 中还会对 ID 进行 MD5 哈希处理。Apoli 现在每个模组只计算一次 ID,并直接从实体自身的属性中读取其应用值。拥有四个修饰符的模组在 1.21.1 上从每刻产生 1.1 KB 垃圾数据和 1.1 µs 耗时变为无垃圾数据和 0.13 µs,在 1.20.1 上从 2.8 KB 和 1.7 µs 变为 64 字节和 0.09 µs。Apoli 每个模组测试一次条件,而不是每个修饰符测试一次,并且在实体被移除时不再扫描世界中的每个属性修饰符。
1.123.0
更新前须知
- 语音聊天和语音模组已从 Apoli 移至新的插件 Birdsong:
action_on_speak、action_on_reply、action_on_speech、modify_speaking_range、五个voice_*条件和voice_*表达式变量。安装 Birdsong 以保持它们正常工作。如果没有安装 Birdsong,使用apoli:ID 的整合包仍可加载,但这些模组无效,条件返回false,变量返回0。 loading_priority现在决定全局模组集和起源之间的优先级,因此具有较高优先级的较低层级整合包可以覆盖最高层级的整合包。- 语音设置首次启动 Birdsong 时从
apoli-client.json移至 Birdsong 的birdsong-client.json。
新增:JSONC 和 JSON5 数据文件
每个 Apoli 和 Origins 数据文件夹现在也接受 .jsonc 文件,允许使用 // 和 /* */ 注释以及末尾逗号。这些文件夹还接受 .json5 文件,允许不带引号的名称、单引号、十六进制数字、.5 和 5.、Infinity 和 NaN,以及 JSONC 功能。这涵盖了模组、宏、全局模组集、自定义状态效果、按键绑定、技能树、起源、图层和徽章。Apoli 使用自己的解析器读取它们,因此不需要 Quilt 的解析器库。感谢 FLD 提供的原始拉取请求。
{
type: 'apoli:swim_speed',
name: 'Strong Swimmer',
modifier: {
operation: 'multiply_total_multiplicative',
value: .5,
},
}
如果文件无法解析,Apoli 会跳过该文件,日志会记录整合包名称、行号、列号和错误值的路径。当普通 .json 文件包含注释或尾部逗号时,错误信息会指出接受它的扩展名。最后一个括号之后的文本仅记录警告。同一整合包中存在两个相同 ID 的文件(如 swim.json 和 swim.json5)会记录警告,且 .json 文件优先。在不同整合包之间,较高层级的整合包无论扩展名如何都优先。
修复:全局模组集的 loading_priority
全局模组集以前只读取最高层级整合包的文件,因此 loading_priority 无效。现在它决定哪个整合包的版本获胜,与自定义状态效果的处理方式相同。
更改:语音聊天和语音移至 Birdsong
Birdsong 将语音类型注册为 birdsong: ID,并将每个 apoli: ID 保留为别名,因此安装后现有整合包无需更改即可工作。语音到动作按键、语音设置和 /apoli:speech 也随之移动。语音识别不再内置于 Apoli,Apoli 的 jar 文件大小从 31.7 MB 减少到 4.3 MB。
更改:加载器
此版本基于 Fabric Loader 0.20.1、Fabric API 0.116.17(1.21.1)和 0.92.12(1.20.1)以及 NeoForge 21.1.265 构建。
性能优化:更快的数据加载
新解析器的数据文件读取速度比 Gson 快约两倍。
1.122.0
新增:播放选定的声音文件
apoli:play_sound 接受一个 index:指定播放声音事件的哪个声音文件,从 0 开始计数,按照 sounds.json 中的顺序排列。如果没有 index,则随机播放一个,如以前一样;超出列表范围的 index 也会随机播放一个。index 也可以是表达式。
{
"type": "apoli:play_sound",
"sound": "minecraft:entity.pig.ambient",
"index": 2
}
每个玩家的游戏会从其 own 的声音副本中选择文件,因此更改列表的资源包会影响该玩家播放的 index 对应的文件。
1.121.0
更新前须知
apoli:stacking_status_effect现在允许计数在能力不激活时下降至min_stacks,并且仅在其激活时应用效果。拥有负数min_stacks的资源包会获得其请求的延迟:Elytrian 的幽闭恐惧症会在低天花板下等待约十秒。- 当
apoli:pose强制玩家进入sitting(坐下)或sliding(滑行)姿态时,其碰撞箱和视角会降低。
已修复:姿态 (Pose)
apoli:pose 改变了某些姿态的碰撞箱,但模型保持不变。现在所有姿态都会在玩家以及使用人形模型的生物(如僵尸和骷髅)身上显示。
crouching(蹲伏)会让玩家自身模型呈现蹲伏状态,且玩家以潜行速度移动。sitting(坐下)、sliding(滑行)、shooting(射击)、inhaling(吸气)、long_jumping(长跳)、croaking(鸣叫)、using_tongue(使用舌头)、roaring(咆哮)、sniffing(嗅探)、emerging(浮现)和digging(挖掘)各自拥有独立的姿态。手册中的“姿态”页面描述了它们。dying(死亡)会让玩家侧身倒下并保持倒地状态,而fall_flying(坠落飞行)则完全展开滑翔。sitting将玩家的碰撞箱降低至 1.2 格(眼睛高度为 1.0),sliding降低至 0.9 格(眼睛高度为 0.6),因此滑行的玩家可以穿过一格高的缝隙。
sliding、shooting 和 inhaling 仅在 1.21.1 版本中存在。
已修复:叠加状态效果
负数的 min_stacks 之前不会造成任何延迟,导致 Elytrian 一旦走进低天花板下方就会立即获得虚弱和缓慢效果。现在,计数必须先回升到 0 以上,效果才会开始施加;对于新授予的能力,如果 min_stacks 为负数,则从该负数值开始。
已修复:来自资源包的声音
apoli:play_sound、apoli:fire_projectile 的 sound 以及 apoli:edible_item 的 consume_sound 之前对于仅由资源包定义的声音没有任何反应。现在它们会为每个拥有该资源包的玩家播放这些声音。
新增:HUD 栏位的回退纹理
hud_render 接受一个 fallback 参数:可以是纹理、包含独立 sprite_location、bar_index 和 icon_index 的对象,或者是它们的列表。没有 sprite_location 背后所指向的资源包的玩家,将看到第一个存在的回退纹理,而不是缺失的纹理。
"hud_render": {
"sprite_location": "example:textures/gui/mana_bar.png",
"fallback": {
"sprite_location": "apoli:textures/gui/resource_bar.png",
"bar_index": 3,
"icon_index": 2
}
}
新增:生成偏移量
apoli:spawn_entity(实体和方块操作)、apoli:summon_clone、apoli:summon_minion 和 apoli:spawn_effect_cloud 现在接受 offset 参数。实体操作还接受 space 参数,因此 "local" 会根据施法者的朝向相对放置实体。
{
"type": "apoli:spawn_entity",
"entity_type": "minecraft:armor_stand",
"offset": { "z": 2 },
"space": "local"
}
1.120.0
新增:修改玩家出生点字段
apoli:modify_player_spawn 新增了四个字段,由 FLDebug10 贡献。
| 字段 | 类型 | 默认值 | 描述 |
|---|---|---|---|
biome_condition |
生物群系条件 | 可选 | 在通过条件的最近生物群系中出生。如果同时设置了 biome,两者任一满足即可。 |
structure_tag |
标识符 | 可选 | 在此标签中的最近结构处出生。如果同时设置了 structure,两者任一满足即可。 |
block_condition |
方块条件 | 可选 | 仅接受玩家脚下方块通过该条件的位置。将其包裹在 apoli:offset 中并设置 "y": -1 以检测地面。 |
search_radius |
整数 | 32 |
安全位置搜索的范围,从 1 到 64 格。超出此范围的值会被限制并附带警告。 |
{
"type": "apoli:modify_player_spawn",
"dimension": "minecraft:overworld",
"structure_tag": "minecraft:village",
"block_condition": {
"type": "apoli:offset",
"y": -1,
"condition": {
"type": "apoli:block",
"block": "minecraft:grass_block"
}
}
}
性能优化:修改玩家出生点
该能力不再保持其找到的每个出生点周围 23×23 个区块的加载状态;这些区块会在服务器运行期间一直保持加载和 ticking 状态。Apoli 会记住生物群系和结构的搜索结果,直到数据包重载,因此只有第一个拥有该能力的玩家需要等待它们。如果五分钟内未找到安全位置,则不会重复搜索。
已修复:修改玩家出生点
- 在 1.20.1 版本中,选择带有此能力的出生点(例如 Blazeborn)只会移动重生点,而不会传送玩家。现在会将玩家传送过去。
block_condition检查了负坐标处的相邻方块。- 安全位置搜索可能会将玩家放置在末地岩屋顶上。
已修复:1.20.1 版本中的攻击距离
其他模组提供的攻击距离(许多 1.20.1 整合包捆绑了 Reach Entity Attributes)会在服务端被覆盖,导致玩家在超越原版攻击距离外挖掘方块时,客户端会出现方块破碎、重新出现且不掉落物品的现象。现在 Apoli 的攻击距离与其他模组的攻击距离叠加生效。Apoli 自身的攻击距离也适用于距离超过约 8 格的方块使用和放置。
已修复:绳索
- 当玩家附着在绳索上离开服务器时,即使在后续会话中,绳索也可能保留在屏幕上。
- Apoli 现在会隐藏其末端不可见的绳索,而不是将其冻结在原位。
- 加入游戏、重生或切换维度的玩家现在可以看到已经存在的绳索。
已修复:按键绑定
每当在世界外保存选项时(例如在主屏幕更改设置后),Origins 和 Apoli 的技能键都会重置为默认值。现在绑定得以保留。在 NeoForge 上,Apoli 还能正确恢复带有修饰键(如 Shift+G)的绑定。
1.119.0
同时更新客户端、服务器和 Origins。
更新前须知
- 自定义状态效果现在从源
apoli:effect/<namespace>/<path>获取其能力,而非效果自身的 ID。需要按源检查或撤销这些授予的数据包需使用新名称。 apoli:modify_xp_gain过去没有任何作用。已使用该字段的数据包现在将改变经验获取。
新增:apoli:connected_blocks
对与该方块相连的每个方块执行方块操作(优先最近),例如整棵树或矿脉的其余部分。起始方块不属于该组。
| 字段 | 类型 | 默认值 | 描述 |
|---|---|---|---|
block_action |
Block Action | required | 在组内的每个方块上运行。 |
block_condition |
Block Condition | optional | 哪些方块属于该组。若无此项,则组包含与起始方块同类型的每一个方块。 |
diagonal |
Boolean | true |
是否将对角接触(边或角)视为相连。 |
downward |
Boolean | true |
搜索是否可以向下扩散。 |
limit |
Integer | 64 |
组中方块的最大数量,范围 1 到 1024。 |
neighbor_condition |
Block Condition | optional | 仅当组旁边的方块与此条件匹配时,才执行操作。 |
actor_condition |
Entity Condition | optional | 在每个方块之前对执行该操作的实体进行检查。一旦失败,操作即停止。 |
在 block_action 内部,count 是组的大小,index 是当前方块的位置。搜索过程不会加载区块。
{
"type": "apoli:connected_blocks",
"downward": false,
"limit": 256,
"neighbor_condition": {
"type": "apoli:all_of",
"conditions": [
{
"type": "apoli:in_tag",
"tag": "minecraft:leaves"
},
{
"type": "apoli:block_state",
"property": "persistent",
"value": false
}
]
},
"block_action": {
"type": "apoli:break_block",
"mine": true
}
}
新增:玩家挖掘模式
apoli:break_block 新增了 mine 字段。设为 true 时,执行该操作的玩家会进行实际挖掘:工具消耗耐久度、附魔生效且矿石掉落经验。在出生点保护、冒险模式和被占有的区域内,挖掘将被拒绝。由于自身操作导致的方块破坏不会再次触发该能力,因此 action_on_block_break 可以挖掘更多方块而无需循环。
新增:依赖方块组的挖掘速度
apoli:modify_break_speed 新增了 connected_blocks 字段,接受与方块操作相同的组字段。修饰符中的表达式变量 count 表示组的大小。该组最多每刻计算一次。
新增:表达式中的耐久度
durability[slot] 读取槽位中物品剩余的可用次数。target_durability[...] 和 actor_durability[...] 分别用于其他实体的物品。
新增:apoli:action_on_tame
当玩家用食物驯服狼、猫或鹦鹉,或在马、驴、骡或骆驼处打破关系时,运行一个双实体操作(执行者:驯兽师,目标:动物)。字段为 bientity_action 和 bientity_condition。
新增:apoli:action_on_breed 和 apoli:breed
当玩家喂食的动物繁殖出幼崽时,apoli:action_on_breed 会运行。bientity_action 和 bientity_condition 分别查看繁殖者和幼崽,而 parents_action 查看生出幼崽的父母及其配偶。新的双实体操作 apoli:breed 会立即让两只成年动物生出一只幼崽,并正常给予经验、统计数据和冷却时间。由能力自身的 parents_action 产生的幼崽不会再次触发该能力。
{
"type": "apoli:action_on_breed",
"parents_action": {
"type": "apoli:random_chance",
"chance": 0.2,
"action": {
"type": "apoli:breed"
}
}
}
新增:apoli:share_effects
当实体获得状态效果时,附近的实体也会获得相同等级和持续时间的副本。
| 字段 | 类型 | 默认值 | 描述 |
|---|---|---|---|
radius |
Vector | 8 |
距离实体碰撞箱的距离:可为所有轴共用一个值,或每个轴单独指定。 |
bientity_condition |
Bi-entity Condition | optional | 执行者:拥有该能力的实体。目标:将获得副本的实体。 |
effects |
Identifier or array | optional | 仅限这些效果(# 表示标签)。 |
category |
String or array | optional | 仅限这些类别。 |
include_ambient |
Boolean | false |
信标和引导灵通的效果是否也共享。 |
新增:apoli:modify_projectile_divergence
使用 modifier 或 modifiers 更改实体投射物偏离瞄准线的程度。可选的 bientity_condition 将发射者作为执行者,投射物作为目标。适用于弓、弩、三叉戟、投掷物品和 fire_projectile。
新增:apoli:modify_enchantability
使用 modifier 或 modifiers 更改玩家在附魔台附魔时物品的附魔能力。可选的 item_condition 限制其适用的物品。更高的附魔能力意味着在相同等级成本下获得更好的附魔结果。战利品表和交易不受影响。
新增:apoli:infinite_trades
玩家的交易不会消耗商人的提供次数,因此商人永远不会对他们售罄。唯一字段是 bientity_condition(执行者:玩家,目标:商人)。
新增:apoli:extra_trades
给予商人只有拥有该能力的玩家才能看到的交易。trades 的每一项包含 buy、buy_b(可选)和 sell,每项均为物品堆栈或 {"loot_table": "<id>"},以及 max_uses(12)、xp(1)和 price_multiplier(0.05)。每个商人每种能力仅滚动生成一次交易,随商人一起保存,且不包含在商人自己的提供列表中。它还接受可选的 bientity_condition。
新增:apoli:modify_anvil
repair_material_modifier 改变一次完整修复所需的修复材料数量(4)。combine_bonus_modifier 改变合并两个物品时增加的额外耐久百分比(12)。可选的 item_condition 检查第一个槽位中的物品。
新增:apoli:sneaky
实体被视为潜行状态,适用于所有对安静玩家做出反应的事物,无需蹲下。名称标签隐藏在方块后面,仅在 32 格范围内显示。它在地面上不发出脚步声或踏步震动。生物以平时距离的 80% 察觉它,且狐狸不会逃跑。
新增:apoli:prevent_level_event
阻止实体导致的世界事件,包括对所有玩家(含自身)生效。原版将四种事件与玩家绑定:破坏方块(2001)以及铜块的涂蜡、去蜡和刮擦(3003、3004、3005)。events 字段为可选;若省略该字段,则阻止所有事件。
修复:apoli:modify_xp_gain
该能力类型已注册但从未连接使用。现在它会改变玩家拾取经验球获得的经验,且在 Mending(修补)抽取其份额之后;/xp 命令不受影响。通过新增的 block_condition,它改为改变在匹配的高炉、 smoker 或熔炉中烹饪所获得的经验。
修复:Fabric 1.20.1 上能力触发两次的问题
apoli:action_on_block_use 能力允许点击穿透时,每次点击会运行两次;apoli:action_on_sending_message 对于允许的每条消息也会运行两次。这两个事件均被注册了两次。
修复:apoli:modify_food 在最后一个物品上的问题
当剩余可食用物品仅剩一件时(例如一碗炖菜),entity_action 和 item_action 未执行。在 1.20.1 中,replace_stack 也未执行。现在应用的能力会在物品消耗前确定。
修复:自定义状态效果携带其他能力的问题
当自定义效果结束时,它会移除所有源自具有该效果 ID 的来源的能力,包括具有相同 ID 的 apoli:multiple 的子能力。效果现在使用自己的来源,且在此版本之前保存的授予记录仍会被清理。
1.118.1
同时更新客户端、服务器和 Origins。
新增:apoli:attribute_modify_transfer
将一个实体的某个属性上的修改器应用于另一个能力类型所改变的值。Avian 的 Like Air 使用了此功能,因此所有增加移动速度的加成(Speed、疾跑、Tailwind)在空气中也会生效。
| 字段 | 类型 | 默认值 | 描述 |
|---|---|---|---|
class |
Identifier | 必填 | 接收修改器的能力类型:modify_air_speed、modify_swim_speed、modify_jump、modify_slipperiness、modify_velocity、modify_falling、modify_break_speed、modify_exhaustion、modify_healing、modify_damage_dealt、modify_damage_taken、modify_projectile_damage、modify_status_effect_amplifier、modify_status_effect_duration 或 modify_fov。 |
attribute |
Identifier | 必填 | 要传递修改器的属性。 |
multiplier |
Float | 1 |
缩放每个传递的修改器。 |
{
"type": "apoli:attribute_modify_transfer",
"class": "modify_air_speed",
"attribute": "minecraft:generic.movement_speed",
"multiplier": 1
}
传递的修改器按照属性应用其自身修改器的方式应用,并与其缓存在一起,因此每次刻钟的传递开销约等于多一个修改器的开销。
新增:自定义原料
原料接受 Fabric 和 NeoForge 的自定义原料,适用于两个加载器:fabric:components、fabric:custom_data、fabric:any、fabric:all、fabric:difference、neoforge:components、neoforge:compound、neoforge:intersection 和 neoforge:difference(1.20.1 中为 fabric:nbt),以及其他模组在其各自加载器上注册的类型。通过 apoli:ingredient,物品条件现在可以检查药水内容物、装有箭的弩或任何其他组件。
{
"type": "apoli:ingredient",
"ingredient": {
"fabric:type": "fabric:components",
"base": "minecraft:potion",
"components": {
"minecraft:potion_contents": {
"potion": "minecraft:swiftness"
}
}
}
}
新增:技能消耗、奖励和独立分支
cost可以花费任何树的点数("skill_tree",或一组点数条目列表),并且任何条目或整个消耗都可以设置为hidden(隐藏)。reward在购买技能时给予点数(可分配至任意树)和物品。悬停卡片会将它们与技能赋予的能力一起列出,这些也可以隐藏。placement: [x, y]将技能绘制为其自身分支的起点,无指向父级的连线。- 退款会退还精确支付的金额并收回奖励。要求玩家仍持有这些奖励;
unbuy和重置操作则收回剩余部分。
修复:技能树顺序
具有相同 order 的标签页和同级技能现按 id 排序,因此不再在服务端重启之间改变顺序。
修复:原料问题
当原料对象同时包含 item 和 tag 时,它会使用 item,正如文档所述。1.20.1 中损坏的原料现在报告实际问题,而不是显示 Not a json array。
修复:分层声音问题
apoli:replace_sound_emission 和 apoli:replace_sound_reception 在 "replace": false 时,现在会在原始声音之上播放替换声音,正如文档所述。在此之前,原始声音从不播放,因此一个在每个声音之上叠加铃声的能力,仅对持有者和周围所有人留下铃声。当分层声音覆盖玩家已经听到的声音时,原始声音继续播放,包括其循环,而分层声音仅播放一次。
修复:物品拾取能力问题
apoli:action_on_item_pickup 和 apoli:prevent_item_pickup 完全无效。现在两者对玩家和拾取战利品的生物均有效。
item_action会在物品进入背包前(对玩家而言,仅在能放入时)更改该物品,而bientity_action则在物品已进入后运行一次。执行者是投掷物品的实体;掉落物和破碎的方块没有投掷者,因此使用apoli:target_action对拾取者执行操作。prevent_item_pickup会让物品留在地面上,并在每次尝试拾取时运行其动作。
新增:action_on_item_pickup 上的 priority
| 字段 | 类型 | 默认值 | 描述 |
|---|---|---|---|
priority |
Integer | 0 |
当存在多个此类能力时,优先级较高的会先运行。 |
修复:prevent_sleep 与重生点
带有 "set_spawn_point": false 的 apoli:prevent_sleep 无论是否有 block_condition,都会将重生点移动到床上。现在,被该能力拒绝的床会保留原有的重生点,而 "set_spawn_point": true 会设置重生点但不会让玩家睡觉。能力的提示信息也会替换掉“你只能在夜间睡觉”以及关于附近怪物的警告。
新增:model_color 中的表达式
apoli:model_color 的 red、green、blue 和 alpha 接受表达式,适用于整个模型以及每个 parts 条目。它们会在每一帧针对持有该能力的实体进行求值。
{
"type": "apoli:model_color",
"green": "clamp(health / max_health, 0.2, 1)",
"blue": "clamp(health / max_health, 0.2, 1)"
}
新增:表达式中的属性
attribute[<id>, <query>] 用于读取属性,其数值用法与 /attribute 命令相同。target_attribute[...] 和 actor_attribute[...] 用于在双实体动作中读取另一实体的属性。
| 查询 (Query) | 读取内容 |
|---|---|
get(默认) |
应用所有修正后的值 |
base |
基础值 |
default, min, max |
属性的默认值及允许范围 |
has |
如果实体拥有该属性则返回 1 |
modifier, <id> |
某一修正量的大小,若不存在则为 0 |
has_modifier, <id> |
如果存在该修正量则返回 1 |
在 1.21.1 中,修正量 ID 为 namespace:path 格式,而在 1.20.1 中为 UUID 格式,这与 /attribute 命令一致。拼写错误的属性 ID 会导致加载错误,并指出是表达式命名的问题。
修复:/reload 后的自定义状态效果
在 /reload 后向玩家施加自定义状态效果可能会导致断开连接,并出现“找不到 id”的错误。现在,/reload 会就地更新自定义效果,而不是将其替换。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
AE2:一款流行的自动化与存储模组
评论 0
登录后参与评分
还没有评论,来抢沙发吧