KartaWorldReset Plugin

KartaWorldReset is a powerful, easy-to-use Minecraft plugin that automatically resets worlds on a customizable schedule, helping maintain a fresh and optimized gameplay environment for players.

Features

• Scheduled Resets: Configure worlds to reset daily, weekly, or monthly at a specific time.
• Multi-world Support: Specify multiple worlds to be reset simultaneously.
• Dynamic World Management: Add or remove worlds from the reset list directly via in-game commands.
• Customizable Messages: Almost all plugin messages can be customized through the config.yml.
• PlaceholderAPI Support: Display countdown timers and reset information on scoreboards, boss bars, and more.
• Lobby System: Set a safe lobby world for players to be teleported to before a world reset occurs.
• Permission-Based Commands: Fine-grained control over who can use administrative commands.

Commands

The main command is /kartaworldreset, which can be aliased with /kwr.

Command	Description	Permission
/kwr help	Displays the help message.	(none)
/kwr info	Shows the time remaining until the next reset.	(none)
/kwr info clock	Shows the current system time.	(none)
/kwr info setting	Shows the current configuration settings.	kartaworldreset.admin
/kwr info worldlist	Shows the list of worlds to be reset.	kartaworldreset.admin
/kwr reload	Reloads the plugin's configuration file.	kartaworldreset.admin
/kwr autogen	Automatically generates the nextReset date.	kartaworldreset.admin
/kwr addworld <world>	Adds a world to the reset list.	kartaworldreset.admin
/kwr removeworld <world>	Removes a world from the reset list.	kartaworldreset.admin
/kwr papi reload	Reloads the PlaceholderAPI expansion.	kartaworldreset.admin
/kwr reset	Manually resets the worlds in the list.	kartaworldreset.admin

Permissions

Permission	Description
kartaworldreset.admin	Grants access to all administrative commands.

PlaceholderAPI Placeholders

Placeholder	Description
%kartaworldreset_normal%	Shows the time left until the next reset in a long format (e.g., "1 week 2 days 3 hours").
%kartaworldreset_nextReset%	Shows the exact date and time of the next reset.
%kartaworldreset_short%	Shows the time left until the next reset in a short format (e.g., "dd:hh:mm:ss").

Configuration (config.yml)

The configuration is split into several sections.

Main Configuration

Config:
  # Set the reset frequency.
  # d = day, w = week, m = month
  every: 1w
  # Set the time of day for the reset (24-hour format).
  time: "00:00"

Save:
  # The date of the next reset.
  # Can be left null to be auto-generated on the first run.
  # Format: dd-MM-yyyy
  nextReset: null

Worlds:
  # A list of worlds to be reset.
  - your_world

Lobby:
  # The world to teleport players to before the reset.
  # Set to null to teleport players to their bed or the main world.
  - world

Message Customization

All user-facing messages can be customized in the Messages section. You can use standard Bukkit color codes (&a, &b, etc.).
New messages for the addworld and removeworld commands have been added.

Messages:
  reload: "&a[KartaWorldReset] Configuration reloaded!"
  autogen: "&a[KartaWorldReset] Autogen complete!"
  papi-reloaded: "&a[KartaWorldReset] PAPI Registered!"
  papi-failed: "&c[KartaWorldReset] PAPI Register is failed!"
  no-permission: "&cYou don't have permission to do that."
  world-list: "&eWorldlist : &f[%worlds%]"
  lobby: "&eLobby : &f%lobby%"
  world-added: "&aWorld %world% has been added to the list."
  world-removed: "&aWorld %world% has been removed from the list."
  world-already-exists: "&cWorld %world% is already in the list."
  world-not-found: "&cWorld %world% is not in the list."
  add-world-usage: "&cUsage: /kwr addworld <world>"
  remove-world-usage: "&cUsage: /kwr removeworld <world>"
  help:
    - "&eKartaWorldReset Plugin"
    - "&e[Usages]:"
    - "&f/kwr reload &7- &aReload config plugin (Admin)"
    - "&f/kwr autogen &7- &aAuto generate config (Admin)"
    - "&f/kwr addworld <world> &7- &aAdd world to reset list (Admin)"
    - "&f/kwr removeworld <world> &7- &aRemove world from reset list (Admin)"
    - "&f/kwr info &7- &aShow time left"