RP Engine 是什么?
RP Engine 将你服务器上的 YAML 文件夹转换为自定义物品、方块、家具、动画模型、玩家表情动作、载具、屏幕界面、HUD、对话框、音效和配方。然后它构建资源包,并分发给每一位加入的玩家。
你编写内容,引擎生成资源包。
# plugins/RPEngine/content/mypack/items/gems.yml
ruby:
material: DIAMOND
name: "Ruby"
将 ruby.png 放在旁边,运行 /rp reload,然后执行 /rp give mypack:ruby。模型、纹理、资源包以及将它们关联起来的物品组件都会自动为你处理完毕。
功能特性

- ✔ 自定义物品:名称、描述、附魔、属性、耐久度、食物效果以及使用时的动作。
- ✔ 自定义方块:硬度、正确工具、光照等级和掉落物,支持楼梯、台阶、门、陷阱门、植物和灯。
- ✔ 家具:放置任何 Blockbench 模型。碰撞箱根据模型计算,部件可设置为座位、光源或储物空间。
- ✔ 动画模型:放入
.bbmodel文件,其骨骼和动画将按你制作的样子播放。可放置在世界中,或附着在生物上,包括 MythicMobs 生物和 Citizens NPC。 - ✔ 玩家表情动作:通过
/emote wave执行挥手等动作,可与好友组队,需事先邀请。移动集替换玩家的行走动画。 - ✔ 可驾驶的载具:汽车、自行车、船只、飞机和直升机,具备真实的操控性、乘客座位、音效、粒子效果和状态动画。
- ✔ 自定义生物:拥有你自己模型的实体。
- ✔ 盔甲:任何物品均可穿戴,并拥有专属外观。
- ✔ GUI 界面和 HUD 覆盖层:自定义菜单背景和屏幕装饰艺术。
- ✔ 对话框(1.21.6+):按你的方式绘制菜单,支持侧边栏、分页、开关、滑块和下拉菜单,显示玩家头像、进度条、实时占位符和物品槽。每次点击都会触发游戏按钮音效。
- ✔ 音效 和 聊天图标:在聊天中输入
:mypack:heart:即可显示对应图片。 - ✔ 配方:合成、烹饪、营火烹饪、切石机、锻造台与锤击、铁砧,以及在 Paper 上的酿造。
- ✔ 液体:划定酸液、粘液或其他液体的区域。它是真实的水或岩浆,但对其中的实体应用你的自定义规则。
- ✔ 资源包由你托管,并根据服务器版本提供正确的包格式。或者关闭托管功能,从你自己的 Web 服务器提供 zip 文件。

在浏览器中编辑

执行 /rp edit mypack:chair 会给你一个链接。它在浏览器中打开一个专业的 3D 编辑器:移动方块、重新上色,然后点击 发送到服务器。内容文件夹中的文件随之更改并重新加载。无需注册账号或登录。链接仅可使用一次,有效期三小时,且仅携带你所命名的那个对象。
从其他插件迁移?
RP Engine 原生读取 ItemsAdder、Nexo、Oraxen、CraftEngine、Model Engine 和 BetterModel 的内容文件夹。只需将文件夹放入,重载即可,你的物品、家具、方块、模型和配方都会顺利迁移过来。无法迁移的内容会在加载时以警告形式列出原因,确保不会静默丢失。

