FeatherEngine 插件功能介绍
面向高版本服务器的 GUI / HUD / 模型 / 脚本 / 玩法表现层
一、插件定位
FeatherEngine 是一款面向 Minecraft 服务器的功能表现增强插件，主要用于为服务器提供 GUI/HUD、自定义模型、脚本交互、按键系统、世界贴图、全息显示、额外槽位、相机运镜和资源保护等能力。
引擎交流群:
企鹅:1063638427
引擎官方wiki
FeatherEngine 文档中心
它更适合作为服务器的“玩法表现层”使用：服务端负责配置、命令、权限、脚本和数据同步，客户端负责界面、模型、贴图、相机和交互效果展示。通过 YAML 配置和 JavaScript 脚本，服主可以为服务器制作专属菜单、技能界面、剧情镜头、模型生物、装饰方块、装备槽位和活动交互。
核心：GUI / HUD 配置基本完美兼容 1.12.2 龙之核心的 GUI 部分写法，已有龙核菜单、HUD、按钮、贴图、文本、槽位等配置的服务器，可以直接作为迁移基础快速改造到 FeatherEngine。
二、GUI / HUD 迁移优势
GUI / HUD 是 FeatherEngine 的核心能力之一。其配置思路基本兼容 1.12.2 龙之核心的 GUI 写法，对于已有龙核界面资产、菜单逻辑和视觉体系的服务器，可以减少从零重写界面的成本。
已有龙核菜单、HUD、按钮、贴图、文本、槽位配置可作为迁移基础。
适合从 1.12.2 升级到高版本的 RPG、商业服、生存服和剧情服。
可以在保留原有界面设计思路的基础上，扩展高版本客户端渲染、模型、脚本和相机能力。
三、主要功能
自定义 GUI / HUD
支持创建服务器专属界面、HUD、菜单、按钮、贴图、文字、槽位、实体预览和交互区域，可用于 RPG 菜单、技能面板、任务界面、背包增强、活动入口等内容。龙之核心旧配置可作为迁移基础快速改造。
脚本系统
内置服务端 JavaScript 脚本能力，可用于条件判断、动作执行、命令扩展、区域触发、按键交互、槽位限制和自定义逻辑处理。
按键系统
支持服务端配置按键功能，配合客户端实现快捷键触发、技能释放、菜单打开、脚本执行等操作，适合 RPG 技能、快捷交互和特殊玩法。
模型系统
支持实体模型、玩家运行时模型、额外模型、动画播放和 MythicMobs 联动，可用于自定义怪物、Boss、NPC、玩家外观、技能表现和剧情演出。
BlockModel 方块模型
支持将指定头颅物品或已放置头颅方块替换为自定义模型，并可配置贴图、动画、缩放、亮度和碰撞箱，适合制作装饰方块、机关、展示物和地图物件。
世界贴图与全息显示
支持在世界坐标中显示图片、文字和头顶信息，可用于公告牌、传送门标识、怪物血条、NPC 名牌、区域提示和场景装饰。
物品表现增强
支持物品图标、掉落物显示、物品额外渲染、物品提示和物品效果，可用于自定义装备、品质框、特殊道具和服务器专属资源展示。
额外槽位系统
支持自定义额外槽位、槽位数据保存、物品校验和服务端同步，并可对接 AttributePlus、CraneAttribute 等属性插件，适合饰品、符文、称号、翅膀、神器等系统。
相机系统
支持越肩第三人称、增强第一人称、场景运镜、人称锁定、FOV 变化、输入锁定和 HUD 隐藏，可用于剧情动画、Boss 登场、传送过场、活动镜头和沉浸式玩法。
区域系统
支持区域配置、区域工具选点、进入/离开脚本触发、优先级判断和副本世界映射，可用于主城保护、副本入口、剧情触发区、活动范围和特殊玩法区域。
资源保护
提供客户端资源保护相关能力，可用于保护服务器专属模型、贴图和资源内容，降低资源被直接提取和复用的风险。
四、适用服务器
1.12.2 龙之核心服务器升级高版本：GUI / HUD 配置可快速迁移，适合已有龙核界面资产、菜单逻辑和服务器视觉体系的项目升级到 1.21.1。
RPG 服务器：用于制作技能界面、任务菜单、Boss 模型、剧情镜头、自定义装备、额外槽位和沉浸式玩法表现。
生存 / 半 RPG 服务器：用于增强菜单、活动界面、装饰模型、物品显示、区域提示、快捷按键和服务器专属 UI。
副本 / 剧情服务器：用于制作场景运镜、区域触发、NPC 展示、Boss 登场、剧情演出和地图交互。
小游戏 / 活动服务器：用于制作活动 HUD、状态显示、快捷操作、世界提示、倒计时界面和特殊交互按钮。
高定制商业服：适合需要统一视觉风格、专属客户端表现、自定义资源、权限细分和复杂玩法扩展的服务器。
五、运行与兼容
当前插件面向 Paper 1.21.1 服务端环境开发，完整体验需要玩家安装匹配的 FeatherEngine 客户端 Mod。可选兼容 PlaceholderAPI、MythicMobs、AttributePlus、CraneAttribute 等插件。
