Simple Prefix - 简易前缀后缀

Simple Prefix 是一款轻量级插件，用于管理玩家聊天格式。它允许你为不同的组、玩家甚至世界设置独特的前缀、后缀和昵称，并支持颜色代码和Hex颜色，让服务器聊天界面更加个性化。

💡命令与权限

所有命令均以 /spr 开头。

基础命令

• /spr reload

重新加载插件配置文件。

• 权限: spr.c.rl

• /spr colors

显示可用的颜色与格式代码。

• 权限: spr.c.c

• /spr help

显示命令帮助菜单。

• 权限: spr.c.*

组管理命令

• /spr p g <group> [prefix]

为指定组设置或移除前缀。若不填写 [prefix] 则移除。

• 权限: spr.c.egp

• /spr s g <group> [suffix]

为指定组设置或移除后缀。若不填写 [suffix] 则移除。

• 权限: spr.c.egs

玩家管理命令

• /spr p u <user> [prefix]

为指定玩家设置或移除个人前缀。若不填写 [prefix] 则移除。

• 权限: spr.c.eup

• /spr s u <user> [suffix]

为指定玩家设置或移除个人后缀。若不填写 [suffix] 则移除。

• 权限: spr.c.eus

玩家自助命令

• /spr p [prefix]

为自己设置或移除前缀。若不填写 [prefix] 则移除。

• 权限: spr.c.eop

• /spr s [suffix]

为自己设置或移除后缀。若不填写 [suffix] 则移除。

• 权限: spr.c.eos

世界昵称命令

• /spr w <world> [nickname]

为指定世界设置或移除昵称。若不填写 [nickname] 则移除。

• 权限: spr.c.ew

其他权限

• spr.<group name>

将玩家添加到指定的组。

• **spr.c.***

授予所有命令的使用权限。

🎮配置说明

配置文件为 config.yml，主要结构如下：

核心设置

Use-Vault: false
debug-mode: false
OPs-have-all: false
Use-UUID: true

• Use-Vault: 是否与 Vault 集成（用于经济、权限等）。
• OPs-have-all: 设置为 true 时，OP 玩家自动拥有所有权限。
• Use-UUID: 使用玩家的 UUID 而非用户名进行存储，更安全可靠。

聊天格式模板

Template:
  format: '<[time] [world] [prefix] [name] [suffix]> '
  time: '[h:mm aa]'

• format: 定义聊天消息的最终显示格式。可用的占位符有 [time], [world], [prefix], [name], [suffix]。
• time: 定义 [time] 占位符的显示格式。

多前缀/后缀设置

multiPrefix: false
multiPrefixSeparator: '&r, '
multiSuffix: false
multiSuffixSeparator: '&r-'

• 启用 multiPrefix 或 multiSuffix 后，玩家可以拥有多个前缀或后缀，并用指定的分隔符连接。

世界、组与玩家配置

Worlds:
  world:
    nickname: '&e[World] &f'

Group:
  example:
    prefix: '&a[Example] &f'
    suffix: ''
    tier: 'exampleTier'

User:
  069a79f4-44e9-4726-a5be-fca90e38aaf5:
    prefix: '&c[Notch] &f'
    suffix: ''

• Worlds: 为特定世界设置昵称，会替换聊天格式中的 [world]。
• Group: 定义组的前缀、后缀和层级 (tier)。
• User: 基于 UUID 为特定玩家设置个人前缀和后缀，优先级高于组设置。

🔧依赖与兼容性

• Vault

这是一个软依赖。仅当 Use-Vault: true 时，才需要安装 Vault 以实现与权限或经济插件的集成。

✨颜色与格式

插件支持标准的 & 颜色代码（例如 &c 代表红色）和 Hex 颜色代码。

Hex 颜色使用格式

格式为 #rrggbb。注意：使用时不要在 Hex 代码前添加 & 符号。

• 正确示例: #FFAA00这是一个金色文本
• 错误示例: &#FFAA00这是一个金色文本