display.yml、gui.yml 与 messages.yml

display.yml 完整默认

config-version: 1
health-bar:
  mode: SCALED
  scale: 40.0
movement-projection:
  mode: OWNED_MODIFIER
respawn-health:
  mode: FULL
  percentage: 30.0
number-format:
  mode: COMPACT_CN
  decimal-places: 2
  trim-trailing-zeros: true
  use-grouping-separator: true
hologram:
  enabled: true
  required: false
  mode: BREAKDOWN
  viewers: [PARTICIPANTS]
  merge-window-ticks: 6
  lifetime-ticks: 24
  update-interval-ticks: 2
  vertical-offset: 0.6
  nearby:
    radius: 16.0
    maximum-viewers: 16
  capacity:
    maximum-active: 128
    maximum-creates-per-tick: 32
  lines:
    total: "&c&l-{total}"
    breakdown: "&c物理 {physical} &d法术 {spell} &f真实 {true}"
combat-effects:
  hurt-animation: true
  hurt-sound: true
  knockback: true
  particles: true
  maximum-particle-bursts-per-tick: 64

区域	允许值/范围
health-bar.mode	SCALED、VANILLA、UNCHANGED；scale 2～40。
movement-projection.mode	OWNED_MODIFIER 或 UNCHANGED；只管理插件自己的 modifier。
respawn-health.mode	FULL、PERCENT、UNCHANGED；percentage 1～100。
number-format.mode	COMPACT_CN、COMPACT_EN、PLAIN。
decimal-places	0～4；trim-trailing-zeros、use-grouping-separator 为布尔。
hologram.enabled/required	required=true 且 DecentHolograms 缺失时拒绝启动/重载。
hologram.mode	BREAKDOWN 或 TOTAL。
viewers	1～4 个不重复值：ATTACKER、TARGET、PARTICIPANTS、NEARBY。
merge-window-ticks	0～100；lifetime-ticks 1～200；update-interval-ticks 1～20。
vertical-offset	-5～10。
nearby.radius / maximum-viewers	1～64 / 1～128。
capacity.maximum-active	1～2048。
capacity.maximum-creates-per-tick	1～256。
lines.total	1～256 字符，必须含 {total}。
lines.breakdown	1～512，必须含 {physical}、{spell}、{true}。

combat-effects 四个效果均为布尔；粒子上限 0～256。关闭视觉效果不改变数学结算。

gui.yml 完整默认

config-version: 1
enabled: true
title: "&8✦ &6SealAttributes &8· &f{player}"
category-title: "&8✦ &6{category} &8· &f{player}"
materials:
  filler: BLACK_STAINED_GLASS_PANE
  border: GRAY_STAINED_GLASS_PANE
  attribute: PAPER
  back: ARROW
back-name: "&6← 返回属性总览"
capacity:
  maximum-open-views: 100
groups:
  attack: { slot: 20, material: NETHERITE_SWORD, name: "&6&l攻击属性", lore: ["&8物理 · 法术 · 真实", "&7共 &f{count} &7项，点击查看"] }
  defense: { slot: 21, material: SHIELD, name: "&b&l防御属性", lore: ["&8减伤 · 穿透对抗 · 格挡", "&7共 &f{count} &7项，点击查看"] }
  accuracy_critical: { slot: 22, material: TARGET, name: "&e&l命中与暴击", lore: ["&8命中 · 闪避 · 暴击", "&7共 &f{count} &7项，点击查看"] }
  sustain: { slot: 23, material: GLISTERING_MELON_SLICE, name: "&a&l续航与治疗", lore: ["&8吸血 · 治疗 · 恢复", "&7共 &f{count} &7项，点击查看"] }
  survival: { slot: 24, material: TOTEM_OF_UNDYING, name: "&c&l生存属性", lore: ["&8生命 · 当前状态", "&7共 &f{count} &7项，点击查看"] }
  utility: { slot: 31, material: FEATHER, name: "&f&l功能属性", lore: ["&8移动与通用扩展", "&7共 &f{count} &7项，点击查看"] }
  custom: { slot: 32, material: ENCHANTED_BOOK, name: "&d&l自定义属性", lore: ["&8第三方插件启动期注册", "&7共 &f{count} &7项，点击查看"] }

title 1～64，可含 {player}；category-title 1～64 且必须含 {category}。Material 必须存在于目标 1.21 平台。back-name 1～128；capacity.maximum-open-views 1～500。groups 恰好七个固定键；slot 0～53 且互不重复，name 1～128，lore 0～16 行。文本使用 & 颜色代码，不是 MiniMessage。

messages.yml 必需键

config-version: 1
messages:
  prefix: "&8[&6SealAttributes&8] &r"
  no-permission: "{prefix}&c你没有权限：&f{permission}"
  player-only: "{prefix}&c该命令只能由在线玩家执行。"
  player-not-found: "{prefix}&c找不到在线玩家 &f{player}&c，请检查名称后重试。"
  subject-not-ready: "{prefix}&e{player} 的属性尚未就绪：&f{reason}&e，请稍后重试。"
  invalid-usage: "{prefix}&c参数不正确。用法：&f{usage}"
  reload-started: "{prefix}&e正在读取并校验八份候选配置……"
  reload-success: "{prefix}&a原子重载成功，配置修订 &f{revision}&a，待完成重建 &f{pending}&a。"
  reload-failed: "{prefix}&c重载失败，旧完整配置仍在使用：&f{error}"
  gui-disabled: "{prefix}&e属性 GUI 当前已关闭，请使用 &f/sa inspect <玩家>&e。"
  source-write-started: "{prefix}&e正在写入持久来源，成功前不会改变在线属性……"
  source-write-success: "{prefix}&a已更新 &f{player}&a 的持久来源 &f{source}&a。"
  source-write-failed: "{prefix}&c持久来源写入失败，在线属性未改变：&f{error}"
  health-repair-success: "{prefix}&a已修复 &f{player}&a 的 SealAttributes 投影：&f{health}/{maximum}&a。"
  health-repair-failed: "{prefix}&c无法修复 &f{player}&c：&f{error}"
  database-flush-started: "{prefix}&e正在后台排空存储队列……"
  database-flush-complete: "{prefix}&a存储排空结束：成功 &f{drained}&a，失败 &f{failed}&a。"

17 个消息键全部必需，每条 1～512 字符；除 prefix 外可用 {prefix}，其他变量以默认文件注释为准。只修改现有键冒号后的文本：删必需键或写空值会拒绝；额外消息键虽可被读入，却没有命令消费者，不会创造新能力。执行 /sa reload 后实际打开 GUI、触发消息检查颜色和布局。