12pit

English | 简体中文

12pit is a lightweight, open-source Forge mod for The Pit on Minecraft 1.8.9, with a configuration interface and OneConfig support.

We recommend using 12pit with PolyPatcher and OptiFine for better performance and a smoother experience.

You can join our Discord here and seek help or discuss development related matters on the #developer channel.

Requirements

Use JDK 21 to run Gradle. Compiling the mod requires a Java 8 toolchain. Gradle will find or download it automatically. The Minecraft client also runs on Java 8.

Node.js and npm are required for assemble and runClient because those tasks build the configuration interface. Java tests require them as well. Node.js 24 is used in CI.

Building

On Windows, run:

.\gradlew.bat assemble

On Linux/macOS, run:

./gradlew assemble

Output jar file will be located at build/libs/.

Development

Use PolyPatcher and OptiFine during development. At a minimum, ensure compatibility with their default settings.

IntelliJ IDEA

Load the project via Gradle and specify JDK 21 as Gradle's JVM. Use Gradle window to run assemble, check or runClient.

VS Code

Install the recommended extensions if prompted. Ctrl+Shift+B runs assemble task. Use Command Palette to run check or runClient as Gradle tasks. On macOS, Cmd+Shift+B should be used for build task.

Documentation

• Architecture
• Implementation
• Contributing
• Translating
• Issues
• Running, testing, and debugging

Third-Party Notices

12pit includes the following third-party components:

• SpongePowered Mixin, MIT. License text: MIXIN-MIT.txt.
• ASM, bundled with Mixin, BSD 3-Clause. License text: ASM-BSD-3-CLAUSE.txt.
• Vue, MIT. License text: VUE-MIT.txt.
• Vite, used for module preloading in the configuration interface, MIT. License text: VITE-MIT.txt.
• Rolldown, used for module preloading in the configuration interface, MIT. License text: ROLLDOWN-MIT.txt.
• Lucide, ISC, with Feather icons under MIT. License texts: LUCIDE-ISC.txt.

12pit is licensed under GPL-3.0-or-later.