Mods / Vertical Mining

Tags:
Tweak
Author:
Feyd
Side:
Both
Created:
Feb 21st at 9:58 PM
Last modified:
Mar 7th at 8:05 PM
Downloads:
237
Follow Unfollow 16
Latest release (for Vintage Story 1.21.6, potentially outdated):
VerticalMining.zip  1-click install

Pattern Mining (formerly Vertical Mining)

 

Mod ID: verticalmining Version: 2.0.0 Side: Client and Server Hotkeys: Ctrl+P (cycle patterns), /vm (toggle on/off)


Description

 

Pattern Mining expands on the original Vertical Mining concept by giving you five distinct mining patterns to choose from, all accessible through a simple hotkey. Whether you're shaft mining, clearing tunnels, or carving out rooms, there's a pattern to match your task. Larger patterns come with trade-offs — increased tool wear and slower mining speed — keeping things balanced and grounded in realistic gameplay.


Mining Patterns

 

Pattern Shape Extra Blocks Tool Wear Mining Speed
Vertical 1x2 Center + below 1 Normal 100%
Column 1x3 Center + above + below 2 +10% 85%
Horizontal 3x1 Center + left + right 2 +15% 85%
Cross Center + above + below + left + right 4 +20% 70%
Tunnel 3x3 Full 3x3 face 8 +25% 50%

Pattern Diagrams

 

Vertical 1x2    Column 1x3     Horizontal 3x1     Cross          Tunnel 3x3
  _ _ _            _ x _           _ _ _           _ x _           x x x
  _ x _            _ x _           x x x           x x x           x x x
  _ x _            _ x _           _ _ _           _ x _           x x x

How to Use

 

  1. Type /vm in chat to toggle Pattern Mining on.
  2. Hold a pickaxe and press Ctrl+P to cycle through the five mining patterns. The selected pattern and its stats are displayed in the chat window.
  3. Mine any block — the extra blocks in your selected pattern will break automatically, based on which face of the block you hit.
  4. Hold Sneak while mining to temporarily override the pattern and mine only a single block.
  5. Type /vm again to toggle Pattern Mining off. Mining speed returns to normal.

Crafting

 

No crafting required. The mod uses a chat command and hotkey to control.


Notes

 

  • Defaults to OFF for new players.
  • Only works with pickaxes.
  • A pickaxe must be highlighted in order to cycle through mining patterns with Ctrl+P.
  • Extra blocks must be within your tool's mining tier to be broken.
  • Horizontal patterns (Horizontal, Cross, Tunnel) are orientation-aware — left and right are based on which face of the block you're hitting, so the pattern always aligns with the wall in front of you.
  • Your pickaxe will not break from pattern mining — if it reaches 1 durability remaining, extra blocks stop breaking.
  • Mining speed reduction is applied as a player stat modifier while Pattern Mining is active. It is removed when you toggle off with /vm.

Disclaimer

 

This mod was vibe-coded by a hobbyist. While it works great in my testing, I'm not a professional developer — please back up your worlds in case something goes sideways and use at your own risk!

I will answer questions and resolve bugs as best I can. I made this mod to use myself and thought I'd share it with others.

Mod Version Mod IdentifierFor Game version Downloads Released Changelog Download 1-click mod install*
2.0.0 verticalmining 163 Mar 7th at 8:05 PM VerticalMining.zip 1-click install

Cleaned up a few small bugs to ensure stability.

1.0.0 verticalmining
1.21.4 - 1.21.5
74 Feb 22nd at 3:26 PM Empty VerticalMining.zip 1-click install

18 Comments (oldest first | newest first) (threaded | flat)

Stallord, 4 days ago

Playing in 1.21.6 and was also having issues getting the pattern cycling to work at first. Couldn't get CTRL+P or a few other "CTRL+" attempts to work, but I did finally get it bound to the "~" key and functioning that way. I also learned about the vanilla macro setting function (via CTRL+M) and got CTRL+~ set to run the toggle on/off command (/vm) which is very *chef's kiss*

Loving it so far except for the part where aiming at the top/bottom of a mined block doesn't act as expected with the 1x2 pattern. I would expect it to mine the origin block and the adjacent block thats opposite from yourself; (essentially acting as the "bottom" of the pattern) but it instead always mines the adjacent block on the North side when hitting the top face, and on the south side when hitting the bottom face. (The 1x3 and 3x1 patterns gobally translate similarly based on which face is mined)

Feyd , Mar 14th at 6:49 PM

@BugsBunny thanks for the update and glad you got it working! Cheers!

BugsBunny, Mar 13th at 6:12 PM

Feyd there was no conflict, just the bind itself wouldn't work. I rebinded it(CTRL+L) just to test and and Voila! now it works. Awesome mod man, keep it going!

