Files
firefrost-operations-manual/docs/deployment/dev-panel-mod-build-env.md
Claude (Chronicler #83 - The Compiler) d614c2d9c5 docs(deployment): Dev Panel mod build environment setup
Installed on Dev Panel (64.50.188.128):
- Java 8, 17, 21 JDKs (all three Forge/NeoForge targets)
- Gradle 8.8 (NeoForge/modern Forge) + 7.6.4 (legacy Forge)
- use-java helper script for version switching
- /opt/mod-builds workspace
- Documented why sandbox can't build mods (proxy blocks NeoForm)

Task #136 infrastructure prep. Future mods build here too.

Claude (Chronicler #83 - The Compiler) <claude@firefrostgaming.com>
2026-04-12 14:52:08 +00:00

52 lines
1.8 KiB
Markdown

# Dev Panel — Mod Build Environment
**Server:** Dev Panel (64.50.188.128)
**Setup Date:** April 12, 2026
**Setup By:** Chronicler #83 — The Compiler
**Purpose:** Dedicated Minecraft mod compilation server
---
## Installed Toolchain
| Tool | Version | Path |
|------|---------|------|
| Java 8 (JDK) | 1.8.0_482 | `/usr/lib/jvm/java-8-openjdk-amd64` |
| Java 17 (JDK) | 17.0.18 | `/usr/lib/jvm/java-17-openjdk-amd64` |
| Java 21 (JDK) | 21.0.10 | `/usr/lib/jvm/java-21-openjdk-amd64` |
| Gradle 8.8 | 8.8 | `/opt/gradle-8.8` (symlinked to `/usr/local/bin/gradle`) |
| Gradle 7.6.4 | 7.6.4 | `/opt/gradle-7.6.4` (for Forge 1.16.5 builds) |
## Java Version Usage
| Minecraft Version | Mod Loader | Java Version | Gradle Version |
|-------------------|------------|--------------|----------------|
| 1.21.1 | NeoForge | Java 21 | Gradle 8.8 |
| 1.20.1 | Forge | Java 17 | Gradle 8.8 |
| 1.16.5 | Forge | Java 8 | Gradle 7.6.4 |
## Java Switcher
```bash
# Switch Java version (must use source to affect current shell)
source use-java 21 # For NeoForge 1.21.1
source use-java 17 # For Forge 1.20.1
source use-java 8 # For Forge 1.16.5
```
## Build Workspace
All mod builds go in `/opt/mod-builds/`. Each mod gets its own subdirectory.
## Why Not the Sandbox?
Claude's sandbox has Java 21 but the egress proxy blocks NeoForm's internal HTTP client from reaching Mojang's launcher manifest (HTTP 407). All Minecraft mod builds must happen on real infrastructure.
## Why Dev Panel Over TX1?
Dev Panel is the dedicated development environment. TX1 is a game server node — its resources should stay reserved for player-facing services. Dev Panel has plenty of disk (30GB free) for mod builds.
---
**Fire + Frost + Foundation = Where Love Builds Legacy** 💙🔥❄️