Configuration Reference

All settings live in config/meridian.json. Auto-generated on first launch with defaults.

enchantingTable

Key Type Default Description
allowTreasureWithoutShelf boolean false Allow treasure enchantments without a Treasure Shelf
maxEterna int 50 Maximum Eterna stat cap (range: 1–100)
showLevelIndicator boolean true Display level indicator on enchanting table UI
globalMinEnchantability int 1 Minimum enchantability requirement (range: 0–100)
{
  "enchantingTable": {
    "allowTreasureWithoutShelf": false,
    "maxEterna": 50,
    "showLevelIndicator": true,
    "globalMinEnchantability": 1
  }
}

shelves

Key Type Default Description
sculkShelfShriekerChance double 0.02 Chance for Sculk shelves to trigger a shrieker (0.0–1.0)
sculkParticleChance double 0.05 Particle spawn rate for Sculk shelves (0.0–1.0)

anvil

Key Type Default Description
prismaticWebRemovesCurses boolean true Enable Prismatic Web curse removal
prismaticWebLevelCost int 30 XP levels consumed per curse removal
ironBlockRepairsAnvil boolean true Enable Iron Block anvil repair
{
  "anvil": {
    "prismaticWebRemovesCurses": true,
    "prismaticWebLevelCost": 30,
    "ironBlockRepairsAnvil": true
  }
}

library

Key Type Default Description
ioRateLimitTicks int 0 Hopper insert throttle in ticks (0 = no limit)

tomes

Key Type Default Description
scrapTomeXpCost int 3 XP levels for Scrap Tome use
improvedScrapTomeXpCost int 5 XP levels for Improved Scrap Tome use
extractionTomeXpCost int 10 XP levels for Extraction Tome use
extractionTomeItemDamage int 50 Durability damage to source item from Extraction Tome
extractionTomeRepairPercent double 0.25 Percent of max durability restored after extraction (0.0–1.0)
{
  "tomes": {
    "scrapTomeXpCost": 3,
    "improvedScrapTomeXpCost": 5,
    "extractionTomeXpCost": 10,
    "extractionTomeItemDamage": 50,
    "extractionTomeRepairPercent": 0.25
  }
}

warden

Key Type Default Description
tendrilDropChance double 1.0 Warden Tendril drop chance (0.0–1.0; 1.0 = guaranteed)
tendrilLootingBonus double 0.10 Additional drop chance per Looting level (0.0–1.0)

display

Key Type Default Description
showBookTooltips boolean true Show enchantment tooltips on books
overLeveledColor string "#FF6600" Hex color for over-leveled enchantment display
enableInlineEnchDescs boolean false Show inline enchantment descriptions in tooltips

enchantmentOverrides

Per-enchantment override system. Keys are enchantment IDs (e.g., minecraft:sharpness or meridian:siphon). Use -1 for any field to keep the vanilla default.

Key Type Default Description
enabled boolean true Whether this enchantment can appear
maxLevel int -1 Override maximum level (1–127, or -1 for default)
maxLootLevel int -1 Override maximum level from loot tables (1–127, or -1)
levelCap int -1 Hard cap on level (1–127, or -1)
minPowerFunction object null Custom min power function (see below)
maxPowerFunction object null Custom max power function (see below)

Power Function Types

  • "linear"base + perLevel * level
  • "fixed" — constant value regardless of level
  • "default" — vanilla behavior
{
  "enchantmentOverrides": {
    "minecraft:sharpness": {
      "enabled": true,
      "maxLevel": 10,
      "maxLootLevel": 5,
      "levelCap": -1,
      "minPowerFunction": {
        "type": "linear",
        "base": 1,
        "perLevel": 11,
        "value": 0
      },
      "maxPowerFunction": {
        "type": "linear",
        "base": 21,
        "perLevel": 11,
        "value": 0
      }
    },
    "meridian:excavate": {
      "enabled": false
    }
  }
}

Full Default Config

The complete default config/meridian.json generated on first launch.

{
  "configVersion": 1,
  "enchantingTable": {
    "allowTreasureWithoutShelf": false,
    "maxEterna": 50,
    "showLevelIndicator": true,
    "globalMinEnchantability": 1
  },
  "shelves": {
    "sculkShelfShriekerChance": 0.02,
    "sculkParticleChance": 0.05
  },
  "anvil": {
    "prismaticWebRemovesCurses": true,
    "prismaticWebLevelCost": 30,
    "ironBlockRepairsAnvil": true
  },
  "library": {
    "ioRateLimitTicks": 0
  },
  "tomes": {
    "scrapTomeXpCost": 3,
    "improvedScrapTomeXpCost": 5,
    "extractionTomeXpCost": 10,
    "extractionTomeItemDamage": 50,
    "extractionTomeRepairPercent": 0.25
  },
  "warden": {
    "tendrilDropChance": 1.0,
    "tendrilLootingBonus": 0.10
  },
  "display": {
    "showBookTooltips": true,
    "overLeveledColor": "#FF6600",
    "enableInlineEnchDescs": false
  },
  "enchantmentOverrides": {}
}