SP Cobble GEN

Build a normal cobblestone generator. When vanilla Minecraft would turn flowing lava into cobblestone, SP Cobble GEN chooses a configured block or a chest instead. Lava sources still create obsidian; vanilla stone and basalt conversion paths are unchanged.

There is no special generator block or crafting recipe. The location where the output appears is the generator identity, including its dimension. Rebuilding at the same position keeps its progress; building elsewhere starts a separate generator. All players mining the same position share its progress.

Successful player breaks of tracked generated blocks count in both Survival and Creative. The game-mode restriction applies to editing settings, not to earning generator progress. Ordinary hand-placed blocks, explosions, and piston/automatic mining do not award progress. Moving a generated block does not transfer progress. Chest generation or opening alone does not count; breaking the generated chest does.

Ore mining uses normal Minecraft tool and harvesting rules. Purchased skills can transform ordinary loot after Fortune; Silk Touch bypasses those transformations. The progress counter counts a successful block break, even if the wrong tool yields no item.

Each default block pool assigns 80% of its weight to cobblestone and splits the remaining 20% equally among its ores. Levels have independent pools; a later level does not implicitly inherit an earlier level's entries.

Run /sgen in chat to see the nearest active generator in loaded chunks in your current dimension:

• Coordinates, level number and level name.
• Total mined blocks, the next cumulative threshold, and remaining blocks.
• Each available block's overall generation percentage, including the chest roll.
• The surprise chest percentage.

This is a read-only command available in Survival without cheats. The generator owns the level, rather than the individual player. If several generators are nearby, the nearest is selected. The command can describe a loaded generator outside the HUD radius; it does not load distant chunks. A removed generator is ignored when it has neither a tracked output nor adjacent water and lava.

Unavailable mod blocks are excluded, duplicate entries are combined, and fallback cobblestone is included when necessary. For example, a 10% chest chance with 80:20 block weights reports 72% cobblestone, 18% coal ore, 10% chest.

A green bar at the top of the screen shows the nearest active generator within 20 blocks by default. Distance is measured in three dimensions from the player to the output block's center. It shows progress within the current level, resets at a level-up, and displays a full MAX bar at the highest level.

The bar updates twice per second and disappears when you leave the radius, change dimension, remove the generator, or disable the mod. Each player has their own nearest-generator display.

Authorized editors can use Esc → SP Cobble GEN → Progress bar to set a radius of 0–256 blocks. 0 hides the bar. Click Apply, then Save for all worlds. The radius is a shared setting; old 0.1.0 worlds automatically default to 20 blocks without losing their configuration or mining progress.

Open Esc → SP Cobble GEN → Progress bar. In addition to the radius, this screen has editable Progress bar text and Text at maximum level fields. Each accepts up to 160 single-line characters. Leave a field blank to keep the original translated label for that state.

You can use plain text, dynamic fields, or both:

My generator | Level {level} | {current}/{required}

For the maximum-level field, a useful example is {name} | MAX | Total: {total}. Keep labels short enough to fit your screen. Unknown tokens remain literal text. Select Apply, then Save for all worlds; Cancel discards the edits. Both labels are shared across worlds and update automatically as progress changes.

• Chest appears: a short burst of white end-rod sparkles and an amethyst chime, emitted after the generated chest has been placed and filled.
• Generator levels up: green happy-villager particles and Minecraft's player level-up sound at the generator when a counted break crosses a level threshold.

The Chest and Level-up buttons in the progress-bar settings independently enable or disable each event's sound and particles together. Both start enabled. They follow the same Apply/Save and Creative/cheats authorization rules as other settings.

Effects use nearby vanilla particle/sound delivery, independent of the HUD visibility radius. Sound volume follows Minecraft's Blocks sound category. They do not grant XP or change loot. Opening an existing chest, ordinary mining within one level, editing thresholds, and reloading a world do not replay the celebrations.

Existing saves keep their settings and progress: missing label fields default to automatic translated labels, and the new effects default to enabled.

Stand within 32 blocks of an active generator and run /slvl. The dark, gold-framed menu shows five rows of rank icons, the generator's coordinates and level, available skill points, the selected branch's current/next effect, costs and an Upgrade button. Hover a rank icon for its name. Select any icon in a branch to view its next purchasable rank. Ranks are bought sequentially. The footer tracks mining toward the next skill point.

The menu stays bound to the original generator while open. Moving out of range, changing dimension, disabling generation or resetting that generator closes it on the next refresh. Leaving the area does not erase progress. Building at another coordinate starts a separate generator; there is no progress-transfer item.

Effects in the table are the total effect at that rank, not added together. Treasure hunter turns a 1% base chest chance into 1.5% at rank 5; it does not enable chests at levels with a 0% base. Chest chance is capped at 100%. /sgen includes the upgraded effective generation percentages and unspent points.

Auto-smelting runs first, doubling second, then the resource jackpot replaces at most one eligible item per mined block. For example, with all three effects triggered, one raw iron becomes two iron ingots, then one of those ingots becomes an iron block. Default mappings cover iron, gold, copper and netherite ingots. A jackpot requires a matching drop; raw iron needs auto-smelting before it matches the default iron-ingot mapping.

Normal tool and harvesting requirements still apply. Silk Touch bypasses these drop transformations and preserves the block. Generated chests and other block entities are excluded, so their inventories are never doubled or smelted. Hand-placed blocks, explosions and automatic mining do not receive skill bonuses.

By default, every 100 tracked Survival breaks earns one point, and a generator level-up caused by Survival mining earns one extra point. Points continue to accrue at maximum generator level. Successful tracked breaks count even if the tool yields no drop. Creative breaks still advance the generator's level but earn no points.

*Resource jackpot instead costs rank + 1 points and 2 × rank diamonds, and requires Auto-smelt rank 1. Creative players can test upgrades without paying or meeting level/prerequisite requirements.

Points and purchased ranks belong to the generator and are shared by its miners. Material costs come from the purchasing player's main inventory/hotbar, excluding equipment and offhand. The server checks range, current rank, prerequisites, level, points and inventory again before applying an upgrade. Purchases and resets are saved immediately. Stale or repeated purchase requests cannot buy the same rank twice.

Open Esc → SP Cobble GEN → Skills:

1. Set Survival blocks per point and points rewarded for a level-up.
2. Select a branch; use arrows to select a rank and + / − to add/remove the final rank (1–10 ranks).
3. Edit the total percentage effect, point cost, material quantity and required generator level.
4. Select the cost-item button to search all registered items, including installed mods.
5. Cycle the prerequisite button and set its required rank. Dependency cycles are rejected when saving.
6. Under Resource mappings, add an input item and then the output item. Select an existing mapping to change its output, or × to remove it.
7. Return to the main editor and Save for all worlds. Root Cancel discards the draft.

Effects must be nondecreasing between ranks and within 0–100%. Costs allow 0–100,000 points and 0–2,304 items; level requirements allow 1–128. There may be up to 128 resource mappings. Set material quantity to zero for a points-only upgrade. Modded smelting recipes are used automatically; modded compression mappings and costs can be selected from the registry picker.

Existing generators keep their level, mined count, pending output and settings when updating. New skills start at rank 0 with zero points: old counts cannot reliably distinguish Survival from Creative, so points are earned going forward. Reducing a branch's rank count caps its active effect; restoring ranks re-enables previously purchased ranks. Settings changes do not refund prior purchases.

Weights are relative and do not have to total 100. Weights 80 and 20 give an 80:20 ratio; weights 4 and 1 give the same ratio. The Blocks screen shows normalized percentages.

Chest probability is rolled first. With a 10% chest chance and block weights 80:20, the overall results are 10% chests, 72% of the first block and 18% of the second block.

Set chest chance to 0 to disable chests for that level, or 100 to generate only chests.

Each configured item entry gets an independent percentage roll. On success, one stack is placed in a randomly selected unused chest slot, with a uniformly selected quantity between its minimum and maximum inclusive. Quantity is capped at the item's own maximum stack size.

For example, coal at 100% with quantity 2–8 always appears in generated chests; diamonds at 10% with quantity 1–2 appear only on successful diamond rolls.

A chest can be empty when all its item rolls fail. To guarantee a nonempty chest, include an available item with a 100% chance. Up to 27 entries fit a chest. This version supports item IDs and quantities, not custom enchantment/NBT/component editing.

Only earned state remains in <world>/sp-cobble-gen.json: generator positions, mined counts, pending outputs, point counters and purchased ranks. No points or purchases transfer between worlds. Points still belong to the generator, as in 0.4.0; this update does not introduce a personal wallet.

When upgrading, if the shared file does not yet exist, the first world opened supplies its old settings. Open the world with your preferred configuration first. If the first world is new, defaults are created. Once the shared file exists, later worlds use it and cannot overwrite it with their old settings.

Before converting each old world to progress-only format 2, its complete original file is preserved as <world>/sp-cobble-gen.legacy-backup.json. To choose another old configuration later, close the world and copy just the backup's config object into the shared settings.json file. Do not copy the entire world-data wrapper. Invalid files disable loading without silently replacing them with defaults.

Editing settings does not spend, refund or transfer earned progress. As before, changing thresholds recalculates displayed levels, and changing rank effects changes the effect of already purchased ranks. Remote players use the server's settings, not their own client config. Settings permissions are unchanged.

This release provides world-settings editing for the single-player world owner, including a world hosted to LAN. The editor is only visible/accessible in Creative mode or with Minecraft's game-master command permission (enabled cheats/operator privileges). Survival without cheats cannot open or save settings. Rights are checked again on the server before saving. Remote players cannot edit the owner's settings. A dedicated-server configuration editor is not included. The separate player skill menu uses client/server packets and is available to remote players with the mod installed on both sides.

Generator progress is shared by players mining the same output position. The HUD independently selects the nearest generator for each player. World PIN Lock has its own restrictions: a PIN-protected world remains subject to that mod's LAN/online blocking.

Creative mode only, even when a Survival player has cheats enabled. Run /sreset within 32 blocks of a generator, read its coordinates in chat, then type /sreset again within 15 seconds.

Confirmation resets only that originally selected generator's mined count, level, unspent points, skill-point mining counter and purchased skills. It does not erase world settings, other generators or the existing output block/chest, and it does not refund spent materials. The current generated block remains eligible for the next counted break. The second command cannot silently switch to a different nearby generator. If confirmation expires, another command starts a new confirmation.

1. Open Esc → SP Cobble GEN.
2. Enable or disable the mod for this world.
3. Select a level, or add a new one.
4. Under Level settings, edit its name, cumulative mined-block threshold, and chest chance.
5. Under Blocks, add/remove blocks and edit their relative weights.
6. Under Chest loot, add/remove items and edit minimum/maximum quantities and individual appearance chances.
7. Return to the main editor and choose Save for all worlds.

Changes are a draft until Save for all worlds succeeds. Cancel discards the whole draft. An entry's Apply only updates the draft. Settings apply to subsequent generation immediately; already generated blocks/chests keep their existing contents. Mining progress is retained when settings change and the level is recalculated from the new thresholds.

The first level always starts at zero. Later thresholds must strictly increase. Thresholds mean total mined blocks, not additional blocks since the previous level. The main editor shows the nearest known generator's coordinates, total mined count and current level.

Invalid values are rejected before saving. The per-item stack-size limit can reduce a configured quantity, for example for items that only stack to one.

Settings live in config/sp-cobble-gen/settings.json; position-based progress lives in <world>/sp-cobble-gen.json. Progress is saved with world saves and shutdown; changing shared settings saves immediately. Writes use a temporary file and atomic replacement where supported.

Settings are shared across worlds in the same Minecraft instance; earned progression remains independent per world. Malformed saved data disables generation for that world and exposes an error through the editor; the original file is preserved rather than overwritten with defaults.

The settings button is missing: the local player must be in Creative or have cheats/game-master permissions. A remote player does not receive the editor. Ordinary Survival players can still use /sgen.

The counter stays at zero in Creative: update to 0.2.1 and remove older duplicate JARs. Earlier versions deliberately excluded Creative breaks. Only generated blocks count; breaking a manually placed block does not.

The bar seems to reset: it shows progress within the current level. For example, at the default level-2 threshold, the bar starts at 0/400 while /sgen shows 100 total mined toward the next threshold of 500.

No progress bar appears: check that the mod is enabled and the radius is not 0. Move within the configured three-dimensional distance of an active generator. The default is 20 blocks, including vertical distance.

/sgen cannot find a generator: produce a block through flowing-lava/water contact first. The command checks active recorded generators in loaded chunks in your current dimension.

The generator produces obsidian or normal stone: lava sources and downward lava-to-water stone conversion keep their vanilla behavior. Build a conventional flowing-lava cobblestone generator.

A modded ore is missing: its mod must be installed and compatible with Fabric 26.2. Search by registry ID, such as tin_ore or the mod namespace. Fluids and block-entity blocks are excluded.

A chest is empty: item rolls are independent. Give at least one available item a 100% appearance chance to guarantee contents.

Settings will not save: check threshold ordering, nonempty block pools, chance/quantity limits and missing mod entries. Use Save for all worlds on the main editor after applying individual edits.

Saved data cannot be read: the existing file is preserved. Check the game's log for the specific error and restore a known-good world backup; no automatic reset is performed.

An incompatible version loads: keep exactly one SP Cobble GEN JAR and a compatible Fabric API build for Minecraft 26.2.