Building from source

You need JDK 25, and Gradle downloads it when it's missing.

1. Clone the repository:

   git clone https://github.com/allay-ai/minecraft
   cd minecraft

2. Build and test:

   ./gradlew build

3. Take the jar from spigot/build/libs/allay-spigot-dev.jar. Every dependency is inside, relocated under chat.allay.libs.

Nothing in the repository holds the version. Local builds are dev, CI builds on master and pull requests are dev-<sha>, and releases pass -PreleaseVersion=X.Y.Z.

#Check it on a real server

The build runs both modules' tests. To see the jar start on Paper, run the smoke script. It downloads Paper and the Modrinth plugins into ~/.cache/paper-smoke and fails on any error about the plugin:

python3 -I .claude/scripts/paper_smoke.py --game 26.3 --plugin spigot/build/libs/allay-spigot-dev.jar \
  --modrinth placeholderapi --modrinth plan --command "papi list" \
  --expect "registered internal expansion: allay" --expect "Registered extension: Allay" \
  --ignore 'Plan\] Failed to enable geolocation'

A real question needs a backend and a player: point server.url at a backend and ask /ask once.

Next: Architecture