Feyd , Mar 13th at 2:48 PM

BugsBunny sounds like another mod or maybe a conflict with the key bindings for Ctrl+P?

BugsBunny, Mar 9th at 3:00 PM

I might do something wrong but CTRL+P doesn't do anything, nothings shows up in chat and it's stuck in the 1x2 pattern.

Feyd , Mar 7th at 8:18 PM

Harbardthr

 

I've uploaded a new version v2.0.0 which should fix your issue.

 

When you load a world the default is OFF so you need to enable it then 'cycle' through the patterns.

  1. type /vm to enable the mod (ON will display in the chat window).
  2. select your pickaxe in the hotbar at the bottom of the game window.
  3. Press Control + P to display the selected pattern in the chat window.
  4. Continue pressing Control + P to 'cycle' through the various patterns.
  5. Once you have cycled and landed on the pattern you want your pickaxe will mine that layout in the game.

 

Also, the mod allows you to mine based on the selected pattern you've selected to any stone wall, floor or ceiling you are facing.

 

Give this version and go and let me know how it goes.

 

Thanks!

Harbardthr, Mar 7th at 5:17 PM (modified Mar 7th at 5:21 PM)

Feyd

/VM is working, and will mine a 2x1 like OG // but nothing else is loading / working for me. 

mod shows and says loaded in log & no errors populate.

if i search "cycle" in my settings it does not show a keybind.

mod version 1.0.0

thanks for the effort on a update of this manor though! this will be incredible!

(even a chat command failsafe would be cool to switch patterns!) /vm p1,p2,p3,p4)

Feyd , Mar 7th at 12:03 AM

Dragonchampion

 

There's no GUI included with this mod. You enable it by typing /vm in the chat window at the bottom left-hand corner of your game screen. You should see a message that it has been turned ON or OFF. Once you toggle it to ON, you should be able to Ctrl+P to cycle through the different mining patterns which will also display in the chat window.

If you check your client-main.log and server-main.log files, search for an error and find none, then it may be another mod interfering. If you notice errors related to 'VerticalMining' or 'PatternMining' please post them here and I'll sort this out for you.

 

Here are the default log locations:

Linux ~/.config/VintagestoryData/Logs/client-main.log

macOS ~/Library/Application Support/VintagestoryData/Logs/client-main.log

Windows %APPDATA%\VintagestoryData\Logs\client-main.log

Dragonchampion, Mar 6th at 10:58 AM

I have the same problem as Flow86; the key doesn't make the GUI open. I see the keybind in the controls but no matter what I set it to it doesn't seem to work.

Feyd , Mar 5th at 11:54 PM

Flow86

 

A few things to check:

  1. Make sure you have a pickaxe actively selected in your hotbar — Ctrl+P only responds when you're holding a pickaxe.
  2. Type /vm first to enable the system — it defaults to off.
  3. Check your Controls settings and search for "Cycle Mining Pattern" — that's the name it registers under. If it shows up there, you can rebind it to whatever key you'd like.
  4. If it doesn't show up in Controls at all, there may be another mod intercepting Ctrl+P before ours registers. Could you let me know what other mods you're running?

 

The hotkey is configurable through the game's normal Controls menu once it registers.

 

Thanks!

Flow86, Mar 5th at 6:31 AM

somehow the hotkey does not work to cycle the mining patterns. (1.21.6) I checked the controls page, no "official" hotkey is set  to ctrl+p - is the hotkey configureable?

Feyd , Mar 3rd at 3:02 AM

Mollycoddle, I haven't tested them together but Salty's Immersive Mining appears to be a content mod while this mod is a code mod. Salty's handles the visuals while mine handles the server-side. This leads me to believe that my mod shouldn't interfere with Salty's.

Mollycoddle, Mar 2nd at 1:19 AM

Do you know how this will affect Salty's Immersive Mining and it's wear-on-use parts?

Feyd , Mar 1st at 4:10 PM

Harbardthr test the update and let me know if you run into any issues.

Feyd , Feb 28th at 11:12 PM

Harbardthr

A mod like mine existed years ago and if my memory is correct, it allowed the player to cycle through mining patterns using a keyboard shortcut.

I'll see if I can add it to my mod and update you here once I've managed to test it.

Harbardthr, Feb 28th at 8:51 PM

this is great! 

can you vide code a varient that does a 3x3 centered around the center block??? (maybe with a toggle to make mining slower when using it for slight balance?)

 

Feyd , Feb 28th at 3:34 PM

Maoman it has been an evolution of trial and error, testing multiple tools, etc. and it shows. LOL

 

Maoman, Feb 28th at 3:33 AM (modified Feb 28th at 3:35 AM)

Good idea, it intrigued me, so I took a peek in the .dll and... man, you weren't kidding about being vibe coded lmao