ВЕРСИИ (18)

This release completes the core of Natural Renewal. Memento is now **feature complete**. The system behaves as intended, and the focus now shifts to testing, stability, and polishing the user experience. --- ### What this means Natural Renewal is now fully implemented and stable: * Areas where players spend meaningful time are preserved * Areas outside those regions can be regenerated * Regeneration uses the current world generator The system now behaves consistently and predictably across different worlds. --- ### More reliable world understanding Memento now keeps its world knowledge up to date without forcing chunk loads. * Changes in player activity are picked up naturally over time * Decisions are based on current data, not outdated observations * The system converges as the world is explored --- ### Safe and controlled renewal Renewal now follows a strict and consistent model: * Regions are checked before execution * They are checked again right before regeneration * Loaded regions are skipped This ensures that regeneration only happens when the world already allows it. --- ### Clear and explainable behavior The system is now easier to understand and reason about: * What you see in `/memento explain` matches what will happen * Renewal is gradual and predictable * You remain in control at all times --- ### Documentation update Documentation has been aligned with the actual behavior of the mod: * Clearer explanations of how renewal works * More precise wording of key concepts * Improved structure and navigation --- ### What comes next With the core complete, the next phase is: * testing in real worlds * refining edge cases * improving clarity and usability --- ### Summary Memento is now ready for broader use. * The system is complete * The behavior is stable * The world evolves naturally From here, we focus on making the experience smooth and reliable.

This release marks a major milestone for Memento. The second core pillar of the mod — **Natural Renewal** — has now been fully stabilized. The system has been reworked to behave in a way that feels **intuitive and predictable** during normal gameplay. ### What’s new * **Natural Renewal now “feels right”** * Your bases and active areas are naturally preserved * Exploration no longer creates unintended protected zones * Transitions between protected and renewable areas are smooth and consistent * **Algorithmic work is complete** * The renewal model is now deterministic and locally grounded * No more heuristic edge cases or surprising behavior * **Major performance improvements** * Significantly faster processing on large worlds * Stable behavior even at scale * **Stronger foundation through testing** * Development has shifted to **test-driven design (TDD)** * A comprehensive test suite now protects core behavior and invariants --- ### What this means * You can trust Natural Renewal to behave consistently * Your builds are protected without manual setup * The mod is now moving from **feature development → hardening and user experience** --- ### Looking ahead With the core algorithms now complete, future updates will focus on: * stability and edge-case hardening * improved operator and player experience * preparing the mod for **General Availability (GA)** --- This is a foundational release — thank you for being part of the journey.

This release improves the reliability of **world analysis**, especially for larger worlds, and introduces the first internal **regression test suite** protecting this part of the system. Most players will not notice dramatic visible changes, but the analysis and reporting behind commands like `explain world` are now **more accurate and robust**. --- ### Improved world analysis accuracy Previously, Memento could sometimes infer that world analysis was complete purely from map counts. On large worlds, discovery could populate the world map before the scanner had actually finished its work. This could make the world appear **fully analyzed earlier than it really was**. Version **0.9.15** introduces a small lifecycle model for world analysis. Memento now distinguishes between: * discovering the world * scanning the world * completing the analysis A world is now only considered fully analyzed once scanning has actually finished. This makes status reporting more accurate and avoids edge cases on larger worlds. --- ### Command improvements The following commands now use the improved lifecycle evaluation: * `explain world` * `do scan` * `do csv` They now rely on the real analysis readiness instead of inferring completion from counts alone. --- ### New regression test suite This release also introduces the first **deterministic regression tests** protecting the world analysis logic. These tests ensure that: * a world cannot appear complete before scanning finishes * mismatched totals are never treated as complete * lifecycle evaluation remains correct over time This strengthens the internal safety net as Memento continues to evolve. --- ### Summary 0.9.15 focuses on **correctness and long-term reliability**: * more accurate world analysis reporting * improved behavior on large worlds * new automated regression tests protecting the logic As always, feedback is welcome. If something behaves unexpectedly, feel free to open an issue on GitHub or leave a comment on Modrinth.

