Feature Setup / MxF Factions
Configure upgrade levels, requirements, effects, reusable rewards, shops, point shops, and purchase safety.
Docs version
v1.0.0-dev
Product version
1.0.0-dev
Last updated
Jul 21, 2026
Upgrades and shops give factions progression goals. Reward definitions keep payouts consistent across missions, events, seasons, and shops.
mxf/upgrades.yml
mxf/upgrade-definitions.ymlmxf/rewards.yml
mxf/reward-definitions.yml
mxf/shop.yml
mxf/shop-definitions.yml
menus/upgrades.yml
menus/shop.yml
messages/upgrades.yml
messages/shop.yml
1. Define categories and display metadata.
2. Define each upgrade id, icon, description, levels, price, requirements, and effects.
3. Confirm the target subsystem supports every effect you enable.
4. Verify max-level rejection, missing economy handling, insufficient funds, and restart persistence.
1. Create reusable reward definitions first.
2. Use clear ids and descriptions.
3. Use console-command rewards only when necessary and reviewed.
4. Confirm reward handlers are registered before attaching them to high-value content.
1. Create shop categories and entries.
2. Set price type, limits, requirements, confirmation, and reward reference.
3. Configure point shop entries separately from money purchases.
4. Verify purchase history and refund behavior where enabled.
/f upgrades
/f upgrade info <id>
/f upgrade buy <id>
/f upgrades admin definitions
/f upgrades admin inspect <id>
/f upgrades admin reload
/f shop
/f shop list [shop] [page]
/f shop buy [shop] <item> confirm
/f shop history [page]
/f pointshop
/f rewardsPrices should charge once, rewards should issue once, maxed upgrades should not repeat, and empty catalogs should show honest empty states.