> 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/getting-started/about-mmoforge.md).

# About MMOForge

**MMOForge** is an add-on for **MMOItems** that adds a **reforge / quality** system inspired by Terraria. Players insert an MMOItems item into a forge, pay a cost, and get a **random quality** that modifies the item's **real stats** and adds a suffix to its name.

Example: an `Epic Sword` can be reforged into `Epic Sword (Razor Sharp)` with +18% damage.

## Key Features:

* Configurable qualities that multiply stats and add name suffixes.
* "Smart" extra stats on high qualities (compatible per item type).
* Quality cap per rarity (a common item can't reach Divine).
* Progressive **pity** system (bad-luck protection).
* **Reforge dust** to raise your odds (sellable, droppable).
* **Protection shield** with limited uses.
* Physical forges (blocks) with a hologram and a per-player menu.
* Multi-language (EN/ES), forge profiles, statistics, audit log.
* Integrations with Vault, MMOCore, PlaceholderAPI, MythicMobs.
* YAML or MySQL storage (for networks).

{% hint style="info" %}

#### `Requirements`

#### `Plugins and MC version`

> * Paper **1.20.1 – 1.21.x**
> * **MMOItems 6.10** + **MythicLib 1.7**
>
> **Optional (auto-detected):**
>
> * **Vault** + an economy plugin (CMI, EssentialsX…) → money requirements.
> * **MMOCore** → level and class requirements per item.
> * **PlaceholderAPI** → placeholders.
> * **MythicMobs** → dust as mob drops.
>
> If an optional plugin isn't present, that feature is simply ignored.

####  `Installation`

> 1. Place `MMOForge.jar` in your `plugins/` folder.
> 2. Make sure MMOItems and MythicLib are installed.
> 3. Restart the server (don't use `/reload`).
> 4. Configuration files will be generated in `plugins/MMOForge/`.
> 5. (Optional) Edit the configs and run `/mmf reload`.
>    {% endhint %}