ServerPropertiesReload
ServerPropertiesReload 是由 DFD3 开发的一款轻量级 Paper 插件,帮助服务器管理员在不重启整个服务器的情况下预览并应用受支持的 server.properties 更改。
该插件旨在保持简单、安全且高效。它不使用通用的服务器重载系统、不必要的后台任务或持续轮询机制。相反,它会验证配置更改,并在运行时仅应用明确支持设置。
功能
- 预览更改: 在应用之前查看检测到的配置更改
- 安全重载: 验证后应用受支持的运行时设置
- 重启通知: 识别需要重启服务器的设置,而不是声称它们已被应用
- 状态命令: 查看最新操作的结果和详细信息
- 可配置命令: 通过
config.yml 自定义主命令
- 自定义消息: 通过
messages.yml 编辑插件消息
- 可配置音效: 为重载成功、错误、需要重启的设置以及未更改的配置设置不同的音效
- 小型大写字体: 在支持的情况下可选使用 Unicode 小型大写英文文本
- 最新操作日志: 将最近相关操作的详细信息存储在
logs/latest.log 中
- 轻量设计: 无需不必要的后台任务或持续文件检查
命令
/spr preview — 预览检测到的更改而不应用它们
/spr reload — 验证配置并应用受支持的运行时更改
/spr status — 查看最新操作结果、时间和更改数量
/spr about — 显示插件信息、开发者及版本
主命令可在 config.yml 中更改。上述示例使用的是默认命令 spr。
文件结构
该插件将配置、消息和操作日志分别组织存放。
plugins/
└── ServerPropertiesReload/
├── config.yml
├── messages.yml
└── logs/
└── latest.log
config.yml
包含插件的主要设置,包括命令名称、字体选项和音效配置。
messages.yml
包含面向玩家的 configurable 消息、命令响应、验证错误和操作报告。
logs/latest.log
包含最近相关操作的详细信息,包括其结果和检测到的更改。旨在避免积累大量的历史操作日志。
安全性与兼容性
ServerPropertiesReload 使用显式属性白名单,仅允许在运行时安全应用的属性。对于需要重启或在服务器运行时无法可靠更改的属性,插件会相应地报告。
在 server.properties 中更改值并不意味着正在运行的服务器已采纳该值。插件会报告实际应用的内容,并且不会声称对不支持的更改成功。
该插件针对 Paper 服务器,旨在支持 Minecraft Java Edition 1.21 至开发期间可用的最新稳定版本。兼容性声明应仅限于实际测试过的版本。
关于
插件: ServerPropertiesReload
描述: 轻量级属性管理器
开发者: DFD3
专为希望以清晰且轻量级的方式管理受支持的服务器属性而无需不必要重启的服务器管理员构建。67
ServerPropertiesReload
ServerPropertiesReload is a lightweight Paper plugin developed by DFD3 that helps server administrators preview and apply supported server.properties changes without restarting the entire server.
The plugin is designed to be simple, safe, and efficient. It does not use a generic server reload system, unnecessary background tasks, or continuous polling. Instead, it validates configuration changes and applies only settings that are explicitly supported at runtime.
Features
- Preview Changes: Review detected configuration changes before applying them
- Safe Reload: Apply supported runtime settings after validation
- Restart Notifications: Identify settings that require a server restart instead of claiming they were applied
- Status Command: View the result and details of the latest operation
- Configurable Commands: Customize the main command through
config.yml
- Custom Messages: Edit plugin messages through
messages.yml
- Configurable Sounds: Set different sounds for successful reloads, errors, restart-required settings, and unchanged configurations
- Small Caps Font: Optionally use Unicode small-capital English text where supported
- Latest Operation Log: Store details of the most recent relevant operation in
logs/latest.log
- Lightweight Design: No unnecessary background tasks or constant file checks
Commands
/spr preview — Preview detected changes without applying them
/spr reload — Validate the configuration and apply supported runtime changes
/spr status — View the latest operation result, time, and change counts
/spr about — Display plugin information, developer, and version
The main command can be changed in config.yml. The examples above use the default command, spr.
File Structure
The plugin keeps its configuration, messages, and operation logs organized separately.
plugins/
└── ServerPropertiesReload/
├── config.yml
├── messages.yml
└── logs/
└── latest.log
config.yml
Contains the plugin's main settings, including the command name, font option, and sound configuration.
messages.yml
Contains configurable player-facing messages, command responses, validation errors, and operation reports.
logs/latest.log
Contains details of the latest relevant operation, including its result and detected changes. It is designed to avoid accumulating large historical operation logs.
Safety and Compatibility
ServerPropertiesReload uses an explicit allowlist of properties that can be safely applied at runtime. Properties that require a restart or cannot be reliably changed while the server is running are reported accordingly.
Changing a value in server.properties does not automatically mean the running server has adopted that value. The plugin reports what it actually applied and does not claim success for unsupported changes.
The plugin targets Paper servers and aims to support Minecraft Java Edition 1.21 through the latest stable version available during development. Compatibility claims should be limited to versions that have actually been tested.
About
Plugin: ServerPropertiesReload
Description: Lightweight Properties Manager
Developer: DFD3
Built for server administrators who want a clear and lightweight way to manage supported server properties without unnecessary restarts. 67
评论 0
登录后参与评分
还没有评论,来抢沙发吧