This update introduces **optional ambient renewal**, allowing Memento to gradually refresh unused terrain over time — while still keeping inhabited areas safe. Nothing happens automatically until you decide to enable it. --- ## Ambient Renewal (Optional) Memento can now perform **small renewal steps automatically during the nightly maintenance cycle**. Before this can happen, the operator must explicitly enable it: ``` /memento accept ``` This simply confirms that you understand Memento may make small changes to abandoned terrain in your world. Until you run this command, **the mod behaves exactly as before**. --- ## How nightly renewal works Once enabled, Memento will occasionally perform a very small renewal step during the night: • If the world has not yet been analyzed, Memento will start a scan • Once scanning is complete, it may renew one eligible region • Active or inhabited areas remain protected Renewal remains **slow, conservative, and explainable**. If you want faster progress, you can still use the manual commands. --- ## World analysis improvements Memento now **rebuilds its understanding of the world directly from the world files**, ensuring that its decisions always match the actual terrain. This makes the system more robust and avoids potential inconsistencies. --- ## Reminder You can always inspect what Memento plans to do before anything happens: ``` /memento explain renew ``` This command shows where renewal could occur and why. --- Feedback is always welcome. If you try the new ambient renewal feature, feel free to share your experience or open an issue on GitHub.

### Modrinth Release Title Clearer renewal model & simplified world scanning --- ### Modrinth Description This update improves the internal structure and explainability of Memento while keeping operator workflows unchanged. ## What’s new ### Two clearly separated renewal paths Memento now treats: * **Natural Renewal** (gradual region pruning), and * **Witherstone-driven renewal** (explicit chunk renewal) as structurally independent mechanisms. Both are shown in `/memento explain renewal`, but they no longer interfere with each other internally. --- ### Simpler, safer world scanning `/memento do scan` now runs in a single pass: * No hidden retry phase * Unresolved files are reported clearly * Rerunning the command reconciles remaining files Scanning remains fully operator-triggered. --- ## What hasn’t changed * Nothing runs automatically * Renewal only happens when you trigger it * Protection always wins * No forced chunk unloads * Vanilla clients remain compatible This release focuses on clarity, stability, and reduced internal complexity as Memento moves toward General Availability.

This release improves reliability, clarity, and operator trust in natural renewal. No gameplay mechanics were changed, but the renewal pipeline and command behavior have been cleaned up and hardened. --- ### 🔎 Clearer Explain → Do Workflow * `/memento explain renewal` and `/memento do renew` now operate from the same stable candidate view. * No more preview drift between “what would renew” and “what actually renews”. * `do renew` processes candidates in a controlled, bounded way. The system is now easier to reason about and safer to operate. --- ### 🛡 Improved Region Pruning Safety Region-based renewal has been hardened: * Preflight checks before file operations * Continue-on-failure behavior (one failure does not abort the entire batch) * Clear, calm operator feedback in edge cases * Explicit file paths shown if manual action is required The goal is predictable, explainable behavior — even in rare failure scenarios. --- ### 🧠 Internal Memory Model Alignment Under the hood, the renewal model has been clarified: * World “memory” is now consistently described in terms of memorability and forgettability. * Renewal candidates are selected cleanly from this memory model. * Logging and CSV exports were updated to reflect this. No changes to how renewal works — just clearer structure and better long-term maintainability. --- ### ⚠️ Automation Status Full automatic nightly renewal remains intentionally disabled. Before enabling automation, the following safeguards will be completed: * Durable protection against renewal loops * Additional guarantees around renewal safety on highly active servers Stone-based renewal remains fully supported and stable. --- ### ✔ What Did Not Change * Witherstone and Lorestone mechanics * Natural renewal behavior * Command syntax * World compatibility This release strengthens the foundation for safe, explainable world evolution without altering your gameplay experience.

## 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](https://github.com/olilanz/memento/issues) --- This release marks the transition from analysis-only to true, automatic world evolution.

## Description This release prepares the foundation for automated natural renewal. ### 🔍 `/memento scan` — Full world scanning The scan command now scans the complete world and builds a full metadata map. This prepares the server for future natural renewal automation. ### 🌱 `/memento renew` — Renewal preview The renew command now reports *where* renewal would take place if automation were active. No chunks are deleted or regenerated yet — this is a safe preview mode for validation. Natural renewal automation is planned for an upcoming release once the scan and renew commands have proven stable in real server environments. --- ### 🪨 Stone-based renewal unchanged Interactive renewal using stones remains fully functional and unchanged. This system is complete and can be used today. --- ### 🛠 Stability & performance improvements * Improved background processing behavior * Better operator feedback * More predictable evaluation logic --- Feedback is welcome on GitHub — especially regarding scan coverage and renewal preview results.

