
Vintage Story Mod DB · Vintage Story mod
Salty & Toast's Immersive: Mining
Pet the floppa to buy me a coffee! Immersive Mining Original Concept, Code Implementation and logo art: SaltyWater Testing & Animations: GamingToast -Guys please take some time to read the Q&A section, it has exactly the answers for questions you're asking
Quick answer
Which Salty & Toast's Immersive: Mining release should I use?
Salty & Toast's Immersive: Mining 0.3.0 targets 1.22.0, 1.22.1, 1.22.2. It must be installed on the client. Installation on the dedicated server is optional. No extra mods listed for this file.
Where it goes
Is Salty & Toast's Immersive: Mining required on the client, server, or both?
It must be installed on the client. Installation on the dedicated server is optional.
This release supports both sides, but the source does not require it on the server.
What else does Salty & Toast's Immersive: Mining 0.3.0 need?
0.3.0. Change the file and its required mods may change too.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add Salty & Toast's Immersive: Mining without breaking your instance.
Built for Salty & Toast's Immersive: Mining 0.3.0. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 0.3.0. It targets 1.22.0, 1.22.1, 1.22.2; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
It must be installed on the client. Installation on the dedicated server is optional.
- 04
Pick the file you checked
Use the “Get this file” button beside 0.3.0. It opens that exact file at the source.
About this project
What does Salty & Toast's Immersive: Mining add?
Pet the floppa to buy me a coffee!
Immersive Mining
Original Concept, Code Implementation and logo art: SaltyWater
Testing & Animations: GamingToast
-Guys please take some time to read the Q&A section, it has exactly the answers for questions you're asking in the comments-![]()
I always felt like the mining process needed a little more "impact" to it.
It also bothers me a lot that animation, particles, block damage and sound aren't synced.
This mod aims to fix this!
Voxel mining system demonstration:
It replaces the continuous mining damage, particle spawning and sound triggering and on top of it all adds a cool visual effect to blocks when being mined!
with frame syncronized effects. It adds a shake effect, custom animations and sounds too!
It also adds some cool new mechanics to mining, so now mining a block requires full attention to get the best out of it!
Blocks take longer to regenerate (if you so desire, check configs).
Compatible with:
Please Read the Q&A Section
This mod is designed to be punishing by default, you will spend more time and tool durability BY DEFAULT and even more if you don't focus on the mining process.
Check the configs to disable mechanics you're not confortable with.
This mod won't work with Kemono and I don't have plans to make it compatible on my end.
Contributors:
XurxoMF - Reviewer, Feedback & Testing!
Michaloid - Reviewer, Feedback & Testing!
Monkey - Reviewer, Feedback & Server side Testing!
yksb - Feedback & Server side Testing!
Chubz - Provided the json code for compatibility with In Dappled Groves!
Configs:
You can configure everything!! CHECK THE CONFIGS!! GO WILD!!
Q&A:
You: Mining is too slow now, can you fix?
Me: My vision for the mod is to make this process slower and impactfull, But I've made everything configurable. You can, change the animation speed inside the zip, the hit detection is synced with the frame of the animation that you can also change for each tool in the mod configs, so any value you insert there (in the animation json) is automatically synced with the animation frame. (looks and sounds goofy with very high animation speeds).
You: What are the configs to be like vanilla?
Me: The mod wasn't build with that in mind, there's no way it will be 100% vanilla. You need to play with configs and see what fits you the best!
You: Mechanics are too strict for me, I don't like it, can you change?
Me: No, but you can! Check the configs! They're inside your data folder, hit windows key, type %appdata%, search for VintagestoryData folder, then inside it search for ModConfig folder, then inside it search for ImmersiveMining folder.
You: How do I insert my custom animation?
Me: Make yourself the animation and save the keyframes on top of my keyframes animation patch, making sure to update the correct frame counts or the game will crash, also make sure to not rename the animation code/name, or else the mod won't read it, and still inside the patch, remember to set the frames sound/damage to your impact frame, or third person won't work! Then in the game configs, just set the shakeframe in tool config to whatever impact frame your custom animation has.
You: Can you do this for other tools?
Me: Done!
You: Will this work multiplayer?
Me: I have no idea! (~ ̄▽ ̄)~ According to the comments apparently it does!
You: Will this have compatibility with x mod?
Me: Probably not. But the mod is designed for compatibility with Vigor.
You: Will this break mining speed and tool tier?
Me: No, the mod doesn't touch these, the damage you deal to the block is still based on both, you can set the value of the damage per hit to whatever you want, a copper pickaxe still gives less damage to a block than a iron pickaxe, and both still mines stone faster than dirt for example.
You: Can I go back to the vanilla mining sound?
Me: Yes just remove my sound patch from the zip, or replace it with your own custom sound with the same name. For shovel, sounds are inside my mod path, not the game path.
You: Can I go back to the vanilla animation?
Me: Yes, just remove my animation and tool patch.
Roadmap:
Add this behavior to other tools.
Add some cool mechanics like: (everything will be configurable)
- Blocks take longer to renegerate.
- Heavy tools like Pickaxe/Axe can only be manipulated using both hands (no item off hand)
- Distance to block being mined makes hits weaker. Taking more swings to mine it if you're far away from the block.
- Striking angle: Crosshair position matters in the block face. Striking in edges lowers the hit damage.
- Dust: Mining will produce dust particles, if not wearing a mask, this can have a negative effect on the player. Discarded. (Maybe for another mod.)
- Moving while trying to mine makes swings weaker.
- Trying to mine in the dark will make swings weaker.
- Tool damage per hit.
Add some effects like:
- Woosh sfx to tool swings. Discarded. (feels too artificial)
Known issues:
It doesn't work in third person (black magic probably) Fixed
Propick doesn't work when the mod is installed. (Game treat's propicks as pickaxes so it will work like a normal pickaxe, I wont bother changing that)
Breaks with immersive third person. Fixed
Switching pickaxes mid swing triggers hits uncontrollably Fixed
check out my other mods here:
Project description from Vintage Story Mod DB.
Pick your setup
Salty & Toast's Immersive: Mining releases for each Vintage Story version.
Choose the version and loader you play, then open the matching release.
1.22.2
1 loader build1.22.1
1 loader build1.22.0
1 loader build1.21.6
1 loader build1.21.5
1 loader build1.21.4
1 loader build1.21.3
1 loader build1.21.2
1 loader build1.21.1
1 loader build1.21.0
1 loader build1.20.12
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Salty & Toast's Immersive: Mining versions and loaders
0.3.0
ImmersiveMining_0.3.0.zip
23 Jun 2026
0.2.22
ImmersiveMining_0.2.21.zip
24 May 2026
0.2.20
ImmersiveMining_0.2.20.zip
25 Apr 2026
0.2.19
ImmersiveMining_0.2.19.zip
15 Apr 2026
0.2.18
ImmersiveMining_0.2.18.zip
18 Dec 2025
0.2.17
ImmersiveMining_0.2.17.zip
4 Oct 2025
0.2.16
ImmersiveMining_0.2.16.zip
25 Sept 2025
0.2.15
ImmersiveMining_0.2.15.zip
19 Sept 2025
0.2.14
ImmersiveMining_0.2.14.zip
18 Sept 2025
0.2.13
ImmersiveMining_0.2.13.zip
14 Sept 2025
0.2.12
ImmersiveMining_0.2.12.zip
10 Sept 2025
0.2.11
ImmersiveMining_0.2.11.zip
10 Sept 2025
Looking for an older file? The official Vintage Story Mod DB project page is in Resources.


