# RegionRestore<\/p>\n
**High-Performance World Region Restoration for Paper\/Folia Servers**<\/p>\n
RegionRestore is a powerful, performance-focused plugin designed to restore parts of your world back to their original
\nstate at exceptional speeds. Whether you’re managing PvP arenas, mini-game lobbies, or need reliable world state resets,
\nRegionRestore delivers sub-10ms restoration for small regions while maintaining server stability even for massive
\noperations.<\/p>\n
—<\/p>\n
## Why RegionRestore?<\/p>\n
### Lightning-Fast Restores<\/p>\n
Small regions (like duels arenas) restore in **under 10 milliseconds**, ensuring minimal disruption to gameplay.<\/p>\n
### Chunk Streaming Technology<\/p>\n
Large restores use intelligent **chunk-by-chunk streaming** that progressively loads and restores chunks rather than
\nloading everything at once. This prevents overloading Minecraft’s chunk system and maintains consistent TPS even during
\nextensive restoration operations.<\/p>\n
### Instant Light Restoration<\/p>\n
Unlike other solutions that trigger expensive light recalculation, RegionRestore features **instant light restore**
\ntechnology. This dramatically reduces CPU usage during restoration operations and eliminates the lag spikes commonly
\nassociated with lighting updates.<\/p>\n
### Perfect for Arena Management<\/p>\n
Ideal for:<\/p>\n
– **PvP Duels Arenas** – Instant reset between matches
\n– **Mini-Game Lobbies** – Restore lobby state after each game
\n– **Event Arenas** – Reset builds, terrain, and structures
\n– **Practice Arenas** – Fast environment resets
\n– **Plot Worlds** – Mass plot regeneration<\/p>\n
—<\/p>\n
## Supported Versions<\/p>\n
| Platform | Supported Versions |
\n|———-|——————–|
\n| Paper | 1.21.4 – 26.1.1 |
\n| Folia | 1.21.4 – 26.1.1 |<\/p>\n
### Minecraft Version Support<\/p>\n
RegionRestore uses NMS adapters for maximum performance on specific versions:<\/p>\n
– 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1-26.1.1<\/p>\n
> **Note:** The plugin requires a matching NMS adapter for your server version. Updates are released shortly after new
\n> Minecraft versions.<\/p>\n
—<\/p>\n
## Dependencies<\/p>\n
A PaperMC based server (eg Paper, Purpur)<\/p>\n
### Optional <\/p>\n
– **PlaceholderAPI** – Access RegionRestore data via `%regionrestore_*%` placeholders —<\/p>\n ## Placeholders<\/p>\n | Placeholder | Description | | Placeholder | Description | —<\/p>\n ## Commands<\/p>\n All commands use `\/regionrestore` (or aliases `\/rr`, `\/arena`, `\/arenas`).<\/p>\n | Command | Description | Permission | The GUI provides visual management of templates, instances, pools, and timers with intuitive menu navigation.<\/p>\n<\/details>\n | Command | Description | Permission | **Versioning System:** Templates support multiple versions, allowing you to maintain different snapshots of the same | Command | Description | Permission | **Audience Scopes:**<\/p>\n – `NEARBY` – Notify players within configured radius | Command | Description | Permission | **Instance Types:**<\/p>\n – **Pooled** – Auto-managed instances for mass cloning **Instance Options:**<\/p>\n – `boot` – Restore on server startup | Command | Description | Permission | **Mass Cloner:** Automatically manages multiple copies (instances) of a template across configured worlds. Perfect for | Command | Description | Permission | | Command | Description | Permission | **Using the Selection Wand:**<\/p>\n – Right-click to set positions (alternates between pos1 and pos2) —<\/p>\n ## Scheduling Features<\/p>\n RegionRestore provides a comprehensive scheduling system that allows you to automate restores based on various triggers Schedule restores to happen after a countdown delay with automatic player notifications. This allows you to schedule “` **Features:**<\/p>\n – **Scheduled Restore** – Delay restoration by specified seconds **Example – Schedule arena restore in 30 seconds:**<\/p>\n “` Announces to all players: “Restoring region in 30 seconds…” counting down to “Restoring region in 1 second…”<\/p>\n **Tip:** Use this for scheduled maintenance, event endings, or to give players time to finish their current activity Set up automatic periodic restores for instances or templates.<\/p>\n “` **Features:**<\/p>\n – **Instance-Based** – Timer follows a specific region instance **Use Cases:**<\/p>\n – Event arenas that reset every 5 minutes **Cancellation:**<\/p>\n “` Automatically restore regions when the server starts.<\/p>\n **Configuration:**<\/p>\n “`hocon **Instance-Level:**<\/p>\n “` (5th parameter `true` enables boot restore)<\/p>\n **Use Cases:**<\/p>\n – Reset all arenas on server restart Automatically restore a region when all players leave it.<\/p>\n **How It Works:**<\/p>\n – Tracks player occupancy in real-time **Configuration:**<\/p>\n “`hocon **Instance-Level:**<\/p>\n “` (6th parameter `true` enables vacate restore)<\/p>\n **Configuration Options:**<\/p>\n “`hocon **Use Cases:**<\/p>\n – Duels\/PvP arenas that auto-reset after matches Prevent server overload with intelligent concurrent restore limiting.<\/p>\n **Configuration:**<\/p>\n “`hocon **Behavior:**<\/p>\n – When limit is reached, new restores are skipped with configurable notification **Notification:** **Example 1: Duels Arena with Vacate**<\/p>\n “`hocon **Example 2: Event Arena with Repeating Timer**<\/p>\n “` # Set 5-minute repeating timer with WORLD notifications **Example 3: Lobby with Boot + Timer**<\/p>\n “`hocon **Example 4: Silent Background Restore**<\/p>\n “` —<\/p>\n ## Permissions<\/p>\n | Permission | Description | Default | —<\/p>\n ## Use Cases<\/p>\n ### Duels Server<\/p>\n Create a pool of 50 identical PvP arenas that auto-restore when players leave:<\/p>\n “`hocon ### Event Arena<\/p>\n Restore an arena on a timer with countdown announcements:<\/p>\n “` ### Practice Server<\/p>\n Instantly reset practice arenas between rounds:<\/p>\n “` ### Plot World<\/p>\n Mass regenerate all plots on server restart:<\/p>\n “`hocon —<\/p>\n ## Performance Notes<\/p>\n – **Small Regions** (< 100 chunks): Sub-10ms restore times\n- **Large Regions**: Uses chunk streaming to maintain TPS\n- **Light Updates**: Restore original light by default (instant light restore)\n- **Async Operations**: Optional fully async restoration\n- **Chunk Unloading**: Automatic cleanup prevents memory leaks\n\n---\n\n## Support\n\nFor support, feature requests, or bug reports, please use the GitHub issue tracker.\n\n**Website:** https:\/\/github.com\/bruhmomen69\/OpenProjects\n**Discord:** https:\/\/discord.gg\/A6NG8DaAb7\n\n---\n\n*RegionRestore - Restore your worlds at the speed of gameplay.*\n\n<\/p>\n","protected":false},"excerpt":{"rendered":" Restore world regions\/chunks to their original state at fast speeds, maintaining performance even during massive operations. Use it for PvP arenas and mini-games that need instant, lag-free resets.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"regionrestore","_minecraft_project_id":"UxNhPoD2","_minecraft_author":"bruhmoment69","_minecraft_license":"AGPL-3.0-or-later","_minecraft_downloads":58,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"regionrestore.zip","_minecraft_size_bytes":125216114,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-15T20:50:23.700866Z","_minecraft_date_created":"2026-01-31T21:08:07.919000Z","_minecraft_date_modified":"2026-04-05T22:58:23.058945Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/regionrestore","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-07T17:55:10+00:00","_minecraft_import_hash":"aef7a47698cd106142890def75cc1b4a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,89,126,127,128,92],"mod_loader":[131,132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167],"class_list":["post-131406","mod","type-mod","status-publish","hentry","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1"],"yoast_head":"\n
\n– **MiniPlaceholders** – Use `PlaceholderAPI Placeholders<\/strong><\/summary>\n
\n|—————————————————-|————————————-|
\n| `%regionrestore_instance_count%` | Total number of instances |
\n| `%regionrestore_instance_count_pooled%` | Count of pooled instances |
\n| `%regionrestore_instance_count_manual%` | Count of manual instances |
\n| `%regionrestore_instance_count_
\n| `%regionrestore_template_count%` | Total number of templates |
\n| `%regionrestore_template_
\n| `%regionrestore_template_
\n| `%regionrestore_pool_count%` | Total number of configured pools |
\n| `%regionrestore_pool_
\n| `%regionrestore_pool_
\n| `%regionrestore_pool_
\n| `%regionrestore_instance_
\n| `%regionrestore_instance_
\n| `%regionrestore_instance_
\n| `%regionrestore_instance_
\n| `%regionrestore_instance_
\n| `%regionrestore_instance_
\n| `%regionrestore_instance_
\n| `%regionrestore_instance_
\n| `%regionrestore_instance_
\n| `%regionrestore_instance_
\n| `%regionrestore_instance_
\n| `%regionrestore_instance_MiniPlaceholders Placeholders<\/strong><\/summary>\n
\n|———————————————————–|——————————-|
\n| `
\n| `
\n| `
\n| `
\n| `
\n| `
\n| `
\n| `
\n| `
\n| `
\n| `GUI Command<\/strong><\/summary>\n
\n|———–|————————————-|———————|
\n| `\/rr gui` | Open the interactive management GUI | `regionrestore.gui` |<\/p>\nTemplate Commands<\/strong><\/summary>\n
\n|——————————————————————|———————————————-|————————————|
\n| `\/rr template create
\n| `\/rr template list` | List all saved templates | `regionrestore.template.list` |
\n| `\/rr template info
\n| `\/rr template setactive
\n| `\/rr template delete
\nregion. The “active” version is used by default for restores.<\/p>\n<\/details>\nRestore Commands<\/strong><\/summary>\n
\n|———————————————————–|——————————————-|—————————|
\n| `\/rr restore [version\/active] [scope]` | Restore template at its original position | `regionrestore.restore` |
\n| `\/rr restore at
\n| `\/rr restore in
\n| `\/rr restore version [version\/active] [scope]` | Restore specific version | `regionrestore.restore` |<\/p>\n
\n– `WORLD` – Notify all players in the world
\n– `SERVER` – Notify all online players
\n– `NONE` – Silent restore<\/p>\n<\/details>\nInstance Commands<\/strong><\/summary>\n
\n|————————————————————————————————-|———————————-|———————————-|
\n| `\/rr instance create
\n| `\/rr instance list all` | List all instances | `regionrestore.instance.list` |
\n| `\/rr instance list world
\n| `\/rr instance info
\n| `\/rr instance delete
\n| `\/rr instance restore
\n– **Manual** – Individually created and managed instances<\/p>\n
\n– `vacate` – Restore when all players leave
\n– `interval` – Auto-restore interval in seconds<\/p>\n<\/details>\nCloner (Pool) Commands<\/strong><\/summary>\n
\n|—————————————–|————————————|——————————–|
\n| `\/rr cloner status [world]` | View pool status and configuration | `regionrestore.cloner.status` |
\n| `\/rr cloner restore [world] [template]` | Trigger restore for pool instances | `regionrestore.cloner.restore` |
\n| `\/rr cloner regen [world] [–force]` | Regenerate all pool instances | `regionrestore.cloner.regen` |<\/p>\n
\nduels servers that need dozens or hundreds of identical arenas.<\/p>\n<\/details>\nTimer Commands<\/strong><\/summary>\n
\n|——————————————————————-|———————————————|——————————|
\n| `\/rr timer set instance
\n| `\/rr timer set template
\n| `\/rr timer cancel id
\n| `\/rr timer cancel template-all Selection Commands<\/strong><\/summary>\n
\n|——————————-|—————————————-|———————————|
\n| `\/rr selection wand` | Get the selection wand item | `regionrestore.wand` |
\n| `\/rr selection` | View current selection info | `regionrestore.selection` |
\n| `\/rr selection clear` | Clear your selection | `regionrestore.selection` |
\n| `\/rr selection create
\n– Left-click to view current selection info
\n– Supports cross-world selection detection<\/p>\n<\/details>\n
\nand conditions.<\/p>\nCountdown Scheduling (Delayed\/Scheduled Restores)<\/strong><\/summary>\n
\nrestores for a future time and warn players before restoration occurs.<\/p>\n
\n\/rr restore in
\n“`<\/p>\n
\n– **Configurable Announce Points** – Notify players at specific intervals (default: 60, 30, 10, 5, 4, 3, 2, 1 seconds)
\n– **Audience Scope Control** – Choose who receives countdown notifications:
\n – `NEARBY` – Players within configured radius
\n – `WORLD` – All players in the world
\n – `SERVER` – All online players
\n – `NONE` – Silent countdown
\n– **Plurality-Aware Messages** – Automatic “second\/seconds” grammar<\/p>\n
\n\/rr restore in my_arena 30 WORLD
\n“`<\/p>\n
\nbefore the restore.<\/p>\n<\/details>\nRepeating\/Interval Scheduling<\/strong><\/summary>\n
\n\/rr timer set instance
\n\/rr timer set template
\n“`<\/p>\n
\n– **Template-Based** – Creates a hidden instance at template’s original location
\n– **Persistent** – Timers survive server restarts
\n– **Configurable Scope** – Per-timer audience notification settings<\/p>\n
\n– Practice arenas that auto-reset every 60 seconds
\n– Lobby areas that refresh periodically<\/p>\n
\n\/rr timer cancel id
\n\/rr timer cancel template-all
\n“`<\/p>\n<\/details>\nBoot Restoration<\/strong><\/summary>\n
\nmass-cloner {
\n worlds=[
\n {
\n name=”duels_world”
\n pools=[
\n {
\n template-name=”classic_arena”
\n restore-on-boot=true
\n }
\n ]
\n }
\n ]
\n}
\n“`<\/p>\n
\n\/rr instance create
\n“`<\/p>\n
\n– Ensure plots are clean after maintenance
\n– Restore event areas to known state<\/p>\n<\/details>\nVacate Restoration<\/strong><\/summary>\n
\n– Monitors chunk movements, teleports, world changes, joins, and quits
\n– Triggers restore after all players have left + configurable delay<\/p>\n
\nmass-cloner {
\n worlds=[
\n {
\n name=”duels_world”
\n pools=[
\n {
\n template-name=”classic_arena”
\n restore-on-vacate=true
\n }
\n ]
\n }
\n ]
\n}
\n“`<\/p>\n
\n\/rr instance create
\n“`<\/p>\n
\nmass-cloner {
\n vacate-delay-seconds=5 # Delay after last player leaves before restoring
\n}
\n“`<\/p>\n
\n– Mini-game instances that clean up when finished
\n– Private arenas that refresh between uses<\/p>\n<\/details>\nConcurrent Restore Management<\/strong><\/summary>\n
\nrestore {
\n max-concurrent-restores=5 # Maximum simultaneous restores
\n}
\n“`<\/p>\n
\n– Prevents TPS drops from too many simultaneous chunk operations
\n– Restores automatically queue and execute when slots become available<\/p>\n
\nPlayers receive a message explaining why the restore was skipped:
\n> “Region restore skipped: maximum concurrent restores (5) reached”<\/p>\n<\/details>\nScheduling Configuration Examples<\/strong><\/summary>\n
\nmass-cloner {
\n vacate-delay-seconds=3 # 3 second delay after last player leaves
\n worlds=[
\n {
\n name=”duels”
\n pools=[
\n {
\n template-name=”1v1_arena”
\n count=20
\n restore-on-vacate=true
\n restore-on-boot=false
\n }
\n ]
\n }
\n ]
\n}
\n“`<\/p>\n
\n# Create instance at specific location
\n\/rr instance create event_arena 100 100 events 0 false false<\/p>\n
\n\/rr timer set instance
\n“`<\/p>\n
\nmass-cloner {
\n worlds=[
\n {
\n name=”lobby”
\n pools=[
\n {
\n template-name=”main_lobby”
\n count=1
\n restore-on-boot=true
\n restore-interval-seconds=3600 # Restore every hour
\n }
\n ]
\n }
\n ]
\n}
\n“`<\/p>\n
\n# Restore with no notifications
\n\/rr restore in silent_arena 10 NONE
\n“`<\/p>\n<\/details>\nComplete Permission List<\/strong><\/summary>\n
\n|————————————|————————————–|———|
\n| `regionrestore.*` | Grants all RegionRestore permissions | OP |
\n| `regionrestore.gui` | Open the management GUI | OP |
\n| `regionrestore.template.create` | Create templates | OP |
\n| `regionrestore.template.list` | List templates | OP |
\n| `regionrestore.template.info` | View template info | OP |
\n| `regionrestore.template.setactive` | Set active version | OP |
\n| `regionrestore.template.delete` | Delete templates | OP |
\n| `regionrestore.restore` | Restore templates | OP |
\n| `regionrestore.restorein` | Schedule timed restores | OP |
\n| `regionrestore.instance.create` | Create instances | OP |
\n| `regionrestore.instance.list` | List instances | OP |
\n| `regionrestore.instance.info` | View instance info | OP |
\n| `regionrestore.instance.delete` | Delete instances | OP |
\n| `regionrestore.instance.restore` | Trigger instance restore | OP |
\n| `regionrestore.cloner.status` | View cloner status | OP |
\n| `regionrestore.cloner.restore` | Trigger pool restores | OP |
\n| `regionrestore.cloner.regen` | Regenerate pools | OP |
\n| `regionrestore.timer.set` | Set restore timers | OP |
\n| `regionrestore.timer.cancel` | Cancel timers | OP |
\n| `regionrestore.wand` | Use selection wand | OP |
\n| `regionrestore.selection` | Manage selections | OP |<\/p>\n<\/details>\nExample Configuration<\/strong><\/summary>\n
\nmass-cloner {
\n worlds=[
\n {
\n name=”duels_world”
\n pools=[
\n {
\n template-name=”classic_arena”
\n count=50
\n separation-chunks=10
\n restore-on-vacate=true
\n }
\n ]
\n }
\n ]
\n}
\n“`
\n<\/details>\n
\n\/rr timer set template event_arena 300 SERVER
\n“`<\/p>\n
\n\/rr restore template my_arena
\n“`<\/p>\nExample Configuration<\/strong><\/summary>\n
\nmass-cloner {
\n worlds=[
\n {
\n name=”plot_world”
\n pools=[
\n {
\n template-name=”default_plot”
\n count=100
\n restore-on-boot=true
\n }
\n ]
\n }
\n ]
\n}
\n“`
\n<\/details>\n