Tags:

Crafting QoL

Author:

Chromarict

Side:

Both

Created:

Jun 14th 2025 at 5:44 PM

Last modified:

Apr 22nd at 4:53 AM

Downloads:

3949

Latest release (for Vintage Story 1.22.0-rc.6 - 1.22.0, potentially outdated):
aminerscraft-1.3.0.zip  1-click install

Adds a miner class with unique craftables, including a flint pickaxe that can mine sedimentary rock and all types of cracked rock in the stone age.

Features

Miner Class

A custom class with a focus on mining. I know there are already a few miner class mods available, but I didn't like how any of them were balanced and I prefer not to use massive all-in-one mods when I only want a few features, so I decided to make my own.

The miner starts with the vanilla miner clothes equipped and the following traits:

• Experienced Miner: Being an experienced miner grants +25% stone mining speed, +25% ore drop rate, and +10% melee weapon damage
• Mining Equipment: Miners have the unique ability to craft makeshift pickaxes for mining sedimentary and cracked rock, small mining bags for carrying stones and ore, and miner's lamps as a dimmer alternative to lanterns.
• Nearsighted: All that time spent underground has affected your eyesight, reducing ranged damage by 15%
• Heavyhanded: Swinging a pickaxe all day makes you strong, but you handle fragile things less delicately. -10% loot from cracked vessels, -15% loot from foraging, and -20% wild crop harvesting.
• Heavyfooted: Miners aren't known for their grace or agility. Increases animal detection range by 15% and reduces walking speed by 5%.
• Hearty Appetite: Mining is hungry work, increasing your overall hunger rate by 10%

Stone Age Mining

Sedimentary rock types (claystone, sandstone, chert, shale, conglomerate, chalk, limestone, and halite) and all types of cracked rocks have been lowered from tool tier 2 to tool tier 1, allowing any stone tool with a stone mining speed value above 0 to break them.

Additionally, ores that normally require a copper pickaxe (tool tier 2) are lowered to tool tier 1 when occurring in sedimentary rock. These ores will still require their original tool tier when occurring in non-sedimentary rock, and ores that require tool tier 3 or higher will not be affected even if they do occur in sedimentary rock.

Makeshift Pickaxes

Adds makeshift flint pickaxes that can mine sedimentary rock and all types of cracked rock. These are crafted by first knapping a flint pickaxe head, then combining it with a stick and a rope.

Small Mining Bag

Miners know how to fashion a small mining bag for carrying their hard-earned stone and ore. An early game predecessor to the vanilla mining bag, the small mining bag has 6 slots for storing stone, ore, or gems, and is crafted from a flax twine, linen, and four stones.

Small mining bags may also be upgraded to normal 12-slot mining bags by reinforcing them with 2 metal plates so they don't become worthless when metal is more readily available.

Miner's Lamps

Miners spend a great deal of time underground, where light is a valuable commodity. They know how to create a simpler alternative to lanterns known as miner's lamps. These lamps act as a middleground between torches and lanterns in terms of brightness. These cannot be upgraded like lanterns, but offer a slightly dimmer alternative if beeswax is unavailable for candles.

Miner's lamps have a light level of 16 and are crafted by combining a metal plate with a lump of fat and flax fibers.

Bandages can be added to miner's lamps to diffuse their light, softening the color but lowering the light level by one. These are crafted by including two bandages in the miner's lamp recipe, or by combining a miner's lamp with two bandages in the crafting grid. Bandages can be recovered by placing a diffused miner's lamp into the crafting grid to remove them.

Miner's lamps can also be attached to boats and elk in the same way as vanilla lanterns.

Miner's Warpick

The miner's warpick is a hybrid weapon and pickaxe, offering the convenience of only requiring a single inventory slot for a weapon and tool at the cost of being somewhat worse in both roles. They can be crafted by casting a warpick head in a mold or smithing one from an ingot, and then combining it with a stick and a rope.

Compatibility

This mod relies on JSON patching to add the miner class and traits to the class and trait lists, which should be compatible with anything else that adds new classes. Obviously, this will likely conflict with any other mod that also adds a miner class, but I can always make a patch to defer to another mod's miner class and just add the crafting recipe trait to them upon request.

