MOHAVE Compiler - Minecraft Forge Mod Building Tool

Overview

MOHAVE is a cross-platform Python library for automated compilation and testing of Minecraft Forge mods.

New in v1.4.0: Fully autonomous environment setup with automatic JDK 17 and Gradle installation - no manual setup required!

Requirements

• Python 3.8+
• Java 17+ JDK
• Internet connection for initial setup

Installation

Usage

Basic Mod Compilation

Full Environment Setup

Mod Project Validation

Required Project Structure

Your Forge mod project must have at minimum:

my_mod_project/
├── build.gradle
├── gradle.properties
└── src/main/resources/META-INF/mods.toml

build.gradle example

gradle.properties example

org.gradle.jvmargs=-Xmx3G
minecraft_version=1.20.1
forge_version=47.2.0
loader_version_range=[47,)
mod_id=mymod
mod_name=My Mod
mod_version=1.0.0
mod_authors=Your Name
mod_description=My awesome Forge mod

mods.toml example

Creating a New Mod Project

Advanced Compilation Options

Troubleshooting

Common Issues

1. Java not found: Install JDK 17+ and set JAVA_HOME
2. Gradle errors: MOHAVE creates Gradle wrapper automatically
3. Missing project files: Use validation and auto-setup features

Debug Build

API Reference

• ForgeCompiler(project_path)
  : Main compilation class
• EnvironmentSetup()
  : JDK/Gradle environment management
• ModProjectValidator()
  : Project structure validation
• ModTester()
  : Automated testing (future feature)

Changelog

• v1.4.0: Autonomous environment setup with automatic JDK 17 and Gradle installation
  • Automatic local JDK 17 download and installation
  • Automatic local Gradle download and installation
  • Cross-platform support (Windows, Linux, macOS)
  • Local tools storage in
    ~/.mohave/
    directory
  • No manual setup required - fully autonomous operation
• v1.3.0: Improved Gradle wrapper integration, enhanced error handling
• v1.2.0: Added auto-setup features and project validation
• v1.1.0: Basic compilation support for Forge 1.20.1

License

MIT License - see LICENSE file for details