rituals

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 — 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