RegionRestore

# RegionRestore **High-Performance World Region Restoration for Paper/Folia Servers** RegionRestore is a powerful, performance-focused plugin designed to restore parts of your world back to their original state at exceptional speeds. Whether you're managing PvP arenas, mini-game lobbies, or need reliable world state resets, RegionRestore delivers sub-10ms restoration for small regions while maintaining server stability even for massive operations. --- ## Why RegionRestore? ### Lightning-Fast Restores Small regions (like duels arenas) restore in **under 10 milliseconds**, ensuring minimal disruption to gameplay. ### Chunk Streaming Technology Large restores use intelligent **chunk-by-chunk streaming** that progressively loads and restores chunks rather than loading everything at once. This prevents overloading Minecraft's chunk system and maintains consistent TPS even during extensive restoration operations. ### Instant Light Restoration Unlike other solutions that trigger expensive light recalculation, RegionRestore features **instant light restore** technology. This dramatically reduces CPU usage during restoration operations and eliminates the lag spikes commonly associated with lighting updates. ### Perfect for Arena Management Ideal for: - **PvP Duels Arenas** - Instant reset between matches - **Mini-Game Lobbies** - Restore lobby state after each game - **Event Arenas** - Reset builds, terrain, and structures - **Practice Arenas** - Fast environment resets - **Plot Worlds** - Mass plot regeneration --- ## Supported Versions | Platform | Supported Versions | |----------|--------------------| | Paper | 1.21.4 - 26.1.1 | | Folia | 1.21.4 - 26.1.1 | ### Minecraft Version Support RegionRestore uses NMS adapters for maximum performance on specific versions: - 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 > **Note:** The plugin requires a matching NMS adapter for your server version. Updates are released shortly after new > Minecraft versions. --- ## Dependencies A PaperMC based server (eg Paper, Purpur) ### Optional - **PlaceholderAPI** - Access RegionRestore data via `%regionrestore_*%` placeholders - **MiniPlaceholders** - Use `<regionrestore_*>` placeholders in MiniMessage-formatted text --- ## Placeholders <details> <summary><strong>PlaceholderAPI Placeholders</strong></summary> | Placeholder | Description | |----------------------------------------------------|-------------------------------------| | `%regionrestore_instance_count%` | Total number of instances | | `%regionrestore_instance_count_pooled%` | Count of pooled instances | | `%regionrestore_instance_count_manual%` | Count of manual instances | | `%regionrestore_instance_count_<world>%` | Instance count for a specific world | | `%regionrestore_template_count%` | Total number of templates | | `%regionrestore_template_<name>_versions%` | Number of versions for a template | | `%regionrestore_template_<name>_active_version%` | Active version ID for a template | | `%regionrestore_pool_count%` | Total number of configured pools | | `%regionrestore_pool_<world>_<template>_count%` | Instance count for a specific pool | | `%regionrestore_pool_<world>_<template>_target%` | Target instance count for a pool | | `%regionrestore_pool_<world>_<template>_occupied%` | Occupied instance count for a pool | | `%regionrestore_instance_<uuid>_world%` | World name of an instance | | `%regionrestore_instance_<uuid>_template%` | Template name of an instance | | `%regionrestore_instance_<uuid>_occupancy%` | Occupancy count of an instance | | `%regionrestore_instance_<uuid>_type%` | Instance type (pooled/manual) | | `%regionrestore_instance_<uuid>_originx%` | Origin chunk X coordinate | | `%regionrestore_instance_<uuid>_originz%` | Origin chunk Z coordinate | | `%regionrestore_instance_<uuid>_sizex%` | Size in chunks (X) | | `%regionrestore_instance_<uuid>_sizez%` | Size in chunks (Z) | | `%regionrestore_instance_<uuid>_minblockx%` | Minimum block X coordinate | | `%regionrestore_instance_<uuid>_maxblockx%` | Maximum block X coordinate | | `%regionrestore_instance_<uuid>_minblockz%` | Minimum block Z coordinate | | `%regionrestore_instance_<uuid>_maxblockz%` | Maximum block Z coordinate | </details> <details> <summary><strong>MiniPlaceholders Placeholders</strong></summary> | Placeholder | Description | |-----------------------------------------------------------|-------------------------------| |