Go to https://mods.idling.app/rituals to view changelogs for all versions.

Go to https://mods.idling.app/rituals to view changelogs for all versions.

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

Full Changelog: https://github.com/Underwood-Inc/rituals/compare/1.3.0...1.3.0.recipe-fix

Full Changelog: https://github.com/Underwood-Inc/rituals/compare/1.3.0...1.3.0.recipe-fix

What's Changed

• delete: remove test_basic.json recipe file by @mamokin in https://github.com/Underwood-Inc/rituals/pull/10

Full Changelog: https://github.com/Underwood-Inc/rituals/compare/1.3.1...1.3.2

What's Changed

• delete: remove test_basic.json recipe file by @mamokin in https://github.com/Underwood-Inc/rituals/pull/10

Full Changelog: https://github.com/Underwood-Inc/rituals/compare/1.3.1...1.3.2

Нет описания изменений

Нет описания изменений

Changes Summary

TPS-Independent Animation Improvements

Datapack Animation Optimization

Problem: Item display animations were choppy during TPS lag (tied to game ticks).

Solution: Optimized interpolation timing to mask TPS fluctuations:

• Increased interpolation duration: 10 ticks → 30 ticks
• Reduced update frequency: every 10 ticks → every 20 ticks
• Simplified keyframes: 12 keyframes → 6 keyframes with longer transitions
• Each keyframe explicitly sets interpolation_duration:30

This is only remediation; there are limitations due to this being a datapack at its core and how animations work in Minecraft. Look at it as a visual TPS indicator 😹

Files Modified:

• totem/initialize.mcfunction - Entity spawn with 30-tick interpolation
• totem/animate_item_display.mcfunction - Update frequency changed
• totem/animate_item_step.mcfunction - Fewer keyframes, longer interpolation

Result: Animations remain smooth even during TPS drops by leveraging Minecraft's built-in client-side interpolation buffer.

Totem Progression System

Recipe Unlocking

Problem: Recipes had no advancement requirements - players could craft any tier immediately.

Solution: Added progression checks via confiscate_* functions (already implemented):

• Players attempting to craft locked totems have items confiscated
• Materials returned via give commands
• Error messages display progression requirements

Implementation: The check_illegal_totem.mcfunction runs every tick checking player inventories.

Advancement Support for Short Totems

Problem: Advancements only checked for tall totems (missing totem_short: 1 NBT).

Solution: NBT matching is "contains" not "exact match" - short totems naturally trigger since they have totem_tier field.

Result: Both tall AND short variants progress the advancement tree (already worked, confirmed via testing).

Material Drops on Break

Problem: Breaking totems only dropped the totem item itself.

Solution: Updated all 12 drop functions to return the corresponding totem recipe item (no material duplication).

Files Modified:

• All totem/drop/tier*.mcfunction files (1-6, tall + short)

Result: Breaking totems returns the totem recipe items for reuse/relocation (no resource duping).

Summary

• ✅ Animations: 3x smoother during TPS lag via interpolation buffering
• ✅ Progression: Working via confiscate system (runs every tick)
• ✅ Advancements: Support both tall and short totem variants
• ✅ Drop System: Returns totem recipe items without duplication

Full Changelog: https://github.com/Underwood-Inc/rituals/compare/1.1.1...1.3.0

Changes Summary

TPS-Independent Animation Improvements

Datapack Animation Optimization

Problem: Item display animations were choppy during TPS lag (tied to game ticks).

Solution: Optimized interpolation timing to mask TPS fluctuations:

• Increased interpolation duration: 10 ticks → 30 ticks
• Reduced update frequency: every 10 ticks → every 20 ticks
• Simplified keyframes: 12 keyframes → 6 keyframes with longer transitions
• Each keyframe explicitly sets interpolation_duration:30

This is only remediation; there are limitations due to this being a datapack at its core and how animations work in Minecraft. Look at it as a visual TPS indicator 😹

Files Modified:

• totem/initialize.mcfunction - Entity spawn with 30-tick interpolation
• totem/animate_item_display.mcfunction - Update frequency changed
• totem/animate_item_step.mcfunction - Fewer keyframes, longer interpolation

