Cobblemon: Underground Mining Minigame

• Added setting to make players invincible during minigame
• Added setting to disable underground music (also works with world override)

• Fixed /mining open command to use block-specific settings from config
• the setting useOnlyBlockSpecificLoot now does what it says and no longer the opposite.

New Commands

• Zone Management: Create rectangular 3D regions where spots are allowed to spawn. Define mining areas for your server using /mining zone pos1, /mining zone pos2, /mining zone create <name>.
• Block Marking: Mark individual block positions for precise natural spot spawning control with /mining mark and /mining unmark. Perfect for reward areas or shop spots.
• Zone Toggle: Enable/disable zone restrictions with /mining zone toggle - when enabled, spots only spawn inside defined zones or on marked blocks, nowhere else.
• Config Reload: New /mining reload command to reload all configs without restarting the server.
• List & Clear: View zones with /mining zone list, marked blocks with /mining marks, or clear all marks with /mining marks clear.

New Configuration Options

• Disable Natural Spawning: New enableNaturalSpawning setting allows you to run in command-only mode - spots will only appear via /mining transform. This intended to be used with the Zone Management / Block Marking functions above.
• Dimension Blacklist: Added dimensionBlacklist to prevent natural spawning in specific dimensions (e.g., disable spawning in the Nether/End while keeping Overworld active).
• Spawn Check Tick Rate: New spawnCheckTickRate setting - define how often the mod checks for spawning new spots (default 20 ticks = 1 second).
• Required Tools for Blocks: Block entries now support requiredTool - require players to have a specific item in their inventory to open certain spots (e.g., diamond pickaxe for obsidian).
• Brush Item Requirement: New requiresBrushItem option - when enabled, players need an actual brush in their inventory to use the brush tool.
• Per-Dimension Spawn Control: World overrides now support enableNaturalSpawning for fine-grained control per dimension.
• Block Whitelist Removed: The blockWhitelist in settings.json has been removed - use blocks.json instead for full per-block customization (textures, health, stability, loot, dimension/biome filtering, and more).

Pokemon Spawning Improvements

• Layer Clear Spawning: New spawnOnLayerClear setting - Pokemon can now spawn when clearing layers.
• Layer Spawn Bonus: New layerSpawnBonus multiplier - spawn chance compounds per layer cleared (e.g., 1.15 = 15% bonus per layer).
• Block Blacklist: Added global blockBlacklist for Pokemon - prevent spawns from specific blocks (amethyst blocks blacklisted by default).

Documentation

• GitBook Documentation: Added comprehensive documentation covering all settings, commands, and features. https://me0-44.gitbook.io/cobblemon-underground-mining-minigame

Bugfixes

• Config Override Fix: Fixed a bug where configs were being overwritten on load, causing user changes to be lost.
• Custom Blocks: Now using custom blocks as primary, secondary or background where their name doesn't line up with the minecraft texture file name is possible.
• /mining simulation now works correctly with custom block types
• /mining transform infinite spots are now correctly saved on server and will persists restarts and ongoing cooldowns will be realculated after server restart.

This update contains critical bugfixes and is highly recommended.

Be aware that you will have to do some reconfiguration as the new configs are in the config/undergroundmining/ folder and have slightly different structure

Here is what happened in version 2.0:

New Gameplay & Mechanics

• New Tools: Added the Brush (1x1 tool for precise work) and TNT (massive 7x7 explosions).
• Progression Unlocks: Tools now require achievements; complete any layer with a Pickaxe only to unlock the Brush, or a Hammer only to unlock TNT.
• Achievement Bypass: Added a setting to disable the requirement of completing specific layers to unlock tools, set to false by default.
• NEW Special Grid Types: Introduced Time-Limited grids with ticking audio cues and Deep grids featuring up to 3 extra layers of dirt. Fully configurable as expected. Find better loot which is harder to get!
• Inventory Integration: Added an optional setting to require TNT items from your inventory, displaying the live count above the button using them when placing it in the grid.
• New Placement Logic: By default, spots no longer appear on blocks with air above them, restricting spawns to walls and cave ceilings.
• Proximity Check: Because of a new setting, mining spots are now at least 4 blocks apart by default.

New Server-Authoritative Language System

