Rituals

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

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
• 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.