Result: Animations remain smooth even during TPS drops by leveraging Minecraft's built-in client-side interpolation buffer.

Totem Progression System

Recipe Unlocking

Problem: Recipes had no advancement requirements - players could craft any tier immediately.

Solution: Added progression checks via confiscate_* functions (already implemented):

• Players attempting to craft locked totems have items confiscated
• Materials returned via give commands
• Error messages display progression requirements

Implementation: The check_illegal_totem.mcfunction runs every tick checking player inventories.

Advancement Support for Short Totems

Problem: Advancements only checked for tall totems (missing totem_short: 1 NBT).

Solution: NBT matching is "contains" not "exact match" - short totems naturally trigger since they have totem_tier field.

Result: Both tall AND short variants progress the advancement tree (already worked, confirmed via testing).

Material Drops on Break

Problem: Breaking totems only dropped the totem item itself.

Solution: Updated all 12 drop functions to return the corresponding totem recipe item (no material duplication).

Files Modified:

• All totem/drop/tier*.mcfunction files (1-6, tall + short)

Result: Breaking totems returns the totem recipe items for reuse/relocation (no resource duping).

Summary

• ✅ Animations: 3x smoother during TPS lag via interpolation buffering
• ✅ Progression: Working via confiscate system (runs every tick)
• ✅ Advancements: Support both tall and short totem variants
• ✅ Drop System: Returns totem recipe items without duplication

Full Changelog: https://github.com/Underwood-Inc/rituals/compare/1.1.1...1.3.0

• displayed item animations should be less prone to interference by TPS lag
• newly placed totems no longer create a totem that is self-illuminated
• add modmenu integration (you need the modmenu mod to leverage this properly)

Full Changelog: https://github.com/Underwood-Inc/rituals/compare/1.1.1...1.2.0

• displayed item animations should be less prone to interference by TPS lag
• newly placed totems no longer create a totem that is self-illuminated
• add modmenu integration (you need the modmenu mod to leverage this properly)

Full Changelog: https://github.com/Underwood-Inc/rituals/compare/1.1.1...1.2.0

Full Changelog: https://github.com/Underwood-Inc/rituals/compare/1.1.0...1.1.1

Overview

This release introduces the Fabric Mod variant of Rituals, providing native mod commands that work seamlessly in singleplayer without requiring a multiplayer server. The mod variant includes all the functionality of the datapack version but with improved command integration and user experience.

🎮 Key Features

Native Mod Commands

• All commands now use /rituals instead of /function rituals:*
• Works in singleplayer - No need to "Open to LAN" or run a dedicated server
• Improved help system - Comprehensive categorized command guide
• Permission-aware - Admin commands only visible to operators
• Pure Java implementation - Commands interact directly with Minecraft's internal systems

Command Structure

/rituals <command> [subcommand] [arguments]

📋 Complete Command Reference

Basic Commands

Item Commands

Configuration & Progress

Admin Commands (Requires OP)

🔄 Migration from Datapack Commands

Command Comparison

🛠️ Technical Changes

Architecture

• Fabric API Integration - Commands use Fabric's Command API v2
• Pure Java Implementation - No longer wraps datapack functions for core commands
• Data Component System - Uses Minecraft 1.21's DataComponentTypes for item creation
• Persistent Storage Integration - Admin commands modify data storage rituals:config and sync to scoreboards
• Silent Command Execution - Config updates use ServerCommandSource.withSilent() to prevent chat spam

Code Organization

• RitualsMod.java - Main mod initializer and command registration
• HelpCommand.java - Comprehensive help system
• AdminCommands.java - All administrative commands
• RitualsConfig.java - Configuration management (future use)

Item Generation

