RP Engine：用 YAML 做自定义物品、家具、动画模型和载具，自动生成资源包的服务器插件 RP Engine

想在服务器里给所有玩家一张小地图，又不想让大家各自去装模组？这款插件装在服务端就行，玩家用原版客户端进服，屏幕角落就会出现实时小地图。

它是怎么做到的

插件借助原版的核心着色器来绘制地图：服务器启动后会自动生成一个配套资源包，玩家进服时加载这个资源包，地图就直接画在画面上，客户端不需要任何额外的东西。地图计算尽量放在异步线程里进行，对服务器主线程的压力比较小。

主要功能 圆形和方形两种外观，可以放在屏幕左侧或右侧 比例尺从 1 倍（1 像素对应 1 个方块）到 8 倍（1 像素对应 8×8 个方块）可调 地图尺寸最大 127×127 像素，游戏内能随时切换不同的地图边框 不限数量的自定义标记点，方便标出主城、商店、传送点等位置 可配置的生物和玩家雷达，主世界、下界和末地都能显示 玩家开启服务端小地图时，可以自动关闭 Xaero's Minimap、VoxelMap、JourneyMap 这几款模组自带的小地图，避免两张地图叠在一起 支持的服务端和版本 服务端：Paper、Folia、Purpur；Spigot 也能运行，但功能会受到不少限制，建议优先用 Paper 系服务端 游戏版本：1.21–26.3（不同版本段对应不同的插件文件，下载时按服务器版本挑选） 文件名里的 Folia-Paper 只是标注支持的服务端，并不代表只能在这两种服务端上用 安装方法 按服务器的游戏版本选对应的 jar 文件，放进服务器的 plugins 文件夹 重启服务器，插件会自动生成小地图所需的资源包，玩家进服时同意加载资源包即可 具体的比例、位置、雷达范围等在插件配置文件里调整 需要注意 地图依赖原版核心着色器，客户端开着 Iris 或 OptiFine 光影时无法正常显示 目前不支持基岩版玩家；服务器装了 Geyser 时，基岩版玩家无法开启小地图

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 协议开源，免费使用。