Memento - Natural Renewal

Description

Natural Renewal is now live.

With this release, /memento renew force performs actual world renewal. This is the first version where Memento modifies region data directly.

---

What This Means

Memento now supports two renewal paths:

🌍 Region-Based Pruning (Primary Path)

If a full region is conservatively determined to be forgettable, Memento will:

• Remove the region file
• Remove the matching entity file
• Remove the matching POI file

When players later revisit that area, Minecraft regenerates it naturally using current world generation.

This is ideal for remote, long-abandoned terrain.

🧱 Chunk-Based Renewal (Fallback)

If a region is not fully eligible, eligible chunks are scheduled through the existing renewal engine.

This is useful near inhabited areas where selective renewal is required.

---

How It Works

• Renewal eligibility is evaluated at command time from a stable projection snapshot.
• Evaluation is region-first, with chunk fallback only when needed.
• Spatial checks are bounded and region-aware (no world-wide scans).
• File operations are staged and guarded to reduce risk.
• Only one pruning operation runs at a time.

The system is conservative by design: unknown or active evidence blocks region-level pruning.

---

⚠️ Important — Back Up Your World

This version performs real file removal.

Safeguards are in place, but this is the first active implementation of Natural Renewal.

Back up your world before testing.

---

Performance Improvements

Projection analysis is now significantly faster due to bounded spatial evaluation. Large worlds benefit the most from this change.

---

Temporary Operator Message

An operator-facing message tracking eligibility recomputation is intentionally enabled in this release to aid testing. It will be removed in a follow-up version.

---

How to Test

Recommended test approach:

1. Back up your world.
2. Run /memento renew to review eligibility.
3. Run /memento renew force in remote areas first.
4. Revisit pruned regions to confirm natural regeneration.
5. Observe behavior near inhabited areas.

Test across different dimensions if possible.

---

Reporting Issues

If you encounter problems:

• Provide logs (latest.log or debug.log)
• Mention world size and dimension
• Describe command sequence used
• State whether region or chunk renewal was selected

Please report issues on GitHub: 👉 https://github.com/olilanz/memento/issues

---

This release marks the transition from analysis-only to true, automatic world evolution.