Rituals Not Rolls

Rituals Not Rolls makes enchanting a craft built around discovery, materials, and the space you create. Find knowledge, build a library, and arrange pedestal chains around your enchanting table. Your setup determines which enchantments your equipment receives and how powerful they become.

Made for Minecraft 1.21.1 on NeoForge.

Getting started is simple:

1. Discover Knowledge Pages. Find them in chest loot. Each page reveals how a material can power a particular enchantment.
2. Build your library. Place pages directly into nearby chiseled bookshelves, or collect them into Knowledge Books. Nearby players can use the same library.
3. Arrange your pedestals. Place the materials your library knows about on Ritual Pedestals, with one item per pedestal.
4. Check your knowledge. Right-click the enchanting table to browse known enchantments and materials. Search by enchantment or item name to find what you need.
5. Drop your equipment toward the table. The ritual captures it, lifts it into the air, and applies compatible enchantments that your setup has enough power to improve.

You can perform a ritual without opening a menu. The table's interface is a reference for your nearby library; the materials you place determine what happens.

Build a ritual that suits your goal. Materials have different strengths for different enchantments. An iron ingot, for example, is more useful for Knockback than Sharpness. Knowledge displays readable strength tiers: Weakest, Weak, Average, Strong, and Strongest.

Ordinary materials remain on their pedestals after enchanting, so you can keep using a carefully built setup. Higher-enchantability equipment needs less power, while lower-enchantability equipment needs more.

Three catalysts give you more control:

• Consumption Catalyst: attach it to a pedestal to double that pedestal's material power and consume the material during a successful ritual. The catalyst itself remains reusable.
• Experience Catalyst: place it on a pedestal to add an XP-powered boost. Experience flows from the player through the catalyst into the ritual. If you have less XP than the full cost, the boost scales to what you can afford.
• Subtraction Catalyst: attach it to reverse a material's contribution, reducing or removing existing enchantments—including curses. Combine it with consumption for stronger disenchanting.

Placement matters. Arrange separate chains to give different enchantments their own materials. Guide a chain back through a previously visited pedestal for a bonus to that material's power. Extra copies of the same material can contribute to one enchantment when their pedestals use consumption catalysts.

Pedestals can attach to floors, walls, and ceilings, while their displayed items always stay upright. Build your enchanting space into a workshop, a communal library, or an entire ritual chamber.

Watch your setup come to life. Magical trails curve from bookshelves through the pedestal chains and gather into layered rings around your equipment. More powerful enchantments form larger rings, and the item rises to make room. Chains build in sequence by default, then their remaining trails gather before the final pulse and outward burst.

A chain with insufficient power grows unstable and scatters into fading particles. Its offerings are preserved, while other successful chains can still finish.

For modpack makers, progression and balance are controlled through data. Change the materials players need, the power they provide, and the enchantment levels they can reach. Add support for your pack's enchantments using JSON definitions—no Java code is needed for ordinary enchantment support.

Datapacks let you define:

• Material affinities using individual items or item tags, with separate power values for each enchantment.
• Power requirements for each level, including levels above the usual maximum.
• Conflict groups and their extra power costs.
• Catalyst rules, XP costs, and bonuses.
• Which enchantments participate in rituals and knowledge-page discovery.
• Each enchantment's particle effect and optional hex color.

Server configuration controls ritual range, pedestal chaining, return-path bonuses, enchantability scaling, and sequential or simultaneous animation starts. Resource packs can customize page artwork, interface textures, and ritual sounds, including their volume and pitch.

The shipped balance uses enchantability 10 as the baseline: the complete set of distinct materials for a vanilla enchantment reaches its normal maximum level before bonuses or power sharing. Consumption, XP, clever placement, and better enchantability can push further when the configured thresholds allow it. Custom datapacks are free to use a different balance.

Built-in support covers all 42 vanilla enchantments and 26 optional modded enchantments, including entries from Create, Farmer's Delight, Combat Roll, Supplementaries, and Vein Mining. Optional definitions activate when their matching enchantments are present. Supplementaries and Iron's Spells 'n Spellbooks pedestals also have built-in support.

Knowledge Pages replace chest-loot enchanted books only for configured enchantments. Unsupported enchantments remain on enchanted books, so you can add support gradually. Knowledge Pages are hidden from JEI and EMI item lists.

Find missing support quickly. Operator commands help you inspect and validate your pack:

• /ritual missing lists enchantments without definitions and suggests the JSON paths to create.
• /ritual definitions lists loaded definitions.
• /ritual validate checks the setup and reports warnings.
• /ritual givepage <enchantment> <entry> gives a specific knowledge page for testing.

Definitions live under data/<namespace>/ritual_enchanting/enchantments/<name>.json. Override an existing definition at its original path, or create one for an unsupported enchantment. Use /reload to load datapack changes, then validate them.

For packs moving away from Immersive Enchanting, saved Ancient Books can convert into matching Knowledge Pages when that mod is absent and a supported ritual definition exists. Install Rituals Not Rolls before first opening the world without Immersive Enchanting. See the migration guide for the conversion scope and handling of unsupported books.

Documentation and examples:

• Datapack guide
• Resource-pack guide
• Included modded enchantments
• Immersive Enchanting migration
• Example packs and downloads
• Source code and issue tracker

Modpack inclusion is welcome. Rituals Not Rolls is MIT licensed.