This release improves scanner compatibility and significantly enhances operator diagnostics. --- ## LZ4 Region File Support Natural Renewal now supports **LZ4-compressed region files**. If your world uses LZ4 compression internally, the scanner will now correctly read and process those chunks instead of marking them as unsupported. This improves: * WorldMap completeness * Scanner convergence * Renewal eligibility accuracy No configuration changes required. --- ## Expanded `/memento inspect` The inspection system has been extended. ### New: System-wide inspection You can now run: ``` /memento inspect ``` Without providing a stone name. This returns a system summary including: * Total Witherstones and Lorestones * Witherstone lifecycle distribution * Renewal batch states * Scanner activity status * WorldMap totals (known / scanned / missing chunks) --- ### Improved: Stone inspection ``` /memento inspect <name> ``` Now provides additional details: * Influenced chunk count * Renewal batch lifecycle state * Explicit waiting explanations * Unload blockers (e.g. players in affected chunks) * Other entities preventing regeneration Inspection now focuses on answering: > Why is renewal not progressing? --- ## Improved command output The following commands received formatting and clarity improvements: * `/memento add witherstone` * `/memento add lorestone` * `/memento list` * `/memento inspect` * `/memento visualize` Changes include: * Cleaner wording * Structured summaries * Bounded output for large result sets * More consistent reporting format --- ## Summary Version 0.9.9 delivers: * Broader compatibility with modern Minecraft region formats * Deeper diagnostic visibility * Clearer operator feedback No gameplay mechanics changed. This is a compatibility and observability upgrade.

This release focuses on polish, clarity, and operator quality of life. A new central pulse system now regulates internal mechanics more efficiently. The mod runs calmer and lighter, without changing its conservative behavior. Visualization has been significantly refined. Influence areas now render with clearer surface and outline effects, making stones easier to understand at a glance. The in-game feedback feels more intentional and cohesive. Command handling has also improved. All stone-related commands now support autocompletion of existing stone names. You no longer need to remember what you created — the command line suggests and lets you select them directly. The result is a smoother experience for operators and a more visually coherent world.

## 🌍 Much Faster World Analysis Natural Renewal now analyzes your world in a completely new way. Instead of loading thousands of chunks in-game to understand them, the mod now reads world data directly from region files. This makes world analysis dramatically faster and far less demanding on your server. * World analysis is now roughly **80× faster** * Large worlds process in seconds instead of minutes * No mass chunk loading during analysis --- ## 🧘 Lower Server Impact The new system no longer creates chunk load pressure while examining the world. That means: * No unexpected lag spikes during `/naturalrenewal scan` * No interference with normal gameplay * Safe to run even on active servers --- ## 📊 Cleaner Progress Feedback * Clearer progress messages while analyzing the world * Better summary logs * World snapshot export remains available --- Renewal behavior itself has not changed. This update improves how Natural Renewal understands your world, making it faster, safer, and more reliable — especially on long-lived servers.

This update is a **major stability and behavior improvement** since 0.9.5. Memento now interacts much more politely with your world and your server. Chunk loading has been reworked to apply steady, adaptive pressure instead of bursts, which makes it safer to run on active servers and alongside other mods that also load chunks. ### What’s improved * **Much smoother chunk loading** * No aggressive forcing * Automatically adapts to server load * **Plays nicely with other mods** * Designed to coexist with mods like *Distant Horizons* and other chunk loaders * **More predictable scanning and renewal** * Renewal always takes priority * Scanning no longer blocks or overloads the server * **Cleaner logs** * Important world events stay visible * Internal details are moved to debug logs ### What this means for you * Lower risk of lag spikes * Better long-running stability * Safer to run scans and renewal on live worlds * A stronger foundation for future features This release focuses on **stability, correctness, and server friendliness**. Further optimizations to scanning behavior are planned for upcoming versions.

**Summary** This release introduces an internal world inspection pipeline used to analyze and validate Memento’s renewal logic. The new tooling is intended for operators and development workflows and does not change gameplay behavior yet. **Changes** * Added `/memento run`, an operator-only command that scans the world and builds an analysis snapshot * Implemented a world scanner that discovers worlds, regions, and chunks and collects structural metadata * Added CSV snapshot generation to support offline analysis and validation * Introduced a `lab/` folder with a Python notebook for exploring and visualizing snapshot data * Internal architectural refinements to support long-running, observable inspection tasks **Notes** * The inspection pipeline is under active development and is not a supported gameplay feature * No changes to renewal behavior, stone mechanics, or player-facing features in this release

## Changes in this release This release is focused on **in-game visualization of stone influence**. Stones now visibly project their presence into the world, making it easier to understand **where**, **when**, and **why** areas are affected — without requiring any client-side mods. ### In-game visualization * Stones now show **surface-level visual effects**: * when a stone is placed * when an area enters a waiting state * when an operator explicitly visualizes stone influence * Visual effects project onto the terrain surface and into the air, making affected areas readable at a glance * Anchor effects clearly mark the **exact location of stones**, even from a distance ### New visualization command * Added `/memento visualize` * Explicitly displays a stone’s area of influence * Useful for inspection, demonstrations, and explaining behavior to other players ### Improved command semantics * Renamed `/memento set` to `/memento alter` * Better reflects that existing stones are being modified * Behavior remains unchanged ### New server-side effects system * Introduced a **brand-new visual effects pipeline** * Built entirely on vanilla particle effects * Fully server-side — **no client mod required** * Effects are driven by **game time**, not ticks * Short-lived effects (placement, visualization) * Long-lived ambient effects (waiting areas) ### Foundation for future work * The new effects system is intentionally flexible and extensible * Provides a stable base for future visualizations without increasing client complexity * Internal structure has been simplified and cleaned up to support further iteration

