离渊系列插件Wiki

配置说明 ​

LyGemSoulRing 的主要配置集中在 config.yml。配置重点分为宝石来源、槽位扫描、显示开关、冷却提示、指令动作和动画效果。

宝石来源 ​

yaml
gem-plugin: "LyGemReload"

gem-plugin 用于指定魂环读取哪个宝石插件的数据。

值说明
LyGemReload使用宝石重置版作为宝石来源
YeeGem使用 YeeGem 作为宝石来源

如果服务器使用的是 LyGemReload，这里保持默认即可。

槽位来源 ​

yaml
plugin-slot:
  - "Origin#MainHand"
  - "Origin#Helmet"

plugin-slot 决定插件从哪些装备位置读取宝石。多个槽位会按列表顺序依次扫描。

格式说明
DragonCore#槽位名读取龙核槽位
LyInventoryReload#背包id#类型读取背包重置版指定类型槽位
YeeJewelry#背包id#槽位id读取 YeeJewelry 指定槽位
Origin#MainHand读取原版主手
Origin#OffHand读取原版副手
Origin#Helmet读取原版头盔
Origin#ChestPlate读取原版胸甲
Origin#Legging读取原版护腿
Origin#Boots读取原版靴子
Minecraft#槽位id读取原版背包槽位，范围通常为 0-35

显示按键 ​

yaml
show-soulring-key: "Z"

show-soulring-key 用于设置释放按键后的切换行为。玩家按下并松开该按键后，会显示或隐藏魂环。

如果填写为空，或者填写了无效按键，按键功能不会生效，玩家仍然可以使用 /lgsr show 切换。

冷却设置 ​

yaml
show-soulring-cooldown: 10000
show-soulring-cooldown-message: "&c魂环显示冷却中，还需要 &e{time} &c秒"
配置说明
show-soulring-cooldown显示魂环的冷却时间，单位为毫秒
show-soulring-cooldown-message冷却中再次显示时发送的提示

{time} 会替换为剩余秒数。隐藏魂环不受该冷却限制。

指令动作 ​

yaml
show-soulring-command:
  - "[console]say {player} 显示了魂环"

hide-soulring-command:
  - "[console]say {player} 隐藏了魂环"
前缀执行身份
[console]控制台执行
[op]临时以管理员身份执行

{player} 会替换为玩家名。可以把这里用于称号、特效、任务条件或菜单联动。

显示参数 ​

yaml
max-soulring: 10
soulring-scale: 4
show-soulring-delay: 5
配置说明
max-soulring单次最多显示的魂环数量
soulring-scale魂环显示缩放
show-soulring-delay魂环逐个显示的间隔

如果宝石数量很多，可以适当降低 max-soulring，避免画面过于拥挤。

动画参数 ​

旋转动画 ​

yaml
RotateAnimation:
  delay: 0
  angle: 360
  duration: 80
  cycleCount: -1
  fixed: false
  resetTime: 0
配置说明
delay动画开始前的延迟
angle单轮旋转角度
duration单轮动画时长
cycleCount循环次数，-1 通常表示持续循环
fixed是否固定动画状态
resetTime重置间隔

位移动画 ​

yaml
TranslateAnimation:
  delay: 0
  distance: 20
  duration: 20
  cycleCount: 1
  fixed: false

distance 控制位移距离，适合做魂环展开或收束效果。

缩放动画 ​

yaml
ScaleAnimation:
  delay: 0
  cycleCount: 1
  fixed: false
  fromScale: 0
  toScale: 1
  duration: 20

fromScale 与 toScale 控制缩放起点和终点，常用于魂环出现时的渐入动画。