# Firefrost Gaming — Dev Panel Workspace

## What This Is
Dedicated development server (64.50.188.128) for Firefrost Gaming.
This repo is `firefrost-services` — all services, mods, and tools in one place.

## Projects
- `services/rules-mod/` — Minecraft /rules command mod (3 versions)
- `services/modpack-version-checker/` — ModpackChecker (Python CLI + Pterodactyl Blueprint extension)
- `services/arbiter-3.0/` — Arbiter backend (Node.js/Express)
- `services/trinity-core/` — MCP gateway for SSH access

## Java Versions (for mod builds)
- Java 8: `/usr/lib/jvm/java-8-openjdk-amd64` (Forge 1.16.5)
- Java 17: `/usr/lib/jvm/java-17-openjdk-amd64` (Forge 1.20.1)
- Java 21: `/usr/lib/jvm/java-21-openjdk-amd64` (NeoForge 1.21.1)
- Switcher: `source use-java {8|17|21}`

## Gradle (for mod builds)
- Gradle 8.8: `/opt/gradle-8.8` (NeoForge + modern Forge)
- Gradle 7.6.4: `/opt/gradle-7.6.4` (Forge 1.16.5)

## Other Tools
- Python 3.12, PHP 8.3, Node.js 24
- Blueprint beta-2026-01 (Pterodactyl extension framework)
- ModpackChecker Phase 5 backup: `/root/modpackchecker_backup/`

## Git
- Remote: git.firefrostgaming.com (firefrost-services repo, main branch)
- Commits push directly to Gitea

## NextCloud Upload (for mod jars)
```
curl -u "mkrause612:APP_TOKEN" -T file.jar \
  "https://downloads.firefrostgaming.com/remote.php/dav/files/mkrause612/Firefrost-Mods/..."
```

## Active Tasks

### Task 138 — Discord Rules Mod (CurseForge Release)
**Goal:** Fork the Firefrost-specific rules mod into a generic version and publish on CurseForge.

**What to do:**
- Create `services/rules-mod/discord-rules/` directory (fork from 1.21.1 code)
- Mod name: "Discord Rules" (not "Firefrost Rules")
- Remove Fire/Frost/Arcane color detection — replace with configurable header_color and body_color in TOML config
- Remove emoji-to-bracket conversion (or make it a config toggle)
- Generic branding in mods.toml, MIT license
- Compile all 3 versions (1.21.1, 1.20.1, 1.16.5)
- Draft CurseForge project page description and changelog

**Source code:** `services/rules-mod/1.21.1/`, `1.20.1/`, `1.16.5/`

## Accessibility
Michael has hand surgery limitations. Small code blocks (8-10 lines).
One question at a time. Complete files over patches.

## Gemini Consultations (Reference Library)
The operations manual is cloned at `/opt/mod-builds/firefrost-operations-manual/`.
Gemini architectural consultations are at `docs/consultations/` in that repo.
When working on a project, check for relevant consultations BEFORE making architectural decisions.

### Key consultations by project:

**Rules Mod / Forge Ecosystem:**
- `gemini-rules-mod-compilation-2026-04-12.md` — build strategy, port guide, reobfuscation requirement
- `gemini-forge-ecosystem-*.md` — Forge/NeoForge ecosystem reference
- `gemini-blueprint-casing-2026-04-06.md` — Blueprint naming conventions
- `gemini-blueprint-confyml-2026-04-06.md` — Blueprint conf.yml structure

**ModpackChecker:**
- `gemini-modpack-version-checker-review-2026-04-01.md` — full architecture review
- `gemini-modpack-database-schema-2026-04-01.md` — database schema design
- `gemini-modpackchecker-round3-licensing-support/` — licensing and support model
- `gemini-hybrid-detection-2026-04-06.md` — hybrid auto-detection approach

**General Architecture:**
- `gemini-the-forge-architecture-2026-04-11.md` — The Forge (Gemma 4 / RAG)
- `gemini-discord-approval-flow-2026-04-11.md` — Discord integration patterns
- `gemini-mcp-connector-2026-04-11.md` — MCP gateway design

To read a consultation: `cat /opt/mod-builds/firefrost-operations-manual/docs/consultations/FILENAME`