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
/ritualsinstead 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:configand sync to scoreboards - Silent Command Execution - Config updates use
ServerCommandSource.withSilent()to prevent chat spam
Code Organization
RitualsMod.java- Main mod initializer and command registrationHelpCommand.java- Comprehensive help systemAdminCommands.java- All administrative commandsRitualsConfig.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
- Install Fabric Loader for Minecraft 1.21+
- Download and install Fabric API
- Place
rituals-1.1.0.jarin yourmodsfolder - 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
/functionreferences 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
/ritualsprefix - ✅ 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
/ritualscommand 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
/ritualsprefix 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
- to change a ritual on a totem you must break the totem itself
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 countrituals.strength_count- Tracks Strength Ritual activation countrituals.prosperity_count- Tracks Prosperity Ritual activation countrituals.protection_count- Tracks Protection Ritual activation countrituals.healing_count- Tracks Healing Ritual activation countrituals.sentry_count- Tracks Sentry Ritual activation countrituals.farming_count- Tracks Auto-Farming Ritual activation countrituals.breeding_count- Tracks Auto-Breeding Ritual activation count
Updated Functions:
load.mcfunction- Initializes 8 new per-ritual countersmark_ritual_complete.mcfunction- Increments both total and per-ritual counterscheck_hidden_advancements.mcfunction- Grants 56 new per-ritual mastery advancementscheck_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
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
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
- 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
- North:
- 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
- Place central totem with the ritual item
- (Optional) Power with redstone to see particle guide
- Place surrounding totems in the correct pattern
- Place required items on surrounding totems
- Perform fire sacrifice at center totem
- Pattern is validated and ritual activates if correct
- 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)
/data modify storage rituals:config require_fire_sacrifice set value false
/function rituals:config/reload
Enable Fire Sacrifice (Default)
/data modify storage rituals:config require_fire_sacrifice set value true
/function rituals:config/reload
Check Current Setting
/data get storage rituals:config require_fire_sacrifice