- 版权类型
- 原创
- 插件中文名称
- 枫林宝石
- 插件英文名称
- FlGem
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- 语言支持
- 中文(简体)
- 前置组件
- 插件硬依赖AttributePlus-3.3.3.3、PlaceholderAPI
插件软依赖 Vault、PlayerPoints
插件适配 ItemAdders、CraftEngine、ArcartX、CloudPick
- 适配版本(Java)
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
- 1.14
- 1.13
- 1.12
FlGem 是一款专注于 AP3 属性体系下的宝石玩法插件,适用于 RPG / 生存养成类服务器。
联系作者QQ2225937164
你可以通过简单的 YAML 配置:
- 自定义任意宝石(名称、孔位类型、成功率、属性效果)
- 定义宝石套装效果和图鉴界面
- 配置单宝石保底 + 宝石组保底双重机制
- 为不同 VIP 等级设置额外成功率加成
- 使用金币 / 点券作为镶嵌消耗
玩家则通过直观的 GUI 完成所有操作,无需记任何命令。
命令区
详细参考 https://www.yuque.com/zhhsasd/xzohfv/hl6cvced6me7qnmb
宝石设置区
详细参考 https://www.yuque.com/zhhsasd/xzohfv/bib7pfuuzu1p5igw
孔位配置文件,用于配置每个宝石能镶嵌的孔位类型,以及拆卸失败时孔位的损坏名称
宝石的配置文件中xq: normal,镶嵌所匹配的孔位为十年魂环孔位,拆卸失败lore为破损 十年魂环孔位
道具设置
具体请看https://www.yuque.com/zhhsasd/xzohfv/yar4z46ss1ofpq4e
GUI设置
镶嵌机制
拆卸机制
修复机制
套装机制
config.yml
插件适配-API
更新记录
联系作者QQ2225937164
你可以通过简单的 YAML 配置:
- 自定义任意宝石(名称、孔位类型、成功率、属性效果)
- 定义宝石套装效果和图鉴界面
- 配置单宝石保底 + 宝石组保底双重机制
- 为不同 VIP 等级设置额外成功率加成
- 使用金币 / 点券作为镶嵌消耗
玩家则通过直观的 GUI 完成所有操作,无需记任何命令。
命令区
详细参考 https://www.yuque.com/zhhsasd/xzohfv/hl6cvced6me7qnmb
宝石设置区
详细参考 https://www.yuque.com/zhhsasd/xzohfv/bib7pfuuzu1p5igw
YAML:
# ============================
# 示例宝石配置: baoshi/example.yml
# ============================
# 说明:
# - basic 段是“默认模板”, 下面各宝石没写到的字段会从这里继承
# - 每一个二级 key (如 mygem) 就是一个“宝石 ID”
# * 会参与 baodi (保底) 里以同名 key 的配置
# 字段说明:
# item : 用来匹配物品显示名(去色后对比)
# lore : 镶嵌成功后替换孔位的一行 Lore
# xq : 需要的孔位类型, 对应 kong/*.yml 里的 key (如 normal)
# gl : 基础成功率(百分比)
# lv : 镶嵌最低等级要求 (0 或不写代表不限制)
# attr : 属性列表 (后续对接 AP3 使用)
# level: 等级区间额外加成 (key=等级下限, value=增加的成功率)
# iq/cq/id/cd: 金币/点券消耗
# ============================
basic:
item: "&e测试宝石"
lore: "&7 ○ &e十年魂环"
xq: normal
# ===== 经济默认值 (可选) =====
iq: 0.0 # 镶嵌金币消耗(Vault)
cq: 0.0 # 拆卸金币消耗(预留)
id: 0 # 镶嵌点券消耗(PlayerPoints)
cd: 0 # 拆卸点券消耗(预留)
mygem: #宝石id,在宝石套装以及宝石保底都会用到此id
# 不写 item / lore / xq 会沿用 basic 的默认值
gl: 50.0
lv: 0
attr:
- "攻击力: 100"
- "生命力: 250"
# 等级区间额外加成: 等级 ≥ key 时增加对应成功率
level:
0: 0.0
30: 10.0
60: 25.0
100: 50.0
# ===== 拆卸相关 =====
# 可选, 默认 100, 单位百分比
dismantle-chance: 100.0
# 拆卸成功时按顺序执行的指令
dismantle-commands:
- "give {player} diamond 1"
- "say 玩家 {player} 拆下了宝石 {gem}"
# 攻击宝石
atk_gem:
# 请保证每个宝石的item不重复,两种宝石item相同,需要开启严格验证通过nbt检测匹配
item: "&c攻击宝石"
lore: "&7 ○ &c锋锐之刃"
xq: normal
gl: 50.0
lv: 0
attr:
- "攻击力: 100"
level:
0: 0.0
30: 10.0
60: 20.0
dismantle-chance: 100.0
dismantle-commands:
- "give {player} iron_sword 1"
# 生命宝石
hp_gem:
item: "&a生命宝石"
lore: "&7 ○ &a磐石之心"
xq: normal
gl: 60.0
lv: 0
attr:
- "生命力: 300"
level:
0: 0.0
40: 10.0
# 暴击宝石 (用高阶孔位 advanced)
crit_gem:
item: "&6暴击宝石"
lore: "&7 ○ &6致命之瞳"
xq: advanced
gl: 35.0
lv: 30
attr:
- "暴击率: 10"
- "暴击伤害: 20"
level:
30: 0.0
60: 15.0
# 护盾宝石 (用史诗孔位 epic)
shield_gem:
item: "&5护盾宝石"
lore: "&7 ○ &5庇护之核"
xq: epic
gl: 25.0
lv: 50
attr:
- "护盾值: 300"
level:
50: 0.0
80: 20.0
宝石的配置文件中xq: normal,镶嵌所匹配的孔位为十年魂环孔位,拆卸失败lore为破损 十年魂环孔位
YAML:
# plugins/FlGem/kong/test.yml
# key = 孔位类型 ID, 对应宝石 xq 字段
normal:
lore: "十年魂环孔位"
chai: "破损 十年魂环孔位"
advanced:
lore: "百年魂环孔位"
chai: "破损 百年魂环孔位"
epic:
lore: "&5史诗魂环孔位"
chai: "&8破损 &5史诗魂环孔位"
legendary:
lore: "&6传说魂环孔位"
chai: "&8破损 &6传说魂环孔位"
道具设置
具体请看https://www.yuque.com/zhhsasd/xzohfv/yar4z46ss1ofpq4e
GUI设置
镶嵌机制
拆卸机制
修复机制
套装机制
config.yml
YAML:
# plugins/FlGem/config.yml
# FlGem - 主配置
# ---------------------------------------------------------
# 调试
# ---------------------------------------------------------
debug:
show-success-rate: false # 镶嵌时输出详细成功率(仅建议测试服开启)
# 聊天前缀
prefix: "§f[§3FlGem§f]"
# ---------------------------------------------------------
# 严格模式: 宝石 / 保护符 NBT 校验
# ---------------------------------------------------------
strict-gem:
use-nbt: true
strict-protection:
use-nbt: true
# ---------------------------------------------------------
# AttributePlus 属性挂接
# ---------------------------------------------------------
attributes:
enabled: false
# ---------------------------------------------------------
# 镶嵌限制
# ---------------------------------------------------------
cannotInlayLore: # 装备含有这些 Lore 时禁止镶嵌
- "&a无法镶嵌"
no-inlay-allowed: # 宝石含有这些 Lore 时禁止镶嵌
- "&c使用后绑定"
# ---------------------------------------------------------
# 等级系统
# ---------------------------------------------------------
level: false # false = 原版等级, true = PAPI
papi: "%dl_normal:level%"
# ---------------------------------------------------------
# 权限增加镶嵌几率
# ---------------------------------------------------------
inlay:
flgem.vip1: 10.0
flgem.vip2: 20.0
# ---------------------------------------------------------
# 镶嵌按钮动态预览
# ---------------------------------------------------------
preview-button:
enabled: true
clear-prefixes:
- "镶嵌预览"
- "成功率"
- "基础:"
- "消耗"
- "宝石连败"
- "组连败"
- "连败"
- "----------------"
no-equip: "&7镶嵌预览: &8请先放入装备和宝石"
no-gem: "&7镶嵌预览: &8请先放入宝石"
unknown-gem: "&c当前宝石无法识别, 无法镶嵌。"
lines:
- "&8----------------"
- "&7镶嵌预览:"
- "&7 成功率: &e<chance>%"
- "&7 基础:&f<base> &7权限:&f<perm> &7等级:&f<level> &7保底:&f<pity>"
- "&7 消耗: &6<money>&7 金币 &8+ &3<points>&7 点券"
- "&7 宝石连败: &f<gemFail>&7/&f<gemMax>"
- "&7 组连败: &f<groupFail>&7/&f<groupMax>"
no-cost-line: "&7 消耗: &a无"
# ---------------------------------------------------------
# 拆卸预览(多孔位拆卸界面中,每个宝石图标的说明)
# ---------------------------------------------------------
dismantle-preview:
enabled: true
# 动态行模板:
# <slot> = 孔位类型名称(例如: 十年魂环孔位)
# <chance> = 拆卸成功几率
# <money> = 金币消耗
# <points> = 点券消耗
lines:
- "&e点击拆卸此宝石"
- "&7孔位: &f<slot>"
- "&7拆卸成功几率: &e<chance>%"
- "&7拆卸消耗: &6<money>&7 金币 &8+ &3<points>&7 点券"
# 当 money/points 都为 0 时,用这一行替代包含 <money>/<points> 的那一行
no-cost-line: "&7拆卸消耗: &a无"
repair-icon:
material: ANVIL
custom-model-data: 0
name: "&a可修复孔位"
lore:
- "&7孔位: <slot>"
- "&7行号: <index>"
- "&e点击消耗修复卷恢复该孔位"
# ---------------------------------------------------------
# 拆卸系统
# ---------------------------------------------------------
dismantle-icon:
material: "STONE"
custom-model-data: 0
dismantle-broken-enable: true
# ---------------------------------------------------------
# MySQL(保底跨服用, 默认关闭)
# ---------------------------------------------------------
database:
mysql:
enable: false
host: "localhost"
port: 3306
username: "root"
password: "root"
database: "LegendInlay"
table-prefix: "flgem_"
# ---------------------------------------------------------
# 内部标记 (不要改)
# ---------------------------------------------------------
internal:
resources-initialized: true
插件适配-API
更新记录
- v1.0.0: 开发版本, 为了适配AX惨遭重构。
- v2.0.0: 初始版本, 集成镶嵌/拆卸/套装/保底系统。
- v2.0.1: 新增数据库配置框架, 优化日志输出。
- v2.0.2: 优化 message 提示, 支持 PAPI 解析。
- v2.0.3: 优化拆卸逻辑, 修复拆卸百分百不扣除物品等问题。
- v2.0.4: 新增 restorePlaceholderIfEmpty, 处理功能槽位占位刷新。
- v2.0.5: 新增 /inlay Tab 补全。
- v2.0.6: 新增 keep-socket-on-fail / DISMANTLE_FORCE_SUCCESS 区分拆卸保护道具。
- v2.0.7: 修复 拆卸后孔位不同步chai
- v2.0.8: 新增拆卸宝石lore自定义解析/config下拆卸预览
- v2.0.9: 修复 拆卸成功后不扣除点券或者金币等问题
- v2.1.0: 新增 REPAIR_BROKEN_SOCKET 孔位修复节点道具。
- v2.1.1: 新增 孔位修复UI。