Base Metals adds metals, alloys, equipment, building blocks, and the crackhammer. Crush ores into powder, smelt the powder into ingots, or combine it into alloy blends. The metals also work with supported processing and tool-building mods.

Version 2.6.3.112021 brings the ore overlays from newer versions of Base Metals to Minecraft 1.12.2. Ores now match your resource pack's rock textures. You can update an existing world without changing where ores spawn. See the changelog for what's changed.

Install these mods on both the client and server:

• Minecraft Forge 14.23.5.2859 or newer for Minecraft 1.12.2.
• MMDLib, tested with 1.0.0-rc2.36.
• MMD OreSpawn 4.1.6.112021 or newer in the 4.x line.
• Base Metals.

Put the jars in the instance's mods folder. Minecraft 1.12.2 runs on Java 8. Back up your worlds and configuration before upgrading. MMD OreSpawn is the world-generation library, not the unrelated creature mod with a similar name.

Older Base Metals mercury blocks, carbon powder, iron nuggets and metal door items load under their current names. This also covers chunks first visited after the upgraded world has already been saved and restarted. Stack counts, damage, enchantments, names and other item data are retained.

Keep the corresponding materials enabled during the upgrade. The fix cannot restore items already lost in an earlier save; use a backup from before the loss instead.

Test a complete copy of the world first. Containers and entities supplied by other mods still need their own compatible versions and upgrade support. When moving a world from 1.10.2 or 1.11.2, copy the whole world folder, including serverconfig, to keep its saved OreSpawn rules.

The natural materials are Antimony, Bismuth, Copper, Lead, Mercury, Nickel, Platinum, Silver, Tin, and Zinc. The alloys are Brass, Bronze, Cupronickel, Electrum, Invar, Pewter, and Steel. Adamantine, Aquarium, Cold Iron, Mithril, and Starsteel provide the fantasy materials.

OreSpawn places Cold Iron and Adamantine in the Nether and Starsteel in the End. Copper, Silver, Tin, Lead, Zinc, Mercury, Nickel, and Platinum generate in ordinary dimensions. Antimony and Bismuth ore blocks are available, but they do not generate by default. Aquarium and Mithril are alloys, not ores.

Base Metals ores use your resource pack's stone, netherrack and end stone. The ore markings are a separate layer, using textures by KiriCattus. Pack makers can replace those markings in assets/basemetals/textures/blocks/ore_overlays/.

Make alloys by combining powders in a crafting grid and smelting the resulting blend. For example, Bronze uses Copper and Tin; Steel uses Iron and carbon. Vanilla Bits adds useful forms for vanilla materials, such as Iron powder, Stone crackhammers, and Obsidian tools.

Mine a crushable block with a crackhammer to get its powdered ingredients. Many metal ores yield two powders, which can be smelted into ingots. You can also drop items on the ground and use the hammer on the block beneath them. The exact output depends on the crusher recipe.

Material choice affects the damage of Base Metals bows, arrows, crossbows, and bolts. Crossbows use the mod's original draw-and-release behaviour; they do not store a charged shot. Ordinary vanilla bow-and-arrow damage is unchanged.

Some materials have additional effects:

• Adamantine armor grants Resistance, and its melee tools are stronger against creatures with more than 20 maximum health.
• A complete Aquarium suit grants Water Breathing and Resistance while in water and removes Mining Fatigue.
• A complete Cold Iron suit grants Fire Resistance.
• A complete Mithril suit removes harmful effects.
• Lead armor slows its wearer.
• Starsteel armor grants Jump Boost and, from two pieces onward, Speed. Held Starsteel equipment slowly repairs itself.

One matching plate fully repairs a damaged armor piece or shield in a crafting grid, preserving its enchantments and name. This uses MMDLib's repair_using_plates setting.

Open Mods → Base Metals → Config from the main menu, or use the Base Metals cog under Create World → OreSpawn → Mods. Both open the same configuration screen. Changes require a Minecraft restart.

• High Fantasy is the default and keeps the historical content available.
• Low Fantasy limits equipment and building recipes to suitable materials. It does not remove existing items or change ore generation.

An old configuration without contentMode still uses High Fantasy. The mode applies to the whole Minecraft instance or server, not to one world. Use the same Base Metals build and Fantasy Level on the client and server. If the settings don't match, you'll see what to change before you join.

OreSpawn is the only Base Metals ore generator. Edit ore rules in OreSpawn, not through MMDLib's old using_orespawn or fallback_orespawn switches. Existing OreSpawn world settings and explicit overrides are preserved.

See the configuration guide and world-generation guide, including the example for letting CoFH World place the ores instead.

Base Metals includes optional integrations for Tinkers' Construct, Construct's Armory, Thermal Expansion, Mekanism, Ender IO, IC2, Thaumcraft, Dense Ores, VeinMiner, and Additional Loot Tables. Ore Dictionary entries let other mods use the materials without a dedicated integration. These mods are not required for an ordinary Base Metals installation.

The Tinkers integration keeps Base Metals Adamantine separate from TAIGA's Adamant. Low Fantasy also restricts the equipment routes exposed by supported integrations.

The Brittle modifier crash at one durability belongs to MMDLib and is not fixed by this Base Metals release.

Use the Gradle wrapper. Gradle runs on Java 17; the build uses Java 25 for ForgeGradle's Mavenizer and Java 8 to compile and run Minecraft. The exact toolchain and dependency versions are recorded in gradle.properties.

./gradlew check build javadoc verifyReleaseArtifacts
./gradlew prepareEclipse

prepareEclipse creates client and server launches with processed resources and keeps optional compile-only mods and test code out of normal launches. After updating an existing Eclipse project, use Gradle → Refresh Gradle Project so Eclipse picks up the generated ore models. The build-script guide explains the supporting scripts. The release guide covers publication from the MMD Actions tab.

Release artifacts use the Maven coordinates zone.moddev.mc.basemetals:BaseMetals:2.6.3.112021. Java packages remain under com.mcmoddev.basemetals; this release does not move saved registry names.

Report bugs through the issue tracker. Include your mod versions, relevant configuration, and a log or crash report.