原创 付费 FlDecorate - 枫林饰品

1. 核心概念​

使用插件前，只需理解三个核心概念，轻松上手无压力：

孔位 (Socket)​

每个GUI界面（戒指、项链等）独立配置孔位，分默认解锁和付费解锁两种。玩家需消耗指定物品/金币解锁更多孔位，用于镶嵌饰品。

饰品 (Decorate)​

即游戏内的“符文/宝石”，是可拾取、可镶嵌的实际物品。每个饰品可提供基础属性（如攻击力、血量）和触发技能（如攻击触发雷击、受伤回血）。

套装 (Suit)​

玩家同时装备指定组合的饰品时，会触发额外的套装效果。例：同时镶嵌「战士戒指」+「战士项链」，额外获得+100最大生命。

3. 配置指南​

插件所有配置文件均为YAML格式，注意缩进规范（用空格，不要用Tab），格式错误会导致插件加载失败！
Wiki教学
支持的动作类型：

• close → 关闭当前GUI界面
• open-gui:<guiId> → 打开指定ID的GUI界面
• player-command:<cmd>/command:<cmd> → 以玩家身份执行命令
• console-command:<cmd>/console:<cmd> → 以后台控制台身份执行命令
• sound:<SOUND_ENUM> → 播放指定Minecraft音效

小提示： 饰品Item的head自定义支持玩家名和Base64纹理码，可搭配头颅生成工具制作专属饰品图标，提升服务器特色。

4. 高级功能​

4.1 世界限制与性能优化​

针对强力饰品做世界生效限制，或为了降低服务器性能消耗，可在饰品配置中添加disabled-worlds节点，实现饰品跨世界自动生效/失效。

配置方法​

# 在饰品yml文件最外层添加以下节点<br>disabled-worlds:<br> - "world_the_end" # 末地世界失效<br> - "pvp_map" # PVP地图失效

生效效果​

• 玩家进入限制世界，饰品的属性加成自动移除，离开后自动恢复；
• 玩家进入限制世界，饰品的所有触发技能停止生效，离开后恢复触发；
• 不影响饰品的镶嵌/拆卸操作，仅限制效果触发。

4.2 持续性技能 (定时任务)​

实现“每30秒回血”“每分钟获得金币”等周期性效果，使用timer触发器即可，专属配置interval（间隔时间）为必填项。

配置示例（自动回血饰品）​

skills:<br> auto_heal: # 技能唯一标识<br> trigger: timer # 触发器类型：定时器<br> interval: 30 # 执行间隔（秒，必填）<br> chance: 100.0 # 触发几率（100.0=必触发）<br> mm-skill: "HealPlayer" # 绑定的MM回血技能
注意： interval 单位为秒，定时任务会轮询所有在线玩家，避免设置1秒/2秒等过短间隔，防止服务器性能消耗过高！

常见问题 (FAQ)​

Q: 修改配置文件后没有生效，怎么办？
A: 先使用 /flda reload 重载插件；若涉及GUI界面布局的修改，建议直接重启服务器确保配置完全刷新；同时检查后台控制台是否有YAML格式报错。
Q: 饰品的属性名在哪里查询？
A: 插件兼容AttributePlus和Minecraft原版属性名，常用属性：max_health（最大生命）、attack_damage（攻击力）、movement_speed（移动速度）、armor（护甲）。
Q: 输入 /fldecorate 没有打开菜单，只显示文字？
A: 从0.0.18版本开始，/fldecorate（及/flda）无参数时默认仅输出命令帮助，需使用 /flda open 打开主菜单。
Q: 为什么饰品的技能不触发？
A: 检查3点：1. 已安装MythicMobs插件且技能名配置正确；2. 饰品已成功镶嵌到解锁的孔位中；3. 玩家当前所在世界不在饰品的disabled-worlds列表中。
Q: 套装效果没有触发，是什么原因？
A: 检查套装配置的pieces节点中的饰品ID是否与decorates/中的饰品ID完全一致；同时确认玩家已将套装所有饰品镶嵌到孔位中（而非仅放在背包）。
Q: 自定义的饰品Lore没有显示？
A: 检查lore-position配置是否正确（top/bottom），同时确认YAML缩进规范，自定义Lore需与material同级缩进。