NatureRevive - brilliant

Supported Versions: 1.17 ~ 26.3

Player: "Resource worlds are such a hassle, always having to teleport back and forth."
Player: "Can't gathering and building just happen in the same world?"
A dev: "But then you couldn't reset the world, and resources would just keep running out."
Player: "Can't the explored areas periodically revert to their original state?"

And so, this plugin was born.
A way to skip the pointless resource world and enjoy the convenience of unlimited resources in a single world!

🧩 Features

• Regenerate chunks that haven't been visited by players for a long time
• Optional regeneration engine to avoid chunk seams
• Optional land-claim regeneration protection modes
  • Don't regenerate chunks containing RES claims
  • Regenerate chunks containing RES claims, but not the blocks within the RES claim area
  • Don't regenerate chunks containing GP claims
  • Regenerate chunks containing GP claims, but not the blocks within the GP claim area
  • Don't regenerate chunks containing GD claims
  • Regenerate chunks containing GD claims, but not the blocks within the GD claim area
• Optional dependencies
  • CoreProtect
  • Residence
  • GriefPrevention
  • GriefDefender
  • ChunkClaimPlugin2
  • FastAsyncWorldEdit (required for 1.21+)
• Randomly regenerated ore resources
• Randomly regenerated loot chests and elytra resources
• Configuration that takes server performance into account
  • Pause regeneration based on TPS until TPS returns to normal
  • Pause regeneration based on player count until it drops below a set number
  • Adjust how many chunks regenerate per tick
  • Adjust the maximum number of blocks placed per regeneration
  • Restrict the time window for regeneration
  • Adjust the chunk generation strategy and aggressiveness
    • aggressive - If a chunk is expired, it's automatically loaded and regenerated
    • average - After a player loads a chunk, nearby chunks (3×3) are regenerated if expired
    • passive - Only the chunk the player loads is regenerated if expired
  • Limit the maximum number of elytra regenerated per day
  • Adjust which biomes and worlds are allowed to regenerate
  • Add extra regeneration delay after regenerating, to prevent players from farming resources at a fixed spot
  • Randomize ore distribution after regeneration, to prevent fixed-spot farming
  • Limit the height of ore obfuscation and which blocks get obfuscated
  • Prevent loot chests from spawning items on regeneration, to prevent fixed-spot farming
  • Adjust how often (in ticks) non-expired chunk data is saved and synced to the local or remote database
  • Adjust how often (in ticks) database commands are executed
  • Adjust how often (in ticks) chunk expiration is checked
  • Adjust how often (in ticks) event-affected chunk calculations are processed
  • Adjust how often (in ticks) blocks that need to be preserved are checked and restored, to avoid the visual glitch of the End gateway flickering in the center of the End
  • Limit the maximum number of blocks processed per chunk-marking pass
• Multiple data storage options
  • yaml - local
  • sqlite - local
  • mysql - remote, requires a configured MySQL server
• A way for developers to integrate with the resource regeneration process
  • Regeneration fires Bukkit events for developers to hook into
  • IIntegrationManager handles the integration of land-claim protection, block logging, regeneration, and more
  • IAPIMain is the plugin's main interface, from which other classes can be obtained

📥 How to Use

• Download this plugin
• Drop the plugin.jar into your server's plugins folder (plugins)
• Done! (If you use a plugin loader, remember to load the plugin)

🔴 When using this plugin, remember to back up your map to avoid any unexpected incidents!!!

⚙️ Configuration

After the plugin starts successfully, you'll find a config.yml file in the plugins/NatureRevive directory, which contains all of the plugin's settings.

💬 Commands

• /nr forceregenall — Force-regenerate all expired chunks
• /nr regenchunk <bukkit/fawe> — Force-regenerate the current chunk (bukkit is auto-disabled on 1.21+)
• /nr reload — Reload the plugin
• /nr pause — Pause the resource regeneration process
• /nr resume — Resume the resource regeneration process
• /nr migrate <yaml/sqlite/mysql> — Migrate the database to the specified storage
• /nr debug — Debug messages; please don't use unless necessary

🔓 Permissions

• naturerevive.forceregenall — Permission to use /nr forceregenall
• naturerevive.regenthischunk — Permission to use /nr regenchunk
• naturerevive.togglerevive — Permission to use /nr pause and /nr resume
• naturerevive.reloadreviveconfig — Permission to use /nr reload
• naturerevive.navmigrate — Permission to use /nr migrate
• naturerevive.debug — Permission to use /nr debug

🧷 Source Code

Github

🗺️ Displayed in BlueMap

Github

🔧 How It Works

• After a player has been active in an area, it is marked as an "expired chunk"
• When no other players have "been active" in it for a certain period, regeneration is performed
• (By default, chunks containing land claims are excluded)
  • "Being active" includes:
    1. BlockBreakEvent
    2. BlockBurnEvent
    3. BlockCookEvent
    4. LeavesDecayEvent
    5. EntityDeathEvent (specific condition: the killer is a player and the victim is not a player)
    6. BrewEvent
    7. FurnaceBurnEvent
    8. EntityExplodeEvent
    9. BlockExplodeEvent
    10. BlockPlaceEvent
    11. BlockRedstoneEvent
    12. BlockGrowEvent
    13. PlayerInteractEvent

🙏 Credits

📢 Notice

Please do not sell plugins developed by the Brilliant Team, or sell their features.
All of our plugins are provided to servers free of charge,
so we earn no real income from developing them.

Such behavior will, to some extent, reduce our willingness to keep developing,
and may lead us to consider turning free, open-source plugins into paid, closed-source ones. We hope you understand.