Progression / MxF Factions
The MxF shop is a configurable reward shop backed by YAML definitions and purchase history.
Docs version
v1.0.0
Product version
1.0.0-dev
Last updated
Jul 21, 2026
# MxF Shop
The MxF shop is a configurable reward shop backed by YAML definitions and purchase history.
/f shop opens the default shop GUI when menus are enabled.
/f shop menu [shop] opens a specific shop GUI./f shop list [shop] [page] shows text fallback entries.
/f shop buy [shop] <item> confirm purchases an item.
/f shop history [page] shows relevant purchase history.
/f shop admin reload reloads reward economy YAML.
/f shop admin validate shows definition diagnostics.
/f shop admin inspect <id> inspects a shop or reward definition.
/f shop admin refund <purchaseId> [reason] marks a purchase refunded and restores reversible currencies.
mxf/rewards.yml controls global reward economy behavior.
mxf/shop-definitions.yml defines shops and items.
mxf/reward-definitions.yml defines reward actions.
data/purchase-history.json stores purchase records.
money
faction-money
season-points
xp-levels
item
Unsupported currencies fail closed until a provider is registered.
The generated default catalog now includes testable personal and faction examples:
Personal money pack paid with XP levels.
Faction season bundle paid with Season Points.
Utility supply bundle paid with personal money.
Limited faction booster paid with faction money and Season Points.
Defaults use existing reward providers and preserve server-owner edits.