Quick Start
Get General Mechanics running in your Minecraft instance in minutes.
Installation
Download and install via CurseForge or Modrinth.
Core Systems
Explore elements, fluids, machines, and energy systems.
Developer Guide
Add General Mechanics as a dependency for your addon mod.
What is General Mechanics?
General Mechanics is a realistic technology mod for Minecraft (NeoForge 1.21.1) that brings real-world science and engineering into the game. Rather than inventing fictional materials, it models the actual periodic table, real industrial chemistry, and genuine electrical components.Periodic Table
Mine, smelt, and process over 80 real chemical elements — from Lithium to Uranium — each with ores, ingots, dusts, plates, rods, and nuggets.
Industrial Chemistry
Work with 30+ realistic fluids including crude oil, sulfuric acid, liquid nitrogen, ethanol, and more — each with its actual chemical formula.
Electronics
Craft real electronic components: capacitors, resistors, transistors (BJT, MOSFET, JFET), transformers, and integrated circuits (555 timer, ATmega328P, etc.).
Plastics
Produce 11 polymer types (Polyethylene, PVC, PTFE, Nylon, Polycarbonate, and more) with full 16-color dyeable variants.
Machines
Build industrial machines including the Matter Fabricator, and construct multiblock structures for large-scale production.
Upgrades
Customize machines with 16+ upgrade cards — Speed, Efficiency, Overclock, Nanite Injector, Replication Node, and more.
Key features
Full periodic table as game content
Full periodic table as game content
Every naturally-occurring element is represented as an ore block that generates in the world. Mine raw ore, smelt it into ingots, and process ingots into dusts, plates, rods, piles, and nuggets. Alloys like Steel, Stainless Steel, Brass, and Bronze are also available.
Realistic fluid system
Realistic fluid system
Fluids are modeled with real chemical properties: temperature (in Kelvin), acidity/basicity flags, and chemical formula tooltips. Fuels, solvents, acids, gases, and cryogenic liquids all have proper behavior and can be stored in buckets or fluid containers.
Multiblock machine framework
Multiblock machine framework
Complex machines are built as multiblock structures — place the component blocks in the correct 3D pattern and the machine assembles automatically. The multiblock system supports rotation and validation with configurable block predicates.
Custom recipe types
Custom recipe types
Three new recipe types integrate with JEI for in-game browsing: Fabrication (advanced crafting), Crushing (ore processing), and Fluid Mixing (chemical reactions). All are defined in JSON and fully datapack-compatible.
Addon developer API
Addon developer API
General Mechanics is designed to be extended. Add it as a Maven dependency, register new elements, fluids, or machines against the core registries, and hook into the energy and multiblock APIs. See the Developer Guide for full details.
Minecraft version support
| Minecraft | NeoForge | Status |
|---|---|---|
| 1.21.1 | 21.1.x | Active |
General Mechanics targets Java 21 and NeoForge 1.21.1. It is not compatible with Fabric, Forge, or older Minecraft versions.
Get started
Install NeoForge 1.21.1
Download the NeoForge installer from neoforged.net and run it for Minecraft 1.21.1.