77 lines
2.2 KiB
Markdown
77 lines
2.2 KiB
Markdown
# Dynmap — NeoForge 1.21.1 Port
|
|
|
|
Port of [Dynmap](https://github.com/webbukkit/dynmap) to **NeoForge 21.1.219 / Minecraft 1.21.1**.
|
|
|
|
This standalone build is used for deployment on an ATM10 server. The goal is to eventually submit this as a PR back to the upstream `webbukkit/dynmap` repository.
|
|
|
|
- **Upstream:** https://github.com/webbukkit/dynmap (branch: `neoforge`)
|
|
- **Fork (for PR):** https://github.com/Cobbert/dynmap
|
|
- **Gitea (this repo):** `Sulkta-Coop/dynmap-neoforge`, branch `neoforge-1.21.1`
|
|
|
|
---
|
|
|
|
## Building
|
|
|
|
Requires Java 21 and Docker (build container: `dynmap-neoforge-build`).
|
|
|
|
```bash
|
|
# Inside build container
|
|
cd /workspace
|
|
./gradlew shadowJar --no-daemon
|
|
```
|
|
|
|
Output: `build/libs/Dynmap-neoforge-1.21.1-3.7-SNAPSHOT-Dev-all.jar`
|
|
|
|
### Memory notes
|
|
- Gradle daemon heap: capped at `-Xmx2g` (see `gradle.properties`)
|
|
- forked javac: capped at `-Xmx3g` (see `build.gradle`)
|
|
- Without these caps, JVM defaults to 25% of host RAM — causes OOM on high-RAM hosts
|
|
|
|
---
|
|
|
|
## Changes from upstream `neoforge-1.20.6`
|
|
|
|
See [CHANGES.md](./CHANGES.md) for the full changelog.
|
|
|
|
---
|
|
|
|
## Test status
|
|
|
|
| Environment | Result |
|
|
|---|---|
|
|
| Vanilla NeoForge 1.21.1 (clean server) | ✅ Passes |
|
|
| ATM10 5.5 (445 mods, NeoForge 21.1.219) | ✅ Passes |
|
|
|
|
---
|
|
|
|
## Deployment
|
|
|
|
Copy the fat jar into the server's `mods/` directory. Remove any old `Dynmap*.jar` first.
|
|
|
|
```bash
|
|
docker cp build/libs/Dynmap-neoforge-1.21.1-3.7-SNAPSHOT-Dev-all.jar <container>:/data/mods/
|
|
```
|
|
|
|
> **Note:** Always remove old jars before copying a new one. The container data volume may retain old versions.
|
|
|
|
---
|
|
|
|
## Containers (internal, Lucy/Unraid)
|
|
|
|
| Container | Purpose | Ports |
|
|
|---|---|---|
|
|
| `dynmap-neoforge-build` | Gradle build environment | — |
|
|
| `neoforge-test` | Vanilla NeoForge 1.21.1 test server | 25566 (MC), 8124 (web) |
|
|
| `atm10-55-test` | ATM10 5.5 test server, 445 mods | — |
|
|
| `a6860a8008ed` (prod) | **Production ATM10 — DO NOT TOUCH** | — |
|
|
|
|
---
|
|
|
|
## PR Plan
|
|
|
|
Once ATM10 testing is confirmed:
|
|
1. Mirror all changes to monorepo (`dynmap-upstream/neoforge-1.21.1/`)
|
|
2. Push to `Cobbert/dynmap` fork on GitHub
|
|
3. Open PR: `Cobbert/dynmap:neoforge-1.21.1` → `webbukkit/dynmap:neoforge`
|
|
|
|
PR description draft is in [DYNMAP.md](https://github.com/Cobbert/dynmap) (workspace copy).
|