Download File

Get the nightly releases here: https://mods.idling.app/rituals The datapack variant, full changelog, and historical versions are also available at the above link. Short version: NEW SOUL EMBODIMENT RITUAL and bug fixes --- ## v1.4.5 — Passive Soul XP Overhaul ### Bug Fixes - **Fixed: Soul XP gain completely non-functional** — The passive XP timer never started because `tick.mcfunction` checked for `soul_embodied:1` (integer) while items store `soul_embodied:1b` (byte). All four `if items` predicates in `tick.mcfunction` now correctly use the `1b` byte suffix, matching the actual NBT data written by `awaken_item.mcfunction` and `apply_soul_data.mcfunction`. ### New Features - **XP Countdown Debug Toggle** — New ModMenu config option (`Soul XP → XP Countdown Log`) and TOML field (`soulXp.countdown`) that logs a once-per-second countdown in chat showing timer progress and seconds until next XP award. Invaluable for verifying the passive XP system is working. - **`/rituals config xp_interval` Command** — Server admins can now set the soul XP rate directly from chat or console. Accepts a preset name (`easy`, `hard`, `brutal`, etc.) or a custom tick count (minimum 20). Saves to TOML and pushes to the datapack immediately. Requires OP level 2+. - **Datapack-Only XP Rate Functions** — For servers running the datapack without the mod, 13 preset functions are available: - `/function rituals:config/soul_xp/set_trivial` through `/function rituals:config/soul_xp/set_impossible` - `/function rituals:config/soul_xp/set_interval` for custom values (set storage first, then call) - **Expanded XP Rate Presets (13 + Custom)** — Replaced the original 3 presets (Easy/Medium/Hard) with 13 presets spanning 10 seconds to 60 minutes, providing granular difficulty control: | Preset | Interval | Time to Lv 100 (no catalyst) | |---|---|---| | Trivial | 10s | ~160 hours | | Easy | 30s | ~481 hours | | Moderate | 1m | ~961 hours | | Standard | 2m | ~1,923 hours | | **Hard (default)** | **3m** | **~2,884 hours** | | Tough | 5m | ~4,807 hours | | Grueling | 8m | ~7,691 hours | | Brutal | 10m | ~9,614 hours | | Punishing | 15m | ~14,421 hours | | Extreme | 20m | ~19,228 hours | | Insane | 30m | ~28,842 hours | | Nightmare | 45m | ~43,262 hours | | Impossible | 60m | ~57,683 hours | ### Documentation - **[SOUL_EMBODIMENT_PLAYER_GUIDE.md](https://github.com/Underwood-Inc/rituals/blob/master/docs/SOUL_EMBODIMENT_PLAYER_GUIDE.md)** — Complete rewrite of the "Earning XP" section for the passive system. Added time-to-level tables for all 13 presets at key milestones (Lv 15, 50, 100). Added offhand catalyst multiplier reference. Fixed total XP to max level (420,631 → 57,683). Updated Soul Bond lore, example journey, and quick reference card. - **wiki/SOUL_EMBODIMENT_GUIDE.md** — Replaced action-based XP mindmap with passive XP flowchart. Added catalyst and preset tables. Fixed total XP figure. - **CONFIG_GUIDE.md** — New "Soul XP System" section with Mermaid Gantt chart, full preset reference, mod and datapack command examples, TOML config reference, catalyst rate defaults, and debug countdown docs. - **COMMANDS_GUIDE.md** — Documented `/rituals config xp_interval` with all presets and datapack equivalents. Fixed permissions (config commands require OP, not level 0). Updated version to 1.4.5 / MC 1.21.11. - **In-game Guidebook** — Updated Soul Leveling, Soul Bond, Channeling, Foolish Awakenings, Configuration, and Commands pages to reflect passive XP and new commands (both datapack `give/guidebook.mcfunction` and Java `RitualsMod.java` guidebook). - **ModMenu Cloth Config** — Description now dynamically shows estimated hours to max level based on current preset and base rate. ### Changed - Default XP rate is now **Hard (3,600 ticks / 3 minutes)** — previously Hard was 600 ticks (30 seconds). The old "Easy" (200 ticks / 10s) is now "Trivial". This reflects the expanded preset range. - `set_medium.mcfunction` retained for backward compatibility, maps to Moderate (1,200 ticks) with a deprecation note. - Config commands (`/rituals config reload`, `/rituals config xp_interval`) now require OP level 2+. ### Files Changed **Java (4 files):** - `RitualsMod.java` — Added `xp_interval` subcommand, updated guidebook pages - `RitualsConfig.java` — Added `soulXpCountdown` field, TOML load/save, updated preset comments - `RitualsClothConfigScreen.java` — Added countdown toggle, time-to-max display, updated tooltip - `SoulXpTracker.java` — Pushes `#xp_countdown` flag to datapack scoreboard - `SoulXpRate.java` — Expanded from 4 to 14 enum values **Datapack (17 files):** - `soul/tick.mcfunction` — Fixed `1b` byte matching, added debug countdown call - `soul/debug_countdown.mcfunction` — **New** — 1/second countdown logger - `config/soul_xp/load.mcfunction` — Updated default to 3,600 ticks, updated comments - `config/soul_xp/set_interval.mcfunction` — **New** — Custom interval setter with time display - `config/soul_xp/set_trivial.mcfunction` through `set_impossible.mcfunction` — **New** (11 files) + updated existing `set_easy`, `set_medium`, `set_hard` - `give/guidebook.mcfunction` — Updated Soul Leveling and Commands pages **Documentation (4 files):** - `docs/SOUL_EMBODIMENT_PLAYER_GUIDE.md` - `docs/wiki/SOUL_EMBODIMENT_GUIDE.md` - `docs/CONFIG_GUIDE.md` - `COMMANDS_GUIDE.md`