12pit

English | 简体中文

12pit is a free and open-source mod for The Pit. It has its own configuration interface and also supports OneConfig. It is also compatible with Lunar Client.

12pit is recommended to be run with PolyPatcher and OptiFine for better performance.

For help and discussion regarding development, please join our Discord and visit #developer.

Requirements

The build process requires at least JDK 21. The mod requires Java 8, which is what Minecraft 1.8.9 uses, and Gradle detects and installs it.

Also required are Node.js and npm because they are needed for assemble and runClient tasks which compile the configuration interface. CI is built with Node.js 24.

Build Process

On Windows:

.\gradlew.bat assemble

On Linux or macOS:

./gradlew assemble

The jar produced is put into build/libs/.

Development

In order to test new changes, run the game with PolyPatcher and OptiFine installed and make sure your changes work with their default settings.

IntelliJ IDEA

Import the project as a Gradle project and set the Gradle JVM to JDK 21 or later. Run assemble, check, and runClient tasks using the Gradle tool window.

VS Code

Install the recommended extensions when prompted. Press Ctrl+Shift+B (Cmd+Shift+B on macOS) to run assemble, or use the Command Palette to run check and runClient as Gradle tasks.

Documentation

• Architecture
• Contributing
• Translating
• Issues
• Running and debugging

Third-Party Notices

12pit includes the following third-party components:

• SpongePowered Mixin is licensed under MIT. License text: MIXIN-MIT.txt.
• ASM is licensed under BSD 3-Clause. License text: ASM-BSD-3-CLAUSE.txt. It is bundled with Mixin.
• Vue is licensed under MIT. License text: VUE-MIT.txt.
• Vite is licensed under MIT. License text: VITE-MIT.txt. It provides module preload support for the configuration interface.
• Rolldown is licensed under MIT. License text: ROLLDOWN-MIT.txt. Third-party notices: ROLLDOWN-THIRD-PARTY-LICENSE.txt. It provides module preload support for the configuration interface.
• Lucide is licensed under ISC. License text: LUCIDE-ISC.txt.
• Feather is licensed under MIT. License text: LUCIDE-ISC.txt. Its icons are included through Lucide.

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