是否曾想过制作属于自己的自定义生物,比如四处游走的鸭子,或是拥有特殊攻击方式的自定义末影龙Boss?现在,你可以实现了!
Custom Entity API 是一个数据包,它提供了一系列工具,让你能够创建自己的自定义生物。你可以选择一种不可见生物作为 AI 来负责行走、寻敌等功能,并搭配 Animated Java 作为该实体的自定义模型。
免责声明!此工具需要掌握 Blockbench、Animated Java、数据包以及动画制作的基础知识!
本工具曾在 Smithed Summit 上展出!
Custom Entity API 亮相于 Smithed Summit 2026,展位紧邻 Animated Java 和 Vanilla Ride Studios,并计划在未来再次参展!
请参阅对创作者的采访!
学习资源
你可以在这里找到 Custom Entity API 的文档。
功能特性
Custom Entity API 支持以下功能:
- 在自定义行走动画与待机动画之间切换
- 自定义受击动画及原版生物拥有的红色受击色调
- 自定义死亡动画,其持续时间可超过普通生物的死亡时间
- 自定义攻击动作,当生物锁定目标时有一定概率触发
此外,还针对 Boss 类型的自定义实体提供了更多定制选项:
- 三种攻击池(近战、中程和远程)
- 阶段转换动画
- 根据当前阶段调整属性与攻击池
特殊攻击
Custom Entity API 的生物可以拥有三种特殊攻击类型:
? 重型攻击: 此攻击会使护盾进入冷却状态,冷却时间是斧头的 3 倍,通常表示该攻击会造成大量伤害。
⚔️ 可格挡: 此攻击会激活一个特殊交互实体碰撞箱,如果在短暂窗口期内命中,将使 Boss 陷入眩晕状态,从而可以轻松对其造成奖励伤害。
?️ 反击: 此攻击会激活一个特殊交互实体碰撞箱,如果尝试在此时攻击 Boss,将会受到惩罚。
这些特殊攻击类型在 Animated Java 模型中均有体现,表现为攻击播放前或蓄力动画期间显示的 tint(色调)和 glow(发光)效果。
其他包含的实用工具
CEAPI 附带了一些实用工具:
- 用于向你的生物应用属性、切换移动能力和护甲的命令,最常用于 Boss 攻击期间。
- 一个宏粒子命令,可使用执行位置下方的方块作为
block_state 来运行粒子命令。
- 一个用于将实体运动应用到 CEAPI 生物底层 AI 部分的命令。
你可以在 CEAPI 文档中阅读更多关于这些实用工具的详细信息。
未来计划
本项目将努力与 Animated Java 保持同步更新,以兼容并支持新功能,同时尽可能与 Minecraft 的版本发布保持一致。
最近,我们进行了大规模的重构,将大量数据从 AI 生物迁移至命令存储,这显著提升了多个 CEAPI 生物共存时的性能扩展能力。
问题追踪器
即将推出!
鸣谢
本项目完全由 lolimtaco 制作
Ever wanted to make your own custom mob, like a duck that walks around, or a custom enderman boss with special attacks? Well, now you can!
Custom Entity API is a datapack that provides one with tools to create their own custom mob, using an invisible mob of their choice as the AI for walking, targetting, etc, and Animated Java as a custom model for the entity.
* Disclaimer! This tool requires knowledge of Blockbench, Animated Java, datapacks, and animation, all to at least a basic degree!
This tool was featured at Smithed Summit!
Custom Entity API was at Smithed Summit 2026, boothed beside Animated Java and Vanilla Ride Studios, and plans to return in the future!
See an interview with the creator!
Learn
You can find documentation for Custom Entity API here.
Features
Custom Entity API supports the following:
- Switching between a custom walk and idle animation
- Custom hurt animation and the red hurt tint vanilla mobs have
- Custom death animation that can extend past a regular mob's death time
- Custom attacks that roll with a chance to play while the mob is targetting something
And more tailored for boss-type custom entities:
- Three attack pools (close range, mid range, and far range)
- Phase transition animations
- Stats and attack pool adjustments based on current phase
Special Attacks
Custom Entity API mobs can have three special attack types:
? Heavy: This attack will put shields on cooldown for 3x the amount an axe would, and generally indicate an attack will deal a large amount of damage.
⚔️ Parryable: This attack will activate a special interaction entity hitbox that if hit during a short window, will stun the boss, allowing for easy reward damage.
?️ Reaction: This attack will activate a special interaction entity hitbox that if hit will punish you for trying to hit the boss.
These special attack types are all indicated by a tint and glow effect displayed on the Animated Java model before the attack plays or during a wind-up animation.
Other Useful Tools Included
CEAPI comes with a few useful tools:
- Commands to apply attributes to your mob, toggling movement and armor, most commonly used during boss attacks.
- A macro particle command to run a particle command that requires a
block_state using the block below the execute position of the command.
- A command to apply entity motion to the underlying AI part of the CEAPI mob.
You can read more about these useful tools in the CEAPI documentation.
Future Plans
This project will attempt to update alongside Animated Java for compatibility and support for new features, as well as update with Minecraft releases as consistently as possible.
Most recently, a massive rewrite has been done to move lots of data from the AI mob to command storage, which drastically increases performance scaling with multiple CEAPI mobs.
Issue Tracker
Will be coming soon!
Credits
This project was made entirely by lolimtaco
评论 0
登录后参与评分
还没有评论,来抢沙发吧