Sol's MMNM Addon 0.25

What Is New?

This update adds two ways to recover protected sites:

1. Automatic crash recovery for Mine Mine no Mi's normal block restoration.
2. Manual site snapshots that admins can save and restore whenever needed.

Automatic Restoration Now Survives Restarts

When an ability damages blocks inside a protected site, MMNM normally adds those blocks to a restoration queue. Previously, stopping or crashing the server could make that unfinished queue disappear.

The addon now saves that queue to the world folder. When the server starts again, unfinished blocks are returned to the correct protected site so normal restoration can continue.

If several sites are damaged at once, they take turns being saved. One heavily damaged site should not completely block the others.

Do take note:

• A normal server shutdown gives the addon time to finish its latest disk saves.
• A sudden crash can still lose the newest changes that had not reached the disk yet.
• Constant ability damage across several huge sites may create a backlog.
• This is extra recovery protection, not a replacement for normal world backups.

Manual Protected-Site Snapshots

Admins can save how an existing protected site currently looks:

/abprotect snapshot savearea <site>

If that site already has a snapshot, confirm that you want to replace it:

/abprotect snapshot savearea <site> confirm

Restore the saved version with:

/abprotect snapshot restorearea <site>
/abprotect snapshot restorearea <site> confirm

Other useful commands:

/abprotect snapshot status <site>
/abprotect snapshot cancel <site>
/abprotect snapshot retry <site>

What happens while saving?

The addon saves the site a little at a time so a large site is not copied in one server tick.

While the save is running, the saved area is temporarily locked:

• Players cannot build, mine, use containers, or change blocks there.
• Abilities and explosions cannot damage the saved area.
• Fire, lava, water, redstone, pistons, and block machines cannot change it while it is being copied.
• MMNM's normal automatic restoration pauses for that site.

The lock ends when saving finishes or an admin safely cancels the save.

There is no artificial size limit. A very large site can still require a lot of time, RAM, CPU, and disk space. Start with a small test site before saving something enormous.

Is a saved snapshot permanent?

Yes. A completed snapshot can be restored as many times as needed.

Restoring it does not consume, delete, or update it. The snapshot changes only when an admin runs another savearea, confirms the replacement, and the new save finishes successfully. A failed or cancelled replacement keeps the previous completed snapshot.

If the protected site is resized afterward, the old snapshot remains valid. Restoring it uses the original area that was saved:

• Expanding the protected site does not add the new space to the old snapshot.
• Shrinking the protected site can make the old snapshot restore blocks outside the site's new smaller size.
• The command warns the admin about this before asking for confirmation.

Save the resized site again if its new size should become the new snapshot.

What happens while restoring?

The site is temporarily locked so players, abilities, fire, fluids, redstone, pistons, explosions, and other activity cannot fight the restoration.

Blocks are checked as they are restored. If a real error occurs, the site remains safely locked and an admin can retry it:

/abprotect snapshot retry <site>

undefined

Optional Fast Mode

Fast mode gives one active save or restore more server time:

/abprotect snapshot fastmode <site> enable
/abprotect snapshot fastmode <site> enable confirm
/abprotect snapshot fastmode <site> disable

Fast mode can make saving or restoring much faster, but it can also cause:

• Lower TPS or temporary server lag.
• Higher CPU and RAM usage.
• More chunk loading and disk activity.
• Other snapshot jobs waiting for the fast job.

Use it when the server is mostly idle and an admin is watching performance. Having no regular players online is recommended, but not required. Fast mode does not automatically turn off when a player joins.

Disabling fast mode does not cancel the job. After a restart, recovered jobs always return to normal mode.

What Does a Snapshot Save?

Saved:

• Blocks and their exact states.
• Chests and other containers, including their saved contents.
• Signs and other block data.
• Compatible modded blocks and block data.

Not saved:

• Players or player inventories.
• Mobs and NPCs.
• Dropped items.
• Paintings, armor stands, projectiles, or other entities.

Restoring a container also restores its old inventory. This can roll back legitimate item changes or duplicate items that were removed after the snapshot. Treat restorearea as an admin rollback and keep players away until it finishes.

Improved: Cleaner Ability Protection Commands

The normal radius-based site command remains:

/abprotect site new <name> <size>

Pos1/Pos2 cuboid creation now has its own command:

/abprotect site new_cuboid pos1 <name>
/abprotect site new_cuboid pos2
/abprotect site new_cuboid pos2 exact
/abprotect site new_cuboid pos2 full_height

Other commands are organized by purpose:

/abprotect site <resize|rename|info|remove|list> ...
/abprotect snapshot <savearea|restorearea|status|cancel|fastmode|retry> ...
/abprotect props ability <nogrief|blacklist> ...
/abprotect props entity <blacklist|whitelist|spawnrules> ...
/abprotect props <setting> ...
/abprotect profile ...
/abprotect view <protection|hud_text> <true|false>

/abilityprotection and /mmnm abprotect use the same layout.

Before Testing

1. Back up the complete world and test on a copy.
2. Start with a small protected site.
3. Test blocks, modded blocks, containers, doors, fluids, fire, redstone, and falling or wall-mounted blocks.
4. Test a normal restart during both saving and restoring.
5. Test fast mode separately while watching TPS, CPU, RAM, and disk usage.

Snapshot data is stored on the server under:

<world>/solsmmnmaddon/area_snapshots/