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

落***

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开源协议，你可以自由分发、修改代码内容，但请保留版权信息

YanR***

感谢楼主分享，制作辛苦了