Logistics is in active development. Core systems work, but expect rough edges, missing features, and the occasional bug. Report issues on GitHub, or join the Discord for help and discussion.
While in pre-release, save compatibility reaches back one major version (the second version digit), so load your world in the latest release of each major in turn before jumping ahead. See the release notes whenever you update.
Logistics is a multiloader (Fabric & NeoForge) mod inspired by BuildCraft and Logistics Pipes, bringing authentic item pipe systems to modern Minecraft. Items travel smoothly through thin pipes with visible motion, integrating with other mods' item, fluid, and energy storage on both loaders.
What's inside:
- Pipes — item transport, extraction, filtering, and full network logistics (providers, requesters, suppliers, crafting, chassis + modules)
- Fluids — a standalone fluid pipe/tank/pump system, separate from the item network
- Power — RF engines (redstone, stirling, creative) and power cables
- Automation — machines like the macerator, kiln, laser quarry, refinery, and sequential fabricator
The full, always-current catalog of blocks, items, machines, and mechanics lives in the wiki — this README stays focused on the repository itself.
Requirements: Minecraft 26.2 • Fabric (with Fabric API) or NeoForge • Java 25+
The mod bundles its libraries — Team Reborn Energy, Configory, and (when crash reporting is enabled) the Sentry SDK — inside the jar, so there's nothing extra to install beyond the loader and Fabric API.
Download from:
- Modrinth — stable releases
- CurseForge — stable releases
- GitHub Releases — includes dev/RC builds
Requirements: JDK 25 and Git. The Gradle wrapper (./gradlew) handles everything else.
git clone https://github.com/indemnity83/logistics.git
cd logistics
./gradlew build # compile both loaders + run unit tests and gametestsBuilt jars land in fabric/build/libs/ and neoforge/build/libs/.
Run in a dev environment:
./gradlew :fabric:runClient # or :neoforge:runClient
./gradlew :fabric:runServer # or :neoforge:runServerTest & format:
./gradlew test # unit tests
./gradlew :fabric:runClientGameTest # in-game tests (Fabric)
./gradlew spotlessApply # auto-format; spotlessCheck verifies in CI
./gradlew installGitHooks # one-time: pre-commit formatting hookMultiloader split — shared code plus thin loader adapters:
common/ # loader-agnostic server/common + client code (no Fabric/NeoForge imports)
fabric/ # Fabric adapter and client wiring
neoforge/ # NeoForge adapter and client wiring
Common code is organized into decoupled domains (pipe, power, automation, core) that depend only on abstractions in core.lib. See CLAUDE.md for the full architecture, multiloader rules, and bootstrap flow. To diagnose performance, see PROFILING.md.
The repo supports several Minecraft versions in parallel. New work starts on the main branch and is cherry-picked to the maintenance branches.
| Branch | Role |
|---|---|
mc/26.2 |
Main / default — active development |
mc/26.1, mc/1.21.11, mc/1.21.1 |
Maintenance / backport targets |
Details and the cross-version workflow are in CLAUDE.md.
Contributions welcome! Report issues on GitHub Issues; for code, read CLAUDE.md first.
Pull request titles use Conventional Commit format — release notes are generated from them, so prefer wording that describes the player-visible impact:
type(scope): short description
Player-facing types appear in the changelog: feat (Added), fix (Fixed), balance/change/perf (Changed), remove (Removed). Internal types are hidden: refactor, test, build, ci, chore, docs. The full type/scope tables live in CLAUDE.md.
Logistics can optionally send sanitized crash diagnostics to help fix bugs. It is off by default and opt-in per install via /logistics diagnostics enable. It never intentionally sends player names, UUIDs, IPs, server addresses, chat, or world data. See CRASH_REPORTING.md for exactly what is and isn't collected.
This project is licensed under the MIT License — see the LICENSE file for details.
Some textures are licensed under CC BY 4.0 or CC BY-NC-SA 4.0 — see CREDITS.md for attribution details.
Inspired by:
- BuildCraft — Classic pipe mechanics and visual style
- Logistics Pipes — Request/provider logistics system design
- Forestry — machines and progressive automation
- The Fabric and NeoForge communities for excellent modding tools and APIs
Textures:
- Some textures used, adapted, or inspired from Unused Textures by Malcolm Riley, licensed under CC BY 4.0
- Some textures used, adapted, or inspired from TextureRepository by Futureazoo, licensed under CC BY-NC-SA 4.0