> For the complete documentation index, see [llms.txt](https://yowsef-development.gitbook.io/yowsef-development-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://yowsef-development.gitbook.io/yowsef-development-docs/untitled/configuration/config.md).

# config

```yaml
# PrimeEnchants Main Configuration

# ─── Discovery System ─────────────────────────────────────────────────

# If true, players must discover enchants (via books or commands) before they trigger.
discovery:
  required: false

# ─── Anomaly Event ────────────────────────────────────────────────────
anomaly:
  enabled: true
  interval: 10800 # 3 hours in seconds
  duration: 900 # 15 minutes in seconds
  radius: 5000
  min-players: 1
  mobs-to-break-shield: 50
  crystal-health: 2000
  pvp-enabled: true
  allowed-worlds:
    - world
    - world_nether
    - world_the_end

# ─── Enchanting Table Integration ─────────────────────────────────────
table:
  enabled: true

# ─── Villager Injection ───────────────────────────────────────────────
villager:
  enabled: true
  inject-chance: 0.15  # Chance to replace a librarian trade with a custom book

# ─── World Loot ───────────────────────────────────────────────────────

# Detailed loot config in loot.yml
loot:
  enabled: true

# ─── Set Bonuses ──────────────────────────────────────────────────────
set-bonuses:
  enabled: true

# ─── Enchant Slot System ──────────────────────────────────────────────

# Limits how many custom enchants can exist on one item.
slots:
  enabled: false
  max-enchants-per-item: 5

# ─── Book Display Settings ────────────────────────────────────────────

# Server owners can fully customize how enchanted books look.
settings:
  # Global book name format (supports color codes)
  book-name-format: "<gold><bold>PRIME BOOK"
  # Show the enchant's usage/description in book lore
  show-usage-in-lore: true
  # Show rarity tier in book lore
  show-rarity-in-lore: true

# ─── Debug Mode ───────────────────────────────────────────────────────
debug:
  enabled: false
  log-enchant-triggers: false
  log-synergy-triggers: false

# ─── WorldGuard Integration ───────────────────────────────────────────
worldguard-integration:
  # - "excavator:spawn"
  # - "utility:spawn"

# ─── Blacksmith Forge ─────────────────────────────────────────────────
forge:
  currency: "VAULT"
  # ... (Tiers removed for brevity)

# ─── Custom Book Items ────────────────────────────────────────────────
custom-book-items:
  provider: "NONE"
  mapping:
    # ...

# ─── Virtual Backpack ──────────────────────────────────────────────────
backpack:
  name: "<blue><bold>Virtual Backpack</bold></blue>"
  material: "BLUE_DYE"

# ─── Enchants List GUI ────────────────────────────────────────────────
gui:
  enchants-list:
    title: "<dark_purple><b>Enchant Categories</b>"
    rows: 6
    filler:
      material: "BLACK_STAINED_GLASS_PANE"
      name: " "
    border:
      material: "PURPLE_STAINED_GLASS_PANE"
      slots: [0,1,2,3,4,5,6,7,8,45,46,47,48,49,50,51,52,53]
    categories:
      SWORD:
        slot: 10
        icon: "DIAMOND_SWORD"
        name: "<gold><b>Sword Enchantments</b>"
      # ...

# ─── Messages ──────────────────────────────────────────────────────────
messages:
  no-permission: "<red>You don't have permission to do this.</red>"
  cooldown-actionbar: "<red>⏱</red> <white>%enchant%</white> <gray>»</gray> <yellow>%time%s remaining</yellow>"
  cooldown-activated-actionbar: "<green>✦</green> <white>%enchant%</white> <gray>▸</gray> <yellow>Cooldown: %time%s</yellow>"
  cooldown-hud-header: "<red>⏱ </red>"
  cooldown-hud-separator: " <dark_gray>·</dark_gray> "
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://yowsef-development.gitbook.io/yowsef-development-docs/untitled/configuration/config.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.