Back to mods
Salty & Toast's Immersive: Mining project artwork

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

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Salty & Toast's Immersive: Mining release should I use?

Updated last month
Latest stable file 0.3.0
Game version 1.22.0, 1.22.1, 1.22.2
Loader Built-in Vintage Story mod system

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.

Client Required
Dedicated server Optional
Loader for this release Built-in Vintage Story mod system
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

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.

No extra mods listed for this file

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.

  1. 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.

  2. 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.

  3. 03

    Put it on the correct side

    It must be installed on the client. Installation on the dedicated server is optional.

  4. 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?

image

Pet the floppa to buy me a coffee!

Immersive Mining

Original Concept, Code Implementation and logo art: SaltyWater
Testing & Animations: GamingToast

image-Guys please take some time to read the Q&A section, it has exactly the answers for questions you're asking in the comments-image

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:

image  image

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:image

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.

12 available setups

Check 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

27 of 27 releases match

Looking for an older file? The official Vintage Story Mod DB project page is in Resources.