落雨sa 发表于 2025-3-3 22:06:48

CustomServerNameAPI-一款轻量化的自定义服务器名称PAPI插件化拓展

本帖最后由 落雨sa 于 2025-3-3 22:18 编辑

CustomServerNameAPI简介
CustomServerNameAPI 专为自定义服务器名称而设计,这是一个插件化的PlaceholderAPI扩展,变量内容支持自定义理论支持全版本!

特性

[*]服务器名称和别名管理:支持通过命令动态更新服务器名称和别名,满足不同场景下的展示需求。
[*]自动生成别名:可根据服务器名称自动生成首字母大写作为别名,注意,此时设置名称为中文或其他非ASCII字符,那么此功能无效。
[*]命令帮助与补全:提供详细的命令帮助信息,以及命令补全功能。
[*]变量持久化开关:可以通过命令开启或关闭变量持久化功能。

命令列表
命令描述使用示例
/customservernameapi 或 /csna显示插件的主要帮助信息,列出所有可用的子命令及其功能描述。/customservernameapi
/customservernameapi reload重新加载插件的配置文件,应用最新的配置更改。/customservernameapi reload
/customservernameapi update name <新的服务器名称>更新服务器的名称。如果开启了自动生成别名功能,且新名称符合条件,会自动更新别名。/customservernameapi update name "My New Server"
/customservernameapi update alias <新的服务器别名>更新服务器的别名。/customservernameapi update alias "New Alias"
/customservernameapi update autogeneratealias切换自动生成别名功能的开关状态。注意:若设置的内容为中文或其他非ASCII字符,则自动生成别名功能将失效。/customservernameapi update autogeneratealias
/customservernameapi togglepersist切换变量持久化功能的开关状态。/customservernameapi togglepersist
/customservernameapi info查询配置文件中的各个设置项状态,包括配置文件版本、服务器名称、别名、自动生成别名功能开关和持久化开关等。/customservernameapi info
/customservernameapi help显示与一级默认命令相同的帮助信息。/customservernameapi help


权限节点
本插件无普通用户权限,所有权限统一为 customservernameapi.admin
安装与配置

[*]安装:将插件的jar文件放置在Bukkit服务器的plugins文件夹中,重启服务器即可完成安装。
[*]配置:

[*]首次启动插件时,会自动生成默认配置文件config.yml。
[*]配置文件中包含服务器名称、别名、自动生成别名开关、持久化开关等配置项,可以根据需求进行修改。
[*]在你想要显示内容的地方加入%customservername%(服务器名称)或%customservername_alias%(别名),即可显示内容


注意事项

[*]使用自动生成别名功能时,若设置的名称为中文或其他非ASCII字符,该功能将失效。
[*]在更新配置文件时,尽量避免手动修改配置文件中的版本号,以免影响插件的自动更新机制。
[*]插件的所有功能需要管理员权限才能使用,确保具有customservernameapi.admin权限节点。
[*]配置文件就版本号请勿修改,可能会导致插件无法使用


兼容性 本插件尽量保证与不同版本的 Bukkit 和 Spigot 服务器兼容,但由于不同版本的 API 可能存在差异,建议在使用前进行测试,理论支持全版本。
插件截图(流量慎入)


计分板效果:

支持颜色代码:




关于开源
本插件使用MIT开源协议,你可以自由分发、修改代码内容,但请保留版权信息



YanRan233 发表于 2025-4-5 12:01:37

感谢楼主分享,制作辛苦了[哔哩_打call]
页: [1]
查看完整版本: CustomServerNameAPI-一款轻量化的自定义服务器名称PAPI插件化拓展