Collection of mods for the game Coal LLC.
IMPORTANT: You use mods at your own risk. I am not responsible for any issues or damage caused by using mods. This is not an official modding method yet, the game author ByeByeOcean is also not responsible for any issues or damage caused by mods.
All mods require Godot Mod Loader (GML) by NanobotZ to be installed first:
👉 https://github.com/NanobotZ/godot-mod-loader
-
Download the mod loader here (choose the version for your operating system): https://github.com/NanobotZ/godot-mod-loader/releases/latest
-
Extract the mod loader and copy the addons folder into both of these locations:
C:\Program Files (x86)\Steam\steamapps\common\Coal LLC\andC:\Program Files (x86)\Steam\steamapps\common\Coal LLC\Coal LLC\ -
In Steam, open Coal LLC's properties and add this into launch options:
--script "addons/mod_loader/mod_loader_setup.gd"
Once GML is set up, drop the mod .zip file(s) into the mods/ folder inside your Coal LLC game directory and launch the game (do not extract the zip).
IMPORTANT: For now it's a good idea to delete "mod-hooks.zip" file from the game folder each time the game updates!
Warning: When launching the game with new mods, you may see a popup saying "New mods will be applied after a restart.", and the buttons might not work. If that happens, Alt+F4 out of the game and launch the game again.
Every mod in this repository has its own README with all its settings, linked from its heading below.
| Mod | Author | Description |
|---|---|---|
| Ore Value Mod | der_floh | Configurable sell price multiplier per ore type |
| Passive Drop Mod | der_floh | Configurable chance for ore (and other) tiles to drop a PassiveUpgrade on destruction |
| Pickaxe AOE Mod | der_floh | Electric pickaxe and AOE ability deal full damage instead of vanilla reduced ratios |
| Effect Spread Mod | der_floh | Spreads poison, fire and wetness to nearby tiles when an affected tile is destroyed |
| Game Limits Mod | der_floh | Tune performance-related caps (mortars, chunk loading, electric chain) via settings tab |
| Performance Mod | der_floh | Optimised chunk loading, tile effects, and level generation to reduce frame time spikes |
| No Holes Mod | der_floh | Fills air pockets in world generation so underground rock is always solid |
| Tick Upgrade Mod | der_floh | Passives that speed up poison/fire ticking; effects keep ticking on unloaded tiles |
| Custom Seed Mod | Ingenitus | World seed for reproducible mines, independent of exploration order |
| Axe Glare Toggle Mod | Ingenitus | Hide the axe/battleaxe full-spin glare particles |
| Bug Fixes Mod | Ingenitus | Fixes quota overflow, save loss, stuck pause, loot duplication and more (each toggleable) |
| Chest QoL Mod | Ingenitus | Open/loot chests on touch, reach them from their protective tiles, no outclassed scrolls |
| Number Format Mod | Ingenitus | Large numbers as 1.23e10 instead of 1.23457e+10 |
| Employee Balance Mod | Ingenitus | Bomber and elementalist tiers mine faster as they rank up |
| Extra Passives Mod | Ingenitus | Ten new passives for guns, axes, vacuum, drill, earthquake and bombs |
| Move Speed Slider Mod | Ingenitus | Walk Speed slider (Tab) that can raise walking up to sprint speed |
| AutoPassiveChooser | NanobotZ | Automatically selects passives on level-up based on a configurable priority list |
| garethwhite-prog's mods | garethwhite-prog | 26 mods: weapons, explosives, employees, shop upgrades, utilities and more |
Ore Value Mod (der_floh-ore_value_mod)
Download from Nexus Mods.
Configurable sell price multiplier for every ore type. Each ore can be scaled independently relative to its vanilla price - set Coal to 1000000 to make it sell for 1,000,000x vanilla, or leave everything at 1 for pure vanilla prices.
Note: A changed multiplier applies immediately. Under the Coal Is Worthless hard modifier, coal sells for 0 whatever its multiplier.
Adds an Ore Value tab to the in-game settings menu with a number input per ore.
| Option | Default | Description |
|---|---|---|
| Coal | 1 |
Sell price multiplier for Coal |
| Option | Default | Description |
|---|---|---|
| Copper Ore | 1 |
Sell price multiplier for Copper Ore |
| Iron Ore | 1 |
Sell price multiplier for Iron Ore |
| Silver Ore | 1 |
Sell price multiplier for Silver Ore |
| Gold Ore | 1 |
Sell price multiplier for Gold Ore |
| Option | Default | Description |
|---|---|---|
| Amethyst | 1 |
Sell price multiplier for Amethyst |
| Sapphire | 1 |
Sell price multiplier for Sapphire |
| Emerald | 1 |
Sell price multiplier for Emerald |
| Ruby | 1 |
Sell price multiplier for Ruby |
| Diamond | 1 |
Sell price multiplier for Diamond |
| Pink Diamond | 1 |
Sell price multiplier for Pink Diamond |
| Spinel | 1 |
Sell price multiplier for Spinel |
| Uranium | 1 |
Sell price multiplier for Uranium |
| Moonstone | 1 |
Sell price multiplier for Moonstone |
| Onyx | 1 |
Sell price multiplier for Onyx |
Passive Drop Mod (der_floh-passive_drop_mod)
Download from Nexus Mods.
Adds a configurable chance for each ore type (and optionally any block) to drop a PassiveUpgrade scroll when destroyed. The quality of the dropped passive scales with the layer depth of the destroyed tile — just like vanilla chests give better loot deeper down.
Adds a Passive Drop tab to the in-game settings menu with a slider (0–100 %) per ore type.
Note: By default the mod turns chest generation off, so mines have no chests at all until you switch Chest Generation on or Mod Enabled off.
Optional: Install AutoPassiveChooser alongside this mod and enable Auto-Collect Dropped Passives to have the passive chooser trigger instantly on each drop and auto-select the best option without any player interaction.
Individual sliders for each ore type. Defaults reflect ore rarity:
| Ore | Default |
|---|---|
| Coal | 1 % |
| Copper | 2 % |
| Iron | 4 % |
| Silver | 6 % |
| Gold | 8 % |
| Amethyst | 10 % |
| Sapphire | 20 % |
| Emerald | 30 % |
| Ruby | 40 % |
| Diamond | 50 % |
| Pink Diamond | 60 % |
| Spinel | 70 % |
| Uranium | 80 % |
| Moonstone | 90 % |
| Onyx | 100 % |
| Non-Ore Blocks | 0 % |
| Option | Default | Description |
|---|---|---|
| Weapon Drops from Chests | true |
When disabled, weapon-scroll chest drops are replaced with a passive upgrade |
| Chest Generation | false |
When enabled, chest dungeons are generated normally in every newly generated chunk |
| Option | Default | Description |
|---|---|---|
| Auto-Collect Dropped Passives | false |
When enabled, triggers the passive chooser screen immediately on drop instead of spawning a world item; pairs with AutoPassiveChooser for fully automatic selection |
Pickaxe AOE Mod (der_floh-pickaxeaoe_mod)
Download from Nexus Mods.
Makes the electric pickaxe and the AOE ability deal full damage to every tile they hit, instead of the reduced ratios vanilla applies to chained/surrounding tiles.
- Electric pickaxe: removes the per-step chain falloff (vanilla: ×0.8 per step)
- AOE ability: removes the area damage reduction (vanilla: ×0.3)
No configuration options.
Effect Spread Mod (der_floh-effect_spread_mod)
Download from Nexus Mods.
When a tile that still has poison or fire ticks left, or is wet, is destroyed, those effects spread to the breakable tiles in a configurable square around it - so you don't waste pre-applied effects.
Adds an Effect Spread tab to the in-game settings menu.
| Option | Default | Description |
|---|---|---|
| Spread Radius | 3 |
How many tiles away the effect can spread |
| Inherit Ticks | true |
If enabled, spread tiles get the same remaining tick count as the destroyed tile |
| Fresh Ticks | 10 |
Tick count assigned to spread tiles when Inherit Ticks is disabled |
Game Limits Mod (der_floh-game_limits_mod)
Download from Nexus Mods.
Adds a Game Limits tab to the in-game settings menu, letting you tune performance-related caps without editing files. It also fixes resuming with Esc sometimes leaving the game paused with no menu.
| Option | Default | Description |
|---|---|---|
| Max Active Mortars | 1000 |
Maximum number of mortar shells active at once (50 to 10000) |
| Max Employee Entities Drawn | 500 |
The game's own employee draw limit from the Gameplay tab, raised to up to 10000 |
| Chunk Load Radius | 3 |
How many chunks around you and every other chunk loader are loaded (1 to 100) |
| Chunks Generated Per Frame | 1 |
How many chunks are generated each frame (higher = faster load, more stutter; 1 to 10) |
| Max Chain Reaction Tiles | 500 |
How many tiles one electric pickaxe chain can reach (10 to 5000) |
| Max Visual Arcs | 200 |
How many tiles of a chain get an electricity arc; doesn't affect damage (0 to 1000) |
Note: The Performance Mod (see below) uses these settings for its faster chunk loading and electric chains, so install both together for the full effect and update them together.
Performance Mod (der_floh-performance_mod)
Download from Nexus Mods.
Replaces the vanilla chunk loading and tile effect processing with optimised implementations. Reduces frame time spikes when moving through the world or when many tile effects are active.
- Replaces
load_chunkswith a more efficient version - Replaces
apply_tile_effectswith a more efficient version - Also replaces
generate_chunk(about 6x faster, with identical terrain),lvl_from_global_pos_TIGHTFUNNELandgenerate_chests - Speeds up electric pickaxe chains
- Uses the Game Limits Mod settings (chunk load radius, chunks per frame, electric chain limits) while that mod is installed and enabled, and the vanilla values otherwise
- Loads before the No Holes, Passive Drop and Tick Upgrade mods, so their changes apply on top of its own
No additional configuration options - configure chunk behaviour via the Game Limits Mod.
No Holes Mod (der_floh-no_holes_mod)
Download from Nexus Mods.
Fills air pockets that vanilla world generation leaves behind. Runs a post-processing pass after each chunk is generated and fills any remaining empty underground tiles with the correct background material for their depth.
No configuration options. To disable, uninstall the mod.
Note: The game doesn't save mines; it builds a new one every time, so the mod applies from the next mine you enter.
Tick Upgrade Mod (der_floh-tick_upgrade_mod)
Download from Nexus Mods.
Adds two level-up passives, Poison Tick Speed and Fire Tick Speed, each adding +10 % to its tick rate per level. They are offered while you have a poison gun or poison staff (poison) or a flamethrower (fire), are saved with your run, show up in the passive bonuses panel (Tab), and can be prioritised in AutoPassiveChooser.
Also keeps poison and fire ticking on distant tiles outside the loaded area, instead of pausing them when you walk away.
Adds a Tick Upgrades tab to the in-game settings menu.
| Option | Default | Description |
|---|---|---|
| Always Tick Distant Tiles | true |
Poison and fire keep ticking on out-of-range (unloaded) chunks |
| Preserve Effect Duration | true |
Scales the stored tick count with the tick speed, so effects tick faster but last just as long |
Custom Seed Mod (ingenitus-custom_seed_mod)
Set a world seed to get the same mine again. Every chunk is generated from the seed, the day and the chunk's own position, so terrain, ore layers and chests come out identical however you explore. The rest of gameplay (loot rolls, employees, ...) stays random.
Adds a World Seed tab to the in-game settings menu.
| Option | Default | Description |
|---|---|---|
| World Seed | 0 |
0 = random (vanilla); any other number gives a reproducible mine |
| Same mine every day | false |
When enabled, every day uses the same mine instead of a new seeded one |
Note: Takes effect from the next mining day.
Axe Glare Toggle Mod (ingenitus-axe_glare_toggle_mod)
Hides the glare particles the axe and battleaxe whirl emits at full spin, which can cover the tiles you are mining. Spin, movement and damage are unchanged.
Adds an Axe Glare tab to the in-game settings menu.
| Option | Default | Description |
|---|---|---|
| Show glare | false |
Turn the glare back on without removing the mod |
Bug Fixes Mod (ingenitus-bug_fixes_mod)
Fixes vanilla bugs. Each fix can be switched off on its own in the Bug Fixes tab of the in-game settings menu.
| Fix | What goes wrong in vanilla |
|---|---|
| Coal quota overflow | From day 62 the coal quota goes negative (integer overflow) |
| Save restore | A missing or corrupt save loads defaults although an intact backup exists, then the backup is overwritten too |
| Stuck pause | Resuming with Esc can leave the game paused with no menu |
| Negative cash | Buying the maximum affordable employees can leave cash below zero |
| Loot duplication | Loot merged or collected in the same frame can be counted twice |
| Loot cap during bursts | Nukes and earthquakes spawn thousands of pickups because the loot cap never engages within a frame |
| Explosion edges | Explosions never reach the bottom row and right column of their circle |
| x0 employee boxes | Float leftovers after promotions show "x0" boxes with a sell button |
| Upgrade-card multiplier | A chest's upgrade card takes the multiplier of whichever chest was rolled last |
| AOE miner gap | AOE miners never hit the tiles directly beside their target (4 of 8 tiles at range 1) |
Chest QoL Mod (ingenitus-chest_qol_mod)
Less fiddly chests. Adds a Chests tab to the in-game settings menu.
| Option | Default | Description |
|---|---|---|
| Open on touch | true |
Touching a chest opens it without pressing interact |
| Loot on touch | true |
With One-Click Looting owned, touching a chest loots it straight to your inventory |
| Protective-ring reach | true |
Once one of a chest's eight protective tiles is mined, standing on any of them takes the chest |
| No outclassed scrolls | true |
Power-up scrolls for weapons no stronger than one you own become passive-upgrade cards |
Number Format Mod (ingenitus-number_format_mod)
Large numbers (cash, coal, prices) show as short scientific notation like 1.23e10 instead of Godot's 1.23457e+10. Numbers shown with thousands separators are unchanged.
No configuration options besides enabled in the config file.
Employee Balance Mod (ingenitus-employee_balance_mod)
In vanilla every bomber and elementalist tier swings at the intern's mining speed (0.5), while miners and barbarians speed up with tier. This mod gives them the same kind of ladder. Their bombs and elemental globs are unchanged.
| Employee | Vanilla | Modded |
|---|---|---|
| Weak / Medium / Strong / Fast Bomber | 0.5 |
0.6 / 0.7 / 0.8 / 0.9 |
| Artillery | 0.5 |
1.0 |
| Weak / Medium / Strong Elementalist | 0.5 |
0.6 / 0.8 / 1.0 |
No configuration options besides enabled in the config file.
Extra Passives Mod (ingenitus-extra_passives_mod)
Ten new level-up passives for weapons and tools that had few or none. A passive is only offered while you own an item it applies to (or a vacuum), and a passive with a cap is no longer offered once it reaches it.
| Passive | Offered with | Effect |
|---|---|---|
| Gun Fire Rate | pistol, shotgun, rifle, minigun | Shorter gun cooldown (never below 0.05 s) |
| Extra Projectiles | guns | Extra bullets per shot |
| Bullet Pierce | guns | Bullets pass through extra breakable blocks |
| Axe Spin-Up Speed | axe, battleaxe | Reaches full spin faster |
| Vacuum Range | a vacuum | Longer hose |
| Vacuum Suction | a vacuum | Wider grab area |
| Drill Speed | drill | Drills dig faster |
| Earthquake Damage | earthquake inducer | More damage |
| Earthquake Radius | earthquake inducer | Bigger radius |
| Bomb Radius | bombs, nuke | Bigger blasts, with a dial-back slider in the passive bonuses panel |
All bomb and earthquake blasts are limited to 48 tiles (the loaded area around the player). Assassins can also be offered Wet Damage. Works with AutoPassiveChooser and the Tick Upgrade Mod.
Move Speed Slider Mod (ingenitus-move_speed_slider_mod)
Adds a Walk Speed slider to the passive bonuses panel (Tab). Walking can be raised up to your current sprint speed and never past it: the sprint passive, the sprint slider and the speed quest reward all count. Handy with auto-sprint, or to move at sprint pace without holding the key.
The value is stored in the mod config (walk_speed_bonus, set by the slider), not in your save, so removing the mod leaves saves untouched. Besides that, only enabled in the config file.
These mods are not part of this repository but are listed here regardless.
garethwhite-prog's mods come from garethwhite-prog/coal-llc-mods; the ready-to-use zips are in its mods/ folder.
| Mod | Author | Description |
|---|---|---|
| AutoPassiveChooser | NanobotZ | Automatically selects passives on level-up based on a configurable priority list, so you never have to click through the passive selection screen manually. |
| Bouncing Grenade Arsenal | garethwhite-prog | 15 tiers of grenades that bounce off walls and explode on a timed fuse |
| Buyable Vacuums | garethwhite-prog | Vacuum quest upgrades can also be bought in the Bonus shop; adds vacuum levels 5 to 8 (up to 600 tiles) |
| Career Leaderboard | garethwhite-prog | All-time records and quest rewards for collectors, mortars, combat and wealth, shown in the settings menu |
| Cosmic Collectors | garethwhite-prog | 4 higher-tier Collector drones with more flight speed and capacity; needs Mod Settings System |
| Dual Multipliers | garethwhite-prog | Second scaling multipliers for drill speed, axe speed and gun fire rate, for stronger late-game scaling |
| Elemental Transmutation | garethwhite-prog | Breaking a burning tile pays 35 cash, a poisoned (corroded) one 15 |
| Excavation Frenzy | garethwhite-prog | Mining combo that speeds up movement and swings and triggers shockwaves; needs Pickaxe AOE Mod |
| Executive Employees | garethwhite-prog | 4 executive Miner tiers above Senior VP, up to Titan Miner; needs Mod Settings System |
| High-Yield Drills | garethwhite-prog | Drill tiers 5 to 10, up to 50 billion damage |
| Hydrogen Bomb | garethwhite-prog | 15 tiers of Hydrogen Bombs (Shoddy to Onyx) with huge blast radii for clearing caverns |
| InfiniPlatform | garethwhite-prog | Platform that extends left and right across gaps until it hits a wall (up to 200 blocks) |
| Martial Legends | garethwhite-prog | Martial Artist gloves and kicks themed after Mike Tyson, Jean-Claude Van Damme and Chuck Norris |
| Mod Settings System | garethwhite-prog | Adds a "Gareth Mods" settings tab with toggles and sliders for these mods |
| More Inventory Slots | garethwhite-prog | Inventory slot upgrades 4 to 10 (+20 up to +250 slots) |
| More Inventory Stacks | garethwhite-prog | Stack size upgrades 7 to 16 for very large item counts |
| More Layer Shifts | garethwhite-prog | Shift Rock Layers upgrades 6 to 12, bringing deeper ores within reach |
| More Nukes | garethwhite-prog | 15 tiers of Tactical Nukes (Shoddy to Onyx) |
| More Vacuum Quests | garethwhite-prog | Continues the vacuum questline past Diamond with Uranium, Moonstone, Onyx and Abyssal upgrades |
| Mortar Gun Arsenal | garethwhite-prog | Mortar Gun tiers 6 to 10, up to 500 billion damage |
| Neutron Bomb | garethwhite-prog | 15 tiers of Neutron Bombs (Shoddy to Onyx) with small, extremely strong blasts that break bedrock |
| Plasma Raygun | garethwhite-prog | Right-click plasma beam that cuts through several layers of rock |
| Prospector's Beacon | garethwhite-prog | Every 4.5 seconds a pulse deals a little damage to a random tile just below you |
| Seismic Hazards | garethwhite-prog | Digging out a tile with open space on both sides can make the ceiling above it cave in |
| Tank Arsenal | garethwhite-prog | 45 Incendiary, Caustic and Depleted Uranium tanks for the Tanker, with chest drops |
| Vacuum Collector Depot | garethwhite-prog | Collectors unload at the vacuum nozzle instead of the surface when it is closer |
| Weapon Stacker | garethwhite-prog | Miniguns and water guns get stronger the more of them you stack |
.vscode/build/build.ps1 packs every mod in src/<author>/<mod>/ into out/<author>/<namespace>-<name>-<version>.zip, ready to drop into the game's mods/ folder, and writes the Nexus Mods descriptions to out/nexus/ (see below). .vscode/build/validate.ps1 then checks that every zip is in the folder of its mod's author, matches its source folder and has the layout and manifest Godot Mod Loader expects.
./.vscode/build/build.ps1
./.vscode/build/validate.ps1Both work with PowerShell 7 (pwsh) on Windows, Linux and macOS, and with the Windows PowerShell 5.1 that ships with Windows. Pass -OutputDirectory <folder> to build somewhere else (the author folders and nexus/ go inside it, and older zips of the same mod there are replaced) and -ZipDirectory <folder> to validate that folder. Validation fails for a zip outside its author's folder, such as one an older build left directly in out/; delete it. If Windows PowerShell refuses to run scripts, start it with powershell -ExecutionPolicy Bypass -File .vscode\build\build.ps1.
In VS Code, Ctrl+Shift+B runs the build, and Tasks: Run Test Task builds and then validates.
GitHub runs both scripts on every push to main and every pull request. When a release is published, publish.yml runs them again and attaches every zip to the release, attested. Every mod also goes to its Nexus Mods page when .github/nexus-mods.json gives it a file id, unless Nexus Mods already has that version; prereleases only get the GitHub release.
Every mod folder has a README.md, which is packed into the zip like the mod's other files. Images for a mod's page go in its media/ folder, which the build leaves out of the zip. .vscode/build/nexus-descriptions.ps1 converts the README of every mod in .github/nexus-mods.json into the BBCode Nexus Mods descriptions use, as out/nexus/<namespace>-<name>.txt: headings become sizes, tables become lists, and relative links point to the file on GitHub. Paste a description into the mod page's description editor in BBCode mode. The build runs it after packing; to regenerate only the descriptions, run it on its own, in VS Code with the Nexus descriptions task.
./.vscode/build/nexus-descriptions.ps1














