ВЕРСИИ (53)

add support for Minecraft v26.3

add support for Minecraft v26.3

add support for Minecraft v26.3

- add on-join welcome message

performance improvements

performance improvements

performance improvements

Added resourcepack support for the icons. The placed totems are still reusing vanilla textures so they will update when you change your resourcepack settings automatically. 

Added resourcepack support for the icons. The placed totems are still reusing vanilla textures so they will update when you change your resourcepack settings automatically. 

Added resourcepack support for the icons. The placed totems are still reusing vanilla textures so they will update when you change your resourcepack settings automatically. 

integration fixes for when recipes conflicts arise

integration fixes for when recipes conflicts arise

paper support, chest-gui enhancements

paper support, chest-gui enhancements

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](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`

**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](https://modrinth.com/mod/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](https://modrinth.com/mod/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 <img width="1024" height="256" alt="image" src="https://github.com/user-attachments/assets/d7ec352a-0cd3-4f1d-9846-ff9d067bf5e3" /> ## 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 | Command | Description | Permission | |---------|-------------|------------| | `/rituals help` | Display comprehensive command guide with categories | All players | | `/rituals guidebook` | Receive the Rituals guidebook (written book) | All players | | `/rituals get` | Display information about obtaining ritual items | All players | ### Item Commands | Command | Description | Permission | |---------|-------------|------------| | `/rituals give all` | Give all 12 totems (6 tiers × 2 variants) + guidebook | All players | | `/rituals give guidebook` | Give another copy of the guidebook | All players | | `/rituals give totem_basic` | Give Basic Totem (Tier 1) | All players | | `/rituals give totem_copper` | Give Copper Totem (Tier 2) | All players | | `/rituals give totem_iron` | Give Iron Totem (Tier 3) | All players | | `/rituals give totem_gold` | Give Gold Totem (Tier 4) | All players | | `/rituals give totem_advanced` | Give Advanced Totem (Tier 5) | All players | | `/rituals give totem_netherite` | Give Netherite Totem (Tier 6) | All players | | `/rituals give totem_basic_short` | Give Basic Totem (short variant) | All players | | `/rituals give totem_copper_short` | Give Copper Totem (short variant) | All players | | `/rituals give totem_iron_short` | Give Iron Totem (short variant) | All players | | `/rituals give totem_gold_short` | Give Gold Totem (short variant) | All players | | `/rituals give totem_advanced_short` | Give Advanced Totem (short variant) | All players | | `/rituals give totem_netherite_short` | Give Netherite Totem (short variant) | All players | ### Configuration & Progress | Command | Description | Permission | |---------|-------------|------------| | `/rituals config reload` | Reload configuration from storage | All players | | `/rituals badges check_status` | View your ritual mastery progress and badge tier | All players | ### Admin Commands (Requires OP) | Command | Description | Permission | |---------|-------------|------------| | `/rituals admin enable_kiwi_mode` | Enable easy mode (rituals don't require fire sacrifice) | OP Level 2 | | `/rituals admin disable_kiwi_mode` | Disable easy mode (restore fire sacrifice requirement) | OP Level 2 | | `/rituals admin enable_debug_mode` | Enable debug messages for troubleshooting | OP Level 2 | | `/rituals admin disable_debug_mode` | Disable debug messages | OP Level 2 | | `/rituals admin debug_status` | View current system configuration and status | OP Level 2 | | `/rituals admin list_totems` | List all active totems in the world | OP Level 2 | | `/rituals admin reset_all` | Reset all active rituals and clear ritual states | OP Level 2 | | `/rituals admin uninstall` | Remove all Rituals data (scoreboards, entities, storage) | OP Level 2 | | `/rituals admin unlock_all_recipes` | Unlock all 12 totem crafting recipes for yourself | OP Level 2 | | `/rituals admin update_previews` | Update ritual preview displays (placeholder) | OP Level 2 | | `/rituals admin test_recipes` | Test recipe functionality (placeholder) | OP Level 2 | | `/rituals admin debug_recipes` | Debug recipe issues (placeholder) | OP Level 2 | | `/rituals admin debug_barriers` | Debug barrier-related issues | OP Level 2 | --- ## 🔄 Migration from Datapack Commands ### Command Comparison | Old Datapack Command | New Mod Command | Notes | |---------------------|-----------------|-------| | `/function rituals:help` | `/rituals help` | Improved categorized display | | `/function rituals:guidebook` | `/rituals guidebook` | Identical functionality | | `/function rituals:give/all` | `/rituals give all` | Now includes guidebook | | `/function rituals:give/guidebook` | `/rituals give guidebook` | Identical functionality | | `/function rituals:give/totem_basic` | `/rituals give totem_basic` | All 6 tiers supported | | `/function rituals:config/reload` | `/rituals config reload` | Silent scoreboard updates | | `/function rituals:badges/check_status` | `/rituals badges check_status` | Identical functionality | | `/function rituals:admin/enable_kiwi_mode` | `/rituals admin enable_kiwi_mode` | No more `/function` in output | | `/function rituals:admin/enable_debug_mode` | `/rituals admin enable_debug_mode` | Clean broadcast messages | | `/function rituals:admin/debug_status` | `/rituals admin debug_status` | Improved formatting | | `/function rituals:admin/list_totems` | `/rituals admin list_totems` | Identical functionality | | `/function rituals:admin/reset_all` | `/rituals admin reset_all` | Identical functionality | | `/function rituals:admin/uninstall` | `/rituals admin uninstall` | Identical functionality | | `/function rituals:admin/unlock_all_recipes` | `/rituals admin unlock_all_recipes` | Identical functionality | --- ## 🛠️ 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](https://discord.gg/mpThbx67J7) - **GitHub**: [Report Issues](https://github.com/Underwood-Inc/rituals/issues) - **Modrinth**: [View on Modrinth](https://modrinth.com/datapack/totem-rituals) --- **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 <img width="1024" height="256" alt="image" src="https://github.com/user-attachments/assets/d7ec352a-0cd3-4f1d-9846-ff9d067bf5e3" /> ## 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 | Command | Description | Permission | |---------|-------------|------------| | `/rituals help` | Display comprehensive command guide with categories | All players | | `/rituals guidebook` | Receive the Rituals guidebook (written book) | All players | | `/rituals get` | Display information about obtaining ritual items | All players | ### Item Commands | Command | Description | Permission | |---------|-------------|------------| | `/rituals give all` | Give all 12 totems (6 tiers × 2 variants) + guidebook | All players | | `/rituals give guidebook` | Give another copy of the guidebook | All players | | `/rituals give totem_basic` | Give Basic Totem (Tier 1) | All players | | `/rituals give totem_copper` | Give Copper Totem (Tier 2) | All players | | `/rituals give totem_iron` | Give Iron Totem (Tier 3) | All players | | `/rituals give totem_gold` | Give Gold Totem (Tier 4) | All players | | `/rituals give totem_advanced` | Give Advanced Totem (Tier 5) | All players | | `/rituals give totem_netherite` | Give Netherite Totem (Tier 6) | All players | | `/rituals give totem_basic_short` | Give Basic Totem (short variant) | All players | | `/rituals give totem_copper_short` | Give Copper Totem (short variant) | All players | | `/rituals give totem_iron_short` | Give Iron Totem (short variant) | All players | | `/rituals give totem_gold_short` | Give Gold Totem (short variant) | All players | | `/rituals give totem_advanced_short` | Give Advanced Totem (short variant) | All players | | `/rituals give totem_netherite_short` | Give Netherite Totem (short variant) | All players | ### Configuration & Progress | Command | Description | Permission | |---------|-------------|------------| | `/rituals config reload` | Reload configuration from storage | All players | | `/rituals badges check_status` | View your ritual mastery progress and badge tier | All players | ### Admin Commands (Requires OP) | Command | Description | Permission | |---------|-------------|------------| | `/rituals admin enable_kiwi_mode` | Enable easy mode (rituals don't require fire sacrifice) | OP Level 2 | | `/rituals admin disable_kiwi_mode` | Disable easy mode (restore fire sacrifice requirement) | OP Level 2 | | `/rituals admin enable_debug_mode` | Enable debug messages for troubleshooting | OP Level 2 | | `/rituals admin disable_debug_mode` | Disable debug messages | OP Level 2 | | `/rituals admin debug_status` | View current system configuration and status | OP Level 2 | | `/rituals admin list_totems` | List all active totems in the world | OP Level 2 | | `/rituals admin reset_all` | Reset all active rituals and clear ritual states | OP Level 2 | | `/rituals admin uninstall` | Remove all Rituals data (scoreboards, entities, storage) | OP Level 2 | | `/rituals admin unlock_all_recipes` | Unlock all 12 totem crafting recipes for yourself | OP Level 2 | | `/rituals admin update_previews` | Update ritual preview displays (placeholder) | OP Level 2 | | `/rituals admin test_recipes` | Test recipe functionality (placeholder) | OP Level 2 | | `/rituals admin debug_recipes` | Debug recipe issues (placeholder) | OP Level 2 | | `/rituals admin debug_barriers` | Debug barrier-related issues | OP Level 2 | --- ## 🔄 Migration from Datapack Commands ### Command Comparison | Old Datapack Command | New Mod Command | Notes | |---------------------|-----------------|-------| | `/function rituals:help` | `/rituals help` | Improved categorized display | | `/function rituals:guidebook` | `/rituals guidebook` | Identical functionality | | `/function rituals:give/all` | `/rituals give all` | Now includes guidebook | | `/function rituals:give/guidebook` | `/rituals give guidebook` | Identical functionality | | `/function rituals:give/totem_basic` | `/rituals give totem_basic` | All 6 tiers supported | | `/function rituals:config/reload` | `/rituals config reload` | Silent scoreboard updates | | `/function rituals:badges/check_status` | `/rituals badges check_status` | Identical functionality | | `/function rituals:admin/enable_kiwi_mode` | `/rituals admin enable_kiwi_mode` | No more `/function` in output | | `/function rituals:admin/enable_debug_mode` | `/rituals admin enable_debug_mode` | Clean broadcast messages | | `/function rituals:admin/debug_status` | `/rituals admin debug_status` | Improved formatting | | `/function rituals:admin/list_totems` | `/rituals admin list_totems` | Identical functionality | | `/function rituals:admin/reset_all` | `/rituals admin reset_all` | Identical functionality | | `/function rituals:admin/uninstall` | `/rituals admin uninstall` | Identical functionality | | `/function rituals:admin/unlock_all_recipes` | `/rituals admin unlock_all_recipes` | Identical functionality | --- ## 🛠️ 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](https://discord.gg/mpThbx67J7) - **GitHub**: [Report Issues](https://github.com/Underwood-Inc/rituals/issues) - **Modrinth**: [View on Modrinth](https://modrinth.com/datapack/totem-rituals) --- **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`

- remove the XP harvester ritual - sentry totem range display is now accurate to 2x that of the base totem range _wood fence normal netherite totem range, nether brick fence is the sentry range_ <img width="1920" height="1057" alt="2025-10-20_18 58 51" src="https://github.com/user-attachments/assets/bb744dbb-d420-4e51-b06e-94d14eec144c" />

- remove the XP harvester ritual - sentry totem range display is now accurate to 2x that of the base totem range _wood fence normal netherite totem range, nether brick fence is the sentry range_ <img width="1920" height="1057" alt="2025-10-20_18 58 51" src="https://github.com/user-attachments/assets/bb744dbb-d420-4e51-b06e-94d14eec144c" />

Prosperity totem will now pull items towards the totem.

Prosperity totem will now pull items towards the totem.

**Full Changelog**: https://github.com/Underwood-Inc/rituals/compare/0.0.8...0.0.10 > the resourcepack _should_ now be optional, have not verified for the datapack variant - rebalance growth ritual - fix errant particle clusters in auto-farm ritual - icon fix on resource pack

**Full Changelog**: https://github.com/Underwood-Inc/rituals/compare/0.0.8...0.0.10 - rebalance growth ritual - fix errant particle clusters in auto-farm ritual - icon fix on resource pack

- bug fixes - advancement changes/progression - debug log system

- bug fixes - advancement changes/progression - debug log system

Fix Growth and Auto-farm rituals. Fix the advancements background. Remove upgrade paths. replace totems to upgrade, there is no more Ritual Paste or Upgrade Slate(s)

Fix Growth and Auto-farm rituals. Fix the advancements background. Remove upgrade paths. replace totems to upgrade, there is no more Ritual Paste or Upgrade Slate(s)

This update brings a new advanced-tier ritual system that requires multiple totems and specific ritual items. Additionally, there is a guided system to help you arrange the ritual components! # Bug fixes - links in chat and help commands (click and hover support) - performance - syntax issues # Features <img width="1920" height="1057" alt="image" src="https://github.com/user-attachments/assets/25c186ba-4a9e-444e-bf11-6fd59f4d4620" /> - a total of nine rituals, and three of them are multi-structure sacrificial ones - when you enable "Kiwi Mode" a Kiwi icon and text status will appear on the screen until turned off - multi-totem rituals with particle helper system - multiple variants ## Current Ritual System Overview ### ✅ CURRENTLY IMPLEMENTED RITUALS (9 Total) #### Standard Single-Totem Rituals (6) These work with 1+ totems displaying the same item. Fire sacrifice is required to activate. ##### 1. Growth Ritual 🌱 - **Item**: `Emerald` - **Effect**: Bonemeals crops/plants in range - **Frequency**: 15s → 3s (tier 1→6) - **Range**: Tier-based (2×2 to 7×7 horizontal) - **Min Totems**: 1+ ##### 2. Strength Ritual 💪 - **Item**: `Diamond` - **Effect**: Grants Strength + Resistance buffs to players - **Frequency**: 2s → 0.75s (tier 1→6) - **Duration**: 10-30s based on tier - **Range**: Tier-based - **Min Totems**: 1+ ##### 3. Prosperity Ritual 💰 - **Item**: `Netherite Block` - **Effect**: Attracts items + grants Luck effect to players - **Pull Speed**: 0.3 to 1.0 blocks/tick based on tier - **Luck Level**: 0-2 based on tier (helps with loot drops) - **Range**: Tier-based - **Min Totems**: 1+ - **Note**: No longer grants XP (use XP Harvester ritual instead) ##### 4. Protection Ritual ⚔️ - **Item**: `Iron Ingot` - **Effect**: Damages hostile mobs periodically - **Damage**: 2-8 HP based on tier - **Frequency**: 9s → 1.5s (tier 1→6) - **Range**: Tier-based - **Min Totems**: 1+ ##### 5. Healing Ritual 💖 - **Item**: `Nether Star` - **Effect**: Applies Regeneration to players and animals - **Duration**: 10-120s based on tier - **Frequency**: 3s → 1.25s (tier 1→6) - **Bonus**: Absorption at tier 3+ - **Range**: Tier-based - **Min Totems**: 1+ ##### 6. Sentry Ritual 🏹 - **Item**: `Arrow` - **Effect**: Fires homing magical projectiles at enemies - **Targets**: Hostile mobs in range - **Range**: Tier-based - **Min Totems**: 1+ --- #### Multi-Totem Pattern Rituals (3) These require specific geometric patterns with multiple totems. Fire sacrifice at center required. ##### 7. Auto-Farming Ritual 🚜 - **Central Item**: `Diamond Hoe` - **Pattern**: Square (4 corners) - **Layout**: 4 totems at corners, 5 blocks diagonal from center ``` Positions: (+5,+5), (+5,-5), (-5,-5), (-5,+5) ``` - **Required Items**: Any 4 items on corner totems (consumed on activation) - **Effect**: Automatically harvests and replants fully grown crops - **Range**: Tier-based from center - **Min Totems**: 5 (1 center + 4 corners) ##### 8. Auto-Breeding Ritual 🐄 - **Central Item**: `Wheat` - **Pattern**: Star (4 cardinals) - **Layout**: 4 totems at cardinal directions, 5 blocks from center ``` Positions: North (0,5), East (5,0), South (0,-5), West (-5,0) ``` - **Required Items**: - North: `Seeds` - East: `Carrot` - South: `Potato` - West: `Beetroot Seeds` - **Effect**: Automatically breeds animals in range when breeding conditions met - **Range**: Tier-based from center - **Min Totems**: 5 (1 center + 4 cardinals) ##### 9. XP Harvester Ritual ✨ - **Central Item**: `Experience Bottle` - **Pattern**: Pentagon (5 around) - **Layout**: 5 totems in pentagon pattern around center ``` Positions: - North: (0,5) - Northeast: (5,2) - Southeast: (3,-4) - Southwest: (-3,-4) - Northwest: (-5,2) ``` - **Required Items**: Any 5 items on surrounding totems (consumed on activation) - **Effect**: Generates XP directly to players in range - **XP Rate**: **Scales with tier!** - Tier 1 (Wood): 1 XP/second - Tier 2 (Copper): 2 XP/second - Tier 3 (Iron): 3 XP/second - Tier 4 (Gold): 4 XP/second - Tier 5 (Diamond): 5 XP/second - Tier 6 (Netherite): 6 XP/second - **Range**: Tier-based from center (larger at higher tiers) - **Requires**: Redstone power to operate (performance optimization) - **Min Totems**: 6 (1 center + 5 pentagon) --- ### 🎯 Pattern Ritual Features #### Visual Pattern Guides Power your central totem with redstone (place redstone block/torch/lever next to it) to see: - Colored particle markers showing where each surrounding totem should be placed - Different colors for each position - Enchanting particle effects to indicate the pattern type #### How Pattern Rituals Work 1. Place central totem with the ritual item 2. (Optional) Power with redstone to see particle guide 3. Place surrounding totems in the correct pattern 4. Place required items on surrounding totems 5. Perform fire sacrifice at center totem 6. Pattern is validated and ritual activates if correct 7. Items are consumed and ritual runs permanently until stopped --- ### 🚧 PLANNED/NOT IMPLEMENTED (5 More) These are defined in the system but not yet coded: - **Flight Zone** (Elytra) - Septagon pattern (7 totems) - **Weather Control** (Lightning Rod) - Septagon pattern (7 totems) - **Forcefield** (End Crystal) - Octagon pattern (8 totems) - **Mob Repellent** (Zombie Head) - Octagon pattern (8 totems) - **Time Warp** (Clock) - Nonagon pattern (9 totems) --- ### Totem Tiers & Ranges | Tier | Material | Horizontal Range | Vertical Range | |------|----------|------------------|----------------| | 1 | Wood | 2×2 | 3 blocks | | 2 | Copper | 3×3 | 4 blocks | | 3 | Iron | 4×4 | 5 blocks | | 4 | Gold | 5×5 | 6 blocks | | 5 | Diamond | 6×6 | 7 blocks | | 6 | Netherite | 7×7 | 8 blocks | --- ### Summary **Total Implemented**: 9 rituals - 6 standard single-totem rituals - 3 advanced multi-totem pattern rituals **Status**: Fully functional with tier scaling, pattern detection, visual guides, and balanced XP harvester rates! ****

This update brings a new advanced-tier ritual system that requires multiple totems and specific ritual items. Additionally, there is a guided system to help you arrange the ritual components! # Bug fixes - links in chat and help commands (click and hover support) - performance - syntax issues # Features <img width="1920" height="1057" alt="image" src="https://github.com/user-attachments/assets/25c186ba-4a9e-444e-bf11-6fd59f4d4620" /> - a total of nine rituals, and three of them are multi-structure sacrificial ones - when you enable "Kiwi Mode" a Kiwi icon and text status will appear on the screen until turned off - multi-totem rituals with particle helper system - multiple variants ## Current Ritual System Overview ### ✅ CURRENTLY IMPLEMENTED RITUALS (9 Total) #### Standard Single-Totem Rituals (6) These work with 1+ totems displaying the same item. Fire sacrifice is required to activate. ##### 1. Growth Ritual 🌱 - **Item**: `Emerald` - **Effect**: Bonemeals crops/plants in range - **Frequency**: 15s → 3s (tier 1→6) - **Range**: Tier-based (2×2 to 7×7 horizontal) - **Min Totems**: 1+ ##### 2. Strength Ritual 💪 - **Item**: `Diamond` - **Effect**: Grants Strength + Resistance buffs to players - **Frequency**: 2s → 0.75s (tier 1→6) - **Duration**: 10-30s based on tier - **Range**: Tier-based - **Min Totems**: 1+ ##### 3. Prosperity Ritual 💰 - **Item**: `Netherite Block` - **Effect**: Attracts items + grants Luck effect to players - **Pull Speed**: 0.3 to 1.0 blocks/tick based on tier - **Luck Level**: 0-2 based on tier (helps with loot drops) - **Range**: Tier-based - **Min Totems**: 1+ - **Note**: No longer grants XP (use XP Harvester ritual instead) ##### 4. Protection Ritual ⚔️ - **Item**: `Iron Ingot` - **Effect**: Damages hostile mobs periodically - **Damage**: 2-8 HP based on tier - **Frequency**: 9s → 1.5s (tier 1→6) - **Range**: Tier-based - **Min Totems**: 1+ ##### 5. Healing Ritual 💖 - **Item**: `Nether Star` - **Effect**: Applies Regeneration to players and animals - **Duration**: 10-120s based on tier - **Frequency**: 3s → 1.25s (tier 1→6) - **Bonus**: Absorption at tier 3+ - **Range**: Tier-based - **Min Totems**: 1+ ##### 6. Sentry Ritual 🏹 - **Item**: `Arrow` - **Effect**: Fires homing magical projectiles at enemies - **Targets**: Hostile mobs in range - **Range**: Tier-based - **Min Totems**: 1+ --- #### Multi-Totem Pattern Rituals (3) These require specific geometric patterns with multiple totems. Fire sacrifice at center required. ##### 7. Auto-Farming Ritual 🚜 - **Central Item**: `Diamond Hoe` - **Pattern**: Square (4 corners) - **Layout**: 4 totems at corners, 5 blocks diagonal from center ``` Positions: (+5,+5), (+5,-5), (-5,-5), (-5,+5) ``` - **Required Items**: Any 4 items on corner totems (consumed on activation) - **Effect**: Automatically harvests and replants fully grown crops - **Range**: Tier-based from center - **Min Totems**: 5 (1 center + 4 corners) ##### 8. Auto-Breeding Ritual 🐄 - **Central Item**: `Wheat` - **Pattern**: Star (4 cardinals) - **Layout**: 4 totems at cardinal directions, 5 blocks from center ``` Positions: North (0,5), East (5,0), South (0,-5), West (-5,0) ``` - **Required Items**: - North: `Seeds` - East: `Carrot` - South: `Potato` - West: `Beetroot Seeds` - **Effect**: Automatically breeds animals in range when breeding conditions met - **Range**: Tier-based from center - **Min Totems**: 5 (1 center + 4 cardinals) ##### 9. XP Harvester Ritual ✨ - **Central Item**: `Experience Bottle` - **Pattern**: Pentagon (5 around) - **Layout**: 5 totems in pentagon pattern around center ``` Positions: - North: (0,5) - Northeast: (5,2) - Southeast: (3,-4) - Southwest: (-3,-4) - Northwest: (-5,2) ``` - **Required Items**: Any 5 items on surrounding totems (consumed on activation) - **Effect**: Generates XP directly to players in range - **XP Rate**: **Scales with tier!** - Tier 1 (Wood): 1 XP/second - Tier 2 (Copper): 2 XP/second - Tier 3 (Iron): 3 XP/second - Tier 4 (Gold): 4 XP/second - Tier 5 (Diamond): 5 XP/second - Tier 6 (Netherite): 6 XP/second - **Range**: Tier-based from center (larger at higher tiers) - **Requires**: Redstone power to operate (performance optimization) - **Min Totems**: 6 (1 center + 5 pentagon) --- ### 🎯 Pattern Ritual Features #### Visual Pattern Guides Power your central totem with redstone (place redstone block/torch/lever next to it) to see: - Colored particle markers showing where each surrounding totem should be placed - Different colors for each position - Enchanting particle effects to indicate the pattern type #### How Pattern Rituals Work 1. Place central totem with the ritual item 2. (Optional) Power with redstone to see particle guide 3. Place surrounding totems in the correct pattern 4. Place required items on surrounding totems 5. Perform fire sacrifice at center totem 6. Pattern is validated and ritual activates if correct 7. Items are consumed and ritual runs permanently until stopped --- ### 🚧 PLANNED/NOT IMPLEMENTED (5 More) These are defined in the system but not yet coded: - **Flight Zone** (Elytra) - Septagon pattern (7 totems) - **Weather Control** (Lightning Rod) - Septagon pattern (7 totems) - **Forcefield** (End Crystal) - Octagon pattern (8 totems) - **Mob Repellent** (Zombie Head) - Octagon pattern (8 totems) - **Time Warp** (Clock) - Nonagon pattern (9 totems) --- ### Totem Tiers & Ranges | Tier | Material | Horizontal Range | Vertical Range | |------|----------|------------------|----------------| | 1 | Wood | 2×2 | 3 blocks | | 2 | Copper | 3×3 | 4 blocks | | 3 | Iron | 4×4 | 5 blocks | | 4 | Gold | 5×5 | 6 blocks | | 5 | Diamond | 6×6 | 7 blocks | | 6 | Netherite | 7×7 | 8 blocks | --- ### Summary **Total Implemented**: 9 rituals - 6 standard single-totem rituals - 3 advanced multi-totem pattern rituals **Status**: Fully functional with tier scaling, pattern detection, visual guides, and balanced XP harvester rates! ****

**Full Changelog**: https://github.com/Underwood-Inc/rituals/compare/0.0.4...0.0.5 ## Changes - Add release support for Fabric mod loader for use in modpacks - Fix config commands setting to allow disabling the requirement of a fire ritual (kiwi mode). ### Disable Fire Sacrifice (Auto-Activation) ```mcfunction /data modify storage rituals:config require_fire_sacrifice set value false /function rituals:config/reload ``` ### Enable Fire Sacrifice (Default) ```mcfunction /data modify storage rituals:config require_fire_sacrifice set value true /function rituals:config/reload ``` ### Check Current Setting ```mcfunction /data get storage rituals:config require_fire_sacrifice ```

**Full Changelog**: https://github.com/Underwood-Inc/rituals/compare/0.0.4...0.0.5 ## Changes - Add release support for Fabric mod loader for use in modpacks - Fix config commands setting to allow disabling the requirement of a fire ritual (kiwi mode). ### Disable Fire Sacrifice (Auto-Activation) ```mcfunction /data modify storage rituals:config require_fire_sacrifice set value false /function rituals:config/reload ``` ### Enable Fire Sacrifice (Default) ```mcfunction /data modify storage rituals:config require_fire_sacrifice set value true /function rituals:config/reload ``` ### Check Current Setting ```mcfunction /data get storage rituals:config require_fire_sacrifice ```

# ADD RITUALS <img width="1920" height="1057" alt="image" src="https://github.com/user-attachments/assets/8e2440e2-4d4c-4fbb-87d0-868678296068" /> # Fire Sacrifice Quick Reference Card **Print this or keep it open for quick reference!** 📋 --- ## Basic Steps ``` 1. Place Totem → Sneak + Right-click 2. Add Ritual Item → Right-click totem with item (Diamond, Emerald, etc.) 3. Drop 4 Catalysts → Throw items on ground (N, S, E, W of totem) 4. Light Fire → Use Flint & Steel at totem base 5. Watch Magic! → Offerings consumed, ritual starts ``` --- ## Catalyst Costs (What to Drop) | Totem Tier | Catalyst Item | Quantity | Total Cost | |------------|--------------|----------|------------| | 🪵 Wood | Coal | 4 | Very Cheap | | 🟠 Copper | Copper Ingot | 4 | Cheap | | ⚙️ Iron | Iron Ingot | 4 | Moderate | | 🟡 Gold | Gold Ingot | 4 | Moderate-High | | 💎 Diamond | Diamond | 4 | High | | 🟣 Netherite | Netherite Ingot | 4 | Very High | --- ## Offering Placement ``` [North] | 2 blocks | [West] -- [TOTEM] -- [East] | 2 blocks | [South] ``` **Tips:** - Drop items approximately 2 blocks away - Any Y-level near ground is fine - All 4 must be present before lighting fire --- ## Ritual Items (What Goes ON the Totem) | Ritual Type | Item Needed | Effect | |-------------|-------------|--------| | 🌱 Growth | Emerald | Crop growth | | 💪 Strength | Diamond | Buffs players | | 💰 Prosperity | Netherite Block | Item magnet + XP | | 🛡️ Protection | Iron Ingot | Damages mobs | | 💖 Healing | Nether Star | Regeneration | | 🏹 Sentry | Arrow | Auto-turret | --- ## Fire Sources That Work ✅ Flint & Steel ✅ Fire Charge ✅ Flame Enchantment ✅ Lava (sets blocks on fire) ✅ Blaze Fireballs ✅ Soul Fire --- ## Troubleshooting ### Ritual Won't Activate? - [ ] 4 catalysts dropped? (correct type for tier) - [ ] Fire lit at totem base? - [ ] Ritual item on totem? - [ ] Totem not already running ritual? - [ ] Items on GROUND (not in inventory)? ### Items Disappeared? - Fire burned them before detection - **Solution**: Drop items FIRST, then light fire immediately --- ## Config Toggle (Admin Only) ```mcfunction # Disable fire sacrifice (auto-activation) /data modify storage rituals:config require_fire_sacrifice set value false /function rituals:config/reload # Re-enable fire sacrifice /data modify storage rituals:config require_fire_sacrifice set value true /function rituals:config/reload ``` --- ## Cost-Benefit Analysis | Tier | Cost/Ritual | Range | Worth It? | |------|------------|-------|-----------| | Wood | 4 Coal | 2×2×7 | ★★★ Best starter | | Copper | 4 Copper | 3×3×9 | ★★★ Great early | | Iron | 4 Iron | 4×4×11 | ★★★ Balanced mid-game | | Gold | 4 Gold | 5×5×13 | ★★☆ If you have gold farm | | Diamond | 4 Diamond | 6×6×15 | ★★☆ Expensive but powerful | | Netherite | 4 Netherite | 7×7×17 | ★☆☆ Only for permanent setups | --- **💡 Pro Tip**: Build a "ritual chamber" with pre-placed fire sources and item storage nearby for quick sacrifices! **📖 Full Guide**: See `FIRE_SACRIFICE_GUIDE.md`

**Full Changelog**: https://github.com/Underwood-Inc/rituals/compare/0.0.2...0.0.3 Switched to smoke markers (self-emitting particle emitters) instead of scoreboards and textures due to modpacks and other datapacks interfering with scoreboards, resulting in the visual showing totem ranges being removed. <img width="1920" height="1057" alt="totem ranges" src="https://github.com/user-attachments/assets/8c6e4359-08c3-4389-b44c-bb5b871cf7ba" />

Prosperity Ritual - performance enhanced - direct xp no orb spawn - requires netherite block for ritual activation instead of gold ingot

Introducing Rituals—a custom datapack + resourcepack combo that brings mystical totems and ritual magic into your world. Craft totems, display items, and trigger powerful effects through immersive rituals. Designed for builders, modpack creators, and lore lovers alike. 🔮 Features • Unique totem tiers with visual item displays • Automatic ritual activation based on placement • Custom textures, animations, and guidebook integration • Fully configurable and ready for expansion Built with care for the Minecraft community—open source, tweakable, and ready to enchant your next adventure.