> 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/v1.0-initial-release.md).

# v1.0 Initial Release

The first public release of MMOForge. A complete reforge & quality system for MMOItems.

**Core system**

* Reforge system that modifies an item's **real stats** and adds a quality suffix to its name.
* Fully configurable **qualities** (suffix, stat modifier, roll weight, sound).
* **Smart extra stats** — high qualities add bonus stats, but only the ones compatible with the item type (weapons get offensive, armor gets defensive).
* **Quality cap per rarity** — higher rarities unlock better qualities and avoid the worst ones.

**Player progression**

* **Progressive pity** — each reforge raises the chance of the best quality your item's rarity can reach; the target is guaranteed at the threshold.
* **Reforge dust** — sellable/tradeable items that raise your odds, with anti-abuse caps, dust consumption, and bad-luck rewards.
* **Protection shield** — limited uses per item (more via VIP permissions), with a cost that scales per use.

**Forges & menu**

* Physical forge blocks with native 1.21 holograms.
* Per-player isolated menu with live stat preview and dynamic quality odds.
* Crash-safe forge saving and automatic cleanup of orphaned holograms.
* **Forge profiles** for VIP/special forges (cost multipliers, type/tier restrictions, permissions).
* **Fireworks celebration** when rolling a top quality.

**Admin & quality of life**

* Multi-language support (English & Spanish) with split, organized config files.
* Player statistics (`/mmf stats`) and a lightweight, self-rotating audit log.
* Anti double-click cooldown and lockable "perfect" qualities.
* Broadcast announcements for top-tier results.

**Integrations**

* **MMOItems** (required) — reads tiers, types, etc
* **Vault**  money costs.
* **MMOCore** level/class requirements with a visual ✔/✘ check in the menu.
* **PlaceholderAPI** pity and quality placeholders.
* **MythicMobs** dust as a natural mob drop.
* **Oraxen** custom dust textures via model data.

**Data & licensing**

* Storage backend: **YAML** (default) or **MySQL** for networks (shared pity/stats), with automatic fallback.