兼容插件
均为可选。RP Engine 在没有这些插件的情况下也能正常运行。
- PlaceholderAPI:RP Engine 自带的记分板、菜单和全息图占位符,以及 HUD 文本和物品动作中的其他插件占位符。
- MythicMobs 和 Citizens:将动画模型应用于它们的生物和 NPC。
- WorldGuard:用于限制模型放置位置和自定义物品使用的区域标志。
安装指南
- 将
RPEngine.jar放入plugins/目录并启动服务器。 - 在
plugins/RPEngine/content/下添加内容文件夹,并运行/rp reload。
玩家加入时无需任何设置:默认情况下,资源包会自动上传至我们的免费托管服务。若想从你自己的服务器提供服务,请在 config.yml 中设置 host.mode。
完整指南:resourcepack.ai/docs/rp-engine/install
要求: Spigot、Paper、Folia 或其任意分支,Minecraft 1.19.4 或更高版本,Java 17 或更高版本。从 1.19.4 到当前版本的所有 Minecraft 版本均支持。如果在较旧的服务器上运行,需要更新游戏特性的少数功能将被禁用,并在启动日志中逐一列出。
命令与权限
每个子命令都有各自的权限,格式为 rpengine.<subcommand>。rpengine.admin(默认:op)授予所有权限。/rp、/rpe 和 /rpengine 是同一个命令。
| 命令 | 作用 |
|---|---|
| /rp reload | 重新读取内容文件夹并重建资源包 |
| /rp give <id> [player] | 给予自定义物品 |
| /rp items, /rp models, /rp entities | 列出服务器中持有的内容 |
| /rp spawn <id> | 生成自定义实体 |
| /rp bind <id>, /rp unbind | 将模型赋予你正注视的实体,或移除模型 |
| /rp vehicle <id> | 在你站立的位置放置载具 |
| /rp screen <id> [player] | 打开 GUI 界面 |
| /rp hud <id|clear> [player] | 显示或清除 HUD 覆盖层 |
| /rp dialog <id> [player] | 打开对话框 |
| /rp sound <id> [player] | 播放自定义音效 |
| /rp liquid corner | fill <id> | clear | 标记液体池区域 |
| /rp edit <id> | 在浏览器编辑器中打开该文件 |
| /emote <name> [players...] | 播放表情动作,可单人或多人一起 |
所有命令与权限说明:resourcepack.ai/docs/rp-engine/commands
附加组件 (Addons)
基于 RP Engine 公共 API 构建的插件,每个都是你需要放在其旁边的第二个 jar 文件。首个附加组件是 Skateboards:推动、蹲伏、跳跃、翻转,并尽量别摔下来。
面向开发者: RP Engine 提供了完整的 API,涵盖物品、模型、载具、表情动作、界面和事件。请参阅 API.md。
连接机制
- 使用计数。 每 30 秒,插件会向 resourcepack.ai 发送一个首次启动时生成的随机 ID、当前在线玩家数量(单个数字),以及任何依赖 RP Engine 的已安装插件名称(即其附加组件),以便我们了解有多少服务器和玩家在使用它及其附加组件。此过程完全匿名:不发送地址、服务器名称、版本、玩家名称或 UUID,也不发送任何内容数据。默认开启。可在
config.yml中将telemetry.enabled设为false以关闭。 - 更新检查。 启动后几秒内,插件会询问 SpigotMC 当前最新的 RP Engine 版本,并在控制台和管理员聊天中提示是否有新版本可用。它不会发送关于你服务器的任何信息。可通过
update-check: false关闭。 - 浏览器编辑 仅在你运行
/rp edit时建立连接,且仅发送你指定的那一个文件。可通过edit.enabled: false关闭。 - Studio 推送与已发布资源包 仅在通过
/rp sync或/rp distribute配对后才建立连接。
若全部关闭,该插件仅与你的玩家通信。
支持
请在 Discord 提问,或在 GitHub 提交 Issue。请勿在评论中发布 Bug;我们无法在那里回复,而且我们更倾向于直接修复问题。
RP Engine 是在 GPL-3.0 许可下的自由软件。源代码托管于 GitHub,欢迎贡献。
由 ResourcePack AI 制作
RP Engine 源自 resourcepack.ai,这是一个资源包网页编辑器,能够生成模型、纹理、GUI、表情动作和载具,并直接推送到你的服务器进行实时测试。你并非必须使用它:手动编写的内容文件夹即可驱动整个插件。

Spigot, Paper and Folia 1.19.4 and newer · Java 17+ · Free and open source (GPL-3.0) · No client mods
What is RP Engine?
RP Engine turns a folder of YAML on your own server into custom items, blocks, furniture, animated models, player emotes, vehicles, screens, HUDs, dialogs, sounds and recipes. Then it builds the resource pack and hands it to every player who joins.
You write the content. The engine writes the pack.
# plugins/RPEngine/content/mypack/items/gems.yml
ruby:
material: DIAMOND
name: "Ruby"
Drop ruby.png next to it, run /rp reload, then /rp give mypack:ruby. The model, the texture, the pack and the item component that ties them together are all worked out for you.
Features

