SimpleNicks

插件

· 作者 Rhythmic

一个基于 SimpleMinimessage 的昵称插件。

0 本站下载 0 关注 更新于 6 个月前

最新 3.2.2 · 26.3 · Paper

一键开服(送7天)

SimpleNicks

一个独立的昵称插件,让你无需安装包含大量其他功能的臃肿插件。
只需要昵称功能?选择 SimpleNicks!
 

特性

使用 MiniMessage 设置昵称
在昵称中使用 MiniMessage 格式。
允许在标签页列表中显示昵称
在标签页列表(Tab List)中显示玩家昵称。
保存昵称
可以保存昵称以便日后使用,例如用于角色扮演。
昵称保护
防止因复制用户名或昵称造成的混淆。
“那是谁?”
找出玩家的真实身份。

更多功能

  • 支持权限系统,可使用 LuckPerms 等插件。
  • 基于 SQL 的存储,可选择 MySQL(服务器端)或 SQLite(本地,默认)。
    • 不需要任何 SQL 配置即可运行此插件。
  • 控制特定昵称功能是否需要权限。
  • 控制用户名或昵称的保护时长。
  • 昵称前缀功能,让你知道谁隐藏了身份。
  • PlaceholderAPI 扩展,让你可以在需要的地方插入昵称。

命令

玩家命令

命令 描述
/nick help 显示帮助文本。
/nick set <nickname> 设置你的昵称。
支持 MiniMessage 格式。
/nick save [nickname] 保存当前昵称以便日后使用。
你也可以直接提供一个要保存的昵称。
/nick delete <nickname> 删除你已保存的一个昵称。
/nick reset 将昵称重置为你的原始用户名。
/nick who <nickname> 显示拥有所提供昵称的玩家的用户名。

管理员命令

命令 描述
/nick admin set <username> <nickname> 设置其他玩家的昵称。
使用管理员的权限进行格式化。
/nick admin reset <username> 重置其他玩家的昵称。
/nick admin delete <username> <nickname> 从玩家的列表中删除一个已保存的昵称。
/nick admin lookup <username> 显示玩家当前的昵称以及所有已保存的昵称。
/nick reload 重新加载配置文件和本地化文件。

权限

玩家权限

权限 描述 默认值
simplenick.nick.set 设置自己的昵称。 op
simplenick.nick.reset 重置自己的昵称。 op
simplenick.nick.delete 删除自己已保存的一个昵称。 op
simplenick.nick.who 使用 /nick who <nickname> 查询用户名。 true

颜色权限

