Admin Guide

Configuration Reference

All configuration files in plugins/OmniEnchant/ — complete guide for every field, default values, and usage.

config.yml — General Settings

The main configuration file that controls general plugin behavior.

config.yml

version: 1                         # Do not edit (auto migration)
debug: false                        # Enable detailed logging (dev only)
book-material: ENCHANTED_BOOK       # Material used for enchant books
max-enchants-per-item: 5            # Maximum enchants per item (base)
inventory-interval: 200            # Ticks between inventory scans (200=10s)
economy-provider: vault            # vault | playerpoints

# Soul System
souls-per-kill: 1                   # Souls earned per kill
soul-death-loss-percent: 0.10      # 10% souls lost on death
pvp-kill-cooldown-seconds: 300     # Anti-spam: 5 min between same player

# Activity/Achievement system
activity-enabled: false

# Lore placeholder — see Lore Format page for details
lore-placeholder: "#omnienchant#"
lore-placeholder-aliases:
  - "#slenchant#"
  - "#ominienchant#"
lore-spacing: 0

# Vanilla Book Override
vanilla-book-override:
  enabled: true
  drag-drop: false

# External enchant adapters (EcoEnchants, AdvancedEnchant)
external-lore:
  enabled: true
  prefix: "&8[&dExt&8] &7"

# OmniModifier interop
modifier-lore:
  placeholder: "#ominimodifier#"
  prefix: "&8[&bMod&8] &7"

max-enchants-per-item is the BASE value. Slot Increaser items add extra slots on top. E.g.: base=5, extra=3 → max=8.

settings/application.yml — Drag-Drop & Rates

Controls the enchant application mechanic: success/failure rates, upgrade behavior, extra slot limit.

settings/application.ymlFull reference

drag-drop:
  enabled: true                    # Enable/disable drag-drop enchanting
  base-success-rate: 85            # Default success % rate
  base-failure-rate: 10            # % chance to destroy item on failure
  allow-upgrade-on-apply: true     # Same enchant+level → auto upgrade
  unique-activation: true         # Keep only highest level for duplicates

extra-slot-limit: 5               # Max extra slots from Slot Increaser

dust:
  enabled: true                    # Enable Lucky Dust
  bonus-per-dust: 1               # +1% success per dust
  max-bonus: 15                   # Max cap +15%

settings/display.yml — Rarity & Colors

settings/display.yml

chars-per-line: 40                # Compact mode: auto line wrap
rarities:
  COMMON:      { color: "&7", display-name: "Common" }
  UNCOMMON:    { color: "&a", display-name: "Uncommon" }
  RARE:        { color: "&9", display-name: "Rare" }
  EPIC:        { color: "&5", display-name: "Epic" }
  LEGENDARY:   { color: "&6", display-name: "Legendary" }

settings/tier-shop.yml — GUI Shop Setup

Configure the Enchant Orb purchase GUI. DeluxeMenus-like style — customize slot, material, lore, price per tier.

settings/tier-shop.ymlGUI customization

enabled: true
currency: EXP                      # EXP, VAULT, POINTS, LEVEL
orb-material: MAGMA_CREAM

gui:
  title: "&5&l✦ Enchant Shop"
  rows: 3
  background:
    slots: [0,1,2,...,26]
    material: BLACK_STAINED_GLASS_PANE
    name: " "

tiers:
  COMMON:
    slot: 10
    display-name: "&f✦ Common Orb"
    material: WHITE_DYE
    price: 10
    description:
      - "&7Contains a random &fCommon &7enchant"
      - "&7Price: &a{price} Levels"
      - "&eClick to purchase!"
  LEGENDARY:
    slot: 16
    display-name: "&6✦ Legendary Orb"
    material: ORANGE_DYE
    price: 75

settings/enchant-table.yml — Enchant Table

Configure how custom enchants appear when using the vanilla enchanting table.

settings/enchant-table.yml

enabled: true
enchant-list:
  mode: false                      # true=WHITELIST, false=BLACKLIST
  list: []
enchants:
  aegis:
    weight: 2.0                   # 2× appearance rate
    min-level: 1
    max-level: 2
  frenzy:
    weight: 0.5                   # Rarer from enchanting table

settings/extraction.yml — Enchant Extraction

settings/extraction.yml

enabled: true
require-scroll: true              # Requires Extraction Scroll
scroll-material: PAPER
success-rate: 100                 # % success rate
level-penalty: 0                  # Level reduction after extraction

settings/fusion.yml — Fusion Recipes

settings/fusion.yml

enabled: true
gui:
  title: "&d&l✦ Enchant Fusion"
  rows: 3
recipes:
  strength_2:
    result:
      enchant: strength
      level: 2
    ingredients:
      - enchant: strength
        level: 1
        amount: 3

settings/vanilla-enchants.yml — Override Vanilla

settings/vanilla-enchants.yml

enabled: true
show-in-lore: true
allow-drag-drop: true
enchants:
  sharpness:
    display-name: "&fSharpness"
    description: "&7Increases melee damage"
    rarity: COMMON
  protection:
    display-name: "&fProtection"
    description: "&7Reduces damage taken"
    rarity: COMMON

settings/messages.yml — Custom Messages

messages.ymlPlaceholders: {enchant}, {level}, {max}, {price}

# Enchant application
enchant-success: "&a{enchant} &7Lv.{level} applied!"
enchant-fail: "&cFailed to apply {enchant}."
enchant-destroyed: "&4Item DESTROYED!"
enchant-max: "&cMax enchants reached! ({max})"

# Protection & Items
protection-applied: "&aProtection Stone applied!"
protection-saved: "&eProtection saved your item!"

# Shop & Orb
shop-purchase-success: "&aPurchased {tier} Orb!"
shop-not-enough-exp: "&cNot enough EXP!"
orb-reveal: "&dRevealed: {enchant}!"

settings/dust.yml — Lucky Dust Config

settings/dust.yml

enabled: true
material: GLOWSTONE_DUST
bonus-per-dust: 1
max-bonus: 15
random-rate:
  min: 1
  max: 3