Maintenance

Maintenance v2.0.0 Release Notes

This is a major update featuring numerous new features, including scheduled maintenance periods and full multilingual support, along with extensive bug fixes and security improvements.

Important Notes When Updating

• Permission nodes have been changed. In addition to maintenance.admin, a new maintenance.bypass permission has been added. Administrators with maintenance.admin automatically receive maintenance.bypass. If you manage permissions individually through a permissions plugin, please review your existing permission assignments.

• The structure of config.yml has been changed. Existing configuration files will automatically have the new settings added when the plugin starts, so no manual migration is required.

New Features

• Scheduled Maintenance: Use /maintenance on <duration> [reason] to specify when maintenance should end. Example: /maintenance on 30m Server update

• Automatic Maintenance End: Maintenance mode automatically ends when the specified duration has elapsed.

• Automatic Countdown Announcements: Countdown messages are automatically broadcast before maintenance ends, including 1 hour, 30 minutes, 10 minutes, 5 minutes, 1 minute, 30 seconds, and more.

• Schedule Persistence: Scheduled maintenance retains its remaining time across server restarts and resumes automatically.

• Maintenance Reason: A reason can be specified when starting maintenance and is displayed on the kick screen and server status.

• /maintenance reload: Reload config.yml and language files without restarting the server.

• /maintenance status: Display the current maintenance status, reason, and remaining time.

• /maintenance help: Display the available commands.

• Tab Completion: Automatically suggest subcommands and duration formats using the Tab key.

• maintenance.bypass Permission: Staff members who do not have permission to manage maintenance can be individually granted access to join the server during maintenance.

• Hex Color Support: All messages now support &#RRGGBB hex color codes.

• Enhanced Server List Display: While maintenance mode is active, the player count is hidden and a warning banner is displayed in the version section.

• Full Multilingual Support: All kick, command, and broadcast messages are available in English and Japanese and automatically follow the player's client language.

• Modrinth Update Notifications: OPs are notified when a new version is released. Notifications can be disabled in config.yml, and the Modrinth project ID can be customized.

Bug Fixes & Improvements

• Fixed an issue where the maintenance kick reason could overwrite a login rejection already made by another plugin.

• Fixed an issue where new settings were not added to config.yml after updating the plugin. Configuration files now support automatic merging.

• Fixed an issue where command messages were hardcoded in English. All messages are now fully managed through language files.

• Replaced deprecated APIs such as kickPlayer(String) with the latest Adventure Component API.

• Fixed resource processing that could cause Japanese language files to become corrupted during the build process by explicitly enforcing UTF-8 encoding.

• Eliminated the possibility of NullPointerException caused by null configuration values by providing default values for all settings.

Technical Changes

• Updated the Paper API to 1.21.11-R0.1-SNAPSHOT with Java 21 builds.

• Centralized plugin version management in Maven, eliminating duplicate version definitions between pom.xml and plugin.yml.

• Refactored the codebase by separating responsibilities into dedicated components:

  • MaintenanceManager
  • MaintenanceTabCompleter
  • UpdateChecker
  • DurationUtil

Commands

Command	Description
/maintenance on [duration] [reason]	Enable maintenance mode
/maintenance off	Disable maintenance mode
/maintenance status	Display the current status
/maintenance reload	Reload configuration and language files
/maintenance help	Display the list of commands

Permissions

Permission	Description	Default
maintenance.admin	Manage maintenance mode (includes bypass access)	OP
maintenance.bypass	Allows joining the server during maintenance	OP