权限 描述 默认值
simplenick.color.basic 使用颜色标签 (<red>, <color:#aabbcc>)。 op
simplenick.color.gradient 使用渐变标签 (<gradient:red:blue>)。 op
simplenick.color.rainbow 使用 <rainbow>。 op
simplenick.color.reset 使用 <reset>。 op

格式权限

权限 描述 默认值
simplenick.format.bold 使用 <b>/</b>。 op
simplenick.format.italic 使用 <i>/</i>。 op
simplenick.format.underline 使用 <u>/</u>。 op
simplenick.format.strikethrough 使用 <st>/</st>。 op
simplenick.format.obfuscated 使用 <obf>/</obf>。 op

管理员权限

权限 描述 默认值
simplenick.admin.set 设置其他玩家的昵称。 op
simplenick.admin.reset 重置其他玩家的昵称。 op
simplenick.admin.delete 删除其他玩家已保存的昵称。 op
simplenick.admin.lookup 查询玩家当前及已保存的昵称。 op
simplenick.reload 重新加载插件配置与本地化文件。 op

绕过权限

权限 描述 默认值
simplenick.bypass.username 使用其他玩家的用户名作为昵称。 false
simplenick.bypass.length 设置超过配置最大长度的昵称。 false
simplenick.bypass.regex 设置不符合配置正则表达式的昵称。 false
simplenick.bypass.nick-protection 绕过昵称保护(在线/离线/过期)。 false

PlaceholderAPI

所有占位符现在均以 simplenick 开头,以保持一致性。

占位符 描述 示例
%simplenick_nickname% 玩家解析后的昵称。
%simplenick_mininick% 玩家的原始 MiniMessage 格式昵称。
%simplenick_prefixed-nickname% 应用了配置前缀的昵称。
%simplenick_prefixed-mininick% 带有前缀的原始 MiniMessage 格式昵称。

配置

MySQL

插件默认使用本地 .db SQLite 数据库。这无需额外设置,但无法在服务器网络中共享。

如果您希望使用 MySQL,可以通过启用它并在配置中填写相关信息来实现。

mysql:
  enabled: false
  ip: "localhost:3306"
  name: simplenicks
  username: username1
  password: badpassword!

昵称长度

这是玩家在颜色与格式处理完成后的昵称最大长度。

例如,如果你设置了一个类似这样的昵称:

    <blue>ThisIs</blue><green>AConvoluted</green><rainbow>Exam</rainbow><b>ple</b>

实际会被检查的文本将是 ThisIsAConvolutedExample。

⚠️ ℹ️ 不建议将数值设置为低于 3,因为这可能会导致意外的副作用。

# 昵称的最大字符数,不包括格式标记
# (因此像 <red>Billy<yellow>Bob 这样的名字只计算 'BillyBob' - 共 8 个字符)
# 将此数字设置为低于 "3" 的值可能会导致意外的副作用
max-nickname-length: 30

昵称正则表达式

这是昵称中允许的字符集。默认值仅允许字母、数字和下划线 [A-Za-z0-9_]+ - 你可以在此添加其他字符,建议使用 等工具确保你的正则表达式能正确解析。

⚠️ ℹ️ 使用非字母数字字符通常不受支持,并可能导致意外的副作用。

# 有效最终昵称字符的正则表达式。
# 请注意,放入非字母数字字符可能会导致与其他插件的问题以及其他意外的副作用
nickname-regex: "[A-Za-z0-9_]+"

需要权限

这些选项用于设置特定功能是否需要权限。如果你不了解权限插件是什么,并且只想让插件正常工作,可以将你希望的功能设置为 'false'。如果你了解权限的概念及其使用方法,可能不需要此部分。

Nick(昵称)

提供以下功能:

  • /nick set
  • /nick reset
  • /nick save 允许玩家更改其显示名称。

Color(颜色)

提供颜色标签的功能,如 <red>、<#aabbcc>、<rainbow>、<gradient:color1:color2> 和 <reset>。 允许玩家更改其显示名称及其名称的颜色。

Format(格式)

提供格式标签的功能,如 <u>(下划线)、<i>(斜体)、<b>(粗体)、<st>(删除线)和 <obf>(ō̵̬b̵̧̛f̷̩̋u̵̳͂ş̸̓c̷̥̈́a̵͇͂t̸̯͋e̸͎̚d̷̟͝)。

Who(谁)

提供访问 /nick who <name> 的权限,该命令显示与特定昵称关联的用户名。

# 哪些功能需要由权限插件设置的权限?
require-permission:
  nick: true
  color: true
  format: true
  who: false

昵称保护

允许保护已被使用的昵称。这不保护已保存的昵称,也不阻止他人保存昵称。

在线保护

仅防止玩家占用当前在线玩家的昵称。允许人们使用离线玩家的昵称。

离线保护

无论玩家是否在线,只要昵称未过期,都防止玩家使用其他人正在主动使用的昵称。

离线保护过期时间

玩家需要离开多少天后,其昵称保护才会过期。如果不想让昵称保护过期,请设置为 -1,但不建议这样做。

用户名保护

防止玩家将自己的昵称设置为其他玩家的用户名。仅针对实际登录过服务器的玩家进行检查。

用户名保护过期时间

此值控制玩家需要离线多少天后,其用户名才被视为允许被用作昵称。如果您不希望保护永久有效,请使用 -1。

# 阻止某些名称被用作昵称
# 过期时间以天为单位,设置为 -1 表示永不失效
nickname-protection:
  username:
    enabled: true
    expires: 30
  online:
    enabled: false
  offline:
    enabled: false
    expires: 30

最大保存数量

控制玩家可以保存多少个昵称。目前对此没有覆盖权限,该设置适用于所有拥有保存权限的玩家。

# 可以保存多少个昵称?
max-saves: 5

标签页列表昵称

修改标签页列表(Tablist)以显示玩家的当前昵称。如果您已经有其他插件可以处理此功能,建议您使用那些插件,或者使用我的另一个插件 Simple Custom Tab List,因为此选项非常有限且容易与其他插件产生冲突。如果您的服务器配置非常简单,只是希望昵称显示在标签页列表中,这将起作用;但如果您使用了 Geyser 或其他可能会更改记分板和其他随机内容的插件,您还是需要单独使用一个插件来处理标签页列表。

# 是否应在标签页列表中更改名称?
# (如果您使用任何其他标签页列表插件,请保持此项为 false,这些插件中有对应的占位符 API 占位符可用)
tablist-nick: false

昵称前缀

设置昵称的前缀。

用于玩家显示名称以及占位符 %simplenick_prefixed-nickname% 和 %simplenick_prefixed-mininick%。

# 拥有昵称的玩家应添加什么前缀?如果不需要前缀,请输入 ""
nickname-prefix: ""

调试模式

为此插件启用开发调试日志记录。

⚠️ ℹ️ 这将导致您的日志大量刷屏,并使其几乎无法阅读。

除非被告知,否则请勿启用。

# 开发选项,这将导致日志大量刷屏,除非被要求,否则不建议启用
debug-mode: false

从旧版本迁移

如果您是从 不支持 SQL 的 SimpleNicks 版本进行升级:

  • 数据存储:
    • 旧版本将昵称存储在 YML 文件或通过持久化数据容器(PDC)中。
    • 新版本使用 MySQL 或 SQLite。现有数据将自动迁移。
  • 命令:
    • 管理员命令现在位于 /nick admin 下,而不是共享玩家命令结构。
    • /nick save 现在可以接受参数(/nick save <nickname>)。
  • 权限:
    • 颜色和格式权限已移至其独立节点(simplenick.color.* 和 simplenick.format.*)。
      • 颜色和格式现在可以在没有特定权限的情况下被允许,请查看新的配置选项。
    • simplenick.admin.restrictive、simplenick.admin.basic 和 simplenick.admin.full 已被移除。现在的权限是 simplenick.admin.set。
      • 管理员设置昵称现在始终使用管理员自身的权限。(以前是 'admin basic' 的功能)
    • simplenick.admin.save 已被移除——由于现在使用的是 Brigadier,您可以使用
  • PlaceholderAPI:
    • 占位符已重命名以保持一致性。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源