• Guidebook: 16-page written book with identical content to datapack version
• Totems: Warped fungus on a stick with custom NBT data (rituals_totem, totem_tier, totem_short)
• Custom Names: Hex color codes preserved (#D2691E, #FF6347, #C0C0C0, #FFD700, #00CED1, #8B008B)
• Enchantment Glint: Diamond and Netherite totems show enchantment glint

Compatibility

• Datapack Still Included - The core ritual mechanics still use the datapack
• Hybrid System - Commands are Java, game logic is datapack
• Storage Integration - Java commands write to same NBT storage datapack reads
• Scoreboard Sync - Config changes automatically update scoreboard values

📦 Installation

Requirements

• Minecraft 1.21+
• Fabric Loader 0.16.0+
• Fabric API 0.100.0+

Setup

1. Install Fabric Loader for Minecraft 1.21+
2. Download and install Fabric API
3. Place rituals-1.1.0.jar in your mods folder
4. Launch the game - the datapack is included in the mod

🎯 Benefits of Mod Variant

For Players

• ✅ Works in pure singleplayer - No "Open to LAN" required
• ✅ Tab completion - All commands support tab completion
• ✅ Better help system - Categorized, color-coded command guide
• ✅ Cleaner chat - No /function references in command output
• ✅ Permission-aware - Only see commands you can actually use

For Server Admins

• ✅ Same functionality - All datapack features preserved
• ✅ Better command structure - Easier to remember /rituals prefix
• ✅ Silent updates - Config changes don't spam chat
• ✅ Native integration - Uses Fabric's permission system

For Developers

• ✅ Organized code - Separated into logical classes
• ✅ Maintainable - Pure Java is easier to debug than mcfunction
• ✅ Extensible - Easy to add new commands
• ✅ Well-documented - Inline comments and structure

🐛 Known Issues

None currently identified. The mod has been tested in both singleplayer and multiplayer environments.

🔮 Future Plans

• Add more admin commands for ritual management
• Implement in-game config GUI
• Add command aliases for common operations
• Expand help system with example usage
• Add command cooldowns/rate limiting options

📝 Changelog Summary

Added

• Native /rituals command system with 30+ subcommands
• Comprehensive categorized help menu
• Pure Java implementations for all user-facing commands
• Permission-aware command visibility
• Silent config update system

Changed

• All commands now use /rituals prefix instead of /function rituals:
• Help command now shows categorized sections
• Admin commands provide cleaner feedback without datapack references
• Config reload no longer shows verbose output

Fixed

• Commands now work in pure singleplayer
• Admin commands properly sync storage to scoreboards
• Item generation uses correct NBT structure for totems
• Guidebook content matches datapack version exactly

Technical

• Migrated to Fabric Command API v2
• Implemented DataComponentTypes for item creation
• Added RitualsConfig and AdminCommands classes
• Integrated with Minecraft's persistent storage system

💬 Support

• Discord: Join our Discord
• GitHub: Report Issues
• Modrinth: View on Modrinth

Note: The datapack variant is still available separately for users who prefer traditional datapack functionality or cannot use Fabric mods.

Full Changelog: https://github.com/Underwood-Inc/rituals/compare/1.1.0...1.1.1

Overview

This release introduces the Fabric Mod variant of Rituals, providing native mod commands that work seamlessly in singleplayer without requiring a multiplayer server. The mod variant includes all the functionality of the datapack version but with improved command integration and user experience.

🎮 Key Features

Native Mod Commands

• All commands now use /rituals instead of /function rituals:*
• Works in singleplayer - No need to "Open to LAN" or run a dedicated server
• Improved help system - Comprehensive categorized command guide
• Permission-aware - Admin commands only visible to operators
• Pure Java implementation - Commands interact directly with Minecraft's internal systems

Command Structure

/rituals <command> [subcommand] [arguments]

📋 Complete Command Reference

Basic Commands

Item Commands

Configuration & Progress

Admin Commands (Requires OP)

🔄 Migration from Datapack Commands

Command Comparison

🛠️ Technical Changes

Architecture

• Fabric API Integration - Commands use Fabric's Command API v2
• Pure Java Implementation - No longer wraps datapack functions for core commands
• Data Component System - Uses Minecraft 1.21's DataComponentTypes for item creation
• Persistent Storage Integration - Admin commands modify data storage rituals:config and sync to scoreboards
• Silent Command Execution - Config updates use ServerCommandSource.withSilent() to prevent chat spam

Code Organization

• RitualsMod.java - Main mod initializer and command registration
• HelpCommand.java - Comprehensive help system
• AdminCommands.java - All administrative commands
• RitualsConfig.java - Configuration management (future use)

Item Generation

• Guidebook: 16-page written book with identical content to datapack version
• Totems: Warped fungus on a stick with custom NBT data (rituals_totem, totem_tier, totem_short)
• Custom Names: Hex color codes preserved (#D2691E, #FF6347, #C0C0C0, #FFD700, #00CED1, #8B008B)
• Enchantment Glint: Diamond and Netherite totems show enchantment glint

Compatibility

• Datapack Still Included - The core ritual mechanics still use the datapack
• Hybrid System - Commands are Java, game logic is datapack
• Storage Integration - Java commands write to same NBT storage datapack reads
• Scoreboard Sync - Config changes automatically update scoreboard values

📦 Installation

Requirements

• Minecraft 1.21+
• Fabric Loader 0.16.0+
• Fabric API 0.100.0+

Setup

1. Install Fabric Loader for Minecraft 1.21+
2. Download and install Fabric API
3. Place rituals-1.1.0.jar in your mods folder
4. Launch the game - the datapack is included in the mod

🎯 Benefits of Mod Variant

For Players

• ✅ Works in pure singleplayer - No "Open to LAN" required
• ✅ Tab completion - All commands support tab completion
• ✅ Better help system - Categorized, color-coded command guide
• ✅ Cleaner chat - No /function references in command output
• ✅ Permission-aware - Only see commands you can actually use

For Server Admins

• ✅ Same functionality - All datapack features preserved
• ✅ Better command structure - Easier to remember /rituals prefix
• ✅ Silent updates - Config changes don't spam chat
• ✅ Native integration - Uses Fabric's permission system

For Developers

• ✅ Organized code - Separated into logical classes
• ✅ Maintainable - Pure Java is easier to debug than mcfunction
• ✅ Extensible - Easy to add new commands
• ✅ Well-documented - Inline comments and structure

🐛 Known Issues

None currently identified. The mod has been tested in both singleplayer and multiplayer environments.

🔮 Future Plans

• Add more admin commands for ritual management
• Implement in-game config GUI
• Add command aliases for common operations
• Expand help system with example usage
• Add command cooldowns/rate limiting options

📝 Changelog Summary

Added

• Native /rituals command system with 30+ subcommands
• Comprehensive categorized help menu
• Pure Java implementations for all user-facing commands
• Permission-aware command visibility
• Silent config update system

Changed

• All commands now use /rituals prefix instead of /function rituals:
• Help command now shows categorized sections
• Admin commands provide cleaner feedback without datapack references
• Config reload no longer shows verbose output

Fixed

• Commands now work in pure singleplayer
• Admin commands properly sync storage to scoreboards
• Item generation uses correct NBT structure for totems
• Guidebook content matches datapack version exactly

Technical

• Migrated to Fabric Command API v2
• Implemented DataComponentTypes for item creation
• Added RitualsConfig and AdminCommands classes
• Integrated with Minecraft's persistent storage system

💬 Support

• Discord: Join our Discord
• GitHub: Report Issues
• Modrinth: View on Modrinth

Note: The datapack variant is still available separately for users who prefer traditional datapack functionality or cannot use Fabric mods.

Full Changelog: https://github.com/Underwood-Inc/rituals/compare/1.0.0...1.1.0

Changelog

• added protections to prevent accidental activated ritual changes
  • to change a ritual on a totem you must break the totem itself
    • when in display mode (no active ritual) you may still freely swap the displayed item

Full Changelog: https://github.com/Underwood-Inc/rituals/compare/1.0.0...1.1.0

Changelog

• added protections to prevent accidental activated ritual changes
  • to change a ritual on a totem you must break the totem itself
    • when in display mode (no active ritual) you may still freely swap the displayed item

v1 Release!

✨240 Downloads at time of writing

This release brings more advancements that, due to their nature, are largely untested. All rituals have been play-tested on at least one totem tier.

Please, report any bugs you find.

Badge System Update - Per-Ritual Mastery Tracking

New Features

76 Hidden Advancements Added

• 8 Unique Type Progression - Track completing different ritual types (First Steps → Ultimate Ritualist)
• 8 Specific Ritual Completion - Unlock for completing each ritual once (Growth Master, Strength Master, etc.)
• 4 Total Activation Milestones - Based on total rituals performed (10, 25, 50, 100)
• 56 Per-Ritual Mastery Advancements - Each of the 8 ritual types now has 7 milestones:
  • Apprentice (25), Adept (50), Expert (75), Virtuoso (100), Legend (200), Grandmaster (500), Transcendent (1000)

Technical Changes

New Scoreboards:

• rituals.growth_count - Tracks Growth Ritual activation count
• rituals.strength_count - Tracks Strength Ritual activation count
• rituals.prosperity_count - Tracks Prosperity Ritual activation count
• rituals.protection_count - Tracks Protection Ritual activation count
• rituals.healing_count - Tracks Healing Ritual activation count
• rituals.sentry_count - Tracks Sentry Ritual activation count
• rituals.farming_count - Tracks Auto-Farming Ritual activation count
• rituals.breeding_count - Tracks Auto-Breeding Ritual activation count

Updated Functions:

• load.mcfunction - Initializes 8 new per-ritual counters
• mark_ritual_complete.mcfunction - Increments both total and per-ritual counters
• check_hidden_advancements.mcfunction - Grants 56 new per-ritual mastery advancements
• check_status.mcfunction - Displays total activation count

New Advancement Files:

• 56 advancement JSON files in data/rituals/advancement/hidden/counts/{ritual_type}/{count}.json

Player Impact

• All advancements are completely hidden until unlocked
• Progress tracks automatically - no player action needed
• Grandmaster (500) and Transcendent (1000) achievements announce to server chat
• Check progress anytime with /function rituals:badges/check_status

v1 Release!

✨240 Downloads at time of writing

This release brings more advancements that, due to their nature, are largely untested. All rituals have been play-tested on at least one totem tier.

Please, report any bugs you find.

Badge System Update - Per-Ritual Mastery Tracking

New Features

76 Hidden Advancements Added

• 8 Unique Type Progression - Track completing different ritual types (First Steps → Ultimate Ritualist)
• 8 Specific Ritual Completion - Unlock for completing each ritual once (Growth Master, Strength Master, etc.)
• 4 Total Activation Milestones - Based on total rituals performed (10, 25, 50, 100)
• 56 Per-Ritual Mastery Advancements - Each of the 8 ritual types now has 7 milestones:
  • Apprentice (25), Adept (50), Expert (75), Virtuoso (100), Legend (200), Grandmaster (500), Transcendent (1000)

Technical Changes

New Scoreboards:

• rituals.growth_count - Tracks Growth Ritual activation count
• rituals.strength_count - Tracks Strength Ritual activation count
• rituals.prosperity_count - Tracks Prosperity Ritual activation count
• rituals.protection_count - Tracks Protection Ritual activation count
• rituals.healing_count - Tracks Healing Ritual activation count
• rituals.sentry_count - Tracks Sentry Ritual activation count
• rituals.farming_count - Tracks Auto-Farming Ritual activation count
• rituals.breeding_count - Tracks Auto-Breeding Ritual activation count

Updated Functions:

• load.mcfunction - Initializes 8 new per-ritual counters
• mark_ritual_complete.mcfunction - Increments both total and per-ritual counters
• check_hidden_advancements.mcfunction - Grants 56 new per-ritual mastery advancements
• check_status.mcfunction - Displays total activation count

New Advancement Files:

• 56 advancement JSON files in data/rituals/advancement/hidden/counts/{ritual_type}/{count}.json

Player Impact

• All advancements are completely hidden until unlocked
• Progress tracks automatically - no player action needed
• Grandmaster (500) and Transcendent (1000) achievements announce to server chat
• Check progress anytime with /function rituals:badges/check_status