**Visual Stone Identity** This release introduces the first **explicit visual identity** for Memento stones and lays the structural foundation for richer, time-driven visual effects. Stone placement now produces clear, intentional particle effects: an anchor at the stone position and a visible projection on the surrounding chunk surface. This restores and validates visualization behavior within the new event-driven architecture. Under the hood, v0.9.3 strengthens the model significantly: * Visualization is now driven by **domain events**, not ad-hoc triggers. * Visual effects are managed as **lifecycle-aware objects**, ready for repetition, fading, and long-lived projections. * A shared **game time tracker** decouples domain logic from raw server ticks, improving correctness and testability. * Command handling has been refined so stones are placed on the **targeted block**, with clear feedback when placement is invalid. This release is primarily structural: it makes stone behavior *visible*, *traceable*, and *extensible*, preparing the system for future work on influence areas, topology-aware effects, and long-running visual projections.

### What’s new **Visual feedback for stone creation** Lorestones and Witherstones now emit a short, server-side particle effect when they are placed. This gives immediate, in-world confirmation that an area has come under influence — fully vanilla and without any client mods. **More natural-shaped areas of influence** The area affected by Lorestones and Witherstones is now calculated using a world-space distance model instead of chunk-aligned squares. This results in smoother, more organic influence shapes that better reflect how stones are placed in the world. ### Why this matters * Stone placement is easier to trust and understand * Areas of influence feel less grid-like and more natural * Visual feedback and spatial behavior are now aligned conceptually ### Technical notes (high level) * Influence areas are derived from stone position using chunk-center distance * Visual effects are event-driven and lightweight * Clear separation between domain logic (renewal & protection) and presentation (visual cues) This release focuses on **clarity, correctness, and foundations**. Future versions will expand on this with richer area visualization, maturity warnings, and operator-controlled inspection tools.

* **Lorestone support is now complete** * Lorestones act as a **strong protection guarantee**. * Any chunks covered by a Lorestone will never be renewed, even if they overlap with a Witherstone. * Overlapping stones are automatically re-evaluated when a Lorestone is created, removed, or resized. * **Clear and predictable renewal behavior** * All stones now follow **one consistent evaluation path**, whether triggered by server startup, the nightly renewal checkpoint, or operator actions. * `daysToMaturity` is handled purely as a countdown, decreasing only at the nightly renewal checkpoint. * Negative values are preserved to indicate overdue renewal pressure. * **Better in-game feedback and logs** * Operators now receive clear messages when stones mature or complete renewal. * Log output has been simplified and rewritten in **domain language** (stones, batches, chunks), removing confusing or technical terms. * **Safety and reliability improvements** * Witherstones are only consumed after all affected chunks have been successfully renewed. * Server restarts no longer risk leaving renewals half-finished. * **Mod artifact renamed** * Renamed from `memento-0.9.0-SNAPSHOT` to `memento-natural-renewal-0.9.1-SNAPSHOT` to avoid potential name clashes with other mods.

## 📦 Memento: Natural Renewal ### SNAPSHOT 0.9.0 (Beta) First public snapshot of **Memento**. ### ✨ Features - **Natural chunk renewal** - Regenerates terrain, trees, ores, and structures using vanilla world-gen - No disk-level deletion, no external tools - **Stone-based control** - **Witherstones** trigger renewal in a defined radius - **Lorestones** protect areas from renewal - Stones mature over time and are consumed after renewal - **Safe, deterministic behavior** - Renewal only happens when chunks are fully unloaded - Never regenerates while players are present - Logout or natural unload resumes renewal automatically - **Strong observability** - Full lifecycle logging for stones and renewal batches - Clear, operator-friendly logs - Warnings when renewal is blocked or needs intervention - **Server-side only** - Fabric server mod - Vanilla clients can connect without installing anything ### ⚠️ Beta notes - Focused on correctness and safety, not performance tuning - Persistence format may still evolve - Log verbosity is intentionally rich during beta ### 🎯 Intended use Designed for renewing abandoned areas and letting new world-gen mods affect existing worlds. Not intended for resource farming or frequent manual chunk resets.