From 40503e083abfb8632f7d816a786f9d28522bddaa Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Thu, 7 May 2026 23:55:35 +0000 Subject: [PATCH 1/2] Add AGENTS.md with Cursor Cloud development instructions Co-authored-by: Dominic Seung --- AGENTS.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..63f591c --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,29 @@ +# BetterHUD - Agent Instructions + +## Cursor Cloud specific instructions + +### Project overview + +BetterHUD is a client-side Minecraft Fabric mod that adds a customizable HUD overlay. It is a single-module Gradle project (not a monorepo) with no external services, databases, or backends. + +### Prerequisites + +- **JDK 25** is required (`sourceCompatibility = JavaVersion.VERSION_25` in `build.gradle`). The update script installs `openjdk-25-jdk` via apt. +- Set `JAVA_HOME=/usr/lib/jvm/java-25-openjdk-amd64` before running Gradle commands. + +### Common commands + +| Task | Command | +|---|---| +| Build | `JAVA_HOME=/usr/lib/jvm/java-25-openjdk-amd64 ./gradlew build` | +| Check (lint + tests) | `JAVA_HOME=/usr/lib/jvm/java-25-openjdk-amd64 ./gradlew check` | +| Run Minecraft client | `JAVA_HOME=/usr/lib/jvm/java-25-openjdk-amd64 ./gradlew runClient` | +| Clean | `JAVA_HOME=/usr/lib/jvm/java-25-openjdk-amd64 ./gradlew clean` | + +### Caveats + +- There are no test sources in this project (`test NO-SOURCE`); `./gradlew check` still runs `validateAccessWidener` and compilation checks. +- `./gradlew runClient` launches a full Minecraft client with the mod loaded. On a headless VM it will produce ALSA audio errors (harmless) and requires a display server (Xvfb or similar) to render. +- The first Gradle invocation downloads Minecraft JARs, mappings, and dependencies (~30s). Subsequent builds are cached and fast (~1-2s). +- Build output JAR is at `build/libs/betterhud-.jar`. +- Gradle wrapper (`./gradlew`) auto-downloads Gradle 9.4.1; no manual Gradle install needed. From f4e668c7809670b203de03bfdb5c7eef72f2f7f8 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Thu, 7 May 2026 23:56:54 +0000 Subject: [PATCH 2/2] Fix gradlew file permissions (make executable) Co-authored-by: Dominic Seung --- gradlew | 0 1 file changed, 0 insertions(+), 0 deletions(-) mode change 100644 => 100755 gradlew diff --git a/gradlew b/gradlew old mode 100644 new mode 100755