Totem Rituals Datapack/Mod

✨ Thank you for 100 downloads 🥹
🎉 300 Downloads! Thank you! ~Oct.27.2025
＼(◎o◎)／ 420 Download achieved Nov.6.2025

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

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:

Craft totems (see Crafting Recipes)
Right-click on the ground to place a totem
Right-click a placed totem with an item to display it
Drop 4 catalyst items around the totem (N/S/E/W)
Light fire at the totem base - the ritual activates!

Note: Rituals now require a Fire Sacrifice to activate! See 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

Place your totem and add a ritual item (Diamond, Emerald, etc.)
Drop 4 catalyst items on the ground around your totem (North, South, East, West)
Light a fire at the totem's base using flint & steel
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:

/data modify storage rituals:config require_fire_sacrifice set value false
/function rituals:config/reload

Or enable Kiwi Mode for easy testing:

/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

Visual comparison of effect ranges for all totem tiers

See RANGE_DIAGRAM.md for detailed range specifications.

How to Use Totems

Placing a Totem

Hold a totem item in your hand
Look at the ground where you want to place it
Right-click on the ground
The totem will appear as a vertical pole

Adding Items to Totems

Hold the item you want to display
Right-click the totem
The item will appear floating above the totem
Only one item can be displayed per totem

Removing Items from Totems

Break the totem with the corresponding tool.
Re-place the totem if desired.

Breaking Totems

Punch (left-click or attack) the totem
The totem and any displayed item will drop
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

Wood Totem (Short)

Wood Totem Short Recipe

🟠 Copper Totem Recipes

Copper Totem (Tall)

Copper Totem Tall Recipe

Copper Totem (Short)

Copper Totem Short Recipe

⚙️ Iron Totem Recipes

Iron Totem (Tall)

Iron Totem Tall Recipe

Iron Totem (Short)

Iron Totem Short Recipe

🟡 Gold Totem Recipes

Gold Totem (Tall)

Gold Totem Tall Recipe

Gold Totem (Short)

Gold Totem Short Recipe

💎 Diamond Totem Recipes

Diamond Totem (Tall)

Diamond Totem Tall Recipe

Diamond Totem (Short)

Diamond Totem Short Recipe

🟣 Netherite Totem Recipes

Netherite Totem (Tall)

Netherite Totem Tall Recipe

Netherite Totem (Short)

Netherite Totem Short Recipe

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 <key> set value <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:

Place a lever, redstone torch, redstone block, or powered redstone wire next to or below your totem
Red particles will show the exact ritual range (varies by tier)
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

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.

Rituals

Compatibility

Minecraft: Java Edition

Platforms

Supported environments

Links

Creators

Details

Totem Rituals Datapack/Mod

Version Information

Installation

1. Download the Datapack

2. Locate Your World Save Folder

3. Install the Datapack

4. Enable the Datapack

5. Get Started

Getting Started

Quick Start Guide

Available Rituals

🌟 Standard Single-Totem Rituals (6 Available)

1. Growth Ritual 🌱

2. Strength Ritual 💪

3. Prosperity Ritual 💰

4. Protection Ritual ⚔️

5. Healing Ritual 💖

6. Sentry Ritual 🏹

🎯 Advanced Multi-Totem Pattern Rituals (2 Available)

7. Auto-Farming Ritual 🚜

8. Auto-Breeding Ritual 🐄

🎨 Visual Pattern Guides

Ritual System

How It Works

Catalyst Costs by Tier

Totem Tiers

Tier 1 - Wood Totem

Tier 2 - Copper Totem

Tier 3 - Iron Totem

Tier 4 - Gold Totem

Tier 5 - Diamond Totem

Tier 6 - Netherite Totem

Range Visualization

How to Use Totems

Placing a Totem

Adding Items to Totems

Removing Items from Totems

Breaking Totems

Interactive Menu System

Main Menu

Totem Browser

Admin Tools

Crafting Recipes

Wood Totem (Tall)

Wood Totem (Short)

Copper Totem (Tall)

Copper Totem (Short)

Iron Totem (Tall)

Iron Totem (Short)

Gold Totem (Tall)

Gold Totem (Short)

Diamond Totem (Tall)

Diamond Totem (Short)

Netherite Totem (Tall)

Netherite Totem (Short)

Commands

Give Commands

Menu Commands

System Commands

Admin Commands

Technical Details

Performance Considerations

Compatibility

Architecture

Scoreboards

Entity Tags

File Structure

Configuration

Viewing Current Config

Modifying Settings

Available Settings

Redstone Range Display