Building from Source

🔨 Building from Source

This guide provides step-by-step instructions on setting up your local environment and compiling Chaos Chickens from source code.

Before compiling, ensure you have the following installed on your machine:

Java Development Kit (JDK):
- JDK 17 is required to compile Spigot/Paper compatibility versions.
- JDK 21 is required for modern Minecraft 1.20.5+ / 1.21.x mod modules.
Build Tools:
- Maven 3.8+ (for compiling the Bukkit module).
- Gradle 8.5+ (managed via gradle wrappers, for Fabric and Forge modules).
Git (to clone the repository).

Clone the project locally using git:

git clone https://github.com/DemonZDevelopment/Chaos-Chickens.git
cd Chaos-Chickens

The core shared API and Spigot/Paper modules are built together using Maven:

# Build both common and bukkit modules, running all unit tests
mvn clean package

The output artifacts will be located under:

Common module: common/target/chaoschickens-common-X.Y.Z.jar
Bukkit plugin: bukkit/target/chaoschickens-bukkit-X.Y.Z.jar (This is the shaded, production-ready jar!)

Fabric and Forge are built via Gradle. First, build the common dependency, then execute gradle:

# Build the Fabric mod
./gradlew :fabric:build

# Build the Forge mod
./gradlew :forge:build

# Build both mods simultaneously
./gradlew build

The output mod artifacts will be located under:

If you are developing custom modules that depend on Chaos Chickens, you can install the common API to your local .m2 repository:

mvn clean install

For guides, API documentation, and releases, visit the Chaos Chickens GitHub Repository. Forging Digital Empires — DemonZ Development

For guides, API documentation, and releases, visit the Chaos Chickens GitHub Repository. Forging Digital Empires — DemonZ Development