配置说明

插件的主要配置文件为 plugins/LySimplePlaceholder/config.yml，用于设置数字格式、缩写起始位数，以及聊天、物品、BossBar 和全息文本的数字替换规则。

修改配置后，可使用 /lsp reload 重新加载配置并重新注册相关数据包监听器。该命令仅允许服务器管理员使用。

警告

如果关闭 item-number-abbreviation，建议修改配置后重启服务器。仅执行重载不会主动恢复客户端已经收到的缩写物品文本。

配置文件

文件	用途
config.yml	设置数字格式、缩写阈值、替换关键词、物品黑名单和各类文本替换开关

完整默认配置

# 默认数字格式
format: '%.2f'

# 为指定 PlaceholderAPI 变量设置独立数字格式
designated-placeholder-format:
  '%ap_damage:min%': '%.0f'

# 从多少位开始检查数字缩写
# 4 表示从万级数字开始缩写，8 表示从亿级数字开始缩写
abbreviation-value: 4

# 聊天替换关键词
# 消息包含任意关键词时，才会替换其中满足条件的数字
message-replace-key:
  - '系统'

# 是否缩写物品 Lore 中的数字
item-number-abbreviation: true

# 物品名称或任意 Lore 行包含关键词时，跳过整个物品
item-abbreviation-black-list:
  - '玩家属性'

# Lore 行包含关键词时，仅跳过该行
item-line-black-list:
  - 'QQ群:'

# 是否缩写 BossBar 文本中的数字
bossbar-number-abbreviation: false

# BossBar 包含任意关键词时，才会执行替换
bossbar-keyword:
  - '生命'

# 是否缩写全息或实体名称中的数字
# 当前实现仅适用于 Minecraft 1.12.2 的非发包全息
hologram-number-abbreviation: false

# 全息或实体名称包含任意关键词时，才会执行替换
hologram-keyword:
  - '魔王'

数字格式

配置项	类型	默认值	说明
format	字符串	'%.2f'	默认数字格式，用于变量结果和文本数字缩写
designated-placeholder-format	映射	见默认配置	为指定 PlaceholderAPI 原始变量设置独立格式
abbreviation-value	整数	4	数字达到指定长度后开始检查是否可使用中文单位缩写

format

格式写法为 %.数字f，其中数字表示最多保留的小数位数。

格式	作用
'%.0f'	不保留小数部分
'%.1f'	最多保留 1 位小数
'%.2f'	最多保留 2 位小数

插件使用向下取整方式处理小数，并且不会强制补齐末尾的 0。例如使用 '%.2f' 时，结果可能显示为 1.2万，而不是固定显示为 1.20万。

如果填写的格式不符合 %.数字f，插件会按最多 2 位小数处理。

designated-placeholder-format

该配置只影响通过 %lsp_变量内容% 调用的 PlaceholderAPI 变量。键名必须填写完整的原始变量，包括两侧的 %。

designated-placeholder-format:
  '%ap_damage:min%': '%.0f'
  '%vault_eco_balance%': '%.2f'

对应调用形式为：

%lsp_ap_damage:min%
%lsp_vault_eco_balance%

没有单独配置的变量会使用 format。

abbreviation-value

该配置控制插件从多少位开始检查数字缩写。

abbreviation-value: 4

默认值 4 对应万级数字。插件内置的中文单位如下：

数值级别	单位
10^4	万
10^8	亿
10^12	兆
10^16	京
10^20	垓
10^24	秭
10^28	穰
10^32	沟
10^36	涧
10^40	正
10^44	载
10^48	极
10^52	恒河沙
10^56	阿僧祇
10^60	那由他
10^64	不可思议
10^68	无量
10^72	大数

插件能够识别普通整数、小数、带逗号千分位的数字和科学计数法数字。实际替换时，只有达到配置阈值并且存在可用中文单位的数字才会被缩写。

聊天替换

配置项	类型	默认值	说明
message-replace-key	字符串列表	['系统']	服务端聊天数据包包含任意关键词时，缩写消息中的数字

message-replace-key:
  - '系统'
  - '造成伤害'

聊天消息必须包含列表中的至少一个关键词，插件才会检查并缩写其中的数字。玩家聊天、插件消息等内容只要通过对应聊天数据包发送，都可能进入该处理流程。

关键词使用包含匹配，不要求整段消息完全一致。列表为空时，聊天消息不会触发数字替换。