- ✔ Custom items: names, lore, enchantments, attributes, durability, food, and actions when they are used.
- ✔ Custom blocks: hardness, the right tool, light and drops, plus stairs, slabs, doors, trapdoors, plants and lamps.
- ✔ Furniture: place any Blockbench model. The hitbox is measured from the model, and pieces can be seats, lights or storage.
- ✔ Animated models: drop in a
.bbmodeland its bones and animations play as you made them. Place it in the world, or put it on a mob, including MythicMobs mobs and Citizens NPCs. - ✔ Player emotes:
/emote wave, on your own or with a cast of friends who are asked first. Movement sets replace how a player walks. - ✔ Vehicles you drive: cars, bikes, boats, aeroplanes and helicopters, with real handling, passenger seats, sounds, particles and an animation for each state.
- ✔ Custom mobs: your own entities with your own models.
- ✔ Armour: any item can be worn with its own art.
- ✔ GUI screens and HUD overlays: your own menu backgrounds and on-screen art.
- ✔ Dialogs (1.21.6+): menus drawn your way, with sidebars and pages, switches, sliders and dropdowns that open, players' heads, progress bars, live placeholders and item slots. Every click makes the game's button sound.
- ✔ Sounds and chat icons: type
:mypack:heart:in chat and the picture appears. - ✔ Recipes: crafting, cooking, campfire, stonecutter, smithing and trims, anvil, and brewing on Paper.
- ✔ Liquids: mark out a pool of acid, slime or anything else. It is real water or lava with your rules applied to whoever is in it.
- ✔ The pack is built and hosted for you, with the right pack format for your server's version. Or switch the host off and serve the zip from your own web server.

The comparison as a PDF, with notes and where each column was checked
Edit in your browser

/rp edit mypack:chair gives you a link. It opens the model in a proper 3D editor in your browser: move the cubes, repaint it, then press Send to server. The file in your content folder changes and reloads. No account and no sign-in. The link works once and lasts three hours, and it carries only the one thing you named.
Moving from another plugin?
RP Engine reads ItemsAdder, Nexo, Oraxen, CraftEngine, Model Engine and BetterModel content folders as they are. Put the folder in, reload, and your items, furniture, blocks, models and recipes come across. Anything that cannot come across is named in a warning at load, with the reason, so nothing goes missing silently.

The full compatibility sheet, as a PDF
Works with
All optional. RP Engine runs fine without any of them.
- PlaceholderAPI: RP Engine's own placeholders for scoreboards, menus and holograms, and any plugin's placeholders in HUD text and item actions.
- MythicMobs and Citizens: put animated models on their mobs and NPCs.
- WorldGuard: region flags for where models can be placed and custom items used.
Installing
- Drop
RPEngine.jarintoplugins/and start the server. - Add a content folder under
plugins/RPEngine/content/and run/rp reload.
Players get the pack with nothing to set up: it is uploaded to our free pack host by default. To serve it from your own server instead, set host.mode in config.yml.
Full guide: resourcepack.ai/docs/rp-engine/install
Requirements: Spigot, Paper, Folia or a fork of any of them, Minecraft 1.19.4 or newer, Java 17 or newer. Everything from 1.19.4 to the current version works. On an older server, the few features that need a newer game are switched off, and the startup log names each one.
Commands and permissions
Every subcommand has its own permission, rpengine.<subcommand>. rpengine.admin (default: op) grants all of them. /rp, /rpe and /rpengine are the same command.
| Command | What it does |
|---|---|
| /rp reload | Reread the content folder and rebuild the pack |
| /rp give <id> [player] | Give a custom item |
| /rp items, /rp models, /rp entities | List what the server holds |
| /rp spawn <id> | Spawn a custom entity |
| /rp bind <id>, /rp unbind | Put a model on the mob you are looking at, or take it off |
| /rp vehicle <id> | Park a vehicle where you stand |
| /rp screen <id> [player] | Open a GUI screen |
| /rp hud <id|clear> [player] | Show or clear a HUD overlay |
| /rp dialog <id> [player] | Open a dialog |
| /rp sound <id> [player] | Play a custom sound |
| /rp liquid corner | fill <id> | clear | Mark out a liquid pool |
| /rp edit <id> | Open it in the browser editor |
| /emote <name> [players...] | Play an emote, alone or with others |
Every command and permission: resourcepack.ai/docs/rp-engine/commands
Addons
Plugins built on RP Engine's public API, each a second jar you drop in beside it. The first is Skateboards: push, tuck, jump, flick it round, and try not to bail.
For developers: RP Engine has a full API for items, models, vehicles, emotes, screens and events. See API.md.
What it connects to
- Usage count. Every 30 seconds the plugin sends resourcepack.ai a random id that it made up the first time it started, how many players are online (a single number), and the names of any installed plugins that depend on RP Engine (its addons), so we know how many servers and players use it and which addons. It is anonymous: no address, server name, version, player names or UUIDs, or content. It is on by default. Turn it off with
telemetry.enabled: falseinconfig.yml. - Update check. A few seconds after start, the plugin asks SpigotMC which version of RP Engine is current, and tells the console and ops if there is a newer one. It sends nothing about your server. Turn it off with
update-check: false. - Browser editing only connects when you run
/rp edit, and only sends the one file you named. Turn it off withedit.enabled: false. - Studio pushes and published packs only connect after you pair with
/rp syncor/rp distribute.
With all of that off, the plugin talks to nothing but your own players.
Support
Ask on Discord or open an issue on GitHub. Please don't post bugs in the reviews; we can't reply there, and we would rather fix it.
RP Engine is free software under the GPL-3.0 licence. The source is on GitHub, and contributions are welcome.
Made by ResourcePack AI
RP Engine comes from resourcepack.ai, a web editor for resource packs that can generate models, textures, GUIs, emotes and vehicles and push them straight to your server for live testing. You never need it: a hand-written content folder gets the whole plugin.
下载 RP Engine
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RP Engine
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RP Engine
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RP Engine
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RP Engine
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RP Engine
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RP Engine
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RP Engine
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RP Engine
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RP Engine
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
插件开发者可在 HUD 中使用玩家头像
新增
- 使用 Paper 1.21.9 或更高版本时,插件可通过
overlays().head(...)在 HUD 文本中嵌入玩家头像。若无法渲染头像(如 Spigot、旧版游戏或 Bedrock),则会保留一个等宽的空白间隙,以确保该行其余部分的位置保持不变。
0.2.87:来自当前 Studio 的过渡动画支持
更改
- Studio 现在以新名称发送包的过渡动画(Transitions),且 RP Engine 0.2.87 可读取该名称。若包中包含来自 Studio 的过渡动画,请在推送或发布前更新引擎,否则
/rp transitions命令将返回空结果。在此日期之前推送、发布或导出的包仍可正常工作。
包含大量图标的资源包加载速度大幅提升
改进
- 拥有大量图标的资源包现在为玩家加载得更快。原本,从同一张图标表裁剪出的每个图标都会单独加载该表一次;现在它们共享这张表。一个包含约 6,000 个图标的服务器,在下载后几乎需要一分钟的加载时间,现在仅需几秒钟即可加载完毕。外观没有任何变化,代码点(codepoints)也未发生更改。相同大小的图标作为单个
grid:表加载时速度最快。
0.2.85:修复 Spigot 上的 3D 盔甲问题
修复
- 修复了在 Spigot 26.1 至 26.3 版本中(未使用 ViaVersion),3D 盔甲显示为每个身体部位多出一个副本并跟随在玩家身后的问题。RP Engine 无法读取 Spigot 服务器的版本信息,因此即使游戏已通过光影绘制了该套装,仍会向玩家发送显示实体。现在 RP Engine 也能正确读取 Spigot 的版本信息,这些玩家将仅看到由光影渲染的盔甲,且不会出现卡顿现象。
全息图中的文字特效
新增
- 文字特效现已支持世界中的文本:全息图(DecentHolograms、FancyHolograms 等)、文本显示、告示牌和命名牌。使用与
/rp effects命令显示的相同颜色。在世界中,特效会限制在字母内部,因此像火焰这样向外延伸的特效会在字母边缘被裁剪。
无投影的 HUD 文本
新增
- HUD 文本可以不使用游戏默认的投影效果:在 JSON HUD 的
runs列表对应条目中添加"shadow": false。这在平面的像素艺术背景上,或用于由字符组成的文字时非常有用,因为原本向右下方偏移一像素的深色投影会造成模糊效果。如果不添加此项,投影将按原有方式绘制,因此你已有的配置不会发生任何变化。此功能需要 Paper 服务器端插件且版本为 1.21.4 或更高;在其他环境下投影效果保持不变,并且该特性会在控制台中列为其他已削减的功能之一。
更大的 API:自定义方块、液体、对话框和生成事件
对于仅使用 RP Engine 自身文件的服务器,没有任何变化。此版本面向基于该引擎构建的插件。
开发者须知
- 新增:
engine.blocks()。查询某处存在的自定义方块(通过at、idAt、is),读取并修改其状态(stateAt、setState、setProperty),以及放置一个方块(place)。自定义方块是真正的方块,因此 Bukkit 自带的BlockBreakEvent和BlockPlaceEvent会告知你何时发生;而此 API 会告诉你具体是哪个方块。 - 新增:
engine.liquids()。获取某位置所在的液体(at)以及玩家当前所在的液体(of)。 - 新增:
DialogOpenEvent和DialogClickEvent,两者均可取消。阻止对话框打开(例如在战斗中),或阻止点击命令执行(例如玩家买不起的商店按钮)。engine.dialogs().showing(player)返回玩家最后显示的对话框。 - 新增:
VehicleSpawnEvent(可取消)和VehicleRemoveEvent,用于规定载具可以放置的位置规则,以及在载具消失时进行清理。 - 新增:
MobSpawnEvent,可取消,带有setLevel。无论自定义生物是如何生成的——通过蛋、刷怪笼、命令、插件还是自然生成——都会触发此事件。 engine.mobs()上新增:spawn(location, id, level)、isMob、level和near(location, radius)。engine.models()上新增:sit(player, location)、isSeated和stand,用于将玩家放置在任意位置坐下,无需模型。- 新增:
engine.emotes().playing(player)返回玩家正在播放的动作表情。 - 文档中的“插件 API”页面涵盖了所有内容。
0.2.81:控制台显示 Studio 对话框所需的功能
对话框
- 现在,在 ResourcePack AI Studio 中创建的对话框会列出其所使用的所有功能。如果某个功能在当前版本的 RP Engine 中尚不支持,控制台会明确指出是哪个对话框以及缺少哪个功能,而不是让对话框以缺失部分内容的形式显示出来。看到此类提示时,请更新 RP Engine。
- 运行 Studio 对话框的代码现与 Dialog Engine 共享,因此对话框在这两个插件中的行为保持一致。你的文件内容不会发生任何变化。
选择平面的物品在手中如何摆放
新增
held:属性用于指定物品的平面精灵图在手中的姿态:item(保持平面且直立,类似纸张)、tool(呈一定角度倾斜,类似剑)或rod(以相反方向倾斜,类似钓鱼竿)。对于旗杆沿对角线绘制的旗帜或法杖,使用held: rod效果最佳。若未设置此属性,物品将沿用材质原有的默认持握方式。- 带有
parent_model: item/handheld或item/handheld_rod的 Nexo 或 Oraxen 物品在导入时会保留该姿态。
3D盔甲在传送时保持同步
已修复
- 通过显示实体展示的 3D 盔甲不再在短距离传送(如末影珍珠、附近的
/home命令或插件的冲刺功能)后滞后于玩家。现在,盔甲部件会在同一游戏刻内随玩家移动。
像持剑一样握持物品,以及可滚动的对话框列表
新增
- 在剑、斧、镐、铲或锄(也可以是木棍、法杖或锤)上自定义的物品会以类似原版的角度倾斜握持。在此之前,所有仅包含
texture:属性的物品都会像纸片一样平放。 - 如果工具的图片绘制方向与原版相反(尖端朝左上,手柄朝右下),系统会自动将其镜像翻转,使其在手中指向前方,无需修改 PNG 文件。
- Studio 对话框:列表可以基于某个数字或设置项开始滚动,这样步进器每次可以滚动多行。
修复
- 放在资源包文件夹内(即包含
pack.mcmeta的文件夹,例如未压缩的 Studio 导出文件)的物品.yml文件之前会被静默忽略。现在控制台会显示具体是哪个文件以及它应该放置的位置:需要作为独立的内容包,并包含一个pack.yml。
在 /rp icons 和聊天中使用 Studio 图标
新增功能
- 引擎现已识别在 Studio 中制作的图标:同步或发布的 Studio 整合包,以及位于
content/目录下的 Studio zip 文件,其图标会列于/rp icons中。当启用chat.icons时,可在聊天中输入:studio:<name>:来调用这些图标,并可在引擎读取:namespace:id:格式的任何地方使用。从此之后导出的 Studio 整合包将自带这些图标。
由部件构成的物品,以及能经受区块卸载的重置
新增
- 物品可由多个部件组装而成:在
parts:下列出插槽及填充这些插槽的物品,该物品将根据其持有的各个部件进行渲染。每个部件仅需一个小模型,而非为每种组合生成一个模型。需要 Minecraft 1.21.4 或更高版本才能进行渲染。 - 配方原料可以是多个物品,写法为
a | b。制作由部件组成的物品时,会根据原料填充其对应插槽,因此单个配方即可生成所有可能的组合。 - API:
Items.withParts和Items.partsOf。
修复
- 插件所持有的
Placement在经历区块卸载并重新加载后失效:isValid()返回 false,且当模型仍然存在时remove()操作被拒绝。
聊天中的图标建议,以及外观正确的 Nexo 名称
新增
- 当开启
chat.icons时,对于有权限使用图标的玩家,在输入(如:wave:及其别名)时聊天栏会提供图标建议。
修复
- 来自 Nexo 或 Oraxen 的物品名称和描述文本保留了原有的颜色和样式,不再显示类似
<dark_purple>的标签,且名称不再以斜体显示。
从 Nexo 迁移时,你的字形也会一并导入
已修复
- 来自 Nexo 服务器的字形现在与它的模型和纹理一起存放在相同的
resourcepack/assets/文件夹中。
0.2.71:从 Nexo 迁移时,你的模型和纹理也会一并导入
已修复
- Nexo 服务器的艺术资源现在会按照 Nexo 的存储位置进行迁移。将
plugins/Nexo/pack/assets/复制到内容包中的resourcepack/assets/,并将pack/external_packs/下的任何压缩文件也解压到其中。 - 在 Nexo 物品中,如果模型或纹理路径没有命名空间,则默认指向
assets/minecraft/(与 Nexo 的行为一致),其他命名空间也从同一文件夹读取。 - 当艺术资源确实缺失时,控制台只会为整个包打印一次提示信息,并告知你查找的位置,而不是每个物品输出两行错误信息。
自定义方块在 1.21.11 及更高版本中正确渲染
已修复
- 使用 Blockbench 模型的自定义方块在 Minecraft 1.21.11 及更高版本中不再显示为紫黑相间的方块。您的文件无需进行任何更改。
工作方块、漏斗、配方和燃烧效果
新增
- 放置的模型现在可以使用
station:属性设置为工作台、附魔台、铁砧、切石机、锻造台、砂轮、织布机、制图台或酿造台。 - 自定义方块也可以作为熔炉、酿造台和工作台,并通过
lit-into:实现燃烧外观。 - 熔炉可以按照其自身的
speed:速度进行烹饪,仅处理你列出的recipes:,并使用你自己的screen:界面艺术素材。 - 燃烧效果可由你自定义或关闭:包括粒子、音效、
glow(发光)、light(光照)以及动画模型的animation。 - 漏斗可以像处理原版方块一样,向熔炉和酿造台输送物品并将其排空。
- 对于开发者:新增了
PieceCookEvent和PieceBrewEvent事件。
修复
- 熔炉、发射器、砂轮和酿造台的界面艺术素材现在已与窗口正确对齐。
重载不再导致服务器卡死
已修复
/rp reload命令在构建资源包时不再导致服务器卡死。内容会立即更新,资源包将在后台进行构建,玩家可在其完成后即时获取。若在一次构建尚未完成时再次执行重载,该操作将排队等待前一个任务结束后再执行。
GUI 图标、文本输入框及传送修复
已修复
- 修复了在带有
armor3d:的物品上,gui:和first-person:外观被忽略的问题。 - 修复了合并资源包时,文本输入框下方出现多余方块的问题。
- 文本输入框的字符限制现已匹配可用空间,以便计数器能正确达到上限。
- 修复了在基于 Folia 的服务器(包括 Canvas)上因重叠传送导致的错误。待处理的移动操作现在会等待当前激活的传送完成,并使用最新请求的目标地点。
同步安全修复、随机模型放置以及更小的动作包
安全与同步
- 修复了另一种使同步技能无需
rpengine.sync.console即可执行控制台命令的方式。不受信任的技能现在使用白名单,同时还会阻止跨世界目标选择、危险的召唤以及对服务器定义元技能的调用。如果您向非管理员授予rpengine.sync,请务必更新。 - 不受信任的推送(push)不再能注册对话命令、快捷操作按键或自然生物生成。这些限制在重启后依然有效。使用同步服务器令牌的服务端会将所有推送视为不受信任。
- 对话命令的目标现在仅接受玩家名称(包括 Bedrock 前缀),因此像
@a这样的选择器无法用于控制台按钮命令。 - 服务器上已被占用的同步代码不能再被其他玩家重新分配。每个玩家在十分钟内最多可尝试五个代码。
- 技能召唤的生物数量上限为每个世界 100 个存活召唤实体,以防止无限刷怪。
- 技能爆炸威力上限设为 16,以防止过度爆炸导致服务器卡顿。
- 自定义刷怪蛋现在会尊重取消点击和模型放置保护检查。
- 同步通知现在以纯文本形式显示名称和资源包名称,防止嵌入的颜色代码冒充服务器消息。
模型与导入
- 已放置的模型现在可以接收随机旋转和缩放,并支持可选的旋转步长。每次放置都会保持其变体,且在重启后保持不变;当物品被破坏时,不会改变其原始大小。
- 修复了在导入 ItemsAdder 资源包时,若文件夹名称与其声明的命名空间不同,会导致缺失模型、纹理、护甲层和字体图像的问题。
对话
- 保持打开状态的对话窗口现在会在执行控制台命令或多行命令按钮运行后刷新,更新占位符和条件按钮,而不会替换玩家已打开的其他屏幕。
- 修复了与 Minecraft 1.21 的对话兼容性问题。
动作(Emotes)
- 动作骨骼包现在仅包含最近见过的玩家,而非所有历史访客。可通过
emotes.rig-days(默认值为 30)和emotes.rig-players(默认值为 64)配置限制。被排除的玩家将使用默认骨骼,直到其骨骼重建完成。 /emote现在列出可用的动作,/emote stop可停止当前动作。
命令与权限
/rp和/rp help现在会列出发送者可以使用的命令。加载内容计数仍仅限于rpengine.info,且对话按钮子命令对普通玩家的帮助菜单和 Tab 补全隐藏。- 命令用法和拒绝提示信息现在提供更清晰的后续步骤,并统一使用
/rp。 - 当同步不可用时,玩家会被告知一分钟后重试,而连接配置提示则会发送至控制台。
- 光影冲突警告现在使用
rpengine.shaders.notify权限,与rpengine.shaders命令权限分离。这也修复了启动时重复权限警告的问题。
安全修复:推送的资源包不再能执行控制台命令
- 安全性:通过 Studio 使用
/rp sync推送的资源包可能包含设置为以控制台身份运行的对话框按钮,以及使用command的怪物技能,因此任何被允许同步的人都可以执行任意控制台命令,包括将自己设为管理员(operator)。现在这些内容仅在启动同步的玩家拥有新的rpengine.sync.console权限时才会生效(默认情况下仅管理员拥有此权限)。其他用户的推送将不包含这些内容,并会收到相应提示。如果您将rpengine.sync权限授予非管理员用户,请务必更新。
0.2.55:导入的资源包中的模型纹理正确显示,而非缺失纹理
- 已修复:一个 ItemsAdder 资源包将其美术资源保存在
textures/block/和textures/item/之外(例如位于textures/<set>/),导致所有模型的每个面都显示为缺失纹理,因为游戏仅合并这两个文件夹。RP Engine 现在会将模型所用到的此类纹理添加到方块纹理图集(blocks atlas)中,同时保留该资源包自带的任何blocks.json。
0.2.54:ItemsAdder 4 资源包的模型可在其 resourcepack 文件夹中找到
- 已修复:一个 ItemsAdder 4 资源包按照
contents/<namespace>/resourcepack/assets/<namespace>/models/的结构布局时,所有model_path项均显示为缺失纹理精灵,因为其模型仅在assets/models/、models/和blueprints/中查找。
MythicMobs 语法中的怪物技能、掉落表、生成器,以及面向基岩版玩家的怪物
怪物技能
- 新增:自定义怪物拥有技能,以 MythicMobs 技能行的格式编写:
- damage{a=8} @PlayersInRadius{r=6} ~onTimer:100 ?stance{s=angry} <50% 0.5。粘贴首领的Skills:区块后,其常见机制将按原样运行:伤害、治疗、药水、跳跃、投掷、拉扯、传送、召唤、火球与箭矢、爆炸、闪电、粒子效果、音效、消息、标题、命令、持续伤害光环、姿态和阶段。 - 新增:元技能(metaskills)置于
skills/文件夹中,采用 MythicMobs 自身的文件格式(Cooldown、Conditions、TargetConditions、Skills),并通过skill{s=Name}调用。 - 新增:14 种触发器(生成、攻击、受伤、死亡、计时器、交互、进入和离开战斗、击杀等)、30 种目标选择器、46 种条件和超过 60 种机制,均使用 MythicMobs 的名称及其简写。FORMAT.md 列出了所有支持项及不支持的内容。
- 新增:RP Engine 独有的机制:
animate播放模型的一个动画,vfx播放视觉特效,tint为模型着色。 - 新增:技能投射物:
projectile、missile(追踪)、totem和chain,在飞行、命中和结束时执行相应技能,可绘制为物品或 VFX(如果你愿意)。~onShoot和~onProjectileHit会在怪物自身发射时触发。 - 新增:仇恨表(
threat-table: true):根据 MythicMobs 的 110% 规则,怪物的目标是对其造成最大伤害的玩家,通过threat、taunt、@ThreatTable和@RandomThreatTarget实现。 - 新增:由技能控制的首领血条(
barcreate、barset、barremove)、怪物变量(setvariable、variableadd、variableequals、<caster.var.x>),以及用于首领与其召唤物通信的信号机制(signal配合~onSignal)。 - 新增:模型机制
bonevisible、swapmodel和defaultstate,同样遵循 ModelEngine 的命名规范。 - 新增:怪物的
name:字段可显示{hp}、{max_hp}、{stance}和{level},并保持实时更新。 - 新增:无法执行的行将在启动时发出警告,指明其所在文件和位置,且仅跳过该行。在 config.yml 中设置
skills.debug: true可记录每行技能的运行日志。 - 新增开发者功能:其他插件可以添加机制、条件和目标选择器,施放技能,并监听
MobSkillEvent。详见 API.md。 - 新增:在 ResourcePack AI Studio 中制作的怪物在同步时会携带其能力,并由与内容文件夹相同的技能系统驱动。
自定义怪物
- 新增:MythicMobs 的怪物选项:
armor(护甲)、armor-toughness(护甲韧性)、equipment(穿戴装备以获取属性,在 1.21.4+ 版本中隐藏于模型之下)、按原因分类的damage-modifiers、invincible(无敌)、collidable(可碰撞)、gravity(重力)、despawn(永不自然消失或区块卸载消失)、faction(阵营)、带per-level缩放的level、kill-messages(击杀提示)、mount(坐骑)、prevent: [leash, rename](防止拴绳和重命名),以及首领血条雾效、暗天和音乐。 - 新增:
extends:基于另一只怪物构建新怪物(使用 MythicMobs 的模板);其技能会追加到该怪物自身的技能列表中。 - 新增:
drops:接受 MythicMobs 的掉落行格式(item 1to3 0.5、exp 10to20、droptable name、command{c=...}),而drop-tables/文件夹则保存带有 TotalItems、MinItems 和 MaxItems 及条件的加权掉落表。 - 新增:生成器会在玩家附近保持一定数量的单一怪物存活,并将游荡的怪物拉回:可在
spawners/中编写,或通过/rp spawner create创建,每个命令都有各自的权限。 - 新增:
/rp spawn可从控制台使用,支持坐标、数量和等级参数。
基岩版
- 新增:基岩版玩家(通过 Geyser)可以看到自定义怪物,以及通过
/rp bind或 MythicMobs 赋予怪物的模型作为其自身模型:位置和大小正确,朝向与怪物一致,播放待机、行走、攻击和受击动画,并在被击中时闪烁红色。此前这些对基岩版玩家是不可见的。从 Studio 同步的怪物也同样可见,渲染自 Studio 发送的基岩版资源包。
图标与 HUD
- 修复:当
content/目录中存在一个 Studio 资源包(自 0.2.49 起,通过/rp distribute绑定的资源包会放置于此)或任何拥有独立font/default.json的资源包时,RP Engine 资源包中的所有图标、排名标签和 HUD 都会显示为方框和乱码字符,原因是引擎未将其自带的字形合并,而是选择不覆盖该资源包的字体。现在两者已合并为一个字体文件,RP Engine 的字形会根据该资源包的字体进行排列,确保彼此不会相互遮挡。
已发布的资源包不再显示被删除的光影对象
- 修复:在同步资源包、删除一个光影对象并发布后,加入游戏的玩家仍会收到已被删除的对象(以缺字方框形式绘制)。现在,已发布的资源包始终根据你发布的内容进行渲染。仍然持有“同步”状态的玩家则继续看到他们同步时的内容。
- 新增:
config.yml中的overlays.trigger-ticks用于设置检查 HUD 触发条件(如潜行或手持物品)的频率,范围从每游戏刻(1)到每秒一次(20)。默认值仍为 2。详见 配置说明。
提供防护且朝向正确的 3D 盔甲
- 新增:3D 盔甲可提供护甲值并具备磨损效果。在普通物品上添加
armor3d: <set>(配合armor:槽位),即可穿戴该 3D 套装的部件,同时保留其原有的名称、属性、耐久度和合成配方。详见 3D 盔甲。 - 修复:在 Blockbench 的玩家模板(或基岩版盔甲模板)上制作的 3D 盔甲套装曾被反向穿戴,即手臂部件错位至另一侧,且图标方向朝外。RP Engine 现已自动判断模型的朝向,无论模型初始朝向如何,渲染时均能正确显示。无需对您的模型进行任何修改。
- 新增:
/rp cast <name> at <x> <y> <z> [world]可在指定坐标处播放视觉效果(VFX),而非仅作用于玩家。该命令可由玩家、命令方块或控制台执行,并拥有独立权限rpengine.cast.at。
头盔上的 3D 帽子会显示在头部
- 已修复:原本带有自定义模型的物品(如下界合金、钻石等)作为头盔基座时,会在玩家头上绘制盔甲层,而帽子仅在物品栏中可见。现在,该物品将显示其自身的模型(适用于 Minecraft 1.21.2 及更高版本),同时保留头盔的护甲值。对于头盔,设置
hat: true也会产生相同的效果。 - ItemsAdder 导入:物品的帽子行为现在会被转换为
hat: true,而不是被跳过。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