Overview#
Crystallogy is a crystal-centric mod that introduces a progression system based on four primary elemental crystals found deep underground. It blends traditional resource gathering with machine-based processing and magical infusion. Players can craft high-tier equipment with unique passive abilities and utilize a specialized 'Voodoo' system to interact with or manipulate other players and entities.
Key features include:
- Elemental Progression: Four distinct crystal types (Red, Blue, Green, Yellow) each tied to specific buffs.
- Machine Processing: Custom machines like the Crystal Crusher and Crystal Infuser for refining materials.
- Advanced Equipment: Armor and tools that surpass diamond tier with elemental powers.
- Voodoo System: A unique mechanic for tagging and controlling entities.
- In-game Documentation: The 'Book of Knowledge' provides a complete guide within the game.
Getting Started#
To begin your journey into Crystallogy, you must first head underground to locate Crystal Ores. These ores typically spawn below Y-level 60 and drop Crystal Shards when mined.
The Book of Knowledge
The most essential item for any aspiring crystallogist is the Book of Knowledge. This in-game wiki contains all recipes and mechanics.
- Crafting: If lost, combine a standard Book with any Crystal in a crafting table.

Basic Processing
Your first machine should be the Crystal Crusher. This block is used to grind raw crystals into Crystal Dust, which is required for advanced crafting and infusion.
Crystals and Resources#
The mod features four primary crystals, each associated with a specific element and set of player buffs.
| Crystal Type | Color | Element | Associated Buffs |
|---|---|---|---|
| Red Crystal | Red | Fire / Strength | Strength, Fire Resistance |
| Blue Crystal | Blue | Water / Speed | Speed, Water Breathing |
| Green Crystal | Green | Earth / Health | Regeneration, Resistance |
| Yellow Crystal | Yellow | Air / Haste | Haste, Jump Boost |
Crystals are obtained by mining their respective ores or by processing shards in the Crystal Infuser.
Machines and Mechanics#
Crystallogy relies on specific machine setups to progress through its tiers.
Crystal Crusher
The Crystal Crusher is a manual machine used to create dust.
- Usage: Place the Crusher and right-click it with a Crystal to begin the grinding process. It will output Crystal Dust used in various recipes.
Crystal Infuser (Multiblock)
The Crystal Infuser is the core of the mod's advanced crafting. It is not a single block but a multiblock structure.
- Setup: Place one Infuser Block in the center and four additional Infuser Blocks around it (forming a cross shape with one block gap between the center and the outer blocks).
- Usage: Place the base item in the center and the required crystals/shards in the outer blocks to begin the infusion process.

Equipment and Armor#
Crystallogy adds full sets of tools and armor for each crystal type. These items are generally more durable and powerful than Diamond.
Armor Abilities
Wearing a full set of specific crystal armor grants permanent potion effects:
- Red Armor: Grants Strength and Fire Resistance.
- Blue Armor: Grants Speed and Water Breathing.
- Green Armor: Grants Health Boost and Resistance.
- Yellow Armor: Grants Haste and Jump Boost.

Crystal Tools
Tools (Pickaxe, Axe, Shovel, Hoe, Sword) crafted from crystals have higher mining speeds and attack damage compared to vanilla materials. They can be further upgraded through the Infusion system.
Voodoo Doll System#
The Voodoo system allows players to interact with entities from a distance.
- Entity Tagging: Use a Player Tag or Entity Tag on a target to "capture" their essence.
- Voodoo Doll: Combine the tag with a Voodoo Doll.
- Manipulation: Once linked, you can use the Voodoo Doll to apply effects, move the entity, or "play" with them. This is often used for utility or pranking friends in multiplayer environments.
Recipes#
Most recipes follow standard Minecraft patterns but substitute vanilla materials with Crystals and Shards.
Basic Crafting
| Item | Recipe |
|---|---|
| Book of Knowledge | 1x Book + 1x Any Crystal (Shapeless) |
| Crystal Crusher | 4x Cobblestone + 1x Iron Ingot + 1x Any Crystal |
| Infuser Block | 4x Iron Ingots + 4x Stone + 1x Crystal Shard |
| Crystal Tool | Standard Tool Pattern (e.g., Pickaxe) using Crystals instead of Diamonds |
| Crystal Armor | Standard Armor Pattern using Crystals instead of Diamonds |
Infusion Recipes
Infusion recipes vary by version; players are encouraged to use JEI (Just Enough Items) or the in-game Book of Knowledge to see the specific requirements for advanced items like the Voodoo Doll and Tier 2 Crystals.
Configuration#
Crystallogy includes a configuration file (crystallogy.cfg) that allows server owners and players to adjust the mod's balance:
- Ore Generation: Toggle the spawn rate and vein size of crystal ores.
- Armor Effects: Enable or disable the passive potion effects granted by full armor sets.
- Voodoo Settings: Restrict the use of Voodoo Dolls on specific entities or players to prevent griefing.
