Home

📖 DimensionsReset Wiki & Guide

Welcome to the official wiki for DimensionsReset! This guide contains everything you need to know to become an expert at managing your server's worlds.

Quick Links

• Getting Started
  • Installation
  • Commands & Permissions
• Feature Guides
  • Dimension Resets (Manual & Scheduled)
  • Automated Scheduler
  • The GUI Control Panel
  • Preview System
• Configuration Deep Dive
• Frequently Asked Questions (FAQ)

---

🚀 Getting Started

This section will get you up and running in minutes.

Installation

1. Download the latest stable release from the project's Releases page.
2. Place the downloaded .jar file into your server's /plugins directory.
3. Start or restart your server.
4. The plugin will generate a plugins/DimensionsReset/ folder containing the config.yml and data.yml files. You are now ready to go!

📋 Commands & Permissions

The main command is /dr with aliases /dims and /dreset.

Command	Description	Permission
/dr gui	Opens the main control panel GUI.	dimensionsreset.admin
/dr reset <dim|all> <time|now>	Schedules or initiates a reset for a dimension.	dimensionsreset.admin
/dr cancel <dim|all>	Cancels a scheduled reset for a dimension.	dimensionsreset.admin
/dr status <dim|all>	Checks the time remaining on a scheduled reset.	dimensionsreset.admin
/dr confirm	Confirms an instant manual reset.	dimensionsreset.admin
/dr preview <dim|seed> [before|exit]	Enters preview mode or checks the world seed.	dimensionsreset.preview
/dr reload	Reloads the config.yml file from disk.	dimensionsreset.reload

💡 Tip: All permissions default to server operators (OPs).

---

✨ Feature Guides

A deep dive into the powerful features of DimensionsReset.

Dimension Resets

This is the core of the plugin. You can reset the_end, the_nether, or both at once.

• Instant Reset: Use /dr reset the_end now. This will require a confirmation with /dr confirm.
• Timed Reset: Use /dr reset the_nether 1h30m. This will schedule the reset to happen in 1 hour and 30 minutes, broadcasting announcements along the way.
• Multi-Reset: You can reset multiple dimensions at once.
  • /dr reset the_end,the_nether now
  • /dr reset all 12h (The all keyword uses the list from reset-all-dimensions in your config.yml).

✅ No Restarts Needed! This plugin uses an advanced Portal Interception system. After a dimension is reset, the plugin temporarily takes control of portals to ensure players are teleported correctly to the new world without requiring a full server restart.

Automated Scheduler

This is the "set it and forget it" feature for ultimate server automation. You can define multiple schedules in the automated_resets.schedules section of your config.yml.

• Interval-Based: Perfect for weekly or bi-weekly resets. The timer starts from the moment the last automated reset was completed.

  schedule:
    type: "INTERVAL"
    value: "7d" # Resets every 7 days.

• Day & Time-Based: Perfect for scheduling resets at a specific time when your server has low traffic.

  schedule:
    type: "DAY_AND_TIME"
    value: "FRIDAY-22:00" # Resets every Friday at 10:00 PM (server time).

Note: The plugin tracks the last reset time for each schedule ID in the data.yml file to ensure the timing is correct even if the server restarts.

🖥️ The GUI Control Panel

For those who prefer menus over commands, /dr gui opens an intuitive control panel.

• Main Menu: Gives you access to all major functions like Reset, Status, and Cancel.
• Sub-Menus: Clicking "Reset a Dimension" will open a second menu allowing you to choose between The End, The Nether, or All.
• Safe & Easy: Clicking a reset button in the GUI will trigger the same safe confirmation flow as the now command, preventing accidents.

🔭 Preview System

• Preview Before: Use /dr preview the_end before to enter spectator mode and fly around the current End dimension. This is perfect for checking if a world needs a reset. Use /dr preview the_end exit to return to your original location and gamemode.
• Preview "After" (Seed): Use /dr preview seed to get the server's main world seed. Because all new dimensions are generated using this seed, you can use it in single-player or online tools to see what the terrain layout of the next reset will look like.

---

⚙️ Configuration Deep Dive (config.yml)

Your config.yml file allows for deep customization.

• automated_resets: This is where you enable/disable the automation system and build your list of recurring schedules.
• reset-all-dimensions: Defines which worlds are included in the /dr reset all command.
• dimension_reset_messages: All messages related to the core reset commands. The %dimension% and %time% placeholders are available.
• preview: All messages for the preview system.
• generic_messages: General messages like "no permission".
• countdown_broadcast_times: A list of times (in seconds) before a reset to send a countdown alert.
• sounds: Lets you customize the sound effects for key events. Find sound keys on the Minecraft Wiki.

---

❓ FAQ & Troubleshooting

• Q: I reset The End, but the Ender Dragon didn't come back!

  • A: Correct. This plugin only resets the world terrain and entities. It does not interfere with Minecraft's vanilla dragon fight progression. To respawn the dragon, you must use the vanilla method with End Crystals.

• Q: Can I reset my main Overworld?

  • A: No. This plugin is designed to safely reset secondary dimensions like The End and The Nether. Attempting to reset the main overworld while the server is running is extremely dangerous and can lead to world corruption. For that, you must stop the server and delete the world folder manually.

• Q: The automated scheduler didn't run my reset.

  • A: Check three things: 1) Ensure automated_resets.enabled is true in your config. 2) Check your server console for any errors related to an invalid schedule format. 3) Check your data.yml to see the timestamp of the last reset; the next one will be based on that time.

Thank you for using DimensionsReset!