SP Spawner Miner

0.1.1 · Minecraft 26.2 · Fabric · Java 25+

Mine ordinary mob spawners with the new Spawner Extraction I pickaxe enchantment, carry their mob settings and upgrades, and improve five independent stats with SP Economy coins. Right-click a spawner for the dark-and-gold SP panel.

Quick test

1. Create a separate cheats-enabled Creative world with the dependencies above.
2. Hold a diamond or netherite pickaxe and run /spspawner enchant. Existing enchantments remain intact. Alternatively: /enchant @s sp_spawner_miner:spawner_extraction 1.
3. Get a vanilla spawner with /give @s minecraft:spawner, place it, and use a spawn egg to select its mob.
4. Change to Survival and break it with the enchanted pickaxe. Expect one named SP Spawner, no spawner XP, and normal tool durability use. Its tooltip shows mob type and all five upgrade levels.
5. Place it again. Right-click with an empty hand to inspect and purchase upgrades. Fund the test player's wallet using SP Economy's administrator tools.
6. Buy Online Owner, travel beyond 128 blocks or to another dimension, and keep the owner connected. The spawner's chunk and its immediate simulation area remain active. Log the owner out on a dedicated server: the mod releases its tickets on the next server tick. Vanilla proximity rules then apply if another player is nearby.
7. Save and reopen the world. Check the type, levels and owner again.

Survival source: End City ship chests only, with an independent 5% chance per chest for one Spawner Extraction I book. Regular End City tower/building chests are unchanged. Normal ship treasure remains intact. There is no enchanting-table, villager-trade, fishing/generic random-loot, recipe or SP Shop source added by this mod. Administrator commands remain available for testing.

Upgrades and defaults

Price is base price × next level. Speed never reduces delays below 40/80 ticks. Existing custom settings above the configured caps are not reduced: purchases that cannot improve the stat are refused. Configuring a lower max level does not undo bought stat upgrades. Online-owner limits apply immediately: defaults are 8 registered remote spawners per owner, 64 globally. Lowering these limits suspends excess entries in registration order rather than deleting their purchased upgrade.

Change prices, level maxima, delay floors, stat caps and online-owner limits in /spadmin → SP Spawner Miner → Spawner settings, or edit config/sp-spawner-miner.json and run /spspawner reload. Settings are saved before becoming active. Invalid bounds are rejected.

Interaction and ownership

• Empty-hand/non-sneaking right-click opens the panel. Sneaking passes through for building; spawn eggs always retain vanilla behavior and may change the mob type.
• Placement assigns the placer as owner, including Creative placement. The first upgrade claims an unowned naturally generated spawner. Only the owner or a game-master administrator may upgrade it.
• Ownership governs upgrades and online activity; it is not land protection. Mining and spawn-egg access follow the server's normal vanilla/protection-mod rules.
• Online Owner keeps the source chunk entity-ticking with a dedicated, nonpersistent ticket. Multiple spawners in the same chunk share that ticket. Owner disconnect, world shutdown or removal releases the mod's tickets without changing /forceload tickets.
• Mobs spawned during remote operation do not immediately distance-despawn while they remain within 32 blocks of their still-active source spawner. Outside that area, when the owner logs out, or when the source is removed, normal despawning resumes. Peaceful difficulty still removes hostile mobs. This is not a permanent persistence flag.
• Existing spawn requirements, collisions, difficulty and nearby-mob limits still apply. Online Owner does not guarantee successful spawning without a suitable farm.

Data preservation and limits

Vanilla spawner serialization is carried intact, including current SpawnData, multiple weighted SpawnPotentials, equipment/custom spawn rules, delays, count, range, nearby limit, and SP levels/owner. A world-local HMAC authenticates the serialized payload before it is loaded. The server rejects tampered data, oversized payloads and block-entity overrides. A valid signed item can be placed only in the world that signed it. The payload limit is 65,536 characters; oversized spawners refuse extraction and stay in place.

Portable items are unstackable. Survival extraction produces one item without spawner XP; Creative breaking produces none. A plain/wrong tool retains vanilla breaking behavior. Trial spawners are outside this release. No arbitrary client NBT is executed. Compatibility with other mods that replace spawner serialization is not guaranteed.

World-specific signing key and remote index are stored in data/sp-spawner-miner.json inside the world. Back up that file with the world; deleting it invalidates existing portable items. Do not distribute that private world file. No personal configs, game accounts or worlds are included in this repository.

Purchases use the official Core EconomyApi.change transaction with validation and rollback, never direct wallet storage. Distance (8 blocks), block identity, current ownership, game mode, limits and displayed purchase state are checked server-side. Stale/replayed panel requests cannot buy twice. This API cannot provide crash-atomic commits across the wallet and Minecraft chunk files: an abrupt process/power failure between separate saves remains a persistence boundary; keep normal world backups.

Commands

Game-master permission is required:

• /spspawner enchant — apply Extraction I to the held pickaxe.
• /spspawner reload — validate and reload configuration.
• /spadmin — shared SP administration panel, supplied by Core.