SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedQuality of life & UI

Minerz - An additional miner class

by Ritzga · for Vintage Story

Adds the miner class to vintage story with new traits, behavoir and custom items.

9.7KDownloads
1.18.15Latest game version
Vintage Story ModDBSource

About Minerz - An additional miner class

From Vintage Story ModDB

Adds the miner class to vintage story with new traits, behavoir and custom items.

Description

Adds a new class to vintage story: the miner class. This class get some positive/negative benefits and class specific items.

This is my first mod so please share your feedback with me if you want something changed or if you find bugs.

Whats the Content ?

Class: Miner

Traits:

  • Loves closed rooms (positive)
    • -15% hunger rate in rooms/underground
    • -12.5% slower stability decrease
  • Real miner (mixed)
    • +20% mining speed
    • +40% ore drop rate
    • +25% hunger rate
  • Coal lung (negative)
    • -10% walk speed
    • -2 extra health points

General recipes:

  • Handle: (every knife, walnut/oak/redwood/ebony/oak-block or unbarked walnut/oak/redwood/ebony/oak)
    • wood-block: 2 outcomes
    • unbarked-wood: 4 outcomes

Class specific recipes:

  • Big ore blasting bomb
  • Wearables
    • Mining helmet (light in the dark)
  • Bags:
    • Enhanced mining helmet (light in the dark)
    • Bigger mining bag (can store more items)
  • Tools:
    • Reinforced pickaxe
      • Faster and higher durability
    • Reinforced prospecting pick
      • More durability 
      • 3 New types of prospecting
        • Ore localisation (8 blocks with with location)
        • Small area search 16 blocks
        • Bigger area search 32 blocks

Handle attributes:

  • Oak: higher durability, faster then normal pickaxe
  • Walnut: lower durability then oak handle, faster then oak handle
  • redwood: work in progress
  • pine: work in progress
  • ebony: best material on all values

Mod config

The config is created at VintagestoryData->ModConfig->Minerz.json

Config data

Spoiler!

How long a check for caves should take in seconds
CheckInCaveSpeed

How often check if the player is in a cave at the start
CheckInCaveTriesAtStart

Modifier for hunger rate in caves for the miner class
HungerRateInCaveModifier

Modifiers for temporal stability in caves for the miner class (1 / n) e.g. default is 1 / 8
TemporalStabilityInCaveModifier

Mining speed multiplier for the miner class
MinerClassMiningSpeedMul

Ore drop rate for the miner class
MinerClassOreDropRate

Hunger rate for the miner class
MinerClassHungerrate

Heal points of the miner class
MinerClassMaxhealthExtraPoints

Walking speed multiplier for the miner class
MinerClassWalkspeed

Whats planned ?

  • Mod settings for customized class modifier (priority 1 from now)
  • Own reinforced pickaxe handbook guide
  • Compatibility with several mods

Known Bugs

  • If the config values are changed the translation and texts are bugged (no text translation availabled)
  • The miner helmet is on all classes on class selection (only visibly while selecting your class and not after creation!)
  • The light source is overriden if the player has other lights sources active (like lanterns)
  • Lags at prospecting types (work in progress)
  • The enhanced mining helmet is too bright (work in progress)

Mod support

Spoiler!
  • X-Skills (from version 0.1.1): XSkillsItemPickaxe for pickaxes and XSkillsBomb for small and big bomb (big bomb gets 1.5x exp)
  • Armory (from version 0.1.6): Mining helmet is wearable and have lightning again (0.1.8) added reinforced pickaxes recipies out of medium handels
  • Combat Overhaul (from version 0.1.8): Reinforced pickaxes are using the pickaxe animation from the mod

Changelog

Spoiler!
  •  0.2.0
    • Made it compatible with VS 1.21.x
  •  0.1.9
    • Added config file for customization
    • Fixed bug from 0.1.8 where a optional recipe is loaded on operating systems like linux
    • Fixed error with XSkills prospecting tool has no modes
  •  0.1.8
    • Added Combat Overhaul mod support (pickaxe animation)
    • Added better Armory support (medium handles can be used for crafting now)
    • Added stability decrease in caves by 12.5%
    • Balanced ore chance and multiplyier based on new properties
  •  0.1.7
    • Added missing translations for EN and DE
  • 0.1.6
    • Added Armory mod support
    • Added new prospecor tool
      • Added 3 new prospecting modes
    • Fixed material textures of different wood types
  • 0.1.5
    • Updated to 1.20.x (tested on 1.20.4)
    • Removed smaller ore blast bomb
    • Updated recipe of bigger mining bag
  • 0.1.4

    Read the full description on Vintage Story ModDB →

    Highlights

    From source data

    Game versions

    Built for Vintage Story 1.18.15.

    Footprint

    Rated a light load on a server.

    Minerz - An additional miner class on Nxeon

    From our catalogue
    One-click install
    Supported on Nxeon Vintage Story servers. We download it from Vintage Story ModDB, place it, and restart the server.
    Server side
    Required on the server
    Server load
    light
    Smallest plan we suggest
    Vintage Story — 1 GB (1 GB RAM). This follows our own load rating above, not a benchmark.

    Run Minerz - An additional miner class on a Vintage Story server

    Pick a server or deploy a new one above; it is installed in one click.

    What kind of mod it is

    From the catalog
    Listed on Vintage Story ModDB as “QoL”

    Quality of life & UI

    Small conveniences, tweaks and interface improvements players notice straight away.

    Runs on your server

    From source side support

    Vintage Story ModDB lists Minerz - An additional miner class as required on the server. Check its Vintage Story ModDB page to see whether players need it too.

    Compatibility

    Game
    Vintage Story
    Runs on
    Serverrequired on the server
    Game versions
    1.18.15

    Verified at the source

    • ✓Vintage Story ModDBOfficial listing, checked 2026-09-24Open ↗
    • ✓AuthorRitzga, as published on Vintage Story ModDB
    • ✓LicenseNot published by the sourceFree

    Minerz - An additional miner class, answered

    Generated from the mod’s own source data.

    Do my players need to install Minerz - An additional miner class?

    Vintage Story ModDB lists Minerz - An additional miner class as required on the server. Check its Vintage Story ModDB page to see whether players need it too.

    Is it free?

    Yes. Minerz - An additional miner class is free to download from Vintage Story ModDB.

    How do I add it to my Nxeon server?

    Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

    NxLabs

    Run Minerz - An additional miner class on a Vintage Story server.

    Deploy in about a minute from $4.00 a month, then add Minerz - An additional miner class in one click.