![Minecraft 1.21.10](https://img.shields.io/badge/Minecraft-1.21.10-db1f29?style=for-the-badge&logo=minecraft) ![Fabric Loader 0.15.11](https://img.shields.io/badge/Fabric%20Loader-0.15.11-dbd0b4?style=for-the-badge&logo=fabricmc) # Totem Rituals Datapack/Mod > ✨ Thank you for 100 downloads 🥹 > 🎉 300 Downloads! Thank you! ~Oct.27.2025 > ＼(◎o◎)／ 420 Download achieved Nov.6.2025 > (●'◡'●) 550 Downloads on Nov.18.2025 ![Totem Rituals Banner](https://github.com/Underwood-Inc/rituals/raw/0.0.4/images/banner.png) Introducing Rituals—a datapack 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** • **8 Unique Rituals** - From simple growth magic to complex multi-totem patterns • **6 Totem Tiers** - Wood to Netherite with increasing power and range • **Visual Pattern Guides** - Redstone-powered particle markers for easy setup • **Fire Sacrifice System** - Immersive activation requiring catalyst offerings • **Interactive Menu System** - In-game totem browser and admin tools • **Custom Textures & Animations** - Beautiful visual effects and smooth item displays • **Fully Configurable** - Customize ranges, frequencies, and behavior • **Debug & Kiwi Modes** - Developer tools and easy mode for testing Built with care for the Minecraft community—open source, tweakable, and ready to enchant your next adventure. ## Version Information - **Minecraft Version**: 1.21+ (Pack Format 48) - **Datapack Version**: 1.0.0 - **Author**: Created with care for the Minecraft community by [strixun](https://www.twitch.tv/strixun) ## Installation

📦 Step-by-Step Installation Guide (Click to Expand)

This guide assumes you have no prior experience with Minecraft datapacks. A datapack is a special folder that adds new features to your Minecraft world. ### 1. Download the Datapack - If you received this as a ZIP file, you're ready to go - If you have the folder structure, compress it into a ZIP file first ### 2. Locate Your World Save Folder - Open Minecraft and note which world you want to add this to - Close Minecraft (important!) - Find your Minecraft saves folder: - **Windows**: Press `Win + R`, type `%appdata%\.minecraft\saves` and press Enter - **Mac**: Press `Cmd + Space`, type `~/Library/Application Support/minecraft/saves` and press Enter - **Linux**: Navigate to `~/.minecraft/saves` ### 3. Install the Datapack - Find the folder with your world's name - Open the `datapacks` folder inside (create it if it doesn't exist) - Place the datapack ZIP file (or folder) into this `datapacks` folder ### 4. Enable the Datapack - Launch Minecraft and open your world - You should see a message in chat: "[Totem Rituals] Datapack loaded successfully!" - If you don't see the message, type `/reload` in the chat and press Enter ### 5. Get Started - Type `/function rituals:give/all` to receive all totem items - You're now ready to perform rituals!

## Getting Started ### Quick Start Guide This datapack adds a new item category called "Totems" which can be crafted and placed in your world. When you place totems with specific items displayed on them, you can activate powerful rituals. Single-totem mode is enabled by default! **Basic Workflow:** 1. Craft totems (see [Crafting Recipes](#crafting-recipes)) 2. Right-click on the ground to place a totem 3. Right-click a placed totem with an item to display it 4. Drop 4 catalyst items around the totem (N/S/E/W) 5. Light fire at the totem base - the ritual activates! **Note**: Rituals now require a **Fire Sacrifice** to activate! See [Ritual System](#ritual-system) below. ## Available Rituals ### 🌟 Standard Single-Totem Rituals (6 Available) These powerful rituals work with just **1 totem** displaying the correct item. Perfect for beginners and small-scale magic! #### 1. Growth Ritual 🌱 - **Required Item**: `Emerald` - **Effect**: Automatically bonemeals crops and plants in range - **Frequency**: Every 15 seconds (Tier 1) → Every 3 seconds (Tier 6) - **Range**: 2×2 to 7×7 horizontal area based on tier - **Visual**: Green happy villager particles - **Perfect For**: Farming automation, tree growth, crop acceleration #### 2. Strength Ritual 💪 - **Required Item**: `Diamond` - **Effect**: Grants Strength and Resistance buffs to nearby players - **Duration**: 10-30 seconds based on tier - **Frequency**: Every 2 seconds to 0.75 seconds based on tier - **Range**: Tier-based area effect - **Visual**: Critical hit particles - **Perfect For**: Combat preparation, mining expeditions, mob farms #### 3. Prosperity Ritual 💰 - **Required Item**: `Netherite Block` - **Effect**: Attracts nearby items to the totem and 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 area effect - **Visual**: Golden dust particles - **Perfect For**: Item collection, loot farming, treasure hunting #### 4. Protection Ritual ⚔️ - **Required Item**: `Iron Ingot` - **Effect**: Damages hostile mobs in range periodically - **Damage**: 2-8 half-hearts per hit based on tier - **Frequency**: Every 9 seconds to 1.5 seconds based on tier - **Range**: Tier-based area effect - **Visual**: Blue dust particles and magic damage - **Perfect For**: Base defense, mob control, area protection #### 5. Healing Ritual 💖 - **Required Item**: `Nether Star` - **Effect**: Applies regeneration to nearby players and animals - **Duration**: 10-120 seconds based on tier - **Frequency**: Every 3 seconds to 1.25 seconds based on tier - **Bonus**: Absorption at tier 3+ - **Range**: Tier-based area effect - **Visual**: Pink/purple dust particles - **Perfect For**: Health regeneration, animal care, safe zones #### 6. Sentry Ritual 🏹 - **Required Item**: `Arrow` - **Effect**: Fires homing magical projectiles at hostile mobs - **Damage**: 1.5-12 half-hearts based on tier - **Fire Rate**: Every 9 seconds to 1.5 seconds based on tier - **Projectile Speed**: 0.4-1.2 blocks/tick based on tier - **Range**: 2× the normal tier range - **Visual**: Glowing projectile with trail particles - **Perfect For**: Automated defense, mob farming, perimeter security ### 🎯 Advanced Multi-Totem Pattern Rituals (2 Available) These complex rituals require **specific geometric patterns** with multiple totems. Each totem must display a specific item, and the pattern must be exact! #### 7. Auto-Farming Ritual 🚜 - **Central Item**: `Diamond Hoe` - **Pattern**: Square (4 diagonal corners) - **Layout**: 4 totems at corners, 5 blocks diagonal from center - **Required Items**: - NE Corner (+5,+5): `Wheat` - SE Corner (+5,-5): `Carrot` - SW Corner (-5,-5): `Potato` - NW Corner (-5,+5): `Beetroot` - **Effect**: Automatically harvests and replants fully grown crops every 5 seconds - **Supported Crops**: Wheat, Carrots, Potatoes, Beetroots, Nether Wart, Pumpkins, Melons, Sweet Berries, Cocoa Beans - **Range**: Tier-based from center - **Min Totems**: 5 (1 center + 4 corners) - **Perfect For**: Large-scale farming, AFK crop production #### 8. Auto-Breeding Ritual 🐄 - **Central Item**: `Wheat` - **Pattern**: Star (4 cardinal directions) - **Layout**: 4 totems at cardinal directions, 5 blocks from center - **Required Items**: - North (0,5): `Seeds` - East (5,0): `Carrot` - South (0,-5): `Potato` - West (-5,0): `Beetroot Seeds` - **Effect**: Automatically breeds animals in range when breeding conditions are met - **Range**: Tier-based from center - **Min Totems**: 5 (1 center + 4 cardinals) - **Perfect For**: Animal farms, livestock management, passive mob breeding ### 🎨 Visual Pattern Guides **NEW FEATURE!** 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 indicating the required item - **Enchanting particle effects** to indicate the pattern type - **Real-time updates** when you change items or totem positions This makes setup MUCH easier - you don't need to memorize coordinates! ## Ritual System **NEW!** Rituals now require a fire sacrifice to activate, making them more immersive and balanced. ### How It Works 1. **Place your totem** and add a ritual item (Diamond, Emerald, etc.) 2. **Drop 4 catalyst items** on the ground around your totem (North, South, East, West) 3. **Light a fire** at the totem's base using flint & steel 4. **The offerings are consumed** and your ritual begins! ### Catalyst Costs by Tier - 🪵 **Wood**: 4× Coal - 🟠 **Copper**: 4× Copper Ingot - ⚙️ **Iron**: 4× Iron Ingot - 🟡 **Gold**: 4× Gold Ingot - 💎 **Diamond**: 4× Diamond - 🟣 **Netherite**: 4× Netherite Ingot **Why this system?** - Makes rituals feel more magical and intentional - Balanced resource cost encourages totem upgrades - Prevents "set and forget" infinite rituals - You control when rituals activate **📖 See `FIRE_SACRIFICE_GUIDE.md` for complete instructions!**

⚙️ Prefer Auto-Activation? (Click to Expand)

Server admins can disable fire sacrifice and restore the old automatic activation: ```mcfunction /data modify storage rituals:config require_fire_sacrifice set value false /function rituals:config/reload ``` Or enable **Kiwi Mode** for easy testing: ```mcfunction /function rituals:admin/enable_kiwi_mode ```

## Totem Tiers

⚡ View All Totem Tiers (Click to Expand)

There are six tiers of totems, each with increasing effect power. All totems use tier-based ranges, with higher tiers providing stronger effects and larger areas. ### Tier 1 - Wood Totem - **Material**: Oak Planks + Sticks - **Range**: 2×2 horizontal, 3 up, 3 down - **Effect Power**: Basic - **Visual**: Oak fence post with item display on top ### Tier 2 - Copper Totem - **Material**: Copper Ingots - **Range**: 3×3 horizontal, 4 up, 4 down - **Effect Power**: Improved - **Visual**: Copper-colored post ### Tier 3 - Iron Totem - **Material**: Iron Ingots - **Range**: 4×4 horizontal, 5 up, 5 down - **Effect Power**: Strong - **Visual**: Iron bars with particles ### Tier 4 - Gold Totem - **Material**: Gold Ingots - **Range**: 5×5 horizontal, 6 up, 6 down - **Effect Power**: Very Strong - **Visual**: Golden post with particles ### Tier 5 - Diamond Totem - **Material**: Diamonds - **Range**: 6×6 horizontal, 7 up, 7 down - **Effect Power**: Powerful - **Visual**: Diamond post with cyan particles ### Tier 6 - Netherite Totem - **Material**: Netherite Ingots - **Range**: 7×7 horizontal, 8 up, 8 down - **Effect Power**: Maximum - **Visual**: Netherite post with purple particles ### Range Visualization ``` [item] ← Item display on top | ← Totem pole (fence post) ███████ ← 5×5×6 effect zone ███████ (3 blocks up, 3 down) ███████ ``` ![totem ranges](https://github.com/Underwood-Inc/rituals/blob/0.0.4/images/totem%20ranges.png?raw=true) *Visual comparison of effect ranges for all totem tiers* See `RANGE_DIAGRAM.md` for detailed range specifications.

## How to Use Totems ### Placing a Totem 1. Hold a totem item in your hand 2. Look at the ground where you want to place it 3. Right-click on the ground 4. The totem will appear as a vertical pole ### Adding Items to Totems 1. Hold the item you want to display 2. Right-click the totem 3. The item will appear floating above the totem 4. Only one item can be displayed per totem ### Removing Items from Totems 1. Break the totem with the corresponding tool. 2. Re-place the totem if desired. ### Breaking Totems 1. Punch (left-click or attack) the totem 2. The totem and any displayed item will drop 3. All visual effects will be removed ## Interactive Menu System

🎮 In-Game Menu Features (Click to Expand)

The datapack includes a comprehensive interactive menu system accessible via commands: ### Main Menu - **Access**: `/function rituals:menu/main` - **Features**: - Totem browser with all available tiers - Quick access to guidebook - Admin tools and configuration options ### Totem Browser - **Access**: Through main menu or `/function rituals:menu/totems` - **Features**: - Visual preview of all totem tiers - Crafting recipe display - Range and effect information - One-click item giving ### Admin Tools - **Debug Mode**: `/function rituals:admin/enable_debug_mode` - Shows detailed ritual timing and range information - Displays particle effects for troubleshooting - **Kiwi Mode**: `/function rituals:admin/enable_kiwi_mode` - Disables fire sacrifice requirement for easy testing - Perfect for creative mode and experimentation - **Reset All**: `/function rituals:admin/reset_all` - Clears all active rituals and resets configuration - **List Totems**: `/function rituals:admin/list_totems` - Shows all placed totems and their current state

## Crafting Recipes All totems come in two variants: **Tall** (2 blocks high) and **Short** (1 block high, walkable). Short variants use the same recipe but **without the top ingredient**.

🪵 Wood Totem Recipes

### Wood Totem (Tall) ![Wood Totem Tall Recipe](https://cdn.modrinth.com/data/cached_images/e1115d7beb143a4dfe4e761706c854d578cd3060_0.webp) ### Wood Totem (Short) ![Wood Totem Short Recipe](https://cdn.modrinth.com/data/cached_images/65764a0eccb7cb0f809dc7b6335d5c01c259a635_0.webp)

🟠 Copper Totem Recipes

### Copper Totem (Tall) ![Copper Totem Tall Recipe](https://cdn.modrinth.com/data/cached_images/e3fe34127e05aac9bf6edba52d25c8d65e52e7fb_0.webp) ### Copper Totem (Short) ![Copper Totem Short Recipe](https://cdn.modrinth.com/data/cached_images/9de4ffa8ebcde871e93b879972c8040a017b1e74_0.webp)

⚙️ Iron Totem Recipes

### Iron Totem (Tall) ![Iron Totem Tall Recipe](https://cdn.modrinth.com/data/cached_images/bfde52b50e99640e673a96cfcb7d2ff83ddb9503_0.webp) ### Iron Totem (Short) ![Iron Totem Short Recipe](https://cdn.modrinth.com/data/cached_images/db66b0a8618cfab06cf7c63a5634d3fe9700cf64_0.webp)

🟡 Gold Totem Recipes

### Gold Totem (Tall) ![Gold Totem Tall Recipe](https://cdn.modrinth.com/data/cached_images/7ce3c005b1e8f2657ba66ceee727a951580162d6_0.webp) ### Gold Totem (Short) ![Gold Totem Short Recipe](https://cdn.modrinth.com/data/cached_images/ebfe97e91eb4d8f49ee99c7acef8a01829714e30_0.webp)

💎 Diamond Totem Recipes

### Diamond Totem (Tall) ![Diamond Totem Tall Recipe](https://cdn.modrinth.com/data/cached_images/240516519a57dee116644be0edef34ce66bf5df4_0.webp) ### Diamond Totem (Short) ![Diamond Totem Short Recipe](https://cdn.modrinth.com/data/cached_images/d7db902353beacafb121ae85d95ac958a277de28_0.webp)

🟣 Netherite Totem Recipes

### Netherite Totem (Tall) ![Netherite Totem Tall Recipe](https://cdn.modrinth.com/data/cached_images/ef7e1fbf45bd4ff5abdd27a751283e0cd25fb8ce_0.webp) ### Netherite Totem (Short) ![Netherite Totem Short Recipe](https://cdn.modrinth.com/data/cached_images/4ceb8caf37bf66ecc0046b3a030251649b6a6d6b_0.webp)

**Tip**: Higher tier totems provide larger ranges and more powerful effects! ## Commands

⌨️ Available Commands (Click to Expand)

### Give Commands These commands give you totem items. They can only be used by players with operator permissions (or in creative mode). - `/function rituals:give/all` - Gives you one of each totem tier - `/function rituals:give/totem_basic` - Gives you a Wood Totem (tall) - `/function rituals:give/totem_basic_short` - Gives you a Wood Totem (short) - `/function rituals:give/totem_copper` - Gives you a Copper Totem (tall) - `/function rituals:give/totem_copper_short` - Gives you a Copper Totem (short) - `/function rituals:give/totem_gold` - Gives you a Gold Totem (tall) - `/function rituals:give/totem_gold_short` - Gives you a Gold Totem (short) - `/function rituals:give/totem_advanced` - Gives you a Diamond Totem (tall) - `/function rituals:give/totem_advanced_short` - Gives you a Diamond Totem (short) - `/function rituals:give/totem_master` - Gives you a Netherite Totem (tall) - `/function rituals:give/totem_master_short` - Gives you a Netherite Totem (short) - `/function rituals:give/guidebook` - Gives you the Totem Rituals Guidebook ### Menu Commands - `/function rituals:menu/main` - Opens the main interactive menu - `/function rituals:menu/totems` - Opens the totem browser - `/function rituals:help` - Shows the in-game help menu ### System Commands - `/reload` - Reloads all datapacks (use if the datapack isn't working) - `/function rituals:config/reload` - Reloads configuration changes ### Admin Commands - `/function rituals:admin/enable_debug_mode` - Enables debug mode for troubleshooting - `/function rituals:admin/disable_debug_mode` - Disables debug mode - `/function rituals:admin/enable_kiwi_mode` - Enables easy mode (no fire sacrifice) - `/function rituals:admin/disable_kiwi_mode` - Disables easy mode - `/function rituals:admin/list_totems` - Lists all placed totems - `/function rituals:admin/reset_all` - Resets all rituals and configuration

## Technical Details

🛠️ For Server Administrators (Click to Expand)

### Performance Considerations - The datapack uses interaction entities for totem placement (Minecraft 1.19.4+) - Rituals check for activation every 20 ticks (once per second) - Effects apply at intervals (20-40 ticks) to maintain performance - Each totem uses 3-4 entities: 1 interaction, 1-2 block displays, 1 item display - Item displays have smooth animations (rotation + bobbing) with 10-tick interpolation ### Compatibility - Should work with most other datapacks - Uses custom scoreboard objectives (all prefixed with "rituals.") - Uses storage namespace "rituals:config" and "rituals:temp" - Custom tags are all in the "rituals" namespace

💻 For Datapack Developers (Click to Expand)

### Architecture - **Main Loop**: `rituals:tick` runs from `minecraft:tick` - **Initialization**: `rituals:load` runs from `minecraft:load` - **Entity System**: Uses interaction entities for hitbox/data, display entities for visuals - **ID System**: Each totem gets a unique ID for linking its entities ### Scoreboards - `rituals.data` - Constants and global data - `rituals.timer` - Tick counters for cooldowns/durations - `rituals.distance` - Totem range values - `rituals.tier` - Totem tier (1-6) - `rituals.effect` - Active ritual effect type - `rituals.temp` - Temporary calculations - `rituals.id` - Entity linking system ### Entity Tags - `rituals.totem` - Main totem interaction entities - `rituals.short_totem` - Short variant totems (1 block tall) - `rituals.totem_visual` - Block display entities for totem visuals - `rituals.totem_display` - Item display entities for held items - `rituals.totem_barrier` - Barrier block displays for collision - `rituals.has_item` - Totems with items displayed - `rituals.active_ritual` - Totems participating in a ritual - `rituals.[ritual_type]_ritual` - Specific ritual type tags ### File Structure ``` data/ ├── rituals/ │ ├── advancement/ # Achievement system │ ├── function/ │ │ ├── load.mcfunction │ │ ├── tick.mcfunction │ │ ├── give/ # Item give commands │ │ ├── totem/ # Totem placement/interaction │ │ ├── ritual/ # Ritual effects │ │ ├── config/ # Configuration system │ │ └── admin/ # Admin utilities │ ├── recipe/ # Crafting recipes │ ├── predicate/ # Random chance predicates │ ├── item_modifier/ # Item modification │ └── tags/ # Custom tags ├── minecraft/ │ └── tags/ │ └── function/ └── pack.mcmeta ``` See `SYSTEM_OVERVIEW.md` for detailed technical documentation.

## Configuration

⚙️ Configuration Options (Click to Expand)

You can customize various datapack settings using the config storage system. ### Viewing Current Config ``` /data get storage rituals:config ``` ### Modifying Settings ``` /data modify storage rituals:config set value /function rituals:config/reload ``` ### Available Settings - `min_totems_required` - Minimum number of totems needed for a ritual (default: 1) - `max_totem_distance` - Maximum distance between totems in blocks (default: 32) - `ritual_duration` - How long rituals last in ticks (default: 600 = 30 seconds) - `require_fire_sacrifice` - Whether rituals require fire sacrifice (default: true) - `kiwi_mode` - Easy mode that disables fire sacrifice (default: false) - `debug_mode` - Enables debug information and particles (default: false) See `CONFIG_GUIDE.md` for complete configuration documentation.

## Redstone Range Display

🔴 Redstone Range Visualization (Click to Expand)

You can visualize a totem's effect range by powering it with redstone! ### How to use: 1. Place a **lever**, **redstone torch**, **redstone block**, or powered **redstone wire** next to or below your totem 2. Red particles will show the exact ritual range (varies by tier) 3. Turn off the redstone to hide the display ### Supported redstone sources: - Redstone torch (always on) - Redstone block (always on) - Lever (toggle on/off) - Button (temporary) - Powered redstone wire See `RANGE_DIAGRAM.md` for detailed range specifications!

## Troubleshooting

🔧 Common Issues & Solutions (Click to Expand)

### Totems won't place: - Make sure you're **right-clicking** (not sneaking required!) - Ensure there's empty space (air block) where you're trying to place the totem - Check that you have the actual totem item (should have custom name and colored text) ### Items won't display on totems: - Make sure you're right-clicking the totem, not the ground near it - The totem can only hold one item at a time - Try removing the current item first (right-click empty-handed) ### Rituals won't activate: - By default, only 1 totem is needed (check config if changed) - Totems work individually by default (configurable to require multiple) - Items must be placed ON the totems (floating above them) - Wait 1 second after placing the last item (system checks every 20 ticks) - **Check fire sacrifice**: Drop 4 catalyst items around totem and light fire ### Pattern rituals won't work: - Use redstone to see particle guides for correct placement - Ensure all totems have the exact required items - Check that totems are at the correct distances (5 blocks for most patterns) - Verify the central totem has the correct item for the ritual type ### Datapack not working: - Type `/reload` in chat - Check that the datapack is in the correct folder (world/datapacks/) - Ensure the folder structure is correct (pack.mcmeta should be at the root) - Make sure you're using Minecraft 1.21 or later ### Resource Pack Issues: - The resource pack is **optional** but provides custom textures - Place it in your `resourcepacks` folder and enable it in-game - If textures don't appear, make sure the pack is above other resource packs in the list ### Debug Mode: - Enable debug mode: `/function rituals:admin/enable_debug_mode` - This shows detailed timing, range, and effect information - Disable when done: `/function rituals:admin/disable_debug_mode`

## Related Documentation - 🔥 **`FIRE_SACRIFICE_GUIDE.md`** - Complete fire sacrifice tutorial - 📐 **`RANGE_DIAGRAM.md`** - Detailed range specifications - 🔧 **`CONFIG_GUIDE.md`** - All configuration options - 📦 **`INSTALLATION.md`** - Detailed installation guide - 🛠️ **`SYSTEM_OVERVIEW.md`** - Technical architecture - 📝 **`CRAFTING_RECIPES.md`** - All crafting recipes - 🎯 **`PATTERN_RITUALS_GUIDE.md`** - Multi-totem pattern setup guide ## Future Enhancements Planned features for future versions: - **Flight Zone Ritual** - Creative flight within zone boundaries - **Weather Control Ritual** - Control local weather patterns - **Time Warp Ritual** - Accelerate time for crops and processes - **Forcefield Ritual** - Protective barriers against hostile mobs - **Mob Repellent Ritual** - Prevent hostile mob spawning - **Mining Haste Ritual** - Extreme mining speed and auto-pickup - Ritual upgrade system to extend range - More ritual types and effects - Ritual combinations for unique effects - Multi-totem ritual networks - Integration with advancement system - Multi-item rituals requiring different items - Ritual altars and structures ## Credits Created with expertise in Minecraft datapack development and a passion for magical gameplay mechanics. ## License This datapack is provided as-is for use in Minecraft worlds. Feel free to modify it for personal use or server use, but please provide credit if you redistribute or share modifications. --- **Enjoy your mystical journey with Rituals!** For issues, questions, or suggestions, please contact the datapack maintainer.

rpg progression

Curated by

strixun | Pack A