> For the complete documentation index, see [llms.txt](https://kubkitdev.gitbook.io/mmoforge/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kubkitdev.gitbook.io/mmoforge/how-it-works/admin-guide-and-faq.md).

# Admin Guide & FAQ

#### `Forge profiles (VIP)`

> Lets you have different forges. In `config.yml` → `profiles`:
>
> {% code overflow="wrap" %}
>
> ```
> profiles:  vip:    permission: "mmoforge.vip"    cost-multiplier: 0.5      # pays half    allowed-types: []          # all    allowed-tiers: []          # all
> ```
>
> {% endcode %}
>
> Assign a profile to a forge: `/mmf profile <forge> vip`. Players without the permission can't open it.

#### `Statistics & audit`

> * `/mmf stats` shows your total reforges, money spent, and best quality. Admins: `/mmf stats <player>`.
> * The **audit log** (`logs/reforge.log`) records every reforge (player, item, rarity, quality, cost). It rotates automatically when it exceeds the max size so it won't fill your folder. Useful to detect dupes/bugs.

#### &#x20;`MySQL`&#x20;

> To share pity and stats across the servers of a network. In `config.yml`:
>
> {% code overflow="wrap" %}
>
> ```
> storage:  type: mysql  mysql:    host: localhost    port: 3306    database: minecraft    username: root    password: ""    table-prefix: "mmoforge_"    use-ssl: false
> ```
>
> {% endcode %}
>
> * The driver downloads itself (Paper). Tables are created automatically.
> * Point all servers to the same database.
> * If the connection fails, it falls back to YAML without breaking anything.
> * **Forges are always local** (they're blocks in a world).

***

### FAQ & Troubleshooting

#### `Frequently Asked Questions`

> **My item says "incompatible".**\
> The item's type isn't in `categories.yml`, or it has none of those stats. Use `/mmf debug` with the item in hand to see its type and stats.
>
> **The rarity shows "None".**\
> The item has no MMOItems tier, or its tier isn't in `tiers.yml` (it'll use `DEFAULT`). Check with `/mmf debug`.
>
> **Pity isn't increasing.**\
> Pity targets the best quality the rarity allows. If the rarity doesn't allow any "good" one, check `allowed-qualities` in `tiers.yml`.
>
> **A hologram is floating with no forge.**\
> It cleans itself up when that chunk loads (walk over to it). Forges use crash-safe saving.
>
> **I changed a config and nothing happens.**\
> Run `/mmf reload` (or restart). If you edited `categories/qualities/tiers/lang`, reload also covers them.
>
> **Reforge cost is sky-high.**\
> That's the per-reroll multiplier. Lower `reroll-money-multiplier` or `reroll-money-cap` in `tiers.yml`.
>
> **A quality never appears for a certain item.**\
> Its rarity doesn't allow it (`allowed-qualities`). It shows as "✖ not available" in the book.

### &#x20;`How to Report a Bug`&#x20;

> ## How to Report a Bug
>
> Found a bug? Thanks for helping make MMOForge better! To get it fixed **fast**, please include the information below. A report without these details usually means I have to ask for them first, which slows everything down.
>
> ### ✅ Always include
>
> 1. **MMOForge version** — shown in your console on startup (`MMOForge v1.0 enabled...`) or by running `/mmf`.
> 2. **Server version** — e.g. `Paper 1.21` (run `/version`).
> 3. **MMOItems & MythicLib versions** — e.g. MMOItems 6.10, MythicLib 1.7.
> 4. **A clear description** — what happened, and what you *expected* to happen.
> 5. **Steps to reproduce** — exactly what you did, step by step, so I can trigger it myself.
> 6. **Console errors** — if there's a red error/stacktrace in console, copy the **whole** thing (use [pastebin.com](https://pastebin.com/) or [mclo.gs](https://mclo.gs/)).
> 7. **Your config files** — `config.yml`, `tiers.yml`, `qualities.yml`, `categories.yml` if the issue is config-related. Use a paste site, not screenshots.
>
> ### 📋 Copy-paste template
>
> {% code overflow="wrap" %}
>
> ```
> MMOForge version:Server (Paper/Spigot + MC version):MMOItems version:MythicLib version:What's happening:What I expected:Steps to reproduce:1.2.3.Console error (link):Config (link, if relevant):
> ```
>
> {% endcode %}
>
> ### 💡 Tips that speed things up
>
> * **Test with no other addons** if possible, it helps tell if another plugin is conflicting.
> * **Use a paste site** for logs/configs, not screenshots, I can't copy text from an image.
> * **One bug per report**  If you have several issues try to separate them.
> * **Run `/mmf debug`** holding the affected item, it shows the item's type, rarity, and what the plugin reads. Paste that output.
>
> The more detail you give, the better.