feat: update setup for MC 26.1.2

[xPand4B]

This pull request introduces significant improvements to the Minecraft Docker Compose infrastructure. The main changes include modernizing the environment and compose configuration, updating mod/plugin lists, and adding comprehensive project documentation. The updates streamline server management, clarify configuration, and improve maintainability.

Configuration and Environment Updates:

• Updated .env.dist:
  • Changed BASE_DIR to a relative path (/opt/docker/minecraft → ./ in compose).
  • Bumped Minecraft version and server name (SERVER_MC_VERSION, SERVER_NAME).
  • Renamed SERVER_CF_API_KEY to SERVER_CURSEFORGE_API_KEY for clarity.
  • Updated mod/plugin lists for all servers to current Modrinth/CurseForge versions and reset datapacks. [1] [2] [3] [4] [5]

Docker Compose Modernization:

• Refactored docker-compose.yaml:
  • Switched all absolute volume paths to relative (./) for improved portability.
  • Updated images to latest Java 25 tags.
  • Added custom Arcane labels and icons for service metadata.
  • Added explicit Docker networks for proxy and backups.
  • Changed server world directories to world-<name> format.
  • Updated plugin/mod environment variables to match .env.dist changes.
  • Fixed variable names and improved consistency (e.g., CF_API_KEY to SERVER_CURSEFORGE_API_KEY). [1] [2] [3] [4] [5] [6] [7] [8] [9]

Documentation:

• Added a new AGENTS.md:
  • Explains project structure, prerequisites, setup, mod/plugin management, and key configuration files.
  • Details on architecture (proxy, servers, backups, code-server), optional services, and CI integration.

CI Workflow:

• Updated GitHub Actions workflow to use a newer/faster OpenCode AI model (deepseek-v4-flash).

---

Most Important Changes:

1. Infrastructure Modernization

• All volume mounts in docker-compose.yaml now use relative paths, eliminating the need for a fixed BASE_DIR and making the setup more portable and developer-friendly. [1] [2] [3] [4]
• Updated all Minecraft-related images to Java 25 for improved compatibility and performance. [1] [2] [3]

2. Environment and Mod/Plugin Management

• Refreshed mod/plugin lists in .env.dist for all server types, ensuring up-to-date dependencies and cleaner configuration (including new Modrinth project IDs and emptying datapack lists for clarity). [1] [2] [3]
• Renamed and clarified environment variables for CurseForge API keys and mod/plugin management. [1] [2] [3] [4]

3. Documentation and Usability

• Introduced AGENTS.md with comprehensive setup, architecture, and configuration instructions, making onboarding and maintenance easier.

4. Service Metadata and Networking

• Added Arcane metadata labels and icons to Docker Compose services for better integration with external tools and dashboards.
• Explicitly defined Docker networks for proxy and backup containers, improving isolation and clarity. [1] [2] [3]

5. CI/CD Improvements

• Updated GitHub Actions workflow to use the faster deepseek-v4-flash model for OpenCode AI, improving CI performance.

[xPand4B]

/opencode summarize the changes in this PR

[xPand4B]

/opencode summarize this pr

[xPand4B]

/opencode summarize this pr

[opencode-agent]

PR Summary: feat: update setup for MC 26.1.2

13 commits, 12 files changed (+386 / −283)

Core upgrade

• Minecraft version: 1.20.1 → 26.1.2
• Java: java17 → java25 (proxy), java20-alpine → java25-alpine (servers)
• All Modrinth project version IDs updated for Fabric 26.1.2 compatibility

Infrastructure refactor

• Paths: Absolute paths (${BASE_DIR}/${SERVER_NAME}/...) → relative paths (./server/...) — portable, repo-root-based
• Networks: Added explicit Docker bridge networks (mc-proxy, mc-smp-backup, etc.) to isolate proxy↔server↔backup traffic
• Labels: Replaced com.centurylinklabs.watchtower.* with com.getarcaneapp.arcane.* labels
• volume mounts: Code-server now exposes the entire repo at /config/workspace via ./ mount

Proxy & forwarding

• Server addresses in velocity.toml changed from hardcoded IPs (172.16.4.22:1338) to Docker service names (server-smp:25565)
• RocketJoin plugin updated 2.4.1 → 2.5, URLs changed to waldinet.de / falsett.de
• simple-voice-chat added to proxy plugins (Modrinth download)

Mod list overhaul

• SMP: dynmap, fabric-seasons, trinkets, oxidizing-lightning-rods, rei, mysql-jdbc, architectury-api removed; waystones, balm, shogi, mc-data-bridge, midnightlib, repurposed-structures-fabric, terralith, forge-config-api-port added
• Expedition: Same removals/additions pattern
• Testing: Stripped to essentials: fabric-api, waystones, balm, shogi, luckperms, chunky, fabricproxy-lite, lithium, simple-voice-chat, worldedit
• Datapacks: All cleared (none listed)
• CurseForge files: All cleared
• SERVER_CF_API_KEY renamed to SERVER_CURSEFORGE_API_KEY

Vanilla Tweaks configs

• Version bumped 1.20 → 26.1, categories reorganized with title-cased names
• Removed packs: craftable name tags, xp management, tag (Hermitcraft), double shulker shells, larger phantoms, dragon drops, armor status
• Added: armor statues

Bug fixes

• MC_TESTIN_SEED → MC_TESTING_SEED (typo fix)
• MC_SMP_NAME changed from smp to waldicraft
• LEVEL changed to world-${SERVER_NAME} pattern

New & administrative

• AGENTS.md — 101-line project documentation (architecture, conventions, env quirks)
• .github/workflows/opencode.yml — whitespace normalization + explicit model pin
• docker-compose.yaml: version: "3.8" removed (obsolete), x-arcane header added
• Code-server port now configurable via SERVICE_VSCODE_PORT env var

opencode session  |  github run

[opencode-agent]

It's a label for Arcane, a self-hosted service dashboard. It tells Arcane to display the PaperMC/Velocity icon for the proxy service in its UI.

opencode session  |  github run

[xPand4B]

/opencode Was at sich geändert?

[opencode-agent]

Hier ist eine Zusammenfassung der Änderungen in diesem PR:

Kern-Upgrade

• Minecraft von 1.20.1 → 26.1.2, Java von java17 → java25
• Alle Modrinth-Project-IDs für Fabric 26.1.2 aktualisiert
• Mod-Listen für SMP, Expedition und Testing überarbeitet (einige entfernt, neue hinzugefügt)

Infrastruktur

• Absolute Pfade (${BASE_DIR}/...) → relative Pfade (./server/...) — portabler
• Explizite Docker-Netzwerke (mc-proxy, mc-smp-backup, etc.) eingeführt
• Labels auf com.getarcaneapp.arcane.* umgestellt
• Code-server mounted jetzt das gesamte Repo unter /config/workspace

Proxy

• Server-Adressen in velocity.toml auf Docker-Service-Namen umgestellt (server-smp:25565)
• simple-voice-chat als Plugin hinzugefügt
• RocketJoin aktualisiert, URLs angepasst

Fixes & Sonstiges

• MC_TESTIN_SEED → MC_TESTING_SEED (Tippfehler)
• SERVER_CF_API_KEY → SERVER_CURSEFORGE_API_KEY
• AGENTS.md mit Projektdokumentation hinzugefügt
• Vanilla Tweaks Configs für 26.1 aktualisiert

Insgesamt: 12 Dateien geändert, +387/−284 Zeilen, 14 Commits.

opencode session  |  github run