Smelter Tools

Project documentation for the Minecraft mod — unofficial, written and maintained by the author

This page is not a Wikipedia article. It is the mod’s own documentation. A Wikipedia article would need coverage in independent reliable sources, which does not exist for this project yet.

Overview

Mod nameSmelter Tools
Added itemSmelter’s Pickaxe (smeltertools:smelter_pickaxe)
GameMinecraft Java Edition 1.21.1
LoadersNeoForge 21.1.266 (released), Forge 52.1.21 and Fabric 0.16.14 (built)
Mod version1.0.0
Language levelJava 21
SideBoth: the item, recipe and tooltip live on the client, vein mining and smelting run on the server
LicenseMIT
Authorchern

Smelter Tools adds one item, the Smelter’s Pickaxe. It targets two repetitive parts of survival mining: waiting for a furnace to turn ore into ingots, and breaking the blocks of one ore vein individually. The pickaxe smelts its own drops and collapses a connected vein in a single break.

The mod registers no blocks, entities, screens, network packets or mixins. It changes only the behaviour of one item it adds.

Smelting mined drops

When the pickaxe breaks a block, each dropped item is looked up in the game’s own smelting and blasting recipes. If a recipe matches, the drop is replaced by its result:

Because the lookup uses datapack recipes, no per-mod configuration is needed. Durability is consumed exactly as it would be for a normal break by this pickaxe; the smelting itself costs nothing.

Silk Touch priority

If the pickaxe has Silk Touch, smelting is skipped and the block itself drops, as in vanilla. This keeps Silk Touch builds predictable.

Turning smelting off

Shift + Right-click while holding the pickaxe toggles smelting. With smelting off, the pickaxe drops blocks normally. The state is stored as a data component on the item, shown in the tooltip (“Smelting: on” / “Smelting: off”) and confirmed in the action bar. Vein mining is not affected by the toggle.

Vein mining

Breaking one ore block also breaks the blocks connected to it face-to-face, up to 64 blocks per break. The search follows blocks of the same ore type and treats an ore and its deepslate variant as the same vein, so iron_ore and deepslate_iron_ore collapse together.

Behaviour details:

Built-in enchantments

The crafting recipe produces the pickaxe with Efficiency II and Unbreaking II already applied. In addition, the mod re-applies them when the item is crafted and keeps them present while the pickaxe is held, so a copy taken from the creative inventory or given by command behaves the same as a crafted one.

These are defaults, not locks: the player can still add or change enchantments at an enchanting table or anvil.

Crafting

GridContents
Row 1raw iron, raw iron, raw iron
Row 2coal, stick, coal
Row 3—, stick, —

Result: smeltertools:smelter_pickaxe with minecraft:enchantments { minecraft:efficiency: 2, minecraft:unbreaking: 2 }. The recipe unlocks when the player picks up raw iron.

The item uses a handheld model with an iron-tier texture; it looks like an iron pickaxe with slightly heated tips.

Availability and build status

TargetStatus
NeoForge, Minecraft 1.21.1Built and released — version 1.0.0
Forge, Minecraft 1.21.1 (52.1.21)Built — boots on a dedicated Forge server with its recipe and advancement loaded; awaiting release
Fabric, Minecraft 1.21.1 (loader 0.16.14)Built — boots on a dedicated Fabric server with its recipe and advancement loaded; requires Fabric API; awaiting release
Other Minecraft versionsPlanned, not released; no dates announced

Why other versions are not shipping yet

The mod is written against APIs that changed after 1.21.1. On Minecraft 1.21.2 and later, tier and recipe classes moved and recipe result signatures changed, so the same source does not compile unchanged; each version needs real code work, not a rebuild. Newer Minecraft releases also require a newer Java runtime than the one used for this project.

Installation: place one jar in the mods folder of a matching Minecraft 1.21.1 instance — smeltertools-1.0.0-neoforge-1.21.1.jar, smeltertools-1.0.0-forge-1.21.1.jar or smeltertools-1.0.0-fabric-1.21.1.jar. There is no configuration file and no command. The NeoForge and Forge jars need nothing besides their loader; the Fabric jar additionally requires Fabric API. The checks so far cover a dedicated-server start with the mod installed; the in-game behaviour of the two newer ports is what players confirm next.

License and sources

Smelter Tools is distributed under the MIT license. The Java sources are bundled inside the mod jar under sources/, and a separate smeltertools-1.0.0-sources.jar is published next to the release. The code can be used, modified and redistributed, including inside closed modpacks, as long as the copyright and permission notice are kept.

Source browser: index.html → Source code.