InstantReset

A Bukkit plugin to reset whole worlds, instantly.

• Reset an entire world instantly, no matter the size.
• Server restart does not reset worlds, they are only reset when you want.
• Player inventories are not reset.
• Monsters and other entities are also reset.
• Works with Multiverse-Core.
• Works with Multiworld.
• Open Source License.
• Mature backend code, works with all CraftBukkit versions as far back as 1.4.7

Commands

/ir list

Permission: instantreset

List worlds which can be reset.

/ir reset [world]

Permission: instantreset

Reset the current world, or the specified world.

Configuration

Example

# Where to look for world templates.
templatedir: templates 
# Where to store temporary files for instantreset worlds.
worlddir: worlds
# Reset worlds on restart
resetOnRestart: false
# List of resetable worlds
#
# Note: they will not load if they are invalid, and messages as
# to why the did not load will be printed to the console.
#
# The environment must match the world save or you will end up
# with an empty world.
#
# You cannot (yet) use this plugin to reset the default worlds in 
# CraftBukkit, as the unload API prevents them from being unloaded.
worlds:
        # Name of world.
        ir:
                # Name of directory containing the world save.
                template: "ir"
                # Environment, one of NORMAL, NETHER, THE_END
                environment: NORMAL
                # Difficulty, one of EASY, NORMAL, HARD, PEACEFUL
                difficulty: NORMAL
        # Name of world.
        ir_nether:
                # Name of directory containing the world save.
                template: "ir_nether"
                # Environment, one of NORMAL, NETHER, THE_END
                environment: NETHER
                # Difficulty, one of EASY, NORMAL, HARD, PEACEFUL
                difficulty: NORMAL
        # Name of world.
        ir_the_end:
                # Name of directory containing the world save.
                template: "ir_the_end"
                # Environment, one of NORMAL, NETHER, THE_END
                environment: THE_END
                # Difficulty, one of EASY, NORMAL, HARD, PEACEFUL
                difficulty: NORMAL

Quick Start

• Install the plugin.
• Copy a world save to plugins/InstantReset/templates/<world name>
• Add the world to config.yml with the correct environment type and difficulty level of your choice. The name of the world, must match the name of the folder your placed your world save in under templates/.

Notes

You cannot reset worlds which are loaded by bukkit at startup, by default this is world, world_nether and world_the_end. If you wish to use it to reset either world_nether or world_the_end you should disable either nether or the_end in server.properties or bukkit.yml respectively. The default world cannot be reset with this plugin.

If you specify the wrong environment type you will likely end up with an empty world.

It is possible for other plugins to depend on this plugin and use it to reset worlds.

Changes to config.yml will be overwritten when the server is shut down, ensure you change it whilst your server is not running.

Examples

Resetting the end

You will also need Multiverse and Multiverse-NetherPortals.

• Start your minecraft server, teleport to the end using /mvtp world_the_end, and walk around to ensure it's all generated.
• Stop your server.
• Edit bukkit.yml, and change allow-end: true to allow-end: false
• Copy world_the_end to plugins/InstantReset/templates/world_the_end
• Add the following to the worlds section of the configuration

    world_the_end:
        template: "world_the_end"
        environment: THE_END
        difficulty: NORMAL

• Start your server.
• Link the worlds using Multiverse-NetherPortals /mvnp link end world world_the_end
• Reset the end when needed using /ir reset world_the_end