Admin Guide

Lore Format Guide

How to configure the #omnienchant# placeholder to control where enchant lore appears on your MMOItems.

How It Works

OmniEnchant uses a placeholder token in MMOItems item lore to determine where enchant information is rendered. When the plugin renders an item, it finds the placeholder line and replaces it with the enchant lore block.

config.ymlPlaceholder configuration

# Where enchant lore appears in MMOItems lore format.
# Add this string to your MMOItems lore where you want enchants to show.
# If not found, enchant lore always appears at the TOP (default).
lore-placeholder: "#omnienchant#"

# Legacy tokens still accepted as aliases:
lore-placeholder-aliases:
  - "#slenchant#"
  - "#ominienchant#"

# Number of blank lines between enchant block and item base lore
lore-spacing: 0

Default behavior: If no placeholder is found in item lore, enchant lines are inserted at the top of the lore, before any MMOItems stats.

Adding to MMOItems Lore Format

Place the #omnienchant# token anywhere in your MMOItems item/type lore format. The plugin will replace this line with the enchant block.

Method 1 — In MMOItems lore-format.yml

MMOItems/lore-format.ymlRecommended approach

# Add the placeholder in your lore format template:
lore-format:
  - '&7&m                              '     # Separator
  - '#omnienchant#'                          # ← Enchant lore goes here
  - '&7&m                              '     # Separator
  - '#item-stat#'
  - '#stat-gem#'
  - '&7'
  - '#item-lore#'

Method 2 — In individual item YAML

MMOItems/item/SWORD/my_sword.ymlPer-item override

lore:
  - '&8&m                    '
  - '#omnienchant#'                 # Enchant block inserted here
  - '&8&m                    '
  - '&7Damage: &f{attack-damage}'
  - '&7Speed: &f{attack-speed}'

The placeholder string is case-insensitive. It will be consumed (removed) and replaced with the rendered enchant lines. If the item has no enchants, the placeholder line is simply removed.

Visual Result

Here's what enchant lore looks like on a Minecraft item, with and without the placeholder.

Without Placeholder (Default — Top)

Divine III

Smites enemies with holy light,

healing 4.0 on attack (20% chance)

Aegis II

+6.5% max health and +4.0% defense

Enchant: 2/6

Damage: 150

Speed: 1.2

With `#omnienchant#` (Custom Position)

Damage: 150

Speed: 1.2

—————————————

Divine III

Smites enemies with holy light,

healing 4.0 on attack (20% chance)

Aegis II

+6.5% max health and +4.0% defense

Enchant: 2/6

—————————————

OmniModifier Placeholder

If you use OmniModifier (SLMMOStatsApply), there's a separate placeholder for modifier lore sections.

config.ymlModifier lore section

# OmniModifier (SLMMOStatsApply) interop
modifier-lore:
  placeholder: "#ominimodifier#"
  placeholder-aliases:
    - "#slmmostatsapply#"
    - "#ominimodifier#"
  prefix: "&8[&bMod&8] &7"

External Enchant Lore

OmniEnchant v3.0.0 includes adapter support for rendering enchants from other plugins (EcoEnchants, AdvancedEnchant) within the unified lore block.

config.ymlExternal enchant display

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

External enchants are appended after OmniEnchant enchants in the lore block. They inherit the same placeholder positioning.

Lore Spacing

Control the gap between the enchant block and adjacent lore content.

config.yml

# Number of blank lines between enchant lore block and item base lore.
# Default: 0 (no gap), set to 1 for a single blank line separator.
lore-spacing: 0

OmniEnchant