Configuration

The main configuration file is located at plugins/SuperEnchants/config.yml. Changes take effect after running /sereload.

Full Reference

# Prefix used in plugin messages (MiniMessage format)
prefix: "<gradient:#FF6B6B:#FFD93D><bold>SuperEnchants</bold></gradient> <dark_gray>»</dark_gray> "

# Update checker settings
update-checker:
  enabled: true

# How often passive enchantments tick (in server ticks, 20 = 1 second)
passive-tick-interval: 20

# Enable debug logging to console
debug: false

# Region protection - fires simulated BlockBreakEvents to check claim plugins
# Works with WorldGuard, GriefPrevention, Towny, Lands, Residence, etc.
region-protection:
  enabled: true

# Custom enchant books appearing in librarian villager trades
villager-trades:
  enabled: true
  chance: 0.95
  base-emerald-cost: 10
  max-emerald-cost: 32

# Custom enchant books appearing in dungeon/structure chest loot
loot-generation:
  enabled: true
  chance: 0.95

Field Details

prefix

The MiniMessage-formatted prefix prepended to plugin messages. Supports gradients, colors, and formatting.

update-checker.enabled

When true, checks for new versions on server start and notifies operators on join.

passive-tick-interval

How frequently (in server ticks) passive enchantments are processed. Lower values = more frequent checks but more CPU usage.

• Default: 20 (once per second)

• Recommended range: 10-40

debug

Enables verbose logging to the console. Useful for troubleshooting enchantment loading issues.

region-protection.enabled

When true, enchantments that modify blocks (vein mine, timber, multi break, lava walker, etc.) will check claim/protection plugins before acting. Supports WorldGuard, GriefPrevention, Towny, Lands, and Residence.

villager-trades.enabled

When true, librarian villagers can offer custom enchanted books in their trades. Setting this to false disables all villager trades globally, regardless of per-enchant settings.

villager-trades.chance

Probability (0.0 - 1.0) that a librarian trade slot will contain a custom enchanted book.

villager-trades.base-emerald-cost

Default minimum emerald cost for a custom enchanted book trade. Individual enchants can override this via their villager_trades.base_emerald_cost field — see Creating Enchantments.

villager-trades.max-emerald-cost

Default maximum emerald cost for a custom enchanted book trade. Individual enchants can override this via their villager_trades.max_emerald_cost field.

loot-generation.enabled

When true, custom enchanted books can appear in dungeon, temple, and other structure chest loot. Setting this to false disables all loot generation globally.

loot-generation.chance

Probability (0.0 - 1.0) that a loot chest will contain a custom enchanted book. Individual enchants control their own eligibility and relative weight via their loot_generation section — see Creating Enchantments.