Meridian

Frequently Asked Questions

Click any question to expand. If yours isn't here, open an issue on GitHub.

Enchanting & Results

Why doesn't Mending (or another treasure enchantment) show up at my table? +
Treasure-tier enchantments like Mending are locked behind the Deepshelf of Arcane Treasures, a utility shelf block. Without one placed in your shelf ring, treasure enchantments will not appear in the enchanting pool. Either craft and place a Deepshelf of Arcane Treasures (see the utility shelves reference), or set allowTreasureWithoutShelf to true under enchantingTable in the config to remove the requirement entirely.
My results are wildly inconsistent — why? +
You almost certainly have high Quanta without Rectification. Quanta raises the upper bound of the random power roll, so high-Quanta shelves like Blazing Hellshelves (or the extreme Beeshelf) make results swing between amazing and terrible. Rectification counters Quanta's negative variance — add Rectification Shelves (Seabound +10, Hellbound +15, End-Fused +25) and your rolls become consistently strong instead of volatile. If you've overshot on Quanta, a Melonshelf (-10 Quanta) is the antidote. The Getting Started guide covers taming variance step by step, and the recommended setups give balanced shelf combinations for each progression stage.
Do vanilla enchantments still exist? Can they go higher than vanilla levels? +
Yes — vanilla enchantments participate in Meridian's system alongside the 75 original ones, and the table's level range scales up to 100 (two enchanting levels per Eterna point, with Eterna itself capped at 50) instead of vanilla's 0–30 cap. Per-enchantment overrides work on any enchantment, vanilla or modded: the config reference includes an example that raises minecraft:sharpness to maxLevel: 10 with custom linear power functions, while capping its loot-table level at 5.

Configuration & Customization

How do I disable or re-tune a specific enchantment? +
Use the enchantmentOverrides map in config/meridian.json. Keys are enchantment IDs (e.g., minecraft:sharpness or meridian:siphon), and each entry can set enabled, maxLevel, maxLootLevel, levelCap, and custom minPowerFunction / maxPowerFunction objects (linear, fixed, or default). Setting enabled: false removes an enchantment from the table, loot, and tooltips without deleting data from existing items. Apply changes live with /meridian reload. Full details in the configuration reference.
How do I change what stats a shelf gives? +
Shelf stat contributions are datapack-driven, not config-driven. They're defined as JSON files in data/meridian/enchanting_stats/ — create a datapack that overrides the relevant file (e.g., data/meridian/enchanting_stats/hellshelf.json to retune Hellshelves), then run the vanilla /reload command to apply changes without restarting. They take effect immediately for all players. See data-driven customization on the shelves page.
Config file vs datapack — which controls what? +
Config (config/meridian.json) controls behavior: enchanting-table settings (max Eterna, treasure shelf requirement, level indicator), shelf effects (sculk shrieker and particle chances), anvil settings, library hopper limits, tome XP costs, warden drop rates, display/tooltip options, and per-enchantment overrides. It hot-reloads via /meridian reload. Datapacks control shelf stat contributions (Eterna, Quanta, Arcana, Rectification, Clues per block) under data/meridian/enchanting_stats/, reloaded with the vanilla /reload. See the config reference and commands page.

Compatibility & Installation

Does Meridian work with EMI / REI / JEI / Jade / WTHIT / ModMenu? +
Yes. Meridian ships first-class integration adapters for EMI, REI, and JEI (enchanting-table crafting recipes and library mechanics) and Jade (shelf stat tooltips and library contents), plus a ModMenu entry, and is compatible with WTHIT. All of these are optional — none are bundled or required, and Meridian runs fine without any of them installed.
Do I install it on the server, the client, or both? +
For multiplayer, both. Drop the jar into the mods/ directory on the server and on every client — a client missing the mod will desync on the first table interaction. The config lives in config/meridian.json on the server side, and /meridian reload re-reads it and syncs updated values to all connected players immediately. See the commands page for reload details.
How does Meridian relate to Apotheosis and Zenith? +
Meridian is a clean-room rewrite for modern Fabric 1.21.1, not a port. The enchanting module concepts — stat-driven table, shelf blocks, enchantment library, anvil interactions, and tome system — are inspired by Apotheosis by Shadows_of_Fire and its Fabric port Zenith by TheWinABagel, but all code, data, and art are original to Meridian — no source or assets were copied. The textures are custom pixel art authored fresh, and all 75 enchantments — names, IDs, weights, costs, effects, and descriptions — are original to Meridian.
Which Minecraft and loader versions are supported? +
Minecraft 1.21.1 with Fabric Loader 0.16.10+, Fabric API (0.116.1+1.21.1 or newer), and Java 21. Quilt users can run the mod via Quilted Fabric API with no changes. Watch the releases page for version updates.