SP Economy

1.3.0 · Minecraft 26.2 · Fabric · Java 25

• /spcoins: show your wallet balance.
• /spcoinedit: Creative + cheats/operator graphical editor for mob/block rewards, Physical/Direct delivery and Auto/On/Off notifications.
• sp_coins:spcoin: one coin item = one SPCoin, stack size 64. Hopper and chest storage work normally; player inventory/cursor coins are automatically redeemed.
• The legacy sp_shop:spcoin item is also registered and redeemed, preserving existing world items even without SP Shop.
• Physical rewards above 4096 use Direct to limit entities. Block rewards are opt-in. Ordinary player placement tracking, correct-tool checks and Creative exclusions are preserved.
• Auto notification integration supports SP VitalView; otherwise SP Economy draws its own +X notice. On forces ours, Off hides ours. Disabled/incompatible foreign feeds fall back in Auto.

Existing worlds

The wallet and placement records live in sp-coins.json in each world; reward settings live in config/sp-coins/settings.json. On first use, if that file does not exist, SP Economy reads balances, reward settings and tracked placements from sp-shop.json, validates them, saves a backup sp-shop.pre-sp-coins.json, and creates the independent wallet file. Subsequent starts use only the wallet file and never reimport the old balances. Corrupt data stops loading rather than resetting money.

Wallet writes use temporary-file replacement. Ordinary API/effect failures roll back in memory and invoke caller rollback. Minecraft inventories and other mods' files remain separate saves: abrupt process/machine crashes are not a cross-file atomic transaction. Placement detection is not a universal natural-block detector; piston movement and placements by other mods may bypass it.

Settings access

/spcoinedit requires both Creative mode and game-master command permission (cheats enabled in singleplayer, or operator permission on a server). Survival, Adventure and Spectator players cannot open or save economy settings, even if they have operator permission. /spcoins remains available to all players.

Shared settings and world data

• SP Economy: config/sp-coins/settings.json — reward rules, chances, amounts, delivery and notifications.
• SP Shop: config/sp-shop/settings.json — sections, catalog, prices, ability rules/durations and HUD settings.

Wallets, acquired ability grants/timers, per-player disabled abilities and placed-block records stay in each world's sp-coins.json / sp-shop.json. They are never copied into shared settings. Ordinary world saves do not overwrite shared configuration.

On the first launch after upgrading, open the existing world whose settings you want to keep: its settings seed the shared file if none exists. Later worlds use the shared file without replacing it. Original world files are preserved as *.json.pre-shared-settings.bak during migration. Invalid shared settings stop loading rather than resetting them.

Version history

• 1.2.0 — 2026-10-08: configurable death penalty and loss messages.

• 1.1.0 — 2026-10-07: shared settings across worlds; wallets and player progress remain world-local.

• 1.0.1 — 2026-10-06: dedicated gold SP icon and Creative + cheats/operator access to settings.

• 1.0.0 — 2026-10-06: first independent economy mod, migration from SP Shop, physical coin compatibility and public API.

• 2026-10-03 to 2026-10-05: original economy developed inside SP Shop 0.1.0–0.5.1.

Death Penalty — 1.2.0

On an actual player death, deduct the configured percentage of that world's digital wallet, rounded down to whole SPCoins. Totem saves and cancelled deaths do not trigger it. The victim receives a separate gold chat line alongside the normal death message: Death penalty: -100 SPCoins. Balance: 900 SPCoins. Zero-wallet/rounded-zero deaths show 0 when enabled; disabled penalties show no line. Physical coins in storage are not included. Keep Inventory does not protect the digital wallet. Any actual player death is eligible, regardless of game mode or cause. A failed save restores the balance and reports the failure instead of claiming a deduction.