原创 付费 闭源 FlGemSystem - 便捷宝石

FlGemSystem​

插件简介​

核心亮点​

灵活的镶嵌体验​

• 双模式交互：背包拖拽镶嵌 + 手持宝石右键交互
• 精准部位限制：支持武器、盔甲、工具等细分类型判定
• 可精确到特定材质的镶嵌限制

深度自定义的属性系统​

• 多插件兼容：AttributePlus、SX-Attribute、原版属性
• 非线性成长：自定义每级宝石的具体加成数值
• 彻底告别死板的固定属性加成

极简而精美的视觉呈现​

• 中文数字等级：一级、二级、十级，更符合国服审美
• 自定义主标题：支持颜色、加粗、划线等样式
• 智能 Lore 管理：自动更新，不残留多余信息

严谨的升级逻辑​

• 独立等级上限：每种宝石可设置不同最高等级
• 风险与机遇：可配置成功率、降级、碎裂惩罚
• 满级保护：自动停止消耗材料并友好提示

宝石系统完全配置指南​

1. gems.yml (宝石定义)​

字段解析​

• name: 宝石的显示名称，支持颜色代码（如 &6 橙色）。
• material: 宝石的基础材质（如 EMERALD 绿宝石）。
• custom-model-data: 给材质包用的 ID，不填默认为 0。
• lore: 宝石本身的描述，支持 {level} (中文等级) 和 {value} (第一个属性的值)。
• item-lore-title: 镶嵌到装备上时，宝石属性区域顶部的标题。支持颜色代码和样式（&m 为划线，&l 为加粗）。
• item-lore: 镶嵌到装备后的详细属性描述。
• base-attribute: 1 级时的基础属性（如：攻击力: 10）。
• growth: 每一级增长的属性（如：攻击力: +5）。
• level-attributes: (高级配置)如果你想让每一级的属性不按固定数值增长，可以用这个：
  level-attributes:<br> 1:<br> - "攻击力: 5"<br> 2:<br> - "攻击力: 12" # 2级比1级多了7点，不是固定的5点<br>
• allowed-items: 允许镶嵌的物品类型。
  • ALL: 所有物品。
  • WEAPON: 剑、斧头、弓、弩、三叉戟。
  • ARMOR: 头盔、胸甲、护腿、靴子。
  • TOOL: 镐、铲、锄、斧。
  • PICKAXE: 仅限各种材质的镐。
  • BOW: 弓和弩。
  • AXE: 各种材质的斧头。
  • SWORD: 仅限剑。
  • HELMET/CHESTPLATE/LEGGINGS/BOOTS: 具体的盔甲部位。
  • 或者直接写材质名：DIAMOND_SWORD。

2. levels.yml (等级与概率)​

字段解析​

• next-level: 升级后的目标等级。
• success-rate: 成功率，0.8 代表 80%。
• fail-to-level: 失败后会掉到多少级。
• fail-message: 失败后发给玩家的倒霉提示。

3. config.yml (主配置)​

字段解析​

• attribute-plugin: 对接的属性插件名（attributeplus / sx-attribute / default）。
• allow-survival-insert: 是否允许生存模式玩家手动镶嵌。
• storage-type: 存储方式，nbt 推荐用于跨服或复杂物品，pdc 推荐用于纯净高版本。

4. messages.yml (语言包)​

• {player}: 玩家名。
• {gem}: 宝石名。
• {level}: 中文数字等级。
• {max-level}: 宝石的最高等级。
• {fail-message}: levels.yml 中定义的失败消息。

宝石系统使用手册​

1. 宝石的操作流程​

镶嵌 (Insert)​

• 方法一: 打开背包，拿起宝石（鼠标指针左键点击宝石），右键点击你的装备。
• 方法二: 手持宝石，副手拿着装备，右键空气或地面（需要配置开启 allow-survival-insert）。
• 注意: 如果装备上已经有同类宝石，默认配置会提示已经镶嵌过了。

升级 (Upgrade)​

• 前提: 你的装备上已经有一颗宝石。
• 操作: 手里拿着一颗 1级 的同类宝石，右键点击已经镶嵌了宝石的装备。
• 逻辑: 系统会去查 levels.yml。如果成功，宝石等级 +1；如果失败，按配置降级或消失。
• 上限: 每一颗宝石在 gems.yml 里都有 max-level。达到上限后，升级操作不会消耗材料，并会提示“已达到最高等级”。

2. 命令详解​

• /gem give &lt;玩家名&gt; &lt;宝石ID&gt; [等级]: 直接给玩家一颗宝石。
  • 例子: /gem give Notch particle 1 (给 Notch 一颗粒子宝石)。
• /gem info: 查看手中物品上的宝石信息。
• /gem reload: 修改配置文件后，执行此命令立即生效。
• /gem remove &lt;行号&gt;: 管理员专用，用于强行移除物品上的宝石数据。
• /gem setlevel &lt;等级&gt;: 管理员专用，修改物品上宝石的等级。

常见报错与排查​

镶嵌不上去​

• 检查 gems.yml 里的 allowed-items。
• 如果写了 PICKAXE，那么剑是镶不上去的。
• 如果写了 WEAPON，那么头盔是镶不上去的。
• 如果写了 BOW，那么只有弓和弩能镶上去。
• 如果写了 AXE，那么只有斧子能镶上去。

属性没加​

• 检查 config.yml 里的 attribute-plugin 填对了没。
• 检查服务器是否安装了对应的属性插件（如 AttributePlus）。
• 检查 gems.yml 里的属性名（如 攻击力）是否跟属性插件里的配置对齐了。
• 属性名后面必须有冒号和数值（如 攻击力: 10）。

升级没反应​

• 检查你手里拿的是不是 1级 宝石。
• 检查物品上是否已经达到 max-level。
• 检查 levels.yml 里是否有当前等级的升级配置（比如当前是 5 级，有没有 5 的配置段）。