Flint pickaxes are also implemented by patching the vanilla game:pickaxehead and game:pickaxe items, so they should be compatible with anything else that touches pickaxes and should work out of the box with mods like Toolsmith.

Small mining bags and miner's lamps are entirely separate items/blocks in the "aminerscraft" namespace, so they shouldn't conflict with anything.

Compatibility patches and general info are listed in the spoiler below.

Changelog

v1.3.0

v1.2.4

• Added recipe for converting a linen sack to a small mining bag with 4 stones instead of requiring flax + linen every time for consistency with the vanilla mining bag recipe that takes 2 plates + a linen sack
• Added miner's lamps to the same trader lists as vanilla lanterns, available less often but slightly cheaper on average

v1.2.3

• Fixed the miner's warpick being considered an axe instead of a pickaxe, which resulted in it being swapped to and losing durability when breaking an axe while chopping trees

v1.2.2

• Added Toolsmith compatibility patch
• Fixed flint pickaxe head being a generic white metal pickaxe head when Toolsmith is installed
• Fixed flint pickaxe head hand transform slightly floating
• Fixed miner's warpick head hand transform being upside down and floating
• Fixed miner's warpick head molds unintentionally using the vanilla clay mold first-person hand transform as their third-person hand transform

v1.2.1

• Fixed tong transform for miner's warpick head being incorrect and causing it to float off to the side
• Fixed small mining bags being craftable by non-miners when class-exclusive recipes are enabled
• Attempted to fix flint pickaxe heads and warpick heads and molds being craftable by non-miners when class-exclusive recipes are enabled. See note below.

Note: I am aware flint pickaxe heads, warpick head molds, and warpick heads can still be crafted by non-miners when class-exclusive recipes are enabled. Unless there's some way to do it that I'm unaware of, the "requiresTrait" entry available for crafting grid recipes doesn't seem to work for knapping, clayforming, or smithing recipes. Since it doesn't cause any errors, I've added it to these recipes anyway in case a future update to the game ever adds support for class-exclusive knapping/clayforming/smithing recipes. If anyone knows of a workaround for this issue, please let me know.

v1.2.0

• Added new clay color variants of warpick tool molds added in 1.21.0
• Added remap config to convert old tool molds to new variants when updating an existing world, using the same method the vanilla game uses for upgrading to 1.21.0. See note below for details.
• Changed the miner class and traits to be defined in their own files in "aminerscraft/config/" for compatibility with the new class/trait API instead of using a JSON patch to modify "game:config/class.json/traits.json", which is no longer supported
• Removed the orientation-specific "*-north", "*-south", etc. variants of warpick tool molds for consistency with vanilla tool molds
• Fixed warpick tool mold walk sound not using the same "game:walk/stone" sound as the vanilla tool molds

Note: Due to the tool mold changes to support the new clay color-specific variants, a block remapping prompt should appear when updating the mod in an existing world. This remap uses the same conversion rules as the vanilla remap for tool molds in 1.21.0 (found in "game:/config/remaps.json"), which will remap them like so:

•  East-oriented raw molds become raw red clay molds
• North-oriented raw molds become raw blue clay molds
• West-oriented raw molds become raw fire clay molds
• South-oriented raw molds become black fired ceramic molds
• East-oriented burned molds become fired gray ceramic molds
• North-oriented burned molds become blue fired ceramic molds
• West-oriented burned molds become brown fired ceramic molds
• South-oriented burned molds become tan fired ceramic molds

Unfortunately, remapping is only 1-to-1, so the orientation-specific variants that were removed can't be remapped to the exact same variant with the new setup. For example, the remapper can't convert all the old raw mold variants into new raw blue clay molds, or all the old burned mold variants into new dark brown fired clay molds.

Known Issues

• Flint pickaxe heads and warpick heads and molds can still be crafted by non-miners when class-exclusive traits are enabled. This appears to be a vanilla limitation since the "requiresTrait" setting available in crafting grid recipes doesn't seem to work when added to knapping, clayforming, or smithing recipes.
• When Toolsmith is installed, anyone can assemble a flint pickaxe when combining a head, handle, and binding. This seems to be a limitation with Toolsmith itself since I can't find a way to prevent this behavior.