物品替换

配置项	类型	默认值	说明
item-number-abbreviation	布尔值	true	是否处理发送给客户端的物品数据
item-abbreviation-black-list	字符串列表	['玩家属性']	名称或 Lore 包含任意关键词时，跳过整个物品
item-line-black-list	字符串列表	['QQ群:']	Lore 行包含任意关键词时，只跳过该行

物品数字缩写

item-number-abbreviation: true

开启后，插件监听发往客户端的物品槽位数据，并缩写物品 Lore 中满足条件的数字。当前代码不会缩写物品名称中的数字，物品名称仅用于整个物品的黑名单检查。

替换发生在发送给客户端的物品副本上，不会直接修改服务端背包中的原始物品数据。

部分龙核界面可能无法正常显示该功能。如果修改此开关，建议重启服务器，使数据包监听状态和客户端物品显示保持一致。

整个物品黑名单

item-abbreviation-black-list:
  - '玩家属性'
  - '&c菜单按钮'

插件会检查物品名称和全部 Lore。任意位置包含列表中的关键词时，整个物品都不会进行数字缩写。

该列表适合排除菜单按钮、说明物品或不应修改显示内容的特殊物品。列表中的 & 颜色代码会转换为 Minecraft 颜色符号后再匹配。

Lore 行黑名单

item-line-black-list:
  - 'QQ群:'
  - '&7编号:'

该列表只影响匹配到的 Lore 行。其他未命中的 Lore 行仍会正常缩写。

列表中的 & 颜色代码会转换为 Minecraft 颜色符号后再匹配。

创造模式物品还原

插件缩写物品 Lore 后，会在发送给客户端的物品数据中保存原始名称和 Lore。创造模式玩家将该物品提交回服务器时，插件会尝试恢复原始文本，并移除用于还原的内部 NBT 数据。

该处理依赖当前服务端版本对应的 NMS 物品实现。若服务端版本无法初始化对应的 NBT 工具，物品缩写与创造模式还原可能无法完整工作。

BossBar 替换

配置项	类型	默认值	说明
bossbar-number-abbreviation	布尔值	false	是否监听并处理 BossBar 数据包
bossbar-keyword	字符串列表	['生命']	BossBar 文本包含任意关键词时才执行缩写

bossbar-number-abbreviation: true
bossbar-keyword:
  - '生命'
  - '血量'

开启后，插件检查发往客户端的 BossBar 文本。文本必须包含至少一个 bossbar-keyword 关键词，数字才会按照全局格式和缩写阈值处理。

该功能可用于包含怪物血量等大数字的 BossBar。列表为空时，即使开启功能也不会触发替换。

全息与实体名称替换

配置项	类型	默认值	说明
hologram-number-abbreviation	布尔值	false	是否监听实体元数据并处理名称文本
hologram-keyword	字符串列表	['魔王']	名称包含任意关键词时才执行缩写

hologram-number-abbreviation: true
hologram-keyword:
  - '魔王'
  - '&c伤害'

该功能监听实体元数据中的名称字段，可处理符合条件的全息文本，也会影响符合关键词条件的怪物名称。

警告

当前实现直接使用 Minecraft 1.12.2 的 v1_12_R1 实体元数据类型，因此该功能仅确认适用于 Minecraft 1.12.2。它主要用于非发包全息，不适用于由其他插件直接通过独立数据包生成且不经过对应实体元数据流程的全息内容。

hologram-keyword 使用包含匹配。列表中的 & 颜色代码会转换为 Minecraft 颜色符号后再匹配。列表为空时，即使开启功能也不会触发替换。

重载说明

执行以下命令可重新读取 config.yml：

/lsp reload

重载时，插件会重新读取 abbreviation-value，移除已有的数据包监听器，并根据当前配置重新注册聊天、物品、BossBar 和全息监听器。

配置类型	重载后效果
数字格式与缩写阈值	后续处理立即使用新配置
聊天关键词	后续聊天数据包使用新列表
物品黑名单	后续发送的物品数据使用新列表
BossBar 开关与关键词	重新注册后生效
全息开关与关键词	重新注册后生效
关闭物品缩写	后续不再缩写，但已经显示的物品不会被主动恢复

如果物品 Lore 没有立即刷新，可由管理员玩家执行 /lsp update，插件会延迟 1 Tick 重新设置该玩家背包和装备栏中的物品，以触发客户端物品信息刷新。