• Dynamic Translation: The server now manages and sends translations directly to clients based on their locale.
• Automatic Syncing: Clients send their language upon joining; the server loads the corresponding file from config/undergroundmining/language/ to overwrite the client's local strings. Meaning you can easily add languages for your servers target audience.
• Auto-Generation: The server automatically generates all default language files upon startup.

Configuration & Customization

• File Reorganization: All config files have been renamed and moved to the config/undergroundmining/ folder.
• CUSTOMIZE SPARKLE BLOCKS: NEW - Fully define what blocks can start a minigame, stability, rarity, health, custom drops, bedrock chances and more!!!.
• World & Biome Overrides: Expanded overrides to support specific dimensions (like Netherrack in the Nether), biomes, and custom block whitelists.
• Clear Rewards: New system to execute weighted commands upon completion (e.g., giving diamonds or applying effects).
• Advanced Pokemon Settings: Configure specific world and biome restrictions for Pokemon spawns along with their max grid sizes they can appear on.
• Post-Mining Cleanup: Optional settings to break the physical block in the world after a success or collapse.

Visuals, Sound & QoL

• Enhanced UI: Added fancy buttons and new sprites for all tools.
• Replaced Mining Tools instead of pickaxes you will now see custom pickaxe and hammer sprites!
• EXEPLOSION: The TNT tool features a custom placement animations, explosion particles, and screen shake for some nice juice.

Balance & Loot

• Rebalancing: General rebalancing of ore drops in the standard configuration:

• Coal always grants 1 item; Gold and Iron ores (2x2) now grant 1 ore.
• Gold and Iron nuggets now drop in randomized quantities of 1–3.
• Dirt specific loot was added to give dirt blocks a bit of a different early game usage.

Bugfixes

• Death Persistence: Dying during the mining minigame should now still correctly grant currently uncovered items.
• Inventory Overflow: If your inventory is full, mined items will now drop to the ground instead of being lost.

• Added items from my new mod Cobblemon: Ball Stickers to default config
• Added basic localization config.

• Fixed an issue where server configuration did not work correctly
• Fixed an issue where clients would sometimes see "ghost spots" that could not open a minigame

New:

• Added configurable compounding Layer Clear Rarity Bonus (15% per layer) with new UI indicators and messages
• Added Debug Mode configuration to view rarity breakdowns, tile durability, and hidden treasure locations
• Added smooth swing animations for pickaxe cursors and adjusted tool scaling
• Implemented Cobblemon spawning integration: fully configurable Pokemon now have a chance to appear upon completing a spot with configurable Shiny rate, bell-curve level distribution, and weighted spawn pools based on grid size
• Added /mining pokemon [gridSize] command for testing spawns
• Added a bunch of advancements
• You can now configure the maximum amount of layers a single node can contain

Bugfixes:

• Closing a active minigame using the button or the esc key will now still give you items you have uncovered.

• Split config files into a pickaxeminigame-loot.json and pickaxeminigame-settings.json
• Added lots of options for grid size chances, rarity boni ect.
• Addex Max Y config suggested by a discord user
• You can overwrite all of these settings per world allowing for quite the amount of customization

• Added Advancements: Treasure Hunter, Double Down, Jackpot!, Dedicated Miner, Master Miner, Big Fin, Motherlode!

• The iron pickaxe will now break blocks in a cross shape, dealing 2x in the center
• Hitting Bedrock will now apply a instability penalty
• Slightly reduced overall stability

• fixed enchanted books not having enchantments
• made sound when hittind bedrock much quieter

Added more pitch variation for repeating sounds

• We now play the Underground Soundtrack by Zame for very large and huge deposits!
• Fixed Bedrock not spawning

Added 10% chance to fing large, 5% chance to find very large and 1% chance to find a huge grids respectively, containing more and rarer items.

• Added more SFX, fixed some blocks not having sfx
• Added block break particles and wobble when hitting blocks

• Fixed issues where natural spawning spots might sometimes not work
• adjusted the button layout
• adjusted the default config

• The different types of spots now have different rarities. You also find higher quality items below Y10 in the overworld.

• Adjusted rarities for top tier items, added very rarely obtainable vanilla items to pool.

• Added commands for servers to create permanent loot spots that have a cooldown. This can for example be used to create Daily loot spots or refreshing loot spots in prison servers.

• Added commands for serverowners to simulate itemdrops for each spot type.