ResourcePackAI

RP Engine 是一款面向 Spigot、Paper 和 Folia 服务器的资源包引擎插件。服主只要在服务器的内容文件夹里写好 YAML 配置、放进贴图和模型，插件就会把自定义物品、方块、家具、动画模型、表情动作、载具、界面、HUD、对话框、音效和配方统统生成出来，并自动打包成资源包发给每一位进服的玩家。玩家不需要安装任何模组。 ## 一个最简单的例子 在 plugins/RPEngine/content/mypack/items/ 下新建一个 YAML 文件，写上物品的材质和名字，再把同名的 png 贴图放在旁边，执行 /rp reload，然后 /rp give mypack:ruby 就能拿到一颗「红宝石」。模型、贴图、资源包以及把它们连起来的物品组件，全部由插件处理。 ## 能做什么 - 自定义物品：名称、描述、附魔、属性、耐久、食物效果，以及使用时触发的动作。 - 自定义方块：硬度、适用工具、亮度和掉落物，还支持楼梯、台阶、门、活板门、植物和灯。 - 家具：直接放入 Blockbench 模型，碰撞箱按模型自动计算，可以做成座椅、灯或储物家具。 - 动画模型：放入 .bbmodel 文件，骨骼和动画按原样播放，既能摆在世界里，也能套在生物身上（包括 MythicMobs 生物和 Citizens NPC）。 - 表情动作：/emote wave 之类的指令，可以独自做，也可以邀请朋友一起；还能替换玩家的走路动作。 - 可驾驶载具：汽车、自行车、船、飞机和直升机，带操控手感、乘客座位、音效、粒子和各状态动画。 - 自定义生物、可穿戴盔甲外观、GUI 界面背景和 HUD 覆盖层。 - 对话框（1.21.6 起）：带侧栏、分页、开关、滑块、下拉框、玩家头像、进度条和实时占位符。 - 音效和聊天图标：在聊天里输入 :mypack:heart: 就会显示对应的图片。 - 配方：合成、烧炼、营火、切石机、锻造台与盔甲纹饰、铁砧，Paper 上还支持酿造。 - 自定义液体：圈出一片区域做成酸液池、史莱姆池等，本质是水或岩浆，再附加你设定的规则。 - 资源包会按服务器版本自动选择正确的格式。 ## 在浏览器里编辑 执行 /rp edit mypack:chair 会得到一个链接，在浏览器里打开就是 3D 编辑器，可以移动方块、重新上色，点「发送到服务器」后内容文件夹里的文件会更新并自动重载。链接只能用一次，三小时内有效，而且只包含你指定的那一个内容。 ## 从其他插件迁移 RP Engine 能直接读取 ItemsAdder、Nexo、Oraxen、CraftEngine、Model Engine 和 BetterModel 的内容文件夹，放进去重载即可迁移物品、家具、方块、模型和配方；无法迁移的内容会在加载时逐条给出警告和原因。  ## 可选联动 PlaceholderAPI（占位符）、MythicMobs 与 Citizens（给生物和 NPC 套动画模型）、WorldGuard（按区域限制模型摆放和物品使用），全部都是可选的。 ## 常用指令 - /rp reload：重新读取内容文件夹并重建资源包。 - /rp give [玩家]：给予自定义物品。 - /rp spawn ：生成自定义实体；/rp bind 把模型套到准星对准的生物上，/rp unbind 取下。 - /rp vehicle ：在脚下放置一辆载具。 - /rp screen、/rp hud、/rp dialog、/rp sound：打开界面、显示或清除 HUD、打开对话框、播放音效。 - /rp edit ：用浏览器编辑器打开。 - /emote [玩家...]：播放表情动作。 - 每个子指令都有单独权限 rpengine.，rpengine.admin（默认 OP）包含全部权限；/rp、/rpe、/rpengine 是同一个指令。 ## 联网说明 - 资源包默认上传到作者提供的免费托管服务，玩家进服即可自动下载；也可以在 config.yml 里修改 host.mode，改由自己的网页服务器提供。 - 插件默认每 30 秒发送一次匿名统计（随机 ID、在线人数和依赖它的附属插件名），不含地址、服务器名或玩家信息，可在 config.yml 里设置 telemetry.enabled: false 关闭。 - 启动几秒后会检查一次更新，可用 update-check: false 关闭；浏览器编辑可用 edit.enabled: false 关闭。全部关闭后，插件只和你的玩家通信。 ## 安装说明 - 适用版本：Java 版 1.19.4–26.3，支持 Spigot、Paper、Folia 及其分支（如 Purpur），需要 Java 17 或更高版本；旧版本服务器上需要新版游戏的少数功能会自动关闭，并在启动日志里列出。 - 把 jar 文件放进服务器 plugins 文件夹后重启，然后在 plugins/RPEngine/content/ 下添加内容文件夹并执行 /rp reload。 - 客户端不需要安装任何模组，进服时接受服务器资源包即可。 - 插件以 GPL-3.0 协议开源，免费使用。