From ff87b8a54489299fe921a09bafad758e4a5c4e51 Mon Sep 17 00:00:00 2001 From: dingo Date: Sat, 5 Sep 2026 12:52:51 -0400 Subject: [PATCH] Build playable Aeternalis foundation and GitOps deployment pipeline --- .dockerignore | 10 + .gitattributes | 6 + .gitea/workflows/build.yaml | 82 + .gitignore | 10 + AGENTS.md | 10 + Dockerfile | 24 + README.md | 113 ++ assets/README.md | 7 + assets/harbinger.blend | Bin 0 -> 789552 bytes client/AGENTS.md | 5 + client/index.html | 35 + client/public/models/boss.glb | Bin 0 -> 28280 bytes client/public/models/herb.glb | Bin 0 -> 43528 bytes client/public/models/ore.glb | Bin 0 -> 8824 bytes client/public/models/player.glb | Bin 0 -> 26728 bytes client/public/models/sentinel.glb | Bin 0 -> 28112 bytes client/public/models/tree.glb | Bin 0 -> 8056 bytes client/src/generated.ts | 79 + client/src/main.ts | 223 +++ client/src/style.css | 6 + client/src/world-view.ts | 234 +++ client/tsconfig.json | 9 + client/vite.config.ts | 10 + deploy/argocd-application.example.yaml | 22 + deploy/chart/Chart.yaml | 6 + deploy/chart/templates/network-policy.yaml | 28 + deploy/chart/templates/worlds.yaml | 83 + deploy/chart/values.schema.json | 10 + deploy/chart/values.yaml | 37 + docs/ARCHITECTURE.md | 116 ++ docs/DEPLOYMENT.md | 106 ++ docs/ROADMAP.md | 64 + docs/VERIFICATION.md | 61 + package-lock.json | 1629 ++++++++++++++++++++ package.json | 25 + planning/IMPLEMENTATION-NOTES.md | 29 + playwright.config.ts | 11 + schemas/AGENTS.md | 4 + schemas/protocol.json | 82 + server/AGENTS.md | 6 + server/cmd/load/main.go | 143 ++ server/cmd/world/main.go | 167 ++ server/content/balance.yaml | 48 + server/content/content.go | 117 ++ server/content/content_test.go | 17 + server/go.mod | 31 + server/go.sum | 86 ++ server/internal/game/terrain.go | 69 + server/internal/game/world.go | 648 ++++++++ server/internal/game/world_test.go | 305 ++++ server/internal/protocol/generated.go | 81 + server/internal/store/store.go | 245 +++ server/internal/store/store_test.go | 210 +++ server/internal/transport/auth.go | 149 ++ server/internal/transport/http.go | 408 +++++ server/internal/transport/http_test.go | 139 ++ server/internal/transport/service.go | 149 ++ tests/game.spec.ts | 88 ++ tools/bootstrap-go.ps1 | 12 + tools/bootstrap-helm.ps1 | 13 + tools/copy-to-aeternalis.ps1 | 36 + tools/create-models.py | 119 ++ tools/dev-server.mjs | 23 + tools/generate-protocol.mjs | 22 + tools/promote-gitops.mjs | 34 + tools/start-local.ps1 | 26 + 66 files changed, 6567 insertions(+) create mode 100644 .dockerignore create mode 100644 .gitattributes create mode 100644 .gitea/workflows/build.yaml create mode 100644 .gitignore create mode 100644 AGENTS.md create mode 100644 Dockerfile create mode 100644 README.md create mode 100644 assets/README.md create mode 100644 assets/harbinger.blend create mode 100644 client/AGENTS.md create mode 100644 client/index.html create mode 100644 client/public/models/boss.glb create mode 100644 client/public/models/herb.glb create mode 100644 client/public/models/ore.glb create mode 100644 client/public/models/player.glb create mode 100644 client/public/models/sentinel.glb create mode 100644 client/public/models/tree.glb create mode 100644 client/src/generated.ts create mode 100644 client/src/main.ts create mode 100644 client/src/style.css create mode 100644 client/src/world-view.ts create mode 100644 client/tsconfig.json create mode 100644 client/vite.config.ts create mode 100644 deploy/argocd-application.example.yaml create mode 100644 deploy/chart/Chart.yaml create mode 100644 deploy/chart/templates/network-policy.yaml create mode 100644 deploy/chart/templates/worlds.yaml create mode 100644 deploy/chart/values.schema.json create mode 100644 deploy/chart/values.yaml create mode 100644 docs/ARCHITECTURE.md create mode 100644 docs/DEPLOYMENT.md create mode 100644 docs/ROADMAP.md create mode 100644 docs/VERIFICATION.md create mode 100644 package-lock.json create mode 100644 package.json create mode 100644 planning/IMPLEMENTATION-NOTES.md create mode 100644 playwright.config.ts create mode 100644 schemas/AGENTS.md create mode 100644 schemas/protocol.json create mode 100644 server/AGENTS.md create mode 100644 server/cmd/load/main.go create mode 100644 server/cmd/world/main.go create mode 100644 server/content/balance.yaml create mode 100644 server/content/content.go create mode 100644 server/content/content_test.go create mode 100644 server/go.mod create mode 100644 server/go.sum create mode 100644 server/internal/game/terrain.go create mode 100644 server/internal/game/world.go create mode 100644 server/internal/game/world_test.go create mode 100644 server/internal/protocol/generated.go create mode 100644 server/internal/store/store.go create mode 100644 server/internal/store/store_test.go create mode 100644 server/internal/transport/auth.go create mode 100644 server/internal/transport/http.go create mode 100644 server/internal/transport/http_test.go create mode 100644 server/internal/transport/service.go create mode 100644 tests/game.spec.ts create mode 100644 tools/bootstrap-go.ps1 create mode 100644 tools/bootstrap-helm.ps1 create mode 100644 tools/copy-to-aeternalis.ps1 create mode 100644 tools/create-models.py create mode 100644 tools/dev-server.mjs create mode 100644 tools/generate-protocol.mjs create mode 100644 tools/promote-gitops.mjs create mode 100644 tools/start-local.ps1 diff --git a/.dockerignore b/.dockerignore new file mode 100644 index 0000000..53efbd7 --- /dev/null +++ b/.dockerignore @@ -0,0 +1,10 @@ +.git +.local +.tools +node_modules +client/dist +assets +test-results +playwright-report +*.log +*.exe diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..caba36f --- /dev/null +++ b/.gitattributes @@ -0,0 +1,6 @@ +* text=auto eol=lf +*.ps1 text eol=crlf +*.glb binary +*.blend binary +*.png binary +*.exe binary diff --git a/.gitea/workflows/build.yaml b/.gitea/workflows/build.yaml new file mode 100644 index 0000000..6d904a4 --- /dev/null +++ b/.gitea/workflows/build.yaml @@ -0,0 +1,82 @@ +name: Verify, publish, and promote +on: + push: + branches: [master, main] + pull_request: + +jobs: + verify: + runs-on: ubuntu-latest + services: + postgres: + image: postgres:17-alpine + env: + POSTGRES_USER: aeternalis + POSTGRES_PASSWORD: ci-test-only + POSTGRES_DB: aeternalis_test + options: >- + --health-cmd "pg_isready -U aeternalis -d aeternalis_test" + --health-interval 5s --health-timeout 5s --health-retries 10 + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-node@v4 + with: { node-version: "24", cache: npm } + - uses: actions/setup-go@v5 + with: { go-version-file: server/go.mod, cache-dependency-path: server/go.sum } + - run: npm ci --no-fund + - run: npm run test:contracts && npm run check && npm run build + - name: Go tests, race detector, and PostgreSQL integration + working-directory: server + env: + TEST_DATABASE_URL: postgres://aeternalis:ci-test-only@postgres:5432/aeternalis_test?sslmode=disable + run: go test -race -count=1 ./... + - name: Go static analysis + working-directory: server + run: go vet ./... + - run: npx playwright install --with-deps chromium + - run: npm run test:e2e + - uses: azure/setup-helm@v4.3.0 + - run: helm lint deploy/chart && helm template aeternalis deploy/chart > /tmp/aeternalis.yaml + + publish: + if: gitea.event_name == 'push' + needs: verify + runs-on: ubuntu-latest + outputs: + digest: ${{ steps.build.outputs.digest }} + steps: + - uses: actions/checkout@v4 + - uses: docker/setup-buildx-action@v3 + - uses: docker/login-action@v3 + with: + registry: ${{ vars.HARBOR_HOST }} + username: ${{ secrets.HARBOR_USERNAME }} + password: ${{ secrets.HARBOR_PASSWORD }} + - uses: docker/build-push-action@v6 + id: build + with: + context: . + push: true + tags: ${{ vars.HARBOR_HOST }}/${{ vars.HARBOR_PROJECT }}/aeternalis:${{ gitea.sha }} + provenance: true + sbom: true + + promote: + if: gitea.event_name == 'push' && vars.GITOPS_REPOSITORY != '' + needs: publish + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-node@v4 + with: { node-version: "24" } + - run: npm ci --no-fund + - name: Update GitOps image digest + env: + GITOPS_REPOSITORY: ${{ vars.GITOPS_REPOSITORY }} + GITOPS_BRANCH: ${{ vars.GITOPS_BRANCH }} + GITOPS_VALUES_FILE: ${{ vars.GITOPS_VALUES_FILE }} + GITOPS_USERNAME: ${{ secrets.GITOPS_USERNAME }} + GITOPS_TOKEN: ${{ secrets.GITOPS_TOKEN }} + IMAGE_REPOSITORY: ${{ vars.HARBOR_HOST }}/${{ vars.HARBOR_PROJECT }}/aeternalis + IMAGE_DIGEST: ${{ needs.publish.outputs.digest }} + run: node tools/promote-gitops.mjs diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..9ccefd4 --- /dev/null +++ b/.gitignore @@ -0,0 +1,10 @@ +node_modules/ +client/dist/ +.local/ +.tools/ +*.exe +*.log +test-results/ +playwright-report/ +.env +!*.example diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..9c64a1a --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,10 @@ +# Aeternalis + +Read `planning/VISION.md` and `docs/ARCHITECTURE.md` before changing systems. +Go owns gameplay; the browser sends intents only. One process owns one world. +Never weaken permanent-death, daily-time-limit, or survivor-transfer invariants. +Protocol bindings are generated from `schemas/protocol.json` with `npm run generate`. +Game tuning lives in `server/content/balance.yaml`. Tests must cover lifecycle changes. +Run `npm run check`, `npm run build`, and `go test ./...` in `server`. +Production must require PostgreSQL and OIDC. Development auth is loopback-only. +Do not increase the documented tested capacity without a representative load test. diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000..1650f71 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,24 @@ +FROM node:24-bookworm-slim AS client +WORKDIR /src +COPY package*.json ./ +RUN npm ci --no-fund +COPY schemas ./schemas +COPY tools/generate-protocol.mjs ./tools/generate-protocol.mjs +COPY client ./client +COPY server/internal/protocol ./server/internal/protocol +RUN npm run test:contracts && npm run check && npm run build + +FROM golang:1.27.1-bookworm AS server +WORKDIR /src +COPY server/go.mod server/go.sum ./ +RUN go mod download +COPY server ./ +RUN CGO_ENABLED=0 go build -trimpath -ldflags="-s -w" -o /world ./cmd/world + +FROM gcr.io/distroless/static-debian12:nonroot +COPY --from=server /world /world +COPY --from=client /src/client/dist /client +ENV APP_ENV=production LISTEN_ADDR=0.0.0.0:8080 CLIENT_DIR=/client +USER 65532:65532 +EXPOSE 8080 +ENTRYPOINT ["/world"] diff --git a/README.md b/README.md new file mode 100644 index 0000000..f068fc1 --- /dev/null +++ b/README.md @@ -0,0 +1,113 @@ +# Aeternalis + +A playable browser survival RPG foundation: an authoritative Go world server, +Three.js terrain and GLB models, persistent one-life characters, and weekly worlds. + +**Status: local prototype, not a production MMO or a verified 2,000-player server.** +The review, architecture, deployment instructions, and remaining work are in +`docs/ARCHITECTURE.md`, `docs/DEPLOYMENT.md`, and `docs/ROADMAP.md`. + +## Run locally + +Requirements: Node.js 24 and Go 1.26+ (tested with Go 1.27.1). +On Windows without Go, `powershell -File tools/bootstrap-go.ps1` downloads a +checksum-verified, project-local toolchain. + +```sh +npm ci +npm run build +node tools/dev-server.mjs +``` + +Open **http://127.0.0.1:18080**. Guest authentication is available only in +development, on an explicit loopback listen address. Production fails closed +without PostgreSQL and an HTTPS OIDC configuration. + +The delivered Windows build can also be started without installing Go: + +```powershell +powershell -File tools/start-local.ps1 -UseExisting +``` + +That command starts a hidden background process and prints its PID. Stop your +specific local process with `Stop-Process -Id `. Local state lives in +`.local/aeternalis.db`; restarting preserves characters, world age, and death. +Deleting this development database is an explicit reset, not part of startup. + +## Play + +- Move with WASD/arrows, click the terrain, or use touch direction controls. +- Click resources/enemies to approach and gather/attack. The toolbar also chooses + the nearest suitable target. E gathers, Space attacks, I opens inventory. +- Gather wood, ore, and herbs. Craft a spear or bandages in inventory. +- The Harbinger appears after seven days. In loopback development, Display + settings includes **Awaken Harbinger** for testing the event immediately. +- During the boss event the safe world radius shrinks toward the center. The + boundary deals damage; complete collapse kills remaining characters, including + offline and daily-capped characters. Killing the boss freezes survivor eligibility. +- Survivors sign into a different configured world with the same identity, then + choose **Continue as ...**. An atomic passage redemption preserves identity, + inventory, skills, kills, and daily play-time usage. + +PvP, damage-priority corpse looting, body-part damage, full skills/stats, +leaderboards, and an admin center are not implemented. Corpse looting currently +has no priority lock because PvP is not enabled. + +## Multiple local worlds + +Start independent worlds against the same SQLite database. Every process needs a +unique world ID and port. A completed world ID must never be recycled for a new +season. Seeds and balance are stored when a world is first created. + +```powershell +$env:WORLD_DIRECTORY = '[{"id":"world-001","url":"http://127.0.0.1:18080"},{"id":"world-002","url":"http://127.0.0.1:18081"}]' +powershell -File tools/start-local.ps1 -WorldId world-001 -Port 18080 +powershell -File tools/start-local.ps1 -WorldId world-002 -Port 18081 -Seed 829312 +``` + +Loopback cookies are shared across these two ports, so the same local guest can +redeem a passage. Production worlds use OIDC issuer + subject for stable identity +and separate secure host cookies. Never use dev identity for public servers. + +## Validate + +```sh +npm run test:contracts +npm run check +npm run build +# In server/: +go test ./... +go vet ./... +# At the repository root: +npx playwright install chromium +npm run test:e2e +helm lint deploy/chart +helm template aeternalis deploy/chart +``` + +When Go is local, use `.tools/go/bin/go.exe` from the root or +`../.tools/go/bin/go.exe` from `server/`. Go tests use a temporary SQLite database. +Set `TEST_DATABASE_URL` to an expendable PostgreSQL test database to run the same +storage suite on PostgreSQL; CI provides one. Linux CI also runs `go test -race`. +The browser suite starts and stops its own server on port 18089 with a fresh DB. +On Windows, `PLAYWRIGHT_CHANNEL=msedge` can use installed Edge without downloading +Chromium. Screenshots and traces are written to `test-results/`. + +For client hot reload, run the server with `PUBLIC_URL=http://127.0.0.1:5175`, +then run `npm run dev` and open port 5175. Origin checking intentionally rejects +requests from other origins. + +## Layout + +| Path | Responsibility | +|---|---| +| `planning/VISION.md` | Original user vision; new boss rule in `IMPLEMENTATION-NOTES.md` | +| `server/internal/game` | Terrain, authoritative simulation, lifecycle | +| `server/internal/store` | World ownership, snapshots, sessions, atomic passages | +| `server/internal/transport` | HTTP, OIDC, origin checks, WebSocket intent validation | +| `schemas/protocol.json` | Generated Go/TypeScript wire contracts | +| `server/content/balance.yaml` | Validated balance and recipe data | +| `client/` | Full-screen browser game and mobile controls | +| `tools/create-models.py` | Original temporary Blender models | +| `deploy/chart/` | Five independent world deployments, services, TLS ingress | +| `.gitea/workflows/build.yaml` | Tests, Harbor image publication, optional GitOps promotion | diff --git a/assets/README.md b/assets/README.md new file mode 100644 index 0000000..588a1c2 --- /dev/null +++ b/assets/README.md @@ -0,0 +1,7 @@ +# Temporary art + +All six GLB models are original procedural placeholder models generated with +Blender by `tools/create-models.py`. No third-party model or texture inputs. +Rebuild with Blender 4.3+: `blender --background --python tools/create-models.py`. +The final Harbinger scene is preserved in `harbinger.blend`. +These are rigid meshes; production rigs, animations, LODs, and material art remain. diff --git a/assets/harbinger.blend b/assets/harbinger.blend new file mode 100644 index 0000000000000000000000000000000000000000..22e0d0f9dbecef2c7f7255f828c3f3a6cca0c970 GIT binary patch literal 789552 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 + + + + + + Aeternalis + + + + +
+
+
A
AETERNALISThe First Reach
+
WNWNNEE
+
Connecting
+
+
THE GATHERING7d 00h
Until the Harbinger
+ + + + + +
+
Traveler100 / 100
2h left today0 kills
+ +
0, 09 chunks
+
+ +
+
THE FIRST REACH

Aeternalis

One life. A world on borrowed time.

+
JOURNEY ENDED

Your story remains.

+ + + diff --git a/client/public/models/boss.glb b/client/public/models/boss.glb new file mode 100644 index 0000000000000000000000000000000000000000..757996c4565c7ec598328ac394ae9c2e9d6de310 GIT binary patch literal 28280 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 literal 0 HcmV?d00001 diff --git a/client/public/models/herb.glb b/client/public/models/herb.glb new file mode 100644 index 0000000000000000000000000000000000000000..e599b0420ff8a23d938405b02ddebcdcec2a4b17 GIT binary patch literal 43528 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 literal 0 HcmV?d00001 diff --git a/client/public/models/ore.glb b/client/public/models/ore.glb new file mode 100644 index 0000000000000000000000000000000000000000..66c497f463d38e527389ff20e4967c08b7612e7a GIT binary patch literal 8824 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 cVK-xJJH#&h<^PMj1@ENYhWFFV!Z literal 0 HcmV?d00001 diff --git a/client/public/models/sentinel.glb b/client/public/models/sentinel.glb new file mode 100644 index 0000000000000000000000000000000000000000..e8b642671ad33fc398f41a60bb1d17f507bd1aa4 GIT binary patch literal 28112 zcmeHQdyFJUd9QnLesIS2ogbVZco}mCNyh7bO?S_Rn_2q;(fM`8XW0bDWM}v0?l$c1 z9J6zF;B?B!5q}X2f&gKX2sy+g$~(j%$jVI{h)AT^2`ES;vJiRMLP-=^gd}oEr2Kx> zT{G3))jiX9NP&3An*F}2`d;7!wT0T9C;PpP-sap1u*}`Q*4;SP?av*)^~l^K-n={S1+{wZk#2u; zwYLFcXWpuvt=BeJAfUEjCD>+d;h{6Njm|pyYDeW*y|&Ri*5!azx9d*bt$X!G-LD7r zu->fO=(Ov$Q@7o^?LB<<;R*Sf+In~Mq?DZqgqfQ?STX2#Ha6Ef18E7x&IgwKc!3|f zf!zq}*28D(N`MWSu|><>wSke}aU{PJ`nKgb%|?pf8S|g)c8-C6bEUI}2|i@ayJ^LK z-J18@*cO=KG#Y`2F4v2@+(zI#K^S0?*(o^l4X?>h!*Olj3Bjh#z@1po>(PQdd+11Z z2NwBO!wc%SSo2mR)@ub`!)k<R`yK3r^j zj-4{HF_yU8>*d{CAkt23Y&3n#^F0qsH*edq>cF*wplLOmn%(|bOQ*kXvfGdC4jX>c z3&RG&YToyyyhdP!o{!0-%nrr^Pj)uat80g;rF7|nI8ZFhX@-{LIu6%2N0(b*Ox|D@ zgzyvCZrBV0D;;&=*e)#4yk*(B$)3j=HOE4^Mir!1T_)^nwdt@<1&RzVDP1aL3MG_l zl}MfJ#@srb_j*-dE~GGJ+e*Lp=mu7+-y2MFl*Kq{hM1pgdv54?2zM;_Ji^HG{YEqJ zd>hHcGlfo)KCEPqH0rJj!zAG$?`T^DsWfFu;-`!`2+8xZ2N^EODzln1Nj1oy{d{I% z0uSX*XsXP@g-bRcl7VA29pnJGX1z1$_E$S=@pI-_@AUFo_vq@e?y=g!pntkMp7$!A zWLSYy%l*5%gU;I8>dJk+(>lc^_4;q`tjK2{Qn{1lZO;y{uN!b8 zZHUdXku_Ye8L%%QOUw$Je%+>Fi5ex);3dREV#0(djI*DEfUv_x&^*hhR`Il!JN@@m zo>n{sJ&ij_ehotl=`}zaSMj8!HRG%p)E7F5%|Q=GhH8uB#TJKt82Zg1w7GMJex!bQei!e4%d&bY(jd*!{4^M7K23@Y}LRLbC=H^Lx z{u&?54xL`^&Re!c^ZTpotAo`?5`xZP&|h6XJz(=p?cO6t58r?I$UX85cF&Rf?!N7= z+5&R${cn5cp(97``>~(0Y75TUdTn*%*y;*dka*M%1?B*o6^c> ziLTamQ+nZ;iC&|ZoeFy4+p%68u2OmfUGMb8bt|ZaXUA%BD$&(CR-xMT`X({u&8`+l z*0EYA<7Fr1<&xRzVZ}?)jPZ=4;zV~QqMcMomqu2+cPm7eqs6n631}x3(Is5V*g#6J2e<2bJzLl7A?7E!!!_ls3cmIWw41f}cIj&$#KP=bQ3# zDxx{vhwHV@3Z7M)C?&{R#q#On$GiOpR=bbNr`$?!{S^GaF}VMIr*Oq@*ba29^iFS} zTEY#y-uW4M@%Q4JusVBKyaqPn!<;&>@>JD;zV%hqOCG{;JI{m8EEBpU*Ffs8J@B?e zF6t~evTAl>H%+s%j2$sBJG+z94xi@PWvBEKH$kHP=%L&0y6wK40Jt$P!0cw8^X%lh zVS7yrr#d_w4To^u&kfc-@?7Z5o!!A!<|$<9X_l6;%Q=0=hNS#z2VrQtO_$Y^ak|ZkfYWm_&}R}daYR1o?MmC)z&~YQ^D#5g zZ&-*ayH0;hp{O9emN-ooR}BT%T%9B3$E*zcEGGn=CMlDN7#uNW|EC?1=XZ?zf3kbi z{CP+6GElZ7QjW|`7>{llfk{c+LWSH9g4FIedMSQ7Aye}cXl!M!;$3B$sipi=Hvd#t z88`pL)!zrtBIM#y7imue`T+>E%$pYjxJ@}iuIAwZHe(x{%PAf#h-U1kLh{+lVh|N zs|CksR$cNECeLCXi+(VcV%oM(xiTNqxPnb}#AGQAOEG2Jb1BA-G-OD5`@@g2@)P=v zFl^!_j?~dP$Hil^JOP^cCdL{jJ0$^VabrB*;Khn^XJN7v{cslMF{wG}wK7>JTYlf5 zdslbk!~ieoI3Z-S}5Zy4cMQy;}%Rll0fD}~L0o?7Del z)y>AsLuqFGATYb(Av4RYhUZ*nqeL@1dv4w~v+T^;k#5s7w|%RE_8dEYFR#Gvg&FOx z#o(OPb#~Txw~^Iewr&lSYE!H3`c<^&*gd@FHM{XHtD}0%q4ZN>;ZSMHus68_bk~*5 zJr{L&%b|kyJUeQRY3*fOJr}f%fIoEV#+R|@wKutx=gsa*duCGLi( zeb1?~{Q2p7_(3?WzwD7E^IY2gpvq|>AO84#uY&$Oe*@R$3ifA@*LDN1RA>3e7lq`K zpxq4Yh9C0Hin+PD#e+iJe)t}7{P;_w=bzgh2{CL55l%THO^yjCuj)79EzO=X zT-iXHB0NfTDLK@e#gz?8j-rwM_@^4lXNWdGL&(%&+)DZsje-eniYCLa=u`c z9r(Kg0xlAJ#bx+=nb;<-5toXc_`6eFfe{fs|J-xuKKaBG)L(`l)M$!u${A^LOgMQ} zzX@+^_LSku2GSJa=Mr5?4)tbnWrLEVXjDH~_!)8?2%|KNTS=dyQ81xR(Pa3QJR?n+ zoXnWAFC|COWMGOWid)JKqZ~zJkR#)jB3kebzHC#*Ttd49$bPoj&+$c$0Sc|narQ59 z3}4lj@<5w~93LvV8YCV0vyk-c&qDOZYdR!W1^=6a&Gy5u{Nw23AKTTgia+q!<0JBZ z@Jm0@u8Lps%CU&NG`1?P>58i2+8m>*ICQmOb1Ru|B^04cIq}fbd>5U3xMw-nj-h%m3?|8nN zF52IMKil-D?jOh>VJ+HR3(X#`i?JViBdihEU1;;ApY{1F-qaimcvHU8Y^G0?&GfTc zQ~JaxU!!Ntn0VW|9NkwMeTrAprTc`jI`+et<`=Ne!}iO+@>=+1*nV>U8QHd;IVsy8 zo?nn~+owO+`tGo8hrL!HAy!O-uBG5qw2Z8*d3!@2fG;p2?EOT0mzXb*_jlFMd>5;w@r9xME&}bQ?ay(M=!tXPLiB z@YcV)BUCgw{PLSW&v+ai`0J01ittm{UqPDIKYabgb47UnmtT}}{`JYP9xTGY`B_)W zS-<>E2aE94rMsk@rt`H{A^z=8;TAn??Y{CrYqbbpx@*LFC34L8w?B1GlVij&7s;E< z%ZOtx>~AIWGUD*9#-5miRDLkQ(dus|! zPR<{H_1*33f9<8#k3V`R^z$R1<0)MR8Y$=Jf5&OR2z#D<>~(DejkKqX<_|veQtRHw zk4ZY{&B>%S8Je6-1C5dsDccM*N=}MKvtitic||7wU|wZ3(guBvisTg2EVh60L)&4e zTo2mo;>&hR>*v(iFZN$@s{O9t-`D=5^@m71hIj1w+m_ZZl5ugzOJ~~O`OUlA8!z~h zUcrw(_n$4TUnKov|KUB7?!>RZtG)A~N875MK=Bv%{$We&7oT5$p+!5McyPa@SM3Cf z?z^v+^s4>2eLJN+2M&Kk@+tVN|8sApJxN z@!t)|+SkZR#SXNtK}NqBS$q!P1IXHM!Si81zT1)G1)c-Dkni{6zkPTjya9de*$eE_ zuirfSRjrU<8;ktWB4lUMbd@Rnvz8Ln&~O%Wa?x|AI1&Em=iB}dW7 zemF1r#Q8|=%?VWFgku`UDBDpC^}nhw3ym~oax!B|cS??;$-op%6t~9qB(z2vgB)2e zATi>9h%ei;WiFvz0%Ski?C1C*#{h-a<~aM8IEJrkOL?HpLXHoWTn&nP_NU>m zo;o-}{EYtY{U2>j!CM+l5l%THO^yjCuj)79j6=$yJ!Lp~6-^ONIn<@(m~ir{{u~aU zC7&VvhtD`pqPVU99n)lJQ#1)*sT@U9CMPqdbf z5MQ=w%UnXc1jv52+0XGsjsXg-&2jcGaSUJ8mhwQGg&ZF$xf&!L`LmGp>`z0+8u}yG zb!Ci{;BAej2&bHpCewtISM{54+D|#Orwk{rqA9{Dhq{y;6HZ>$pTl8G@)^>9_>AKu zirf0%F-?XxMU(KA%270Bax!B|cS@I{$-op%6t~9qB(z2vgB%%WB!-WN__9q~<`UW^ zK=!lEevU743{YrojWB97Jln2@@(rAq|iZ+2Mnnd=i^ZcpR3V4@i zZ1c`;!g)7W{Y5x=d6!pmOgMQ}zX@+?Hk9GY2GSJaqePdIL%msC*`VYo8reUIlw7VIPd0)rU<8;ktWlG zlUMbdaNZv&hq}se@+z7loN}m3$uZ&NRsA`95-BRa#&MFw&4gkr{#g&;y`R3COZM6l zAp6;7KgSn21}L;P$JxKcF?>~9$^&f{a(t-dYLIl~&qC6(KMT>jRe#|9dc=40@Sa;C zuGL$3f9Jble1~u*T)UgkRCCbjwYow30`Qq?4x0SRH3!Y+XsiCPRe#Xm6VvN3Mg98w zV|smNtNyT6fB64ef8f&>=dVON5CV6Q>KaLop-#q z{cnGHaqGYS^p|+X5x)U^@bp>QflqucoslNet(-c-|`Euk#at< z|FdtU90f5a_-GNnDTmwe-p@|Fr^EMvcF8wD99Q$l+PZ_RkAWacIN^~hX)SJbX4N8upk^ORm%0I(YUWCqQGN!OGO@>yD6Dqze zG}4sG$&4x8DLINJ15-3n+#1`H&>CqBa^$_3#L|Dsy&80L3GEUfb0*ugk@Slk0~A`D d$Jw8Sq$7V8l8*gp_`lB_FTnr+ literal 0 HcmV?d00001 diff --git a/client/public/models/tree.glb b/client/public/models/tree.glb new file mode 100644 index 0000000000000000000000000000000000000000..ba94f3ceadee3aea9aac15ed31b35ebbb02b506e GIT binary patch literal 8056 zcmcgxZEPGz8J+|uZCp2>b<^|%JDWHm(fPVN`|b30FEvTAo5YdrCRL4F&gVVn=zUms z=cJLb8WD;BRaAl^2o#}6ZK(t*8()wpI#G3l&VDrbuY0OPnUEySd98VpDS zav+tZfr)vkkjlfFG)8}mNrmFHM}ClFN({%;$%V<4wRtJ;mCsNEfmWq7S9lU!RZ6Ks zIhU$Xcc81rO__c))38)iF=F!MLX7DvV6y5pohlS(&kGFbbqcsaAuh{`K*@~PtEpi% zEKswnYLI9?Rq;yMRIXZ?>Ehf}&Kt{4d(+YYWa`z-O{GdC>)EN&aj%lf<+AC~;@r%c zf>#F3d1)$D_6Cc&V(DlqO?PWTj$_rPAI(s8-BN5b25U-n&9Y?EmQ95$Rm&!0+mf-0 zu@+NET!9y64|cG`9M;z2mQIziYH5n4oAv^!cyto8*@D+w@Vx09Z20PuQL3I~-8N*+ z&@>AoSG8*Bs%{$Cv}k_%|1SDW36A1_7(TYDp(=`vWgFWNy=Ky_uxxB9ilN#X$*2xx z*~WjB4c*4_8A`4i>jsNJNT_`&o6lCVXM-P8l}af)HCG|idFkZH*wFaU$O+236C?YX|4FQ>wPNn>YS?WJ5`{hEK>y<4qskHjdY74*U6ZaN<-<(#Zt9% zOwDC7Ug=cUJ4ZJyUChry;R}`V^Rv)vbp;zSDP5c^Kv&nmRX+6;>9}#-(rn!@4P7xc z%g{|x8;$Fl4E;mZbkar)LkH*iEHwFveu07ha3cnoQ9anTMgb-&G&1SbkwF!13TRVB^nr-T)YU!BUfUtpnfd#TBRjWEy6$4vZi~0la zS|!k|{xsF-14!~;Q4iN2m>u@MQhyc9H?Kd~4;v8GAIEL1nee(G8*r{=)fUws!zN)H z5V8g5U)R)?^B>k1m%l~1q2;uSccoqew!r1wzJ9pgqz|>yubx*NSK#W^6b+81sc4`m zIBiPYwy>fqnx!aE*oJ~N8W0u?v$qoVGS{MjqLHz@0eGZslc17E<-mU3nQ5feW`}cs-#LYY>zCg*Mza)kEG@RbPeou)49DZ4U*n$>D9UkuM+~$2JXX z7Q7zy_I_(CLJtm|fPdK{bnR+x`P-Lv`7Pw+s}H4?0!&DLyZ@#`>?FSIFGa~;+AR}I z^7Xl{r6~C=zuP5to_XU|CrW<%@&vVW`3s*)M9J%ipP})5CEe*p$uBJYEJ5N)e>m(! z$)LML;tA{sWzhX8XGbVQEk5vCi{rc1-j>R zAN;|&`9LBuG?Vc`USe{9amm;M6S8ym3dGjInU5ICF zw#OAkp2*h3f{zv+)~O|L$<>C|E~*L)$5C=9S0Xj)`+Fn+GHM&B@mtZXLauzwVGY zE}ib9cs374wnuq^W8tRo#NT}!~D|; zl5a3aY+Q#rP$yakf487p(QRlOd~ZXW(d}p}+6mt~(H&?z>PGj#_dVz?bT_&WN$@S9 z9<&8*LLY-?KiUn?z35JOw$PQ`AoZd>=m2~lK>JW1`UKhl-y6_+v=`Ff2u~N<0naY< zad`I9l^r0FPbRZ(Syju+QL?(%NfOLIF7I59k`LXTr{pV<5G*`GMy`9+ue$csrIZ@VPW%m@hteJ{~@P-VR_Q{MPyp>o;^{eTMaw+8Fec=Y#&iM%EWt-(Yjbf7Tz^ zob`b>1KzWd@%^=c-)w~X0soV*533v30dqTmr*}agxCPjM8*scExVjlQzZH4_qWsEy5hbSiVr-N>k z{P`DNraaF5GnQ;3Q|<;Bp$zsZF9Tmf8RDetLCiuq$Ttb&g|(Ey9Ody`&lTt4JvSWp z`FQyFc{|a5*M`T}g8QBEn9Vc6JCl!JVeFkVBt_}a#y~+5;=Iq{N{9|**zvbW_W#d}kqyGklk>ghY literal 0 HcmV?d00001 diff --git a/client/src/generated.ts b/client/src/generated.ts new file mode 100644 index 0000000..e6175e4 --- /dev/null +++ b/client/src/generated.ts @@ -0,0 +1,79 @@ +// Code generated from schemas/protocol.json. DO NOT EDIT. +export interface Protocol { + intent: Intent; + snapshot: Snapshot; +} + +export interface Intent { + op: string; + seq: number; + target: string; + x: number; + z: number; +} + +export interface Snapshot { + chunkKeys: string[]; + chunks: Chunk[]; + entities: Entity[]; + message: string; + self: Character; + tick: number; + type: string; + unavailableResources: string[]; + version: number; + world: WorldInfo; +} + +export interface Chunk { + biome: string; + heights: number[]; + key: string; + resolution: number; + resources: Entity[]; + size: number; + x: number; + z: number; +} + +export interface Entity { + hp: number; + id: string; + kind: string; + maxHp: number; + name: string; + position: Vec3; + state: string; +} + +export interface Vec3 { + x: number; + y: number; + z: number; +} + +export interface Character { + ack: number; + entity: Entity; + hasKeystone: boolean; + inventory: { [key: string]: number }; + kills: number; + playedSeconds: number; + remainingSeconds: number; + skills: { [key: string]: number }; +} + +export interface WorldInfo { + ageSeconds: number; + bossHp: number; + bossInSeconds: number; + bossMaxHp: number; + capacity: number; + collapseInSeconds: number; + id: string; + online: number; + phase: string; + radius: number; + safeRadius: number; + seed: number; +} diff --git a/client/src/main.ts b/client/src/main.ts new file mode 100644 index 0000000..7eb4f33 --- /dev/null +++ b/client/src/main.ts @@ -0,0 +1,223 @@ +import './style.css'; +import { createIcons, Crosshair, Settings2, X, Flame, LogOut, Hourglass, Swords, Pickaxe, HeartPulse, Gem, Backpack, ChevronUp, ChevronDown, ChevronLeft, ChevronRight, ArrowRight, RefreshCw } from 'lucide'; +import { WorldView } from './world-view'; +import type { Character, Chunk, Entity, Intent, Snapshot } from './generated'; + +type Recipe = { Inputs: Record; Outputs: Record }; +type Config = { worldId: string; development: boolean; worlds: { id: string; url: string }[]; recipes: Record; playerSpeed: number; gatherRange: number; attackRange: number }; +const $ = (id: string) => document.getElementById(id) as T; +const visible = (id: string, show: boolean) => { $(id).hidden = !show; }; +const pretty = (s: string) => s.replaceAll('_', ' ').replace(/^./, c => c.toUpperCase()); +const time = (seconds: number) => seconds >= 86400 ? `${Math.floor(seconds / 86400)}d ${Math.floor(seconds % 86400 / 3600)}h` : seconds >= 3600 ? `${Math.floor(seconds / 3600)}h ${Math.floor(seconds % 3600 / 60)}m` : `${Math.floor(seconds / 60)}m ${Math.floor(seconds % 60)}s`; +let config: Config; +let snapshot: Snapshot | undefined; +let ws: WebSocket | undefined; +let sequence = 0; +let lastNotice = ''; +let noticeTimer: ReturnType; +let inputElapsed = 0; +let walkTo: { x: number; z: number } | undefined; +let pendingAction: { op: string; target: string } | undefined; +let requestedClose = false; +const keys = new Set(); +let view: WorldView; + +async function api(path: string, body?: unknown): Promise { + const response = await fetch(path, { method: body === undefined ? 'GET' : 'POST', credentials: 'same-origin', headers: body === undefined ? {} : { 'Content-Type': 'application/json' }, body: body === undefined ? undefined : JSON.stringify(body) }); + const result = await response.json(); + if (!response.ok) throw new Error(result.error ?? `Request failed (${response.status})`); + return result as T; +} +function notice(message: string) { $('notice').textContent = message; visible('notice', true); clearTimeout(noticeTimer); noticeTimer = setTimeout(() => visible('notice', false), 3500); } +function send(op: string, target = '', x = 0, z = 0) { + if (ws?.readyState !== WebSocket.OPEN || !snapshot || snapshot.self.entity.state !== 'alive') return; + const intent: Intent = { op, target, x, z, seq: ++sequence }; + ws.send(JSON.stringify(intent)); +} +function selection(entity?: Entity) { + view.selected = entity; visible('target', !!entity); + if (entity) { $('target-name').textContent = entity.name; $('target-health').textContent = ['boss', 'sentinel', 'player'].includes(entity.kind) ? `${Math.ceil(entity.hp)} / ${Math.ceil(entity.maxHp)}` : pretty(entity.kind); } +} +function action(op: string) { + if (!snapshot) return; + const kinds = op === 'attack' ? ['boss', 'sentinel'] : ['tree', 'ore', 'herb', 'corpse']; + let target = view.selected; + if (!target || !kinds.includes(target.kind)) { + const p = snapshot.self.entity.position; + target = snapshot.entities.filter(e => kinds.includes(e.kind)).sort((a, b) => Math.hypot(a.position.x - p.x, a.position.z - p.z) - Math.hypot(b.position.x - p.x, b.position.z - p.z))[0]; + } + if (!target) { notice('No target nearby.'); return; } + selection(target); + pendingAction = { op: target.kind === 'corpse' ? 'loot' : op, target: target.id }; + walkTo = target.position; +} +function connect() { + requestedClose = false; sequence = 0; + const ending = $('ending'); ending.close(); + ws = new WebSocket(`${location.protocol === 'https:' ? 'wss:' : 'ws:'}//${location.host}/ws`); + ws.onopen = () => { $('connection-status').textContent = 'Connected'; $('connection-dot').parentElement!.classList.remove('offline'); }; + ws.onmessage = event => { + const value = JSON.parse(event.data) as Snapshot; + if (value.type !== 'snapshot' || value.version !== 1) { ws?.close(); notice('Client and server versions do not match.'); return; } + snapshot = value; view.update(value); updateHUD(value); + const state = value.self.entity.state; + if (state === 'dead') showEnding('A life, remembered.', 'This character is permanently dead. Their belongings remain in this world.', false); + else if (state === 'eligible') showEnding('A passage forward.', 'The Harbinger has fallen. Your character and belongings can continue to a new world.', true); + else if (value.self.remainingSeconds <= 0) showEnding('Rest until tomorrow.', 'Your daily play time is complete. Your keystone will return you to your previous location after 00:00 UTC.', false); + }; + ws.onclose = async () => { + $('connection-status').textContent = 'Disconnected'; $('connection-dot').parentElement!.classList.add('offline'); keys.clear(); walkTo = undefined; + if (requestedClose || $('ending').open) return; + let detail = 'The connection ended. Your character state is held by the server.'; + try { const me = await api<{ character?: Character }>('/api/me'); if (me.character?.entity.state === 'dead') { showEnding('A life, remembered.', 'This character is permanently dead.', false); return; } if (me.character?.remainingSeconds === 0) detail = 'Daily play time is complete. Return after 00:00 UTC.'; } catch { detail = 'Your session ended. Sign in again to continue.'; } + showEnding('Connection interrupted.', detail, false); visible('reconnect', true); + }; +} +function showEnding(title: string, detail: string, survivor: boolean) { + keys.clear(); walkTo = undefined; pendingAction = undefined; + $('ending-title').textContent = title; $('ending-detail').textContent = detail; + $('ending-eyebrow').textContent = survivor ? 'WORLD SURVIVED' : 'JOURNEY PAUSED'; + if (snapshot?.self.entity.state === 'dead') $('ending-eyebrow').textContent = 'JOURNEY ENDED'; + const destinations = $('destinations'); destinations.replaceChildren(); + if (survivor) for (const destination of config.worlds.filter(w => w.id !== config.worldId)) { + const link = document.createElement('a'); link.href = destination.url; link.textContent = `Travel to ${destination.id}`; link.rel = 'noopener'; destinations.append(link); + } + if (survivor && destinations.children.length === 0) { const p = document.createElement('p'); p.textContent = 'Your passage is saved. No destination world is open yet.'; destinations.append(p); } + visible('reconnect', false); + $('ending').show(); +} +function inventory(c: Character) { + const parent = $('inventory-items'); parent.replaceChildren(); + for (const [item, count] of Object.entries(c.inventory).filter(([, n]) => n > 0)) { + const div = document.createElement('div'); div.className = 'item'; + const text = document.createElement('span'); text.textContent = pretty(item); + const quantity = document.createElement('b'); quantity.textContent = String(count); + div.append(text, quantity); parent.append(div); + } + const recipes = $('recipes'); recipes.replaceChildren(); + for (const [name, recipe] of Object.entries(config.recipes)) { + const row = document.createElement('div'); row.className = 'recipe'; + const label = document.createElement('div'), title = document.createElement('strong'), cost = document.createElement('small'); + title.textContent = pretty(name); cost.textContent = Object.entries(recipe.Inputs).map(([k, n]) => `${n} ${pretty(k)}`).join(' + '); label.append(title, cost); + const button = document.createElement('button'); button.textContent = 'Craft'; button.title = `Craft ${name}`; button.disabled = Object.entries(recipe.Inputs).some(([item, count]) => (c.inventory[item] ?? 0) < count); button.onclick = () => send('craft', name); + row.append(label, button); recipes.append(row); + } + const skills = $('skills'); skills.replaceChildren(); + for (const skill of ['gathering', 'crafting', 'combat']) { const label = document.createElement('span'); label.textContent = pretty(skill); const amount = document.createElement('b'); amount.textContent = `${c.skills[skill] ?? 0} XP`; label.append(amount); skills.append(label); } +} +function minimap(s: Snapshot) { + const canvas = $('minimap'), ctx = canvas.getContext('2d')!; + const p = s.self.entity.position, radius = s.world.radius; + ctx.clearRect(0, 0, 140, 140); ctx.save(); ctx.beginPath(); ctx.arc(70, 70, 66, 0, Math.PI * 2); ctx.clip(); + ctx.fillStyle = '#263c30'; ctx.fillRect(0, 0, 140, 140); + ctx.strokeStyle = '#77916a50'; ctx.lineWidth = 1; + for (let i = 6; i < 140; i += 16) { ctx.beginPath(); ctx.moveTo(i, 0); ctx.lineTo(i, 140); ctx.stroke(); ctx.beginPath(); ctx.moveTo(0, i); ctx.lineTo(140, i); ctx.stroke(); } + ctx.strokeStyle = s.world.phase === 'cataclysm' ? '#e18a8a' : '#aebc92'; ctx.lineWidth = 2; ctx.beginPath(); ctx.arc(70, 70, 62 * s.world.safeRadius / radius, 0, Math.PI * 2); ctx.stroke(); + if (s.world.phase === 'cataclysm') { ctx.fillStyle = '#ed7963'; ctx.fillRect(67, 67, 6, 6); } + ctx.fillStyle = '#ecedbd'; ctx.beginPath(); ctx.arc(70 + p.x / radius * 62, 70 + p.z / radius * 62, 3, 0, Math.PI * 2); ctx.fill(); + ctx.fillStyle = '#d4debf'; ctx.font = '9px sans-serif'; ctx.fillText('N', 67, 15); ctx.restore(); +} +function updateHUD(s: Snapshot) { + const c = s.self, w = s.world; + visible('game-controls', true); visible('movement', c.entity.state === 'alive' && $('inventory').hidden && $('settings').hidden); + $('character-name').textContent = c.entity.name; + $('health-number').textContent = `${Math.max(0, Math.ceil(c.entity.hp))} / ${Math.ceil(c.entity.maxHp)}`; + $('health-fill').style.width = `${Math.max(0, c.entity.hp / c.entity.maxHp * 100)}%`; + $('play-time').textContent = `${time(c.remainingSeconds)} left today`; + $('kills').textContent = `${c.kills} kills`; + $('bandage-count').textContent = String(c.inventory.bandage ?? 0); + $('heal').disabled = !c.inventory.bandage || c.entity.hp >= c.entity.maxHp; + $('keystone').disabled = !c.hasKeystone; + $('world-name').textContent = `${w.id} / ${w.online} online`; + $('phase-label').textContent = w.phase === 'gathering' ? 'THE GATHERING' : w.phase === 'cataclysm' ? 'THE UNRAVELING' : w.phase === 'won' ? 'WORLD SURVIVED' : 'WORLD LOST'; + $('season-clock').textContent = time(w.phase === 'gathering' ? w.bossInSeconds : w.collapseInSeconds); + $('season-detail').textContent = w.phase === 'gathering' ? 'Until the Harbinger' : `${Math.round(w.safeRadius)}m of world remaining`; + $('season-progress').style.width = `${w.safeRadius / w.radius * 100}%`; + visible('boss-bar', w.phase === 'cataclysm'); $('boss-health').style.width = `${w.bossHp / w.bossMaxHp * 100}%`; $('boss-count').textContent = `${Math.ceil(w.bossHp)} / ${Math.ceil(w.bossMaxHp)}`; + $('coordinates').textContent = `${Math.round(c.entity.position.x)}, ${Math.round(c.entity.position.z)}`; + $('chunk-count').textContent = `${view.chunks.size} chunks`; + if (!$('inventory').hidden) inventory(c); + selection(view.selected); minimap(s); + if (s.message && s.message !== lastNotice) { notice(s.message); lastNotice = s.message; } +} +async function boot() { + createIcons({ icons: { Crosshair, Settings2, X, Flame, LogOut, Hourglass, Swords, Pickaxe, HeartPulse, Gem, Backpack, ChevronUp, ChevronDown, ChevronLeft, ChevronRight, ArrowRight, RefreshCw } }); + view = new WorldView($('world')); + view.start(dt => { + inputElapsed += dt; + if (!snapshot || ws?.readyState !== WebSocket.OPEN || $('ending').open) return; + let x = Number(keys.has('d') || keys.has('arrowright')) - Number(keys.has('a') || keys.has('arrowleft')); + let z = Number(keys.has('s') || keys.has('arrowdown')) - Number(keys.has('w') || keys.has('arrowup')); + if (x || z) { walkTo = undefined; pendingAction = undefined; } + if (walkTo) { + const p = snapshot.self.entity.position, dx = walkTo.x - p.x, dz = walkTo.z - p.z, distance = Math.hypot(dx, dz); + const target = snapshot.entities.find(e => e.id === pendingAction?.target); + const range = pendingAction ? pendingAction.op === 'attack' ? config.attackRange + (target?.kind === 'boss' ? 3 : -0.5) : config.gatherRange - 0.5 : 0.8; + if (distance <= range) { if (pendingAction) send(pendingAction.op, pendingAction.target); walkTo = undefined; pendingAction = undefined; } + else { x = dx / distance; z = dz / distance; } + } + view.moving = !!(x || z); + if (inputElapsed >= 0.05) { send('move', '', x, z); inputElapsed = 0; } + }); + const [loadedConfig, chunks] = await Promise.all([api('/api/config'), api('/api/preview'), view.load()]); + config = loadedConfig; + $('zoom').value = String(view.distance); + view.addChunks(chunks); view.updateEntities(chunks.flatMap(c => c.resources)); + $('connection-status').textContent = 'World online'; + visible('dev-boss', config.development); + let me: { character: Character | null } | undefined; + try { me = await api('/api/me'); } catch { if (config.development) { await api('/auth/dev', {}); me = await api('/api/me'); } } + if (!me && !config.development) { visible('join-form', false); visible('login', true); } + else if (me?.character) { + $('arrival').close(); + if (me.character.entity.state === 'dead') showEnding('A life, remembered.', 'This character is permanently dead. A fresh world is a new beginning.', false); + else if (me.character.entity.state === 'eligible') showEnding('A passage forward.', 'Your survivor passage is saved.', true); + else connect(); + } else { + const passages = await api<{ characterId: string; sourceWorld: string; name: string }[]>('/api/passages').catch(() => []); + for (const passage of passages.filter(p => p.sourceWorld !== config.worldId)) { + const button = document.createElement('button'); button.textContent = `Continue as ${passage.name}`; + button.onclick = async () => { try { await api('/api/join', { name: '', passage: passage.characterId }); $('arrival').close(); connect(); } catch (e) { $('arrival-error').textContent = String((e as Error).message); } }; + $('passages').append(button); + } + } + $('join-form').onsubmit = async event => { + event.preventDefault(); const button = $('join'); button.disabled = true; + try { await api('/api/join', { name: $('name').value, passage: '' }); $('arrival').close(); connect(); } + catch (e) { $('arrival-error').textContent = (e as Error).message; } + finally { button.disabled = false; } + }; + for (const id of ['inventory', 'settings']) { $(`${id}-toggle`).onclick = () => { visible(id, $(id).hidden); visible('movement', $('inventory').hidden && $('settings').hidden && !!snapshot); if (id === 'inventory' && snapshot) inventory(snapshot.self); }; } + document.querySelectorAll('[data-close]').forEach(button => button.onclick = () => visible(button.dataset.close!, false)); + $('attack').onclick = () => action('attack'); $('gather').onclick = () => action('gather'); $('heal').onclick = () => send('heal'); $('keystone').onclick = () => send('return'); + $('target-boss').onclick = () => { selection(snapshot?.entities.find(e => e.id === 'boss')); walkTo = { x: 0, z: 0 }; pendingAction = { op: 'attack', target: 'boss' }; }; + $('dev-boss').onclick = () => void api('/api/dev/boss', {}).catch(e => notice(e.message)); + $('reconnect').onclick = () => location.reload(); + $('logout').onclick = async () => { requestedClose = true; await api('/auth/logout', {}); ws?.close(); location.reload(); }; + $('quality').onchange = event => view.quality((event.target as HTMLSelectElement).value === 'high'); + $('zoom').oninput = event => { view.distance = Number((event.target as HTMLInputElement).value); view.resize(); }; + window.addEventListener('keydown', event => { + if ((event.target as HTMLElement).matches('input,select,textarea') || $('arrival').open) return; + const key = event.key.toLowerCase(); + if (['w', 'a', 's', 'd', 'arrowup', 'arrowdown', 'arrowleft', 'arrowright', ' '].includes(key)) event.preventDefault(); + keys.add(key); if (event.repeat) return; + if (key === 'e') action('gather'); if (key === ' ') action('attack'); if (key === 'i') $('inventory-toggle').click(); if (key === 'escape') { visible('inventory', false); visible('settings', false); selection(); walkTo = undefined; } + }); + window.addEventListener('keyup', event => keys.delete(event.key.toLowerCase())); + window.addEventListener('blur', () => { keys.clear(); walkTo = undefined; send('move'); }); + document.addEventListener('visibilitychange', () => { if (document.hidden) { keys.clear(); walkTo = undefined; send('move'); } }); + const movements: Record = { up: 'w', down: 's', left: 'a', right: 'd' }; + document.querySelectorAll('[data-move]').forEach(button => { + const key = movements[button.dataset.move!]; + button.onpointerdown = event => { button.setPointerCapture(event.pointerId); keys.add(key); }; + button.onpointerup = button.onpointercancel = () => keys.delete(key); + }); + view.canvas.addEventListener('pointerdown', event => { + if (!snapshot || $('ending').open || event.button !== 0) return; + const hit = view.pick(event.clientX, event.clientY); + if (hit.entity) { selection(hit.entity); action(['boss', 'sentinel'].includes(hit.entity.kind) ? 'attack' : 'gather'); } + else if (hit.point) { selection(); walkTo = hit.point; pendingAction = undefined; } + }); + Object.defineProperty(window, '__aeternalis', { value: { diagnostics: () => view.diagnostics(), get snapshot() { return snapshot; } }, configurable: true }); +} +boot().catch(error => { console.error(error); $('arrival-error').textContent = `Unable to enter the world: ${error.message}`; $('connection-status').textContent = 'Unavailable'; }); diff --git a/client/src/style.css b/client/src/style.css new file mode 100644 index 0000000..baf3868 --- /dev/null +++ b/client/src/style.css @@ -0,0 +1,6 @@ +:root{font-family:Inter,"Segoe UI",sans-serif;color:#f0f4ee;background:#9bbabc;font-synthesis:none;font-size:14px;letter-spacing:0;color-scheme:dark}*{box-sizing:border-box}body{margin:0;overflow:hidden}button,input,select{font:inherit}button,a.command{cursor:pointer;display:inline-flex;align-items:center;justify-content:center;gap:9px;min-height:42px;color:#edf3ed;background:#293b36;border:1px solid #6c82706b;border-radius:4px;padding:9px 14px;text-decoration:none}button:hover,a.command:hover{background:#41574a;border-color:#a6bd9c}button:disabled{opacity:.4;cursor:default}button:focus-visible,a:focus-visible,input:focus-visible,select:focus-visible{outline:2px solid #d1e3a4;outline-offset:3px}svg{width:20px;height:20px;flex-shrink:0}input,select{width:100%;min-height:42px;border:1px solid #77867b;background:#14201e;color:#f4f4ec;padding:8px 10px;border-radius:3px}input[type=range]{padding:0;accent-color:#b9cf8b}label{display:block;color:#c4cdc4;font-size:12px;margin-bottom:7px}h1,h2,h3,p{margin:0}h1{font-family:Georgia,serif;font-size:42px;font-weight:400;margin:12px 0 16px}h2{font-size:17px;font-weight:500}h3{font-size:12px;font-weight:500;text-transform:uppercase;color:#b4c3ae;margin:24px 0 12px}.icon{width:36px;height:36px;min-height:36px;padding:8px;background:transparent;border-color:transparent}[hidden]{display:none!important}#world{position:fixed;inset:0;width:100%;height:100%;display:block;touch-action:none}#hud{position:fixed;inset:0;pointer-events:none}#hud button,#hud input,#hud select,.panel{pointer-events:auto}.topbar{position:absolute;top:0;left:0;width:100%;display:flex;align-items:center;justify-content:space-between;padding:24px 30px;background:linear-gradient(#122521a6,transparent);text-shadow:0 2px 7px #12251c80}.brand{display:flex;align-items:center;gap:13px}.brand-mark{font:36px Georgia,serif;border:1px solid #e7edce99;padding:0 10px;color:#d9e6b5}.brand strong{display:block;font:21px Georgia,serif}.brand span:not(.brand-mark){display:block;font-size:11px;color:#cfdfc9;margin-top:6px}.compass{display:flex;align-items:center;gap:32px;font-size:11px;color:#e2eddfb3}.compass b{color:#edf5d8;font-size:15px;border-bottom:2px solid #dce7af;padding-bottom:7px}.connection{display:flex;gap:8px;align-items:center;font-size:11px}.connection>i{height:6px;width:6px;border-radius:50%;background:#a4c478}.connection.offline>i{background:#d37569}.season{position:absolute;top:115px;left:30px;width:210px;text-shadow:0 2px 5px #142119}.season>div:first-child{display:flex;align-items:center;justify-content:space-between;gap:12px}.season span{font-size:10px;color:#dce4d3}.season strong{font-size:17px;font-weight:500}.season>span{display:block;font-size:11px;margin:9px 0 12px}.thin-track{height:2px;background:#d9e5d14d}.thin-track i{display:block;width:100%;height:100%;background:#c9da99}.panel{position:absolute;background:#192722f2;border:1px solid #7b887469;border-radius:6px;box-shadow:0 10px 35px #10251d40;padding:20px;backdrop-filter:blur(12px);width:310px;max-height:calc(100dvh - 210px);overflow:auto}.panel-title{display:flex;align-items:center;justify-content:space-between;margin-bottom:18px}.inventory{right:30px;bottom:155px}.inventory-items{display:grid;grid-template-columns:1fr 1fr;gap:8px}.item{background:#e6eeca0a;border:1px solid #87927938;padding:11px 9px;display:flex;align-items:center;gap:8px;min-height:55px}.item span{font-size:11px;overflow-wrap:anywhere;flex:1}.item b{font-size:13px;font-weight:500;color:#d6e4b6}.recipe{display:flex;gap:10px;justify-content:space-between;align-items:center;border-top:1px solid #ffffff12;padding:10px 0}.recipe strong{font-size:12px;font-weight:500}.recipe small{display:block;font-size:10px;color:#9dab9c;margin-top:5px}.recipe button{padding:8px;min-height:34px}.skills{display:flex;gap:18px}.skills span{font-size:11px;color:#c1d0bd}.skills b{display:block;margin-top:5px;color:#f0f5e8}.settings{right:30px;top:95px}.settings label{margin:18px 0;display:grid;gap:8px}.settings>button{width:100%;margin-top:8px}.bottom{position:absolute;left:30px;right:30px;bottom:24px;display:flex;align-items:flex-end;justify-content:space-between;gap:20px}.vitals{width:250px;padding:18px;background:#172a23e8;border:1px solid #b2c3a24a;border-radius:4px}.vitals>div:first-child{display:flex;justify-content:space-between;gap:10px;font-size:11px}.vitals strong{font-size:13px;max-width:160px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.bar{height:6px;background:#ffffff20;margin:12px 0;overflow:hidden}.bar>i{display:block;width:100%;height:100%;background:#b3ce82;transition:width .18s}.vital-detail{display:flex;justify-content:space-between;gap:8px;color:#b8c9b2;font-size:10px}.vital-detail>span:first-child{display:flex;align-items:center;gap:5px}.vital-detail svg{width:12px;height:12px}.actions{display:flex;gap:7px;align-items:center;background:#172720df;padding:9px;border:1px solid #a8b99a50;border-radius:5px}.actions button{position:relative;width:48px;height:48px;padding:10px;background:#29382fe6}.actions button:first-child{background:#773f36}.actions>span{height:25px;width:1px;background:#a5b78b4a;margin:0 2px}.actions small{position:absolute;bottom:3px;right:5px;font-size:9px}.location{display:flex;flex-direction:column;align-items:center;gap:5px;width:150px;font-size:10px;color:#e2e8d8;text-shadow:0 1px 3px #000}.location canvas{width:122px;height:122px;border:1px solid #c9d4b99c;border-radius:50%;background:#263d30b3}.location small{color:#d0debc;font-size:9px}.target{position:absolute;left:50%;top:26%;transform:translateX(-50%);background:#13261ee3;border:1px solid #aabb9277;padding:8px 14px;border-radius:3px;font-size:12px;text-align:center}.target span+span{display:block;font-size:10px;color:#aebf99;margin-top:4px}.notice{position:absolute;left:50%;bottom:120px;transform:translateX(-50%);max-width:90%;background:#18241feb;border:1px solid #94a77755;border-radius:3px;padding:10px 18px;text-align:center;font-size:12px}.boss-bar{position:absolute;left:50%;top:100px;transform:translateX(-50%);width:350px;max-width:50%;text-align:center}.boss-bar>span{font:18px Georgia,serif;color:#ffe3d5;text-shadow:0 2px 5px #000}.boss-bar .bar{height:5px}.boss-bar .bar>i{background:#c9685b}.boss-bar small{font-size:10px}.movement{display:none}dialog{position:fixed;top:50%;left:50%;transform:translate(-50%,-50%);margin:0;width:360px;max-width:calc(100% - 36px);padding:30px;background:#172722f2;color:#eef2e6;border:1px solid #a2b2946b;border-radius:6px;box-shadow:0 20px 90px #132c1d44;backdrop-filter:blur(15px)}dialog .eyebrow{font-size:10px;color:#bed399}dialog p{font-size:13px;color:#bec9bd;line-height:1.6;margin-bottom:22px}dialog form{display:flex;flex-direction:column;gap:7px}dialog form button{margin-top:12px;background:#c1d095;color:#19261d;border-color:#d0ddb1;font-weight:600}dialog input{background:#101e18a6}dialog .error{font-size:12px;color:#edaa94;margin:14px 0 0}dialog a.command{width:100%;margin-top:10px}dialog #passages button{width:100%;margin-top:10px}#destinations a{display:flex;color:#d0e9a7;margin:12px 0;align-items:center;gap:10px}#ending h1{font-size:32px}#reconnect{width:100%} +@media(max-width:800px){.compass{display:none}.topbar{padding:18px}.brand strong{font-size:18px}.brand-mark{font-size:30px}.connection>span{max-width:95px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.season{left:18px;top:95px;width:170px}.bottom{left:18px;right:18px;bottom:18px;flex-wrap:wrap;justify-content:space-between;gap:10px}.vitals{width:210px;padding:12px}.location{width:90px}.location canvas{width:78px;height:78px}.location small{display:none}.actions{order:3;margin:0 auto;padding:6px}.actions button{width:42px;height:42px}.inventory{right:18px;bottom:165px;width:290px;max-height:calc(100dvh - 250px)}.settings{right:18px;top:85px}.boss-bar{top:165px;max-width:75%;width:290px}.movement:not([hidden]){display:grid;position:absolute;left:18px;bottom:182px;grid-template-columns:repeat(3,38px);grid-template-rows:repeat(2,38px);gap:3px}.movement button{min-height:38px;padding:7px;background:#1b3026ae;touch-action:none}.movement button:first-child{grid-column:2}.movement button:nth-child(2){grid-row:2;grid-column:1}.movement button:nth-child(3){grid-row:2;grid-column:2}.movement button:nth-child(4){grid-row:2;grid-column:3}.notice{bottom:315px;width:max-content;max-width:85%}.target{top:36%}h1{font-size:36px}} +.panel{z-index:4} +.boss-bar>button{background:transparent;border:0;padding:0;min-height:28px;font:18px Georgia,serif;color:#ffe3d5;text-shadow:0 2px 5px #000} +@media(max-width:800px){.inventory{bottom:190px;max-height:calc(100dvh - 285px)}} +@media(max-height:520px){.season{top:85px}.bottom{bottom:10px;flex-wrap:nowrap}.location{display:none}.movement:not([hidden]){display:grid;position:absolute;grid-template-columns:repeat(4,38px);gap:3px;bottom:110px;left:18px}.movement button{padding:6px}.boss-bar{top:80px}.inventory,.settings{top:70px;bottom:auto;max-height:calc(100dvh - 90px)}dialog{max-height:calc(100dvh - 24px);overflow:auto;padding:20px}.notice{bottom:90px}} diff --git a/client/src/world-view.ts b/client/src/world-view.ts new file mode 100644 index 0000000..dbfec04 --- /dev/null +++ b/client/src/world-view.ts @@ -0,0 +1,234 @@ +import * as T from 'three'; +import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js'; +import type { Chunk, Entity, Snapshot, Vec3 } from './generated'; + +type Batch = { parts: T.InstancedMesh[]; entities: Entity[] }; +export class WorldView { + readonly renderer: T.WebGLRenderer; + readonly scene = new T.Scene(); + readonly camera = new T.OrthographicCamera(-60, 60, 40, -40, 0.1, 1400); + readonly chunks = new Map(); + readonly batches = new Map(); + readonly focus = new T.Vector3(0, 0, 0); + readonly position = new T.Vector3(); + readonly aim = new T.Vector3(); + readonly ring: T.Mesh; + readonly selection: T.Mesh; + readonly storm: T.Mesh; + readonly sun: T.DirectionalLight; + readonly models = new Map(); + player?: T.Group; + snapshot?: Snapshot; + selected?: Entity; + distance = 46; + frames = 0; + moving = false; + private highQuality = true; + private initialized = false; + private clock = new T.Clock(); + private matrix = new T.Matrix4(); + private dummy = new T.Object3D(); + private ray = new T.Raycaster(); + private onFrame: (dt: number) => void = () => {}; + constructor(readonly canvas: HTMLCanvasElement) { + this.renderer = new T.WebGLRenderer({ canvas, antialias: true, powerPreference: 'high-performance' }); + this.renderer.setPixelRatio(Math.min(devicePixelRatio, 1.5)); + this.renderer.shadowMap.enabled = true; + this.renderer.shadowMap.type = T.PCFSoftShadowMap; + this.renderer.toneMapping = T.ACESFilmicToneMapping; + this.renderer.toneMappingExposure = 1.0; + this.scene.background = new T.Color('#b9ccd0'); + this.scene.fog = new T.Fog('#b9ccd0', 200, 650); + this.scene.add(new T.HemisphereLight('#e9f4f2', '#475c3d', 1.35)); + this.sun = new T.DirectionalLight('#fff0d8', 2.3); + this.sun.position.set(-60, 100, 45); + this.sun.castShadow = true; + this.sun.shadow.mapSize.set(2048, 2048); + Object.assign(this.sun.shadow.camera, { left: -100, right: 100, top: 100, bottom: -100, near: 1, far: 300 }); + this.sun.shadow.bias = -0.0003; + this.sun.shadow.normalBias = 0.15; + this.scene.add(this.sun, this.sun.target); + this.ring = new T.Mesh(new T.RingGeometry(1.35, 1.5, 48), new T.MeshBasicMaterial({ color: '#ebefc1', side: T.DoubleSide, depthWrite: false })); + this.ring.rotation.x = -Math.PI / 2; + this.scene.add(this.ring); + this.selection = new T.Mesh(new T.RingGeometry(2.1, 2.24, 40), new T.MeshBasicMaterial({ color: '#f1d595', side: T.DoubleSide, depthWrite: false })); + this.selection.rotation.x = -Math.PI / 2; + this.selection.visible = false; + this.scene.add(this.selection); + this.storm = new T.Mesh(new T.CylinderGeometry(1, 1, 36, 160, 1, true), new T.MeshBasicMaterial({ color: '#ce4f65', transparent: true, opacity: 0.27, side: T.DoubleSide, depthWrite: false })); + this.storm.visible = false; + this.scene.add(this.storm); + window.addEventListener('resize', () => this.resize()); + this.resize(); + } + async load() { + const loader = new GLTFLoader(); + await Promise.all(['tree', 'ore', 'herb', 'player', 'sentinel', 'boss'].map(async kind => { + const gltf = await loader.loadAsync(`/models/${kind}.glb`); + gltf.scene.updateMatrixWorld(true); + this.models.set(kind, gltf.scene); + if (kind === 'player') return; + const batch: Batch = { parts: [], entities: [] }; + gltf.scene.traverse(child => { + if (!(child instanceof T.Mesh)) return; + const geometry = child.geometry.clone().applyMatrix4(child.matrixWorld); + const mesh = new T.InstancedMesh(geometry, child.material, kind === 'boss' ? 1 : 2048); + mesh.count = 0; + mesh.instanceMatrix.setUsage(T.DynamicDrawUsage); + mesh.castShadow = true; + mesh.receiveShadow = true; + mesh.userData.kind = kind; + this.scene.add(mesh); + batch.parts.push(mesh); + }); + this.batches.set(kind, batch); + })); + this.player = this.models.get('player')!.clone(true); + this.player.traverse(o => { if (o instanceof T.Mesh) { o.castShadow = true; o.receiveShadow = true; } }); + this.scene.add(this.player); + // Players share rigid placeholder geometry until animated LOD assets are available. + const template = this.models.get('player')!; + const peers: Batch = { parts: [], entities: [] }; + template.traverse(child => { + if (!(child instanceof T.Mesh)) return; + const mesh = new T.InstancedMesh(child.geometry.clone().applyMatrix4(child.matrixWorld), child.material, 2048); + mesh.count = 0; mesh.castShadow = true; mesh.userData.kind = 'player'; + this.scene.add(mesh); peers.parts.push(mesh); + }); + this.batches.set('player', peers); + const corpseMesh = new T.InstancedMesh(new T.BoxGeometry(1.1, 0.45, 2.1), new T.MeshStandardMaterial({ color: '#77766d' }), 2048); + corpseMesh.count = 0; corpseMesh.userData.kind = 'corpse'; this.scene.add(corpseMesh); + this.batches.set('corpse', { parts: [corpseMesh], entities: [] }); + } + resize() { + const width = innerWidth, height = innerHeight, aspect = width / height; + this.renderer.setSize(width, height, false); + const size = this.distance * (width < 800 ? 0.7 : 0.65); + this.camera.left = -size * aspect; this.camera.right = size * aspect; + this.camera.top = size; this.camera.bottom = -size; + this.camera.updateProjectionMatrix(); + } + quality(high: boolean) { + this.highQuality = high; this.renderer.shadowMap.enabled = high; + this.renderer.setPixelRatio(Math.min(devicePixelRatio, high ? 1.5 : 1)); + this.resize(); + } + addChunks(chunks: Chunk[], keys?: string[]) { + const keep = new Set(keys ?? chunks.map(c => c.key)); + for (const [key, chunk] of this.chunks) { + if (keep.has(key)) continue; + this.scene.remove(chunk.mesh); chunk.mesh.geometry.dispose(); + (chunk.mesh.material as T.Material).dispose(); this.chunks.delete(key); + } + for (const chunk of chunks) { + if (this.chunks.has(chunk.key)) continue; + const n = chunk.resolution, step = chunk.size / n; + const positions: number[] = [], colors: number[] = [], indices: number[] = []; + const green = new T.Color('#425e3e'), light = new T.Color('#748058'), stone = new T.Color('#829092'); + for (let z = 0; z <= n; z++) for (let x = 0; x <= n; x++) { + const wx = chunk.x * chunk.size + x * step, wz = chunk.z * chunk.size + z * step; + const h = chunk.heights[z * (n + 1) + x]; + positions.push(wx, h, wz); + const noise = (Math.sin(wx * 0.072) * Math.cos(wz * 0.052) + 1) / 2; + const patch = Math.max(0, Math.sin(wx * 0.018 + wz * 0.012) * Math.cos(wz * 0.025) - 0.22); + const color = green.clone().lerp(light, noise * 0.6).lerp(stone, Math.min(0.9, Math.max(0, (h - 5) / 10) + patch)); + if (Math.hypot(wx, wz) < 16) color.lerp(new T.Color('#97a07d'), 0.5); + colors.push(color.r, color.g, color.b); + } + for (let z = 0; z < n; z++) for (let x = 0; x < n; x++) { + const a = z * (n + 1) + x, b = a + 1, c = a + n + 1, d = c + 1; + indices.push(a, c, b, b, c, d); + } + const geometry = new T.BufferGeometry(); + geometry.setAttribute('position', new T.Float32BufferAttribute(positions, 3)); + geometry.setAttribute('color', new T.Float32BufferAttribute(colors, 3)); + geometry.setIndex(indices); geometry.computeVertexNormals(); + const mesh = new T.Mesh(geometry, new T.MeshStandardMaterial({ vertexColors: true, roughness: 1, flatShading: true })); + mesh.receiveShadow = true; + this.scene.add(mesh); this.chunks.set(chunk.key, { data: chunk, mesh }); + } + } + height(x: number, z: number) { + const chunk = this.chunks.get(`${Math.floor(x / 128)}:${Math.floor(z / 128)}`)?.data; + if (!chunk) return this.position.y; + const gx = (x - chunk.x * chunk.size) / chunk.size * chunk.resolution; + const gz = (z - chunk.z * chunk.size) / chunk.size * chunk.resolution; + const ix = Math.min(chunk.resolution - 1, Math.floor(gx)), iz = Math.min(chunk.resolution - 1, Math.floor(gz)); + const fx = gx - ix, fz = gz - iz, n = chunk.resolution + 1, i = iz * n + ix; + const [a, b, c, d] = [chunk.heights[i], chunk.heights[i + 1], chunk.heights[i + n], chunk.heights[i + n + 1]]; + return fx + fz <= 1 ? a + (b - a) * fx + (c - a) * fz : d + (c - d) * (1 - fx) + (b - d) * (1 - fz); + } + updateEntities(entities: Entity[]) { + for (const batch of this.batches.values()) batch.entities = []; + for (const entity of entities) this.batches.get(entity.kind)?.entities.push(entity); + for (const batch of this.batches.values()) { + const count = Math.min(2048, batch.entities.length); + for (let i = 0; i < count; i++) { + const e = batch.entities[i]; + this.dummy.position.set(e.position.x, e.position.y, e.position.z); + const variation = e.id.split('').reduce((n, c) => n + c.charCodeAt(0), 0); + this.dummy.rotation.set(0, e.kind === 'tree' || e.kind === 'ore' ? variation : 0, 0); + const scale = e.kind === 'tree' ? 0.85 + (variation % 6) * 0.07 : 1; + this.dummy.scale.setScalar(scale); this.dummy.updateMatrix(); + for (const mesh of batch.parts) mesh.setMatrixAt(i, this.dummy.matrix); + } + for (const mesh of batch.parts) { mesh.count = count; mesh.instanceMatrix.needsUpdate = true; mesh.computeBoundingSphere(); } + } + } + update(snapshot: Snapshot) { + this.snapshot = snapshot; + this.addChunks(snapshot.chunks, snapshot.chunkKeys); + const unavailable = new Set(snapshot.unavailableResources); + const resources = [...this.chunks.values()].flatMap(c => c.data.resources).filter(r => !unavailable.has(r.id)); + snapshot.entities = [...snapshot.entities, ...resources]; + this.updateEntities(snapshot.entities); + const p = snapshot.self.entity.position; + this.aim.set(p.x, p.y, p.z); + if (!this.initialized || this.position.distanceTo(this.aim) > 20) { this.position.copy(this.aim); this.focus.copy(this.aim); this.initialized = true; } + this.storm.visible = snapshot.world.phase === 'cataclysm'; + this.storm.scale.set(snapshot.world.safeRadius, 1, snapshot.world.safeRadius); + const danger = snapshot.world.phase === 'cataclysm'; + (this.scene.background as T.Color).set(danger ? '#c19f9e' : '#b9ccd0'); + (this.scene.fog as T.Fog).color.copy(this.scene.background as T.Color); + if (this.selected) this.selected = snapshot.entities.find(e => e.id === this.selected!.id); + } + pick(clientX: number, clientY: number): { entity?: Entity; point?: T.Vector3 } { + const rect = this.canvas.getBoundingClientRect(); + this.ray.setFromCamera(new T.Vector2((clientX - rect.left) / rect.width * 2 - 1, -(clientY - rect.top) / rect.height * 2 + 1), this.camera); + const objects: T.Object3D[] = []; + for (const batch of this.batches.values()) objects.push(...batch.parts); + const hit = this.ray.intersectObjects(objects, false)[0]; + if (hit?.instanceId !== undefined) { + const batch = this.batches.get(hit.object.userData.kind); + return { entity: batch?.entities[hit.instanceId] }; + } + return { point: this.ray.intersectObjects([...this.chunks.values()].map(c => c.mesh), false)[0]?.point }; + } + start(onFrame: (dt: number) => void) { + this.onFrame = onFrame; + this.renderer.setAnimationLoop(() => { + const dt = Math.min(this.clock.getDelta(), 0.05); + this.onFrame(dt); + // Presentation interpolation follows server positions; it never changes authoritative movement. + this.position.lerp(this.aim, 1 - Math.exp(-14 * dt)); + this.focus.lerp(this.position, 1 - Math.exp(-8 * dt)); + this.camera.position.copy(this.focus).add(new T.Vector3(0, 85, 80)); + this.camera.lookAt(this.focus); + if (this.player) { + this.player.position.copy(this.position); + const direction = this.aim.clone().sub(this.position); + if (direction.lengthSq() > 0.002) this.player.rotation.y = Math.atan2(-direction.x, -direction.z); + this.player.position.y += this.moving ? Math.sin(this.clock.elapsedTime * 15) * 0.09 : 0; + } + this.ring.position.copy(this.position); this.ring.position.y += 0.08; + this.selection.visible = !!this.selected; + if (this.selected) this.selection.position.set(this.selected.position.x, this.selected.position.y + 0.1, this.selected.position.z); + if (this.highQuality) { + this.sun.position.copy(this.focus).add(new T.Vector3(-60, 100, 45)); + this.sun.target.position.copy(this.focus); + } + this.renderer.render(this.scene, this.camera); this.frames++; + }); + } + diagnostics() { return { frames: this.frames, chunks: this.chunks.size, drawCalls: this.renderer.info.render.calls, triangles: this.renderer.info.render.triangles, models: this.models.size, position: this.position.toArray() }; } +} diff --git a/client/tsconfig.json b/client/tsconfig.json new file mode 100644 index 0000000..47fb677 --- /dev/null +++ b/client/tsconfig.json @@ -0,0 +1,9 @@ +{ + "compilerOptions": { + "target": "ES2022", "module": "ESNext", "moduleResolution": "Bundler", + "lib": ["ES2022", "DOM", "DOM.Iterable"], "strict": true, + "noEmit": true, "skipLibCheck": true, "allowImportingTsExtensions": true, + "types": ["vite/client"] + }, + "include": ["src"] +} diff --git a/client/vite.config.ts b/client/vite.config.ts new file mode 100644 index 0000000..cdb2361 --- /dev/null +++ b/client/vite.config.ts @@ -0,0 +1,10 @@ +import { defineConfig } from 'vite'; + +export default defineConfig({ + root: 'client', + build: { outDir: 'dist', target: 'es2022', chunkSizeWarningLimit: 650 }, + server: { + port: 5175, strictPort: true, + proxy: { '/api': 'http://127.0.0.1:18080', '/auth': 'http://127.0.0.1:18080', '/ws': { target: 'ws://127.0.0.1:18080', ws: true } }, + }, +}); diff --git a/deploy/argocd-application.example.yaml b/deploy/argocd-application.example.yaml new file mode 100644 index 0000000..10d7649 --- /dev/null +++ b/deploy/argocd-application.example.yaml @@ -0,0 +1,22 @@ +apiVersion: argoproj.io/v1alpha1 +kind: Application +metadata: + name: aeternalis + namespace: argocd +spec: + project: default + sources: + - repoURL: https://gitea.example.invalid/games/aeternalis.git + targetRevision: master + path: deploy/chart + helm: + valueFiles: [$values/apps/aeternalis/values.yaml] + - repoURL: https://gitea.example.invalid/infra/gitops.git + targetRevision: main + ref: values + destination: + server: https://kubernetes.default.svc + namespace: aeternalis + syncPolicy: + automated: { prune: false, selfHeal: true } + syncOptions: [CreateNamespace=true] diff --git a/deploy/chart/Chart.yaml b/deploy/chart/Chart.yaml new file mode 100644 index 0000000..0b57a80 --- /dev/null +++ b/deploy/chart/Chart.yaml @@ -0,0 +1,6 @@ +apiVersion: v2 +name: aeternalis +description: Independent authoritative Aeternalis worlds +type: application +version: 0.1.0 +appVersion: 0.1.0 diff --git a/deploy/chart/templates/network-policy.yaml b/deploy/chart/templates/network-policy.yaml new file mode 100644 index 0000000..e9cb0be --- /dev/null +++ b/deploy/chart/templates/network-policy.yaml @@ -0,0 +1,28 @@ +{{- if .Values.networkPolicy.enabled }} +apiVersion: networking.k8s.io/v1 +kind: NetworkPolicy +metadata: + name: {{ .Release.Name }}-worlds +spec: + podSelector: + matchLabels: { app.kubernetes.io/name: aeternalis, app.kubernetes.io/instance: {{ .Release.Name | quote }} } + policyTypes: [Ingress, Egress] + ingress: + - from: + - namespaceSelector: + matchLabels: { kubernetes.io/metadata.name: {{ .Values.networkPolicy.ingressNamespace | quote }} } + ports: [{ protocol: TCP, port: 8080 }] + egress: + - to: + - namespaceSelector: + matchLabels: { kubernetes.io/metadata.name: {{ .Values.networkPolicy.dnsNamespace | quote }} } + ports: [{ protocol: UDP, port: 53 }, { protocol: TCP, port: 53 }] + {{- range .Values.networkPolicy.databaseCIDRs }} + - to: [{ ipBlock: { cidr: {{ . | quote }} } }] + ports: [{ protocol: TCP, port: 5432 }] + {{- end }} + {{- range .Values.networkPolicy.identityCIDRs }} + - to: [{ ipBlock: { cidr: {{ . | quote }} } }] + ports: [{ protocol: TCP, port: 443 }] + {{- end }} +{{- end }} diff --git a/deploy/chart/templates/worlds.yaml b/deploy/chart/templates/worlds.yaml new file mode 100644 index 0000000..69f8b05 --- /dev/null +++ b/deploy/chart/templates/worlds.yaml @@ -0,0 +1,83 @@ +{{- $root := . -}} +{{- $directory := list -}} +{{- range .Values.worlds -}} +{{- $directory = append $directory (dict "id" .id "url" (printf "https://%s" .host)) -}} +{{- end -}} +{{- range .Values.worlds }} +--- +apiVersion: apps/v1 +kind: Deployment +metadata: + name: {{ $root.Release.Name }}-{{ .id }} + labels: { app.kubernetes.io/name: aeternalis, app.kubernetes.io/instance: {{ $root.Release.Name | quote }}, aeternalis.world: {{ .id | quote }} } +spec: + replicas: 1 + strategy: { type: Recreate } + revisionHistoryLimit: 3 + selector: + matchLabels: { app.kubernetes.io/instance: {{ $root.Release.Name | quote }}, aeternalis.world: {{ .id | quote }} } + template: + metadata: + labels: { app.kubernetes.io/name: aeternalis, app.kubernetes.io/instance: {{ $root.Release.Name | quote }}, aeternalis.world: {{ .id | quote }} } + spec: + automountServiceAccountToken: false + terminationGracePeriodSeconds: 30 + imagePullSecrets: {{ $root.Values.imagePullSecrets | toJson }} + securityContext: + runAsNonRoot: true + runAsUser: 65532 + runAsGroup: 65532 + seccompProfile: { type: RuntimeDefault } + containers: + - name: world + image: {{ if $root.Values.image.digest }}{{ printf "%s@%s" $root.Values.image.repository $root.Values.image.digest | quote }}{{ else }}{{ printf "%s:%s" $root.Values.image.repository $root.Values.image.tag | quote }}{{ end }} + imagePullPolicy: IfNotPresent + ports: [{ name: http, containerPort: 8080 }] + securityContext: + readOnlyRootFilesystem: true + allowPrivilegeEscalation: false + capabilities: { drop: [ALL] } + env: + - { name: APP_ENV, value: production } + - { name: LISTEN_ADDR, value: "0.0.0.0:8080" } + - { name: WORLD_ID, value: {{ .id | quote }} } + - { name: WORLD_SEED, value: {{ .seed | quote }} } + - { name: PUBLIC_URL, value: {{ printf "https://%s" .host | quote }} } + - { name: WORLD_DIRECTORY, value: {{ $directory | toJson | quote }} } + envFrom: + - secretRef: { name: {{ $root.Values.existingSecret | quote }} } + resources: {{ $root.Values.resources | toJson }} + startupProbe: { httpGet: { path: /readyz, port: http }, periodSeconds: 5, failureThreshold: 24 } + readinessProbe: { httpGet: { path: /readyz, port: http }, periodSeconds: 3, failureThreshold: 2 } + livenessProbe: { httpGet: { path: /healthz, port: http }, periodSeconds: 10, failureThreshold: 3 } +--- +apiVersion: v1 +kind: Service +metadata: + name: {{ $root.Release.Name }}-{{ .id }} +spec: + selector: { app.kubernetes.io/instance: {{ $root.Release.Name | quote }}, aeternalis.world: {{ .id | quote }} } + ports: [{ name: http, port: 8080, targetPort: http }] +--- +apiVersion: networking.k8s.io/v1 +kind: Ingress +metadata: + name: {{ $root.Release.Name }}-{{ .id }} + annotations: + nginx.ingress.kubernetes.io/proxy-read-timeout: "3600" + nginx.ingress.kubernetes.io/proxy-send-timeout: "3600" + nginx.ingress.kubernetes.io/proxy-body-size: "8k" + nginx.ingress.kubernetes.io/limit-rps: "10" + nginx.ingress.kubernetes.io/ssl-redirect: "true" +spec: + ingressClassName: {{ $root.Values.ingress.className | quote }} + tls: [{ hosts: [{{ .host | quote }}], secretName: {{ $root.Values.ingress.tlsSecret | quote }} }] + rules: + - host: {{ .host | quote }} + http: + paths: + - path: / + pathType: Prefix + backend: + service: { name: {{ $root.Release.Name }}-{{ .id }}, port: { name: http } } +{{- end }} diff --git a/deploy/chart/values.schema.json b/deploy/chart/values.schema.json new file mode 100644 index 0000000..3e868db --- /dev/null +++ b/deploy/chart/values.schema.json @@ -0,0 +1,10 @@ +{ + "$schema": "http://json-schema.org/draft-07/schema#", + "type": "object", + "required": ["worlds", "existingSecret", "image"], + "properties": { + "worlds": {"type": "array", "minItems": 1, "items": {"type": "object", "required": ["id", "seed", "host"], "properties": {"id": {"type": "string", "pattern": "^[a-z][a-z0-9-]{0,30}$"}, "seed": {"type": "string", "pattern": "^[0-9]{1,15}$"}, "host": {"type": "string", "minLength": 1}}}}, + "existingSecret": {"type": "string", "minLength": 1}, + "image": {"type": "object", "required": ["repository", "tag", "digest"], "properties": {"repository": {"type": "string", "minLength": 1}, "tag": {"type": "string", "minLength": 1}, "digest": {"type": "string", "pattern": "^(sha256:[a-f0-9]{64})?$"}}} + } +} diff --git a/deploy/chart/values.yaml b/deploy/chart/values.yaml new file mode 100644 index 0000000..adefe07 --- /dev/null +++ b/deploy/chart/values.yaml @@ -0,0 +1,37 @@ +image: + repository: harbor.example.invalid/games/aeternalis + tag: bootstrap + digest: "" +imagePullSecrets: + - name: harbor-pull +existingSecret: aeternalis-runtime +ingress: + className: nginx + tlsSecret: aeternalis-tls +worlds: + - id: world-001 + seed: "734291" + host: world-001.aeternalis.example.invalid + - id: world-002 + seed: "829312" + host: world-002.aeternalis.example.invalid + - id: world-003 + seed: "942731" + host: world-003.aeternalis.example.invalid + - id: world-004 + seed: "1037412" + host: world-004.aeternalis.example.invalid + - id: world-005 + seed: "1123491" + host: world-005.aeternalis.example.invalid +resources: + requests: { cpu: "500m", memory: "256Mi" } + limits: { cpu: "2", memory: "1Gi" } +networkPolicy: + enabled: true + ingressNamespace: ingress-nginx + # Explicitly set actual database and OIDC provider IP ranges before deployment. + databaseCIDRs: [] + identityCIDRs: [] + # Kube-dns defaults; adjust for clusters using NodeLocal DNSCache. + dnsNamespace: kube-system diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md new file mode 100644 index 0000000..3a38791 --- /dev/null +++ b/docs/ARCHITECTURE.md @@ -0,0 +1,116 @@ +# Architecture and vision review + +Reviewed 2026-09-05 against `C:/Dev/aeternalis/planning/VISION.md` and the earlier +RPGTheory design notes. The new weekly boss rule is authoritative over the older +uncertain session-ending description. + +## Assessment + +The vision has a coherent distinguishing loop: players invest in a single life, +cooperate against a closing deadline, and earn passage to a new world. The browser +is a reasonable first client. Chunk subscriptions and GPU instancing address some +client costs, but do not prove that thousands of players can gather around one boss. +Changing to a native client would not remove simulation, bandwidth, or persistence +bottlenecks. Measure before changing platforms. + +The highest-risk requirements are: + +1. **Death and transfers must remain correct after retries, crashes, and redeploys.** + A duplicated survivor or resurrected character undermines the one-life premise. +2. **One world is explicitly one server instance.** Kubernetes adds world capacity + by adding independent owners; replicating the same world deployment does not + share its simulation. A crowded final boss bypasses the benefit of small AOIs. +3. **Nine 128-unit chunks are a subscription rule, not a complete scaling plan.** + Entity density, bytes/update, allocation rate, AI work, and client draw cost need + separate budgets and load measurements. +4. **Two hours per day and a destructive weekly event interact.** The prototype + protects a capped character from enemies in a central safe zone, but does not + exempt it from final world collapse or grant passage before the boss dies. + Offline-world survival is an explicit provisional rule requiring playtesting. +5. **Five worlds opened together also reach their deadlines together.** Operators + need to open fresh destinations before survivors transfer. There is no automatic + Kubernetes world allocator in this slice. + +## Implemented boundaries + +One Go process owns one world, with a serial simulation protected by one lock. +Clients submit bounded intents. The server determines speed, terrain height, +range, cooldown, inventory changes, damage, death, play-time, and passage eligibility. +Movement is interpolated on the client; full prediction/reconciliation is deferred. +No rigid-body physics is claimed: this is heightfield movement in open terrain. + +The simulation ticks at 20 Hz; snapshots are sent at 5 Hz. Coordinates use X/Z +chunk indices and Y height. Terrain has a vertical coordinate but is a 2.5D +heightfield, **not** a volumetric 128x128x128 voxel world. Overhangs, caves, stacked +chunks, and fully destructible voxel terrain require another generator/version. +Destruction currently means a shrinking hazardous boundary, not terrain deformation. + +OpenSimplex supplies seeded noise. A versioned generator produces chunk meshes and +resources only as needed. Mesh height and server collision height share a triangle +split. A connection subscribes to current chunk + eight neighbors. Unchanged +terrain and static resource transforms are not resent; resource availability IDs +and dynamic entities are filtered by this area. GPU terrain is disposed +on eviction. Repeated GLB meshes use instancing; camera frustum culling is separate +from network interest. The server retains mutation deltas across chunk eviction. + +The finite circular world, 48-unit spawn separation, 100-character capacity, +combat numbers, terrain details, mob scaling, and respawn periods are provisional +defaults. They are not newly confirmed design decisions. Balance is validated and +persisted with the world; editing YAML affects newly created world IDs only. + +## Durability and ownership + +Development uses SQLite WAL. Production requires PostgreSQL with TLS certificate +verification. Both use the same storage tests and transaction behavior. + +The `worlds` row has an expiring owner token and a monotonically increasing +revision. Every save atomically checks owner, lease expiry using database time, +and expected revision. A competing process cannot acquire an unexpired lease, +and a previous owner cannot write after replacement. Lease renewal accompanies +regular saves; a stopped/crashed process releases or expires after 30 seconds. + +World snapshots are saved every second and on material gameplay changes before +the next client snapshot. Victory creates survivor passage records in that same +transaction. A destination saves its imported character and marks the passage +redeemed in one transaction. Later victories can issue a new passage for the same +character ID; old source servers cannot overwrite it. Account identity is checked +at redemption, and the destination rejects duplicate accounts/characters. + +On storage failure the process freezes and fails readiness/liveness, closes its +sockets, and must restart/reload durable state. This avoids continuing after an +ambiguous commit. Default shutdown allows 10 seconds to save and release ownership. +Treat backup/restore as an explicit administrative operation: restoring an old +database can reverse deaths and transfers, so production needs a restoration policy. + +**Prototype durability limit:** an abrupt crash can roll back up to one second of +position and daily play usage. Gameplay mutations are acknowledged after a save; +unacknowledged inputs can disappear. Whole-world JSON checkpoints occur under the +simulation lock and are deliberately a simple first implementation. Before public +permadeath or large worlds, replace this with a durable event log, asynchronous +checkpoints, versioned migrations, and crash/latency fault injection. + +## Security scope + +- Production login: OIDC verification (issuer, audience, signature, expiry), PKCE, + state and nonce binding, and opaque server-side sessions. +- Secure, HttpOnly, SameSite cookies. No client-controlled identity or progression. +- Explicit same-origin checks on mutations and WebSockets; no permissive CORS. +- Strict JSON parsing, small input limits, sequence checks, HTTP/WS rate limits, + action validation, movement timeout, and bounded slow-consumer queues. +- CSP, no framing, MIME sniff protection, HSTS in production, and no token logging. +- A non-root, read-only runtime container with all capabilities dropped, no service + account token, health probes, TLS ingress, and limited network egress. + +The application limiter uses the real TCP peer address, **not untrusted forwarded +headers**. Behind ingress this may group many users into one bucket. Configure +trusted-proxy-aware rate limiting before public load; the chart's ingress rate +limit is an additional layer. OIDC provider callbacks and JWKS refresh, TLS, network +policies, actual ingress behavior, backups, secret rotation, and dependency scanning +must be tested on the real cluster. This code is not a completed security audit. + +## Source references + +- [Three.js instanced rendering](https://threejs.org/docs/pages/InstancedMesh.html) +- [Three.js object-count optimization](https://threejs.org/manual/en/optimize-lots-of-objects.html) +- [Kubernetes security contexts](https://kubernetes.io/docs/tasks/configure-pod-container/security-context/) +- [Gitea Actions runner setup](https://docs.gitea.com/usage/actions/quickstart/) diff --git a/docs/DEPLOYMENT.md b/docs/DEPLOYMENT.md new file mode 100644 index 0000000..1474784 --- /dev/null +++ b/docs/DEPLOYMENT.md @@ -0,0 +1,106 @@ +# Kubernetes and Gitea deployment + +The chart and workflow are provided for configuration and cluster validation. +No image has been published, no GitOps repository has been modified, and no +cluster resources have been applied by this implementation session. + +## Runtime prerequisites + +- PostgreSQL database shared by all worlds, with verified TLS. The runtime needs + table/index creation for initial bootstrap, then reads and writes in its own + database. A separate migration job and reduced DDL privileges are follow-up work. +- An OIDC provider/client with exact callbacks for each world: + `https:///auth/callback`. Use one client accepting these registered + callbacks or extend the chart to use per-world credentials. Never use wildcards. +- Harbor registry project and a pull-only robot credential for Kubernetes. +- An ingress controller that supports WebSocket upgrades and preserves Host, + certificates covering all world hosts, working DNS, and NetworkPolicy enforcement. +- ArgoCD with read access to the application and GitOps repositories. + +Create the runtime secret through your existing secret manager (e.g. External +Secrets or sealed secrets). Do not put actual secret values into this repository. +The named secret `aeternalis-runtime` must contain: + +| Key | Value | +|---|---| +| `DATABASE_URL` | `postgres://user:password@db.example/db?sslmode=verify-full` | +| `OIDC_ISSUER` | Exact HTTPS issuer URL | +| `OIDC_CLIENT_ID` | Registered client ID | +| `OIDC_CLIENT_SECRET` | Client secret, if required by your provider | + +Certificates from the image's system CA bundle are trusted. Mount a custom CA and +configure the PostgreSQL/HTTPS clients if your infrastructure uses a private CA; +that mounting is site-specific and not included in the sample chart. + +Configure `deploy/chart/values.yaml` (prefer an external GitOps values file): + +1. Set image repository, pull secret, runtime secret, TLS secret, and actual hosts. +2. Set `networkPolicy.databaseCIDRs` and `identityCIDRs` to the actual permitted + destinations. Empty lists deny these connections, so the server will not start + until the allowlists match. Adjust DNS rules for NodeLocal DNSCache if used. +3. Adjust requests/limits after measuring on cluster hardware. Defaults are initial + allocations, not a capacity guarantee. +4. Render and inspect with `helm lint` and `helm template`; validate against the + target cluster version using your normal dry-run pipeline. + +## Gitea setup + +Enable Actions in the repository. Use a runner with the `ubuntu-latest` label, +Node/Go setup support, service-container networking, and Docker build capability. +The publication runner should be trusted; do not expose a privileged Docker socket +to untrusted pull-request jobs. The verify job has no deployment credentials. +Action references use upstream version tags; mirror/pin these to reviewed commits +under your organization's supply-chain policy before production use. + +Set repository variables: + +| Variable | Example | +|---|---| +| `HARBOR_HOST` | `harbor.your-domain` (no scheme) | +| `HARBOR_PROJECT` | `games` | +| `GITOPS_REPOSITORY` | `https://gitea.your-domain/infra/gitops.git` | +| `GITOPS_BRANCH` | `main` | +| `GITOPS_VALUES_FILE` | `apps/aeternalis/values.yaml` | + +Set repository secrets `HARBOR_USERNAME`, `HARBOR_PASSWORD`, `GITOPS_USERNAME`, +and `GITOPS_TOKEN`. Use a Harbor project-scoped push robot and a token restricted +to the intended GitOps repository. An empty `GITOPS_REPOSITORY` skips promotion. +Harbor publication still requires its own variables/secrets. + +On a push to `master` or `main`, CI verifies generated contracts, TypeScript, +production client build, Go tests with the race detector, real PostgreSQL storage +integration, browser tests, Go vet, and Helm rendering. It builds/publishes an image +tagged with the commit SHA, then updates the GitOps values to the image's immutable +digest. ArgoCD reconciles that change. No kubeconfig is handed to CI. + +Copy and configure `deploy/argocd-application.example.yaml`. It uses ArgoCD's +multiple-source Application support: chart from the app repository, values from +the GitOps repository. Pruning is disabled in the example to avoid silently +deleting worlds when editing the list. Monitor promotion failures; concurrent +GitOps commits are rejected by a normal non-force push and must be retried. + +## Add worlds and retire seasons + +Each world gets a distinct Deployment, Service, hostname, ID, seed, and database +row. `replicas: 1` and `Recreate` are intentional. An expiring DB lease also fences +duplicate processes. Increasing replicas does not increase one world's capacity. + +To add capacity, append a world entry with a never-used ID and fresh seed, register +its OIDC callback and DNS/TLS, and sync ArgoCD. Open destination worlds before the +current cohort wins; five worlds launched together have the same deadline. +The world directory is supplied to every client, and passages are visible to the +same account after signing into a destination. + +Retire a finished world's workload only after confirming its persisted outcome and +passages. Keep its database row and passage history. Never reuse its ID: restarted +IDs restore their old state. Rolling the code back does not roll the database back. +Balance/seed changes do not mutate a running saved world's rules. + +## Before public access + +Run a real OIDC login and cross-host survivor transfer, restart/kill a pod during +combat and victory, simulate database failure, validate NetworkPolicy and TLS, +and test peak boss crowding. Add observability and alerting, versioned migrations, +durable event recording, abuse controls, account-level cap policy if chosen, and +an operational backup/restore procedure. The current prototype is suitable for +controlled development playtests after deployment validation. diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md new file mode 100644 index 0000000..aa3efca --- /dev/null +++ b/docs/ROADMAP.md @@ -0,0 +1,64 @@ +# Implementation status and next work + +## Playable in this slice + +- Browser 3D scene, original Blender placeholder GLBs, instanced resource meshes, + desktop/touch controls, target selection, inventory, recipes, skills display. +- Seeded streamed heightfield chunks, negative coordinates, seamless borders, + server-authoritative terrain height, 3x3 subscriptions, client chunk eviction. +- Persistent character identity and starting kit; gathering, spear/bandage crafting, + XP counters, basic melee, healing, roaming/respawning zone-confined enemies. +- Seven-day boss deadline, development trigger, shrinking danger boundary, + permanent death, corpses, frozen victory, account-bound atomic survivor passages. +- Two-hour daily character cap, safe relocation, HP floor, logout, next-day keystone. +- SQLite local persistence, PostgreSQL production adapter, exclusive world leases, + strict intents, OIDC, secure cookies, origin checks, bounded sockets/rate limits. +- Gitea verification/publication/GitOps workflow, Dockerfile, five-world Helm chart, + TLS ingress, probes, pod security, network policy, ArgoCD example. + +## Deliberate gaps + +- **2,000 players in one world:** unverified. Default is 100 admitted characters per + world. Current snapshot construction and enemy searches scan world collections; + whole-world persistence can stall ticks. Do not raise capacity based on unit tests. +- **Procedural volume/destruction:** current terrain is a heightfield. The storm + destroys playable space; it does not erode individual terrain cells or structures. +- **Permadeath durability:** last second of movement/time can roll back on abrupt + crash; public permadeath needs event persistence and failure injection. +- **PvP and corpse priority:** disabled/unimplemented. Corpse items can currently be + looted by nearby living players. The highest-damage-attacker lock and close-to- + release rule must ship together with PvP, not be inferred from PvE behavior. +- **Stats/body parts/dynamic skills:** XP counters exist, not the complete formula, + emergent-skill, multi-limb damage, or level/stat allocation systems. +- **Progression:** gathering/crafting content is intentionally small. Fishing, + alchemy stations, smithing, buildable structures, loot tables, and hunger are absent. +- **Operations:** no admin center, chat/moderation, leaderboards, account management, + automatic world provisioning, observability dashboard, or migration framework. +- **Art:** rigid placeholders; no rigged locomotion, attack telegraphs, audio, or LODs. +- **Networking:** interpolated movement without prediction; full entity snapshots + at 5 Hz, not packed/delta entity replication; no proven large-crowd behavior. + +## Next milestones + +1. Playtest the small loop and decide offline/capped survival during the final boss, + return timing, boss telegraphs, and whether peers cooperate or can attack each other. +2. Add a durable event log, versioned database migrations, transfer race/failure + stress tests, and restart recovery. Prove PostgreSQL and OIDC on the real cluster. +3. Add chunk-indexed entity lookups, network byte/tick/allocation telemetry, and + incremental entity replication. Load-test spread populations and a concentrated + boss arena at 50, 100, 250, 500, and then higher only as measurements allow. +4. Build proper enemy telegraphs, animation/LOD pipeline, collision/navigation, and + client prediction. Compare browser frame time on actual target hardware. +5. Implement the full progression and PvP/loot rules with focused tests. Add admin + inspection, leaderboard persistence, account controls, and moderation. +6. Automate lifecycle-aware world provisioning once transfers and retirement are + proven operationally. Keep world creation out of untrusted client requests. + +## Open design questions retained + +The original unresolved good-karma source, exact spawn separation, node dimensions, +full starting gear, and mob scaling policy remain open. This build uses configurable +placeholders (world-age mob scaling resets with each new world). New clarification: +the boss spawns after seven days and slowly destroys the world until defeated or +until no survivors remain. Collapse duration, damage behavior, offline safety, +and the fresh-world opening cadence still need design approval through playtesting. diff --git a/docs/VERIFICATION.md b/docs/VERIFICATION.md new file mode 100644 index 0000000..bf0e952 --- /dev/null +++ b/docs/VERIFICATION.md @@ -0,0 +1,61 @@ +# Verification performed + +Local checks on Windows, 2026-09-05. Node 24.13.0, Go 1.27.1, Blender 4.3.2, +Helm 3.18.6, and headless Microsoft Edge driven by Playwright. + +## Passing checks + +- Generated Go/TypeScript contract drift check, TypeScript strict checking, and + production Vite build. Main JavaScript: 600.22 KB, 156.65 KB gzip estimate. +- Go tests: deterministic terrain and seams, movement bounds/replay rejection, + chunk interest, gathering/crafting, permanent death across restart, daily cap, + real wall-time accounting under lag, keystone safety, boss victory/collapse, + offline survivors, transfer progress preservation, resource replication. +- Storage tests: exclusive ownership, stale-owner rejection, durable passages, + cross-account denial, duplicate redemption rejection, simultaneous redemption + at two destinations, later-world passages, session revocation. +- HTTP/WebSocket tests: origin rejection, HttpOnly sessions, unknown JSON fields, + initial chunk delivery, private identity exclusion, malformed socket input. +- `go vet ./...`. +- Four Playwright tests: desktop rendering/movement/gather/reconnect; mobile + portrait and landscape controls/layout; HTTP security behavior; boss rendering + and actual server-authoritative boss damage. Canvas pixel variation, loaded + models, triangle counts, and progressing render frames were checked. +- Desktop, mobile, landscape, and boss screenshots visually inspected. +- Helm lint and rendering: five distinct Deployments/Services/Ingresses plus a + NetworkPolicy. No cluster resources were applied. + +## Initial concurrency measurement + +`go run ./cmd/load -url http://127.0.0.1:18090 -clients 20 -duration 15s` + +Twenty authenticated WebSocket clients on an isolated local development world, +with periodic movement/idle intents and snapshot reads. Join setup is excluded +from the throughput window. This is a short connection/replication smoke test, +not a long-duration soak, active combat workload, mobile hardware benchmark, or +large final-boss crowd test. + +| Measurement | Before static-resource optimization | After | +|---|---:|---:| +| Concurrent clients | 20 | 20 | +| Measurement duration | 15 seconds | 15 seconds | +| Delivered snapshots | 1,500 | 1,500 | +| Outgoing application payload | 7,548.5 KiB/s | 560.3 KiB/s | +| p95 interval between snapshots | 206.9 ms | 203.0 ms | +| Unexpected disconnections | 0 | 0 | + +The target snapshot interval is 200 ms. Sending static resource transforms once +per chunk reduced measured outgoing payload by about 92.6%. Figures exclude TCP, +WebSocket, and TLS framing. CPU/RAM/GPU saturation and 2,000 players remain unproven. + +## Not executed locally + +- Docker image build/runtime: Docker Desktop's Linux daemon was not running. +- PostgreSQL-backed tests: no test database was configured locally; the workflow + provides a PostgreSQL service and runs the same storage lifecycle suite there. +- Go race detector: no local C toolchain was available; the Linux CI job runs it. +- Real OIDC-provider login, cross-host production transfer, TLS ingress, network + policy enforcement, image publication, ArgoCD sync, and Kubernetes rollout. + +The Playwright Chromium download timed out; all browser tests ran successfully +using installed Edge instead. CI is configured to install Chromium. diff --git a/package-lock.json b/package-lock.json new file mode 100644 index 0000000..c9e05d7 --- /dev/null +++ b/package-lock.json @@ -0,0 +1,1629 @@ +{ + "name": "aeternalis", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "aeternalis", + "dependencies": { + "lucide": "^0.468.0", + "three": "^0.180.0" + }, + "devDependencies": { + "@playwright/test": "^1.55.0", + "@types/three": "^0.180.0", + "quicktype-core": "^23.2.6", + "typescript": "^5.9.2", + "vite": "^7.1.0", + "yaml": "^2.8.1" + } + }, + "node_modules/@dimforge/rapier3d-compat": { + "version": "0.12.0", + "resolved": "https://registry.npmjs.org/@dimforge/rapier3d-compat/-/rapier3d-compat-0.12.0.tgz", + "integrity": "sha512-uekIGetywIgopfD97oDL5PfeezkFpNhwlzlaEYNOA0N6ghdsOvh/HYjSMek5Q2O1PYvRSDFcqFVJl4r4ZBwOow==", + "dev": true, + "license": "Apache-2.0" + }, + "node_modules/@esbuild/aix-ppc64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.28.2.tgz", + "integrity": "sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "aix" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.28.2.tgz", + "integrity": "sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.28.2.tgz", + "integrity": "sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.28.2.tgz", + "integrity": "sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.28.2.tgz", + "integrity": "sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.28.2.tgz", + "integrity": "sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.28.2.tgz", + "integrity": "sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.28.2.tgz", + "integrity": "sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.28.2.tgz", + "integrity": "sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.28.2.tgz", + "integrity": "sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ia32": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.28.2.tgz", + "integrity": "sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-loong64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.28.2.tgz", + "integrity": "sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-mips64el": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.28.2.tgz", + "integrity": "sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA==", + "cpu": [ + "mips64el" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ppc64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.28.2.tgz", + "integrity": "sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-riscv64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.28.2.tgz", + "integrity": "sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-s390x": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.28.2.tgz", + "integrity": "sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.28.2.tgz", + "integrity": "sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.28.2.tgz", + "integrity": "sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.28.2.tgz", + "integrity": "sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.28.2.tgz", + "integrity": "sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.28.2.tgz", + "integrity": "sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openharmony-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.28.2.tgz", + "integrity": "sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/sunos-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.28.2.tgz", + "integrity": "sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "sunos" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.28.2.tgz", + "integrity": "sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-ia32": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.28.2.tgz", + "integrity": "sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.28.2.tgz", + "integrity": "sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@glideapps/ts-necessities": { + "version": "2.2.3", + "resolved": "https://registry.npmjs.org/@glideapps/ts-necessities/-/ts-necessities-2.2.3.tgz", + "integrity": "sha512-gXi0awOZLHk3TbW55GZLCPP6O+y/b5X1pBXKBVckFONSwF1z1E5ND2BGJsghQFah+pW7pkkyFb2VhUQI2qhL5w==", + "dev": true, + "license": "MIT" + }, + "node_modules/@napi-rs/lzma-linux-x64-gnu": { + "version": "1.5.1", + "resolved": "https://registry.npmjs.org/@napi-rs/lzma-linux-x64-gnu/-/lzma-linux-x64-gnu-1.5.1.tgz", + "integrity": "sha512-oTXEIha4SsuXdTA4Iyskj0kpdx2yVXdhd75c2v3xGrHFfVMsbhTPZU/nMPL4sWKo4pBHm3aucLaqGlF696dTyQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^22.20 || ^24.12 || >=25" + } + }, + "node_modules/@playwright/test": { + "version": "1.63.0", + "resolved": "https://registry.npmjs.org/@playwright/test/-/test-1.63.0.tgz", + "integrity": "sha512-oxMK4vllB9RK5NQ2l1pq1IfOf2AvnEuj/vYGDj0H2nMtmtZpKtCwt/l00GEO6xjGfpBNAvjovvYdCm50dRQkpQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "playwright": "1.63.0" + }, + "bin": { + "playwright": "cli.js" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/@rollup/rollup-android-arm-eabi": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.63.1.tgz", + "integrity": "sha512-UZ8sUxPTiHWYX9QNdJedb1kDZSpS1t/VPWBWGSgqHNi9w3Cu6IXvu2mzbhiTiPvtrqgTQJ+zqiAq2iPIPilpaQ==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-android-arm64": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.63.1.tgz", + "integrity": "sha512-cQ4nFQABN5cDvDpbvJ7bMStCpnaVxynZrRMfUJYgxcIk9Sh54FIO1vtfkg0B69REjER77ioZ/ov+eAApx/KmLQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-darwin-arm64": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.63.1.tgz", + "integrity": "sha512-FQNqd1lRy/0QhDk3xeRIkSBiCpXCiDnZO3YLVdcDKN1UBiKToNftCzcXYNLshmPDUMlu2TdeS8tGcsU6f3YF1Q==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-darwin-x64": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.63.1.tgz", + "integrity": "sha512-pvD16V939D3CloK0+qikpGaxiPrDUXTe7Y5cWOMkMSy7m1cawa8EGy/kXYi/G/cKAC4HDAbSnzCIk1WmsoOKXg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-freebsd-arm64": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.63.1.tgz", + "integrity": "sha512-pcFGeL2345VwdTnJhA6zLbew+YgWB0qBG2+dMtXjCicf6+rm6kO6cOoh5VnTe0ZMrMRgRyuHmCJxZWrIdzYuOw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-freebsd-x64": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.63.1.tgz", + "integrity": "sha512-mRJlqSRulVzcKq/LKA6ICSIc3K/l4fzlVn/gePn2nXIHy8seRi5z/eeRE0d/XMBxcMldiXtQTSpRj0tkkC3g8Q==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-linux-arm-gnueabihf": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.63.1.tgz", + "integrity": "sha512-YDUNvVM85TI3g/1OpnqKP1h4NeW/j64DfWMf+G3M809xNk1bJSnpFp4sh83NpmVE5DXnkh8ULor4LTVZKoYLHw==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm-musleabihf": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.63.1.tgz", + "integrity": "sha512-7Mcn71p9ZuQFAj+h+dhQXy/yeLePRS2yKRnmW1DijA9thKO5qap0GNOIQK4yQ6iP3SU0Mrb/yWo8h8vgRba8lw==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-gnu": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.63.1.tgz", + "integrity": "sha512-4YiLQTX6U4CSl0L9cluep9A9W6UmTfqBDc2/CH6wlu54pl4E7Jn3cOD8oxzvBDEGk/JMKgJ47C8g+radF7mwvg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-musl": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.63.1.tgz", + "integrity": "sha512-2ra8F7w8OquwZN9z2/fKFnli69wa8PLwaVzRMIPGb13ByMJwC28Fbp8YcVGoUhlYMTt7j5j9bNgpysrN2UM+vw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-gnu": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.63.1.tgz", + "integrity": "sha512-Sy20ncyhjmBP0Ml+UvQbimjlk6VFgjW5uNP+qqwHB00mTE8Bl2C1TuHTlRwK2YoXeZbee5lP2XevBWVkAQAtSQ==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-musl": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.63.1.tgz", + "integrity": "sha512-noITLp8oNjYliPnGWmLyelIHwULGqbHloQHGw1rtxbWhTuWooRpnZarZQJ1y9EUC4szuCusCc+HEpUtxpIwYvA==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-gnu": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.63.1.tgz", + "integrity": "sha512-hlxxXd+F1mWiAcaFR7Sv9ZQT6m6UfI8+Vy/kFJzztq2pDMU/0wZ9sish0iszNZvsQDo8Gc0i5yuFEOz5dDf6fA==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-musl": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.63.1.tgz", + "integrity": "sha512-EF7OpqQTQ/BvGqLzUi4rEHuagCV9MugAUXSHemwPW5vxZ75RR+jxO/2j95Ph2dalMpFHSVECjRoioHZgA9zOYA==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-gnu": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.63.1.tgz", + "integrity": "sha512-wQO3JesW9PRkwlabQ27y7sPfVOOTLRG73I4F2UYHG5PXun3J9U3y+b7ezVKSYbsvSKGQ1k1cq8Qlun4C9kLt3w==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-musl": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.63.1.tgz", + "integrity": "sha512-ouAGwhO6wHRXdnOVCOsB0tRFkA7nhNB2Nwax6oECXN0YiN8EYUTBAOudADOB1PI+yDL61TeNx/u7MVCzksNbkQ==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-s390x-gnu": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.63.1.tgz", + "integrity": "sha512-q2R38Sn+1J8RxhfJ+T54wSWmyKXWec+9jgDfqO2AtArEqHO5R2aeayp5H5OYLr5UYDVGsVaZPEFUooMhYCdz5A==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-gnu": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.63.1.tgz", + "integrity": "sha512-gfI5T24WLLuFfSKw7Go/zDXjAAV0fny0swTaDv+WjK7vqcw4cRhFfdsyKL1n+ukI+ooBxn3bVQnyrn06WpI50w==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-musl": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.63.1.tgz", + "integrity": "sha512-4h6XqthmB4Hspji84wvgk+ElodTsGj+dbZqHJHHtKxj4mYq0ANSEEPX9ys3moJueqsRjwpaJYH7874Itwnj2ow==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-openbsd-x64": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.63.1.tgz", + "integrity": "sha512-dlfCOa87o1VAYegLQ9EKilx2JCeRofiyPGhTCmqnuXZ6bMPiycO1rq1+sKoulAp7pGLIsTIw+1x5R+zgh5LhhA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ] + }, + "node_modules/@rollup/rollup-openharmony-arm64": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.63.1.tgz", + "integrity": "sha512-cjkLbOlfcm3QGhMM1J5zaZjsw1GggbN6rw9UTSSRrPrR1KkcXnN7Uq9rPw34xImQ9VOY9GN+6u2Zj80B9ptkcw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ] + }, + "node_modules/@rollup/rollup-win32-arm64-msvc": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.63.1.tgz", + "integrity": "sha512-Li1KdUnWGE4N3e1F/B4RTB1ms+nG4WBgjByO46pkeBVX/2UBsY53xf5vK9WygVmnH3RwncIST7lkSdLSY6P9lg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-ia32-msvc": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.63.1.tgz", + "integrity": "sha512-t4ZYOSoLTgwhuFMrmTMLx/+i1DQVK7HYqMc6kY46EApwi8X0nIVphzdNoThU3xt6n+N5urG1/gxBdCaKDLavfg==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-gnu": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.63.1.tgz", + "integrity": "sha512-RgroPfMmKlD1RzSDxvwgcPiy2HNQKoYV7OmwIXDsk73uKW5t6B/V8KIy27SMv/FNXFo/oSBtWc9J0X7t91ezZg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-msvc": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.63.1.tgz", + "integrity": "sha512-at8QVep6S3h5Y6gSbdGU06bRY5WJkf6WUduM9YtvYMbYhB1MOFfUgc6kehitQXzOtMSaT70q7f9ydPhpqu821w==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@tweenjs/tween.js": { + "version": "23.1.3", + "resolved": "https://registry.npmjs.org/@tweenjs/tween.js/-/tween.js-23.1.3.tgz", + "integrity": "sha512-vJmvvwFxYuGnF2axRtPYocag6Clbb5YS7kLL+SO/TeVFzHqDIWrNKYtcsPMibjDx9O+bu+psAy9NKfWklassUA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/estree": { + "version": "1.0.9", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.9.tgz", + "integrity": "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/stats.js": { + "version": "0.17.4", + "resolved": "https://registry.npmjs.org/@types/stats.js/-/stats.js-0.17.4.tgz", + "integrity": "sha512-jIBvWWShCvlBqBNIZt0KAshWpvSjhkwkEu4ZUcASoAvhmrgAUI2t1dXrjSL4xXVLB4FznPrIsX3nKXFl/Dt4vA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/three": { + "version": "0.180.0", + "resolved": "https://registry.npmjs.org/@types/three/-/three-0.180.0.tgz", + "integrity": "sha512-ykFtgCqNnY0IPvDro7h+9ZeLY+qjgUWv+qEvUt84grhenO60Hqd4hScHE7VTB9nOQ/3QM8lkbNE+4vKjEpUxKg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@dimforge/rapier3d-compat": "~0.12.0", + "@tweenjs/tween.js": "~23.1.3", + "@types/stats.js": "*", + "@types/webxr": "*", + "@webgpu/types": "*", + "fflate": "~0.8.2", + "meshoptimizer": "~0.22.0" + } + }, + "node_modules/@types/webxr": { + "version": "0.5.24", + "resolved": "https://registry.npmjs.org/@types/webxr/-/webxr-0.5.24.tgz", + "integrity": "sha512-h8fgEd/DpoS9CBrjEQXR+dIDraopAEfu4wYVNY2tEPwk60stPWhvZMf4Foo5FakuQ7HFZoa8WceaWFervK2Ovg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@webgpu/types": { + "version": "0.1.72", + "resolved": "https://registry.npmjs.org/@webgpu/types/-/types-0.1.72.tgz", + "integrity": "sha512-0cF7RFM2edNoiIS1ODJp0/Gzv4/xSXhwoR0YCza+OWpJWtn4wmo9DvK91aLlH9+uUnwIriP7ZiC3WitmyhuzBw==", + "dev": true, + "license": "BSD-3-Clause" + }, + "node_modules/abort-controller": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/abort-controller/-/abort-controller-3.0.0.tgz", + "integrity": "sha512-h8lQ8tacZYnR3vNQTgibj+tODHI5/+l06Au2Pcriv/Gmet0eaj4TwWH41sO9wnHDiQsEj19q0drzdWdeAHtweg==", + "dev": true, + "license": "MIT", + "dependencies": { + "event-target-shim": "^5.0.0" + }, + "engines": { + "node": ">=6.5" + } + }, + "node_modules/base64-js": { + "version": "1.5.1", + "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz", + "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/browser-or-node": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/browser-or-node/-/browser-or-node-3.0.0.tgz", + "integrity": "sha512-iczIdVJzGEYhP5DqQxYM9Hh7Ztpqqi+CXZpSmX8ALFs9ecXkQIeqRyM6TfxEfMVpwhl3dSuDvxdzzo9sUOIVBQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/buffer": { + "version": "6.0.3", + "resolved": "https://registry.npmjs.org/buffer/-/buffer-6.0.3.tgz", + "integrity": "sha512-FTiCpNxtwiZZHEZbcbTIcZjERVICn9yq/pDFkTl95/AxzD1naBctN7YO68riM/gLSDY7sdrMby8hofADYuuqOA==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "dependencies": { + "base64-js": "^1.3.1", + "ieee754": "^1.2.1" + } + }, + "node_modules/collection-utils": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/collection-utils/-/collection-utils-1.0.1.tgz", + "integrity": "sha512-LA2YTIlR7biSpXkKYwwuzGjwL5rjWEZVOSnvdUc7gObvWe4WkjxOpfrdhoP7Hs09YWDVfg0Mal9BpAqLfVEzQg==", + "dev": true, + "license": "Apache-2.0" + }, + "node_modules/cross-fetch": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/cross-fetch/-/cross-fetch-4.1.0.tgz", + "integrity": "sha512-uKm5PU+MHTootlWEY+mZ4vvXoCn4fLQxT9dSc1sXVMSFkINTJVN8cAQROpwcKm8bJ/c7rgZVIBWzH5T78sNZZw==", + "dev": true, + "license": "MIT", + "dependencies": { + "node-fetch": "^2.7.0" + } + }, + "node_modules/esbuild": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.28.2.tgz", + "integrity": "sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "bin": { + "esbuild": "bin/esbuild" + }, + "engines": { + "node": ">=18" + }, + "optionalDependencies": { + "@esbuild/aix-ppc64": "0.28.2", + "@esbuild/android-arm": "0.28.2", + "@esbuild/android-arm64": "0.28.2", + "@esbuild/android-x64": "0.28.2", + "@esbuild/darwin-arm64": "0.28.2", + "@esbuild/darwin-x64": "0.28.2", + "@esbuild/freebsd-arm64": "0.28.2", + "@esbuild/freebsd-x64": "0.28.2", + "@esbuild/linux-arm": "0.28.2", + "@esbuild/linux-arm64": "0.28.2", + "@esbuild/linux-ia32": "0.28.2", + "@esbuild/linux-loong64": "0.28.2", + "@esbuild/linux-mips64el": "0.28.2", + "@esbuild/linux-ppc64": "0.28.2", + "@esbuild/linux-riscv64": "0.28.2", + "@esbuild/linux-s390x": "0.28.2", + "@esbuild/linux-x64": "0.28.2", + "@esbuild/netbsd-arm64": "0.28.2", + "@esbuild/netbsd-x64": "0.28.2", + "@esbuild/openbsd-arm64": "0.28.2", + "@esbuild/openbsd-x64": "0.28.2", + "@esbuild/openharmony-arm64": "0.28.2", + "@esbuild/sunos-x64": "0.28.2", + "@esbuild/win32-arm64": "0.28.2", + "@esbuild/win32-ia32": "0.28.2", + "@esbuild/win32-x64": "0.28.2" + } + }, + "node_modules/event-target-shim": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/event-target-shim/-/event-target-shim-5.0.1.tgz", + "integrity": "sha512-i/2XbnSz/uxRCU6+NdVJgKWDTM427+MqYbkQzD321DuCQJUqOuJKIA0IM2+W2xtYHdKOmZ4dR6fExsd4SXL+WQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/events": { + "version": "3.3.0", + "resolved": "https://registry.npmjs.org/events/-/events-3.3.0.tgz", + "integrity": "sha512-mQw+2fkQbALzQ7V0MY0IqdnXNOeTtP4r0lN9z7AAawCXgqea7bDii20AYrIBrFd/Hx0M2Ocz6S111CaFkUcb0Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.8.x" + } + }, + "node_modules/fdir": { + "version": "6.5.0", + "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz", + "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12.0.0" + }, + "peerDependencies": { + "picomatch": "^3 || ^4" + }, + "peerDependenciesMeta": { + "picomatch": { + "optional": true + } + } + }, + "node_modules/fflate": { + "version": "0.8.3", + "resolved": "https://registry.npmjs.org/fflate/-/fflate-0.8.3.tgz", + "integrity": "sha512-tbZNuJrLwGUp3zshBtdy4W+ORxZuIh8a5ilyIEQDC5rY1f3U20JMry0Ll3WBzU58EZKsEuJFXhb5gwv8CsPvgA==", + "dev": true, + "license": "MIT" + }, + "node_modules/fsevents": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", + "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/ieee754": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz", + "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "BSD-3-Clause" + }, + "node_modules/is-url": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/is-url/-/is-url-1.2.4.tgz", + "integrity": "sha512-ITvGim8FhRiYe4IQ5uHSkj7pVaPDrCTkNd3yq3cV7iZAcJdHTUMPMEHcqSOy9xZ9qFenQCvi+2wjH9a1nXqHww==", + "dev": true, + "license": "MIT" + }, + "node_modules/js-base64": { + "version": "3.9.3", + "resolved": "https://registry.npmjs.org/js-base64/-/js-base64-3.9.3.tgz", + "integrity": "sha512-uwYQp+VJ38FVvtim6qNbit6e9uT6dwWQ4Y1+H9TxhW5hcHjpHwoxlR0nMpqUmIFOmu4VqMxwdJA88gIVuZJQ/g==", + "dev": true, + "license": "BSD-3-Clause" + }, + "node_modules/lodash": { + "version": "4.18.1", + "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.18.1.tgz", + "integrity": "sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/lucide": { + "version": "0.468.0", + "resolved": "https://registry.npmjs.org/lucide/-/lucide-0.468.0.tgz", + "integrity": "sha512-UFbgwji/ZnAV7iTTE4jujyTV7J95AILKyATDUrqOJrMcUGfXvGjw3c1mcuHZUX2oJfkrAGU9KoxkrLQk2jjtiA==", + "license": "ISC" + }, + "node_modules/meshoptimizer": { + "version": "0.22.0", + "resolved": "https://registry.npmjs.org/meshoptimizer/-/meshoptimizer-0.22.0.tgz", + "integrity": "sha512-IebiK79sqIy+E4EgOr+CAw+Ke8hAspXKzBd0JdgEmPHiAwmvEj2S4h1rfvo+o/BnfEYd/jAOg5IeeIjzlzSnDg==", + "dev": true, + "license": "MIT" + }, + "node_modules/nanoid": { + "version": "3.3.18", + "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.18.tgz", + "integrity": "sha512-DTg4MJbGMWkfi6VZFdNt2/caMbQy4Ou+Op/hJQvGEWcnVfoA1QA+xzRKAzw9jD6+GVOOeYr/mIcuDSdug6F6+w==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "bin": { + "nanoid": "bin/nanoid.cjs" + }, + "engines": { + "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1" + } + }, + "node_modules/node-fetch": { + "version": "2.7.0", + "resolved": "https://registry.npmjs.org/node-fetch/-/node-fetch-2.7.0.tgz", + "integrity": "sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==", + "dev": true, + "license": "MIT", + "dependencies": { + "whatwg-url": "^5.0.0" + }, + "engines": { + "node": "4.x || >=6.0.0" + }, + "peerDependencies": { + "encoding": "^0.1.0" + }, + "peerDependenciesMeta": { + "encoding": { + "optional": true + } + } + }, + "node_modules/pako": { + "version": "1.0.11", + "resolved": "https://registry.npmjs.org/pako/-/pako-1.0.11.tgz", + "integrity": "sha512-4hLB8Py4zZce5s4yd9XzopqwVv/yGNhV1Bl8NTmCq1763HeK2+EwVTv+leGeL13Dnh2wfbqowVPXCIO0z4taYw==", + "dev": true, + "license": "(MIT AND Zlib)" + }, + "node_modules/picocolors": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "dev": true, + "license": "ISC" + }, + "node_modules/picomatch": { + "version": "4.0.7", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.7.tgz", + "integrity": "sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/playwright": { + "version": "1.63.0", + "resolved": "https://registry.npmjs.org/playwright/-/playwright-1.63.0.tgz", + "integrity": "sha512-+7ziBLidS4NaNCdt57SUDT+wYmmd5fmiQejUic/kb+YsYSCPyOOE9sebzMjNmQrsnNpDJqd4WHvV/8lfKfUDUg==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "playwright-core": "1.63.0" + }, + "bin": { + "playwright": "cli.js" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/playwright-core": { + "version": "1.63.0", + "resolved": "https://registry.npmjs.org/playwright-core/-/playwright-core-1.63.0.tgz", + "integrity": "sha512-rYCsBF/M5HjUch52bbtVONEFjv6Xu8sm8h72dNlR5bzIE1fvC/bxgspzkjSfU+MweEMmPM8KJebG6nnyxo5mCg==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "playwright-core": "cli.js" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/pluralize": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/pluralize/-/pluralize-8.0.0.tgz", + "integrity": "sha512-Nc3IT5yHzflTfbjgqWcCPpo7DaKy4FnpB0l/zCAW0Tc7jxAiuqSxHasntB3D7887LSrA93kDJ9IXovxJYxyLCA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/postcss": { + "version": "8.5.28", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.28.tgz", + "integrity": "sha512-RRuzqDtt5Y9h3quz5hWhK+TPnsmVs6WwSU6LkJMeY4HstUEDuYTG8UJSdawMRzmzAtV+KEoG8N3Qg2qLy5vM/A==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/postcss" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "nanoid": "^3.3.18", + "picocolors": "^1.1.1", + "source-map-js": "^1.2.1" + }, + "engines": { + "node": "^10 || ^12 || >=14" + } + }, + "node_modules/process": { + "version": "0.11.10", + "resolved": "https://registry.npmjs.org/process/-/process-0.11.10.tgz", + "integrity": "sha512-cdGef/drWFoydD1JsMzuFf8100nZl+GT+yacc2bEced5f9Rjk4z+WtFUTBu9PhOi9j/jfmBPu0mMEY4wIdAF8A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.6.0" + } + }, + "node_modules/quicktype-core": { + "version": "23.3.25", + "resolved": "https://registry.npmjs.org/quicktype-core/-/quicktype-core-23.3.25.tgz", + "integrity": "sha512-WOKJw/DemC1pO8CD0tgZ/Fn8FzWvWIeLPrbfpwfNbnPoXnehNgDRFesPYpgrNlF0Pce98aUBqqT55fsidaJGVQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@glideapps/ts-necessities": "2.2.3", + "browser-or-node": "^3.0.0", + "collection-utils": "^1.0.1", + "cross-fetch": "^4.0.0", + "is-url": "^1.2.4", + "js-base64": "^3.7.7", + "lodash": "^4.18.1", + "pako": "^1.0.6", + "pluralize": "^8.0.0", + "readable-stream": "4.5.2", + "unicode-properties": "^1.4.1", + "urijs": "^1.19.1", + "wordwrap": "^1.0.0", + "yaml": "^2.8.3" + } + }, + "node_modules/readable-stream": { + "version": "4.5.2", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-4.5.2.tgz", + "integrity": "sha512-yjavECdqeZ3GLXNgRXgeQEdz9fvDDkNKyHnbHRFtOr7/LcfgBcmct7t/ET+HaCTqfh06OzoAxrkN/IfjJBVe+g==", + "dev": true, + "license": "MIT", + "dependencies": { + "abort-controller": "^3.0.0", + "buffer": "^6.0.3", + "events": "^3.3.0", + "process": "^0.11.10", + "string_decoder": "^1.3.0" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + } + }, + "node_modules/rollup": { + "version": "4.63.1", + "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.63.1.tgz", + "integrity": "sha512-3Df9jsstwhccuEfmAMi9l8XUh/GOkVObmFTU7CCVBysEbcOZLl84jCtaAZMcPiMz2EGKsATzQcU+Xr3n/wU6cg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/estree": "1.0.9" + }, + "bin": { + "rollup": "dist/bin/rollup" + }, + "engines": { + "node": ">=18.0.0", + "npm": ">=8.0.0" + }, + "optionalDependencies": { + "@napi-rs/lzma-linux-x64-gnu": "1.5.1", + "@rollup/rollup-android-arm-eabi": "4.63.1", + "@rollup/rollup-android-arm64": "4.63.1", + "@rollup/rollup-darwin-arm64": "4.63.1", + "@rollup/rollup-darwin-x64": "4.63.1", + "@rollup/rollup-freebsd-arm64": "4.63.1", + "@rollup/rollup-freebsd-x64": "4.63.1", + "@rollup/rollup-linux-arm-gnueabihf": "4.63.1", + "@rollup/rollup-linux-arm-musleabihf": "4.63.1", + "@rollup/rollup-linux-arm64-gnu": "4.63.1", + "@rollup/rollup-linux-arm64-musl": "4.63.1", + "@rollup/rollup-linux-loong64-gnu": "4.63.1", + "@rollup/rollup-linux-loong64-musl": "4.63.1", + "@rollup/rollup-linux-ppc64-gnu": "4.63.1", + "@rollup/rollup-linux-ppc64-musl": "4.63.1", + "@rollup/rollup-linux-riscv64-gnu": "4.63.1", + "@rollup/rollup-linux-riscv64-musl": "4.63.1", + "@rollup/rollup-linux-s390x-gnu": "4.63.1", + "@rollup/rollup-linux-x64-gnu": "4.63.1", + "@rollup/rollup-linux-x64-musl": "4.63.1", + "@rollup/rollup-openbsd-x64": "4.63.1", + "@rollup/rollup-openharmony-arm64": "4.63.1", + "@rollup/rollup-win32-arm64-msvc": "4.63.1", + "@rollup/rollup-win32-ia32-msvc": "4.63.1", + "@rollup/rollup-win32-x64-gnu": "4.63.1", + "@rollup/rollup-win32-x64-msvc": "4.63.1", + "fsevents": "~2.3.2" + } + }, + "node_modules/safe-buffer": { + "version": "5.2.1", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", + "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/source-map-js": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz", + "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==", + "dev": true, + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/string_decoder": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz", + "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==", + "dev": true, + "license": "MIT", + "dependencies": { + "safe-buffer": "~5.2.0" + } + }, + "node_modules/three": { + "version": "0.180.0", + "resolved": "https://registry.npmjs.org/three/-/three-0.180.0.tgz", + "integrity": "sha512-o+qycAMZrh+TsE01GqWUxUIKR1AL0S8pq7zDkYOQw8GqfX8b8VoCKYUoHbhiX5j+7hr8XsuHDVU6+gkQJQKg9w==", + "license": "MIT" + }, + "node_modules/tiny-inflate": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/tiny-inflate/-/tiny-inflate-1.0.3.tgz", + "integrity": "sha512-pkY1fj1cKHb2seWDy0B16HeWyczlJA9/WW3u3c4z/NiWDsO3DOU5D7nhTLE9CF0yXv/QZFY7sEJmj24dK+Rrqw==", + "dev": true, + "license": "MIT" + }, + "node_modules/tinyglobby": { + "version": "0.2.17", + "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.17.tgz", + "integrity": "sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==", + "dev": true, + "license": "MIT", + "dependencies": { + "fdir": "^6.5.0", + "picomatch": "^4.0.4" + }, + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/SuperchupuDev" + } + }, + "node_modules/tr46": { + "version": "0.0.3", + "resolved": "https://registry.npmjs.org/tr46/-/tr46-0.0.3.tgz", + "integrity": "sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw==", + "dev": true, + "license": "MIT" + }, + "node_modules/typescript": { + "version": "5.9.3", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz", + "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/unicode-properties": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/unicode-properties/-/unicode-properties-1.4.1.tgz", + "integrity": "sha512-CLjCCLQ6UuMxWnbIylkisbRj31qxHPAurvena/0iwSVbQ2G1VY5/HjV0IRabOEbDHlzZlRdCrD4NhB0JtU40Pg==", + "dev": true, + "license": "MIT", + "dependencies": { + "base64-js": "^1.3.0", + "unicode-trie": "^2.0.0" + } + }, + "node_modules/unicode-trie": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/unicode-trie/-/unicode-trie-2.0.0.tgz", + "integrity": "sha512-x7bc76x0bm4prf1VLg79uhAzKw8DVboClSN5VxJuQ+LKDOVEW9CdH+VY7SP+vX7xCYQqzzgQpFqz15zeLvAtZQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "pako": "^0.2.5", + "tiny-inflate": "^1.0.0" + } + }, + "node_modules/unicode-trie/node_modules/pako": { + "version": "0.2.9", + "resolved": "https://registry.npmjs.org/pako/-/pako-0.2.9.tgz", + "integrity": "sha512-NUcwaKxUxWrZLpDG+z/xZaCgQITkA/Dv4V/T6bw7VON6l1Xz/VnrBqrYjZQ12TamKHzITTfOEIYUj48y2KXImA==", + "dev": true, + "license": "MIT" + }, + "node_modules/urijs": { + "version": "1.19.11", + "resolved": "https://registry.npmjs.org/urijs/-/urijs-1.19.11.tgz", + "integrity": "sha512-HXgFDgDommxn5/bIv0cnQZsPhHDA90NPHD6+c/v21U5+Sx5hoP8+dP9IZXBU1gIfvdRfhG8cel9QNPeionfcCQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/vite": { + "version": "7.3.6", + "resolved": "https://registry.npmjs.org/vite/-/vite-7.3.6.tgz", + "integrity": "sha512-4XP60spRGjSZFf1qYH+dJIkK2znL3zQfl9KkOV9MkkRR/3Dls0dxaBsQPTloEc5BLXWPL9vsOxopxyKoMmDueg==", + "dev": true, + "license": "MIT", + "dependencies": { + "esbuild": "^0.27.0 || ^0.28.0", + "fdir": "^6.5.0", + "picomatch": "^4.0.3", + "postcss": "^8.5.6", + "rollup": "^4.43.0", + "tinyglobby": "^0.2.15" + }, + "bin": { + "vite": "bin/vite.js" + }, + "engines": { + "node": "^20.19.0 || >=22.12.0" + }, + "funding": { + "url": "https://github.com/vitejs/vite?sponsor=1" + }, + "optionalDependencies": { + "fsevents": "~2.3.3" + }, + "peerDependencies": { + "@types/node": "^20.19.0 || >=22.12.0", + "jiti": ">=1.21.0", + "less": "^4.0.0", + "lightningcss": "^1.21.0", + "sass": "^1.70.0", + "sass-embedded": "^1.70.0", + "stylus": ">=0.54.8", + "sugarss": "^5.0.0", + "terser": "^5.16.0", + "tsx": "^4.8.1", + "yaml": "^2.4.2" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + }, + "jiti": { + "optional": true + }, + "less": { + "optional": true + }, + "lightningcss": { + "optional": true + }, + "sass": { + "optional": true + }, + "sass-embedded": { + "optional": true + }, + "stylus": { + "optional": true + }, + "sugarss": { + "optional": true + }, + "terser": { + "optional": true + }, + "tsx": { + "optional": true + }, + "yaml": { + "optional": true + } + } + }, + "node_modules/webidl-conversions": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-3.0.1.tgz", + "integrity": "sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ==", + "dev": true, + "license": "BSD-2-Clause" + }, + "node_modules/whatwg-url": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-5.0.0.tgz", + "integrity": "sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw==", + "dev": true, + "license": "MIT", + "dependencies": { + "tr46": "~0.0.3", + "webidl-conversions": "^3.0.0" + } + }, + "node_modules/wordwrap": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/wordwrap/-/wordwrap-1.0.0.tgz", + "integrity": "sha512-gvVzJFlPycKc5dZN4yPkP8w7Dc37BtP1yczEneOb4uq34pXZcvrtRTmWV8W+Ume+XCxKgbjM+nevkyFPMybd4Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/yaml": { + "version": "2.9.0", + "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.9.0.tgz", + "integrity": "sha512-2AvhNX3mb8zd6Zy7INTtSpl1F15HW6Wnqj0srWlkKLcpYl/gMIMJiyuGq2KeI2YFxUPjdlB+3Lc10seMLtL4cA==", + "dev": true, + "license": "ISC", + "peer": true, + "bin": { + "yaml": "bin.mjs" + }, + "engines": { + "node": ">= 14.6" + }, + "funding": { + "url": "https://github.com/sponsors/eemeli" + } + } + } +} diff --git a/package.json b/package.json new file mode 100644 index 0000000..b53c164 --- /dev/null +++ b/package.json @@ -0,0 +1,25 @@ +{ + "name": "aeternalis", + "private": true, + "type": "module", + "scripts": { + "generate": "node tools/generate-protocol.mjs", + "check": "tsc --noEmit -p client/tsconfig.json", + "build": "vite build --config client/vite.config.ts", + "dev": "vite --config client/vite.config.ts --host 127.0.0.1", + "test:e2e": "playwright test", + "test:contracts": "node tools/generate-protocol.mjs --check" + }, + "dependencies": { + "three": "^0.180.0", + "lucide": "^0.468.0" + }, + "devDependencies": { + "@playwright/test": "^1.55.0", + "@types/three": "^0.180.0", + "typescript": "^5.9.2", + "vite": "^7.1.0", + "quicktype-core": "^23.2.6", + "yaml": "^2.8.1" + } +} diff --git a/planning/IMPLEMENTATION-NOTES.md b/planning/IMPLEMENTATION-NOTES.md new file mode 100644 index 0000000..b4d0001 --- /dev/null +++ b/planning/IMPLEMENTATION-NOTES.md @@ -0,0 +1,29 @@ +# September 2026 implementation notes + +The original `VISION.md` remains the user-authored planning source. This addendum +records the new explicit requirement and the boundary of the first implementation. + +## Confirmed addition + +After one real-world week, a boss spawns and slowly destroys the world. When the +boss dies, living characters may move to a new server/world. A dead character is +permanently finished. Production deployment should run on Kubernetes and use a +Gitea workflow compatible with Harbor and ArgoCD. The client is browser-first, +with platform changes considered only after real performance measurements. + +## Implemented interpretation for playtesting + +The deadline is seven days by default. A shrinking circular hazard represents +world destruction over a configurable period. Victory grants persistent passage +to eligible survivors; complete collapse kills everyone still assigned to the +world. A character and its inventory/skills retain identity across successful +passages. A passage is bound to its account and can be redeemed only once per +successful world. Daily play usage carries forward with the character. + +These choices remain provisional: 30-minute destruction duration, hazard damage, +offline exposure, safe-zone behavior during the event, finite world radius, +48-unit spawn separation, and mob scaling. The current generated chunks are +heightfields; volumetric terrain and terrain deformation are not implemented. + +The full assessment, delivered scope, and follow-up work are documented under +`docs/`. No 2,000-player, security-audit, or live Kubernetes deployment claim is made. diff --git a/playwright.config.ts b/playwright.config.ts new file mode 100644 index 0000000..bbc8753 --- /dev/null +++ b/playwright.config.ts @@ -0,0 +1,11 @@ +import { defineConfig } from '@playwright/test'; + +export default defineConfig({ + testDir: './tests', timeout: 45000, workers: 1, fullyParallel: false, + use: { baseURL: 'http://127.0.0.1:18089', browserName: 'chromium', channel: process.env.PLAYWRIGHT_CHANNEL || undefined, headless: true, screenshot: 'only-on-failure', trace: 'retain-on-failure', launchOptions: { args: ['--use-angle=swiftshader', '--enable-unsafe-swiftshader'] } }, + webServer: { + command: 'node tools/dev-server.mjs', url: 'http://127.0.0.1:18089/readyz', + timeout: 180000, reuseExistingServer: false, + env: { PORT: '18089', E2E: 'true', WORLD_ID: 'e2e', DEV_SEASON_SECONDS: '3600' }, + }, +}); diff --git a/schemas/AGENTS.md b/schemas/AGENTS.md new file mode 100644 index 0000000..344038c --- /dev/null +++ b/schemas/AGENTS.md @@ -0,0 +1,4 @@ +# Shared contracts + +Edit protocol.json, then run `npm run generate`. Generated Go and TypeScript must +be committed together. Inputs additionally need semantic validation on the server. diff --git a/schemas/protocol.json b/schemas/protocol.json new file mode 100644 index 0000000..d0b3f9b --- /dev/null +++ b/schemas/protocol.json @@ -0,0 +1,82 @@ +{ + "$schema": "http://json-schema.org/draft-07/schema#", + "title": "Protocol", + "type": "object", + "additionalProperties": false, + "properties": { + "intent": {"$ref": "#/definitions/Intent"}, + "snapshot": {"$ref": "#/definitions/Snapshot"} + }, + "required": ["intent", "snapshot"], + "definitions": { + "Vec3": { + "type": "object", "additionalProperties": false, + "properties": {"x": {"type": "number"}, "y": {"type": "number"}, "z": {"type": "number"}}, + "required": ["x", "y", "z"] + }, + "Intent": { + "type": "object", "additionalProperties": false, + "properties": { + "op": {"type": "string"}, "seq": {"type": "integer"}, + "x": {"type": "number"}, "z": {"type": "number"}, "target": {"type": "string"} + }, + "required": ["op", "seq", "x", "z", "target"] + }, + "Entity": { + "type": "object", "additionalProperties": false, + "properties": { + "id": {"type": "string"}, "kind": {"type": "string"}, "name": {"type": "string"}, + "position": {"$ref": "#/definitions/Vec3"}, + "hp": {"type": "number"}, "maxHp": {"type": "number"}, + "state": {"type": "string"} + }, + "required": ["id", "kind", "name", "position", "hp", "maxHp", "state"] + }, + "Character": { + "type": "object", "additionalProperties": false, + "properties": { + "entity": {"$ref": "#/definitions/Entity"}, + "inventory": {"type": "object", "additionalProperties": {"type": "integer"}}, + "skills": {"type": "object", "additionalProperties": {"type": "integer"}}, + "playedSeconds": {"type": "number"}, "remainingSeconds": {"type": "number"}, + "kills": {"type": "integer"}, "ack": {"type": "integer"}, + "hasKeystone": {"type": "boolean"} + }, + "required": ["entity", "inventory", "skills", "playedSeconds", "remainingSeconds", "kills", "ack", "hasKeystone"] + }, + "Chunk": { + "type": "object", "additionalProperties": false, + "properties": { + "key": {"type": "string"}, "x": {"type": "integer"}, "z": {"type": "integer"}, + "size": {"type": "number"}, "resolution": {"type": "integer"}, + "heights": {"type": "array", "items": {"type": "number"}}, + "biome": {"type": "string"}, "resources": {"type": "array", "items": {"$ref": "#/definitions/Entity"}} + }, + "required": ["key", "x", "z", "size", "resolution", "heights", "biome", "resources"] + }, + "WorldInfo": { + "type": "object", "additionalProperties": false, + "properties": { + "id": {"type": "string"}, "seed": {"type": "integer"}, "phase": {"type": "string"}, + "ageSeconds": {"type": "number"}, "bossInSeconds": {"type": "number"}, + "collapseInSeconds": {"type": "number"}, "safeRadius": {"type": "number"}, + "radius": {"type": "number"}, "online": {"type": "integer"}, "capacity": {"type": "integer"}, + "bossHp": {"type": "number"}, "bossMaxHp": {"type": "number"} + }, + "required": ["id", "seed", "phase", "ageSeconds", "bossInSeconds", "collapseInSeconds", "safeRadius", "radius", "online", "capacity", "bossHp", "bossMaxHp"] + }, + "Snapshot": { + "type": "object", "additionalProperties": false, + "properties": { + "type": {"type": "string"}, "version": {"type": "integer"}, "tick": {"type": "integer"}, + "world": {"$ref": "#/definitions/WorldInfo"}, "self": {"$ref": "#/definitions/Character"}, + "entities": {"type": "array", "items": {"$ref": "#/definitions/Entity"}}, + "chunks": {"type": "array", "items": {"$ref": "#/definitions/Chunk"}}, + "chunkKeys": {"type": "array", "items": {"type": "string"}}, + "unavailableResources": {"type": "array", "items": {"type": "string"}}, + "message": {"type": "string"} + }, + "required": ["type", "version", "tick", "world", "self", "entities", "chunks", "chunkKeys", "unavailableResources", "message"] + } + } +} diff --git a/server/AGENTS.md b/server/AGENTS.md new file mode 100644 index 0000000..d22f3aa --- /dev/null +++ b/server/AGENTS.md @@ -0,0 +1,6 @@ +# Authoritative server + +`internal/game` is deterministic simulation, with no HTTP or database dependency. +`internal/store` owns durable snapshots, exclusive ownership, and atomic transfers. +`internal/transport` authenticates and validates requests before intents reach game. +Keep all balance values in `content/balance.yaml`. Test lifecycle and auth boundaries. diff --git a/server/cmd/load/main.go b/server/cmd/load/main.go new file mode 100644 index 0000000..90a3055 --- /dev/null +++ b/server/cmd/load/main.go @@ -0,0 +1,143 @@ +package main + +import ( + "bytes" + "context" + "encoding/json" + "flag" + "fmt" + "io" + "net" + "net/http" + "net/url" + "sort" + "strings" + "sync" + "sync/atomic" + "time" + + p "aeternalis/server/internal/protocol" + "github.com/coder/websocket" +) + +func main() { + base := flag.String("url", "http://127.0.0.1:18080", "loopback development world") + clients := flag.Int("clients", 20, "concurrent clients (1-100)") + duration := flag.Duration("duration", 20*time.Second, "measurement duration after connections") + flag.Parse() + u, err := url.Parse(*base) + if err != nil || net.ParseIP(u.Hostname()) == nil || !net.ParseIP(u.Hostname()).IsLoopback() { + panic("load tool only targets explicit loopback development servers") + } + if *clients < 1 || *clients > 100 { + panic("clients must be 1-100") + } + var received, frames, failures atomic.Int64 + var mu sync.Mutex + intervals := []float64{} + ctx, cancel := context.WithCancel(context.Background()) + defer cancel() + var readers, writers sync.WaitGroup + client := &http.Client{Timeout: 5 * time.Second} + post := func(path, body string, cookie *http.Cookie) (*http.Response, error) { + req, _ := http.NewRequestWithContext(ctx, "POST", *base+path, strings.NewReader(body)) + req.Header.Set("Origin", *base) + req.Header.Set("Content-Type", "application/json") + if cookie != nil { + req.AddCookie(cookie) + } + return client.Do(req) + } + for i := 0; i < *clients; i++ { + r, err := post("/auth/dev", "{}", nil) + if err != nil { + panic(err) + } + cookies := r.Cookies() + io.Copy(io.Discard, r.Body) + r.Body.Close() + if r.StatusCode != 200 || len(cookies) == 0 { + panic(fmt.Sprintf("auth status %d", r.StatusCode)) + } + r, err = post("/api/join", fmt.Sprintf(`{"name":"Load %d","passage":""}`, i), cookies[0]) + if err != nil { + panic(err) + } + data, _ := io.ReadAll(r.Body) + r.Body.Close() + if r.StatusCode != 200 { + panic(fmt.Sprintf("join %d %s", r.StatusCode, data)) + } + conn, _, err := websocket.Dial(ctx, "ws"+strings.TrimPrefix(*base, "http")+"/ws", &websocket.DialOptions{HTTPHeader: http.Header{"Origin": []string{*base}, "Cookie": []string{cookies[0].String()}}}) + if err != nil { + panic(err) + } + conn.SetReadLimit(4 << 20) + readers.Add(1) + go func() { + defer readers.Done() + defer conn.CloseNow() + last := time.Time{} + for { + _, data, err := conn.Read(ctx) + if err != nil { + if ctx.Err() == nil { + failures.Add(1) + } + return + } + now := time.Now() + if !last.IsZero() { + mu.Lock() + intervals = append(intervals, now.Sub(last).Seconds()*1000) + mu.Unlock() + } + last = now + received.Add(int64(len(data))) + frames.Add(1) + if !bytes.Contains(data, []byte(`"type":"snapshot"`)) { + failures.Add(1) + } + } + }() + writers.Add(1) + go func() { + defer writers.Done() + ticker := time.NewTicker(50 * time.Millisecond) + defer ticker.Stop() + seq := int64(0) + for { + select { + case <-ctx.Done(): + return + case <-ticker.C: + seq++ + data, _ := json.Marshal(p.Intent{Op: "move", Seq: seq}) + writeCtx, stop := context.WithTimeout(ctx, time.Second) + err := conn.Write(writeCtx, websocket.MessageText, data) + stop() + if err != nil { + return + } + } + } + }() + time.Sleep(400 * time.Millisecond) + } + baselineBytes, baselineFrames := received.Load(), frames.Load() + start := time.Now() + time.Sleep(*duration) + elapsed := time.Since(start).Seconds() + cancel() + readers.Wait() + writers.Wait() + sort.Float64s(intervals) + p95 := float64(0) + if len(intervals) > 0 { + p95 = intervals[int(float64(len(intervals)-1)*.95)] + } + fmt.Printf("clients=%d duration=%.1fs snapshots=%d payload_KiB_per_second=%.1f p95_snapshot_interval_ms=%.1f disconnects=%d\n", *clients, elapsed, frames.Load()-baselineFrames, float64(received.Load()-baselineBytes)/1024/elapsed, p95, failures.Load()) + if failures.Load() > 0 { + panic("unexpected client disconnects") + } +} diff --git a/server/cmd/world/main.go b/server/cmd/world/main.go new file mode 100644 index 0000000..e956444 --- /dev/null +++ b/server/cmd/world/main.go @@ -0,0 +1,167 @@ +package main + +import ( + "context" + "encoding/json" + "errors" + "fmt" + "log/slog" + "net" + "net/http" + "net/url" + "os" + "os/signal" + "path/filepath" + "strconv" + "strings" + "syscall" + "time" + + "aeternalis/server/content" + "aeternalis/server/internal/game" + "aeternalis/server/internal/store" + "aeternalis/server/internal/transport" +) + +func env(k, def string) string { + if v := os.Getenv(k); v != "" { + return v + } + return def +} +func run() error { + dev := env("APP_ENV", "production") == "development" + listen := env("LISTEN_ADDR", "127.0.0.1:18080") + base := env("PUBLIC_URL", "http://127.0.0.1:18080") + if dev { + host, _, err := net.SplitHostPort(listen) + if err != nil || net.ParseIP(host) == nil || !net.ParseIP(host).IsLoopback() { + return errors.New("development auth requires an explicit loopback listen address") + } + u, err := url.Parse(base) + if err != nil || net.ParseIP(u.Hostname()) == nil || !net.ParseIP(u.Hostname()).IsLoopback() { + return errors.New("development PUBLIC_URL must be loopback") + } + } + if !dev && os.Getenv("DATABASE_URL") == "" { + return errors.New("production requires DATABASE_URL") + } + dsn := env("DATABASE_URL", "file:../.local/aeternalis.db") + if !dev && !(strings.HasPrefix(dsn, "postgres://") || strings.HasPrefix(dsn, "postgresql://")) { + return errors.New("production requires PostgreSQL") + } + if !dev { + u, err := url.Parse(dsn) + if err != nil || u.Query().Get("sslmode") != "verify-full" { + return errors.New("production DATABASE_URL requires sslmode=verify-full") + } + } + if dev && strings.HasPrefix(dsn, "file:") { + path := strings.Split(strings.TrimPrefix(dsn, "file:"), "?")[0] + if err := os.MkdirAll(filepath.Dir(path), 0700); err != nil { + return err + } + } + b, err := content.Load() + if err != nil { + return err + } + if dev { + for key, dest := range map[string]*float64{"DEV_SEASON_SECONDS": &b.SeasonSeconds, "DEV_COLLAPSE_SECONDS": &b.CollapseSeconds, "DEV_DAILY_SECONDS": &b.DailyPlaySeconds} { + if raw := os.Getenv(key); raw != "" { + value, err := strconv.ParseFloat(raw, 64) + if err != nil { + return err + } + *dest = value + } + } + } + if err = b.Validate(); err != nil { + return err + } + seed, err := strconv.ParseInt(env("WORLD_SEED", "734291"), 10, 64) + if err != nil { + return err + } + id := env("WORLD_ID", "world-001") + if len(id) > 64 || strings.ContainsAny(id, "/\\ \t\n") { + return errors.New("invalid WORLD_ID") + } + ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second) + defer cancel() + db, err := store.Open(ctx, dsn) + if err != nil { + return err + } + defer db.Close() + w := game.New(id, seed, time.Now().UTC(), b) + lease, raw, err := db.Acquire(ctx, w) + if err != nil { + return fmt.Errorf("acquire world: %w", err) + } + released := false + defer func() { + if !released { + ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second) + defer cancel() + _ = lease.Release(ctx) + } + }() + if err = json.Unmarshal(raw, w); err != nil { + return err + } + if err = w.Restore(time.Now().UTC()); err != nil { + return err + } + auth, err := transport.NewAuth(ctx, db, dev, base, os.Getenv("OIDC_ISSUER"), os.Getenv("OIDC_CLIENT_ID"), os.Getenv("OIDC_CLIENT_SECRET")) + if err != nil { + return err + } + worlds := []transport.Destination{} + if raw := os.Getenv("WORLD_DIRECTORY"); raw != "" { + if err = json.Unmarshal([]byte(raw), &worlds); err != nil { + return err + } + for _, dest := range worlds { + u, err := url.Parse(dest.URL) + if err != nil || u.Host == "" || (!dev && u.Scheme != "https") || u.User != nil { + return errors.New("invalid WORLD_DIRECTORY URL") + } + } + } + svc := transport.NewService(w, lease) + handler := transport.NewHTTP(svc, auth, env("CLIENT_DIR", "../client/dist"), worlds).Handler() + server := &http.Server{Addr: listen, Handler: handler, ReadHeaderTimeout: 5 * time.Second, ReadTimeout: 15 * time.Second, WriteTimeout: 15 * time.Second, IdleTimeout: 60 * time.Second, MaxHeaderBytes: 16384} + runtimeCtx, stop := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM) + defer stop() + go svc.Run(runtimeCtx) + errorsCh := make(chan error, 1) + go func() { + slog.Info("world listening", "url", base, "world", id, "development", dev) + errorsCh <- server.ListenAndServe() + }() + select { + case <-runtimeCtx.Done(): + case err = <-errorsCh: + if !errors.Is(err, http.ErrServerClosed) { + return err + } + } + stop() + shutdown, cancelShutdown := context.WithTimeout(context.Background(), 10*time.Second) + defer cancelShutdown() + err = svc.Stop(shutdown) + released = true + httpErr := server.Shutdown(shutdown) + if err != nil { + return err + } + return httpErr +} +func main() { + if err := run(); err != nil { + slog.Error("world stopped", "error", err) + os.Exit(1) + } +} diff --git a/server/content/balance.yaml b/server/content/balance.yaml new file mode 100644 index 0000000..17dca40 --- /dev/null +++ b/server/content/balance.yaml @@ -0,0 +1,48 @@ +version: 1 +tickHz: 20 +snapshotHz: 5 +chunkSize: 128 +terrainResolution: 16 +worldRadius: 1024 +maxPlayers: 100 +spawnSeparation: 48 +seasonSeconds: 604800 +collapseSeconds: 1800 +dailyPlaySeconds: 7200 +playerHp: 100 +playerSpeed: 12 +attackRange: 6 +attackCooldown: 0.7 +playerDamage: 18 +spearDamage: 32 +gatherRange: 7 +gatherCooldown: 0.6 +bossHp: 1200 +bossDamage: 18 +bossRange: 12 +bossCooldown: 2 +stormDamagePerSecond: 15 +mobHp: 54 +mobDamage: 6 +mobSpeed: 4 +mobAggroRange: 24 +mobAttackRange: 3 +mobCooldown: 1.8 +mobRespawnSeconds: 40 +mobScalePerDay: 0.1 +resourcesPerChunk: 48 +resourceRespawnSeconds: 120 +skillXpPerAction: 1 +startingKit: + knife: 1 + axe: 1 + flint_and_steel: 1 + fishing_pole: 1 +recipes: + spear: + inputs: { wood: 3, ore: 2 } + outputs: { spear: 1 } + bandage: + inputs: { herb: 2 } + outputs: { bandage: 1 } +bandageHealing: 35 diff --git a/server/content/content.go b/server/content/content.go new file mode 100644 index 0000000..1a7e915 --- /dev/null +++ b/server/content/content.go @@ -0,0 +1,117 @@ +package content + +import ( + "bytes" + _ "embed" + "fmt" + "math" + "reflect" + + "go.yaml.in/yaml/v3" +) + +//go:embed balance.yaml +var balance []byte + +type Recipe struct { + Inputs map[string]int64 `yaml:"inputs"` + Outputs map[string]int64 `yaml:"outputs"` +} + +type Balance struct { + Version int `yaml:"version"` + TickHz int `yaml:"tickHz"` + SnapshotHz int `yaml:"snapshotHz"` + ChunkSize float64 `yaml:"chunkSize"` + TerrainResolution int `yaml:"terrainResolution"` + WorldRadius float64 `yaml:"worldRadius"` + MaxPlayers int `yaml:"maxPlayers"` + SpawnSeparation float64 `yaml:"spawnSeparation"` + SeasonSeconds float64 `yaml:"seasonSeconds"` + CollapseSeconds float64 `yaml:"collapseSeconds"` + DailyPlaySeconds float64 `yaml:"dailyPlaySeconds"` + PlayerHp float64 `yaml:"playerHp"` + PlayerSpeed float64 `yaml:"playerSpeed"` + AttackRange float64 `yaml:"attackRange"` + AttackCooldown float64 `yaml:"attackCooldown"` + PlayerDamage float64 `yaml:"playerDamage"` + SpearDamage float64 `yaml:"spearDamage"` + GatherRange float64 `yaml:"gatherRange"` + GatherCooldown float64 `yaml:"gatherCooldown"` + BossHp float64 `yaml:"bossHp"` + BossDamage float64 `yaml:"bossDamage"` + BossRange float64 `yaml:"bossRange"` + BossCooldown float64 `yaml:"bossCooldown"` + StormDamagePerSecond float64 `yaml:"stormDamagePerSecond"` + MobHp float64 `yaml:"mobHp"` + MobDamage float64 `yaml:"mobDamage"` + MobSpeed float64 `yaml:"mobSpeed"` + MobAggroRange float64 `yaml:"mobAggroRange"` + MobAttackRange float64 `yaml:"mobAttackRange"` + MobCooldown float64 `yaml:"mobCooldown"` + MobRespawnSeconds float64 `yaml:"mobRespawnSeconds"` + MobScalePerDay float64 `yaml:"mobScalePerDay"` + ResourcesPerChunk int `yaml:"resourcesPerChunk"` + ResourceRespawnSeconds float64 `yaml:"resourceRespawnSeconds"` + SkillXpPerAction int64 `yaml:"skillXpPerAction"` + StartingKit map[string]int64 `yaml:"startingKit"` + Recipes map[string]Recipe `yaml:"recipes"` + BandageHealing float64 `yaml:"bandageHealing"` +} + +func Load() (Balance, error) { return Parse(balance) } +func Parse(data []byte) (Balance, error) { + var b Balance + d := yaml.NewDecoder(bytes.NewReader(data)) + d.KnownFields(true) + if err := d.Decode(&b); err != nil { + return b, err + } + return b, b.Validate() +} +func (b Balance) Validate() error { + v := reflect.ValueOf(b) + for i := 0; i < v.NumField(); i++ { + f := v.Field(i) + n := float64(1) + switch f.Kind() { + case reflect.Int, reflect.Int64: + n = float64(f.Int()) + case reflect.Float64: + n = f.Float() + } + if n <= 0 || math.IsNaN(n) || math.IsInf(n, 0) { + return fmt.Errorf("%s must be finite and positive", v.Type().Field(i).Name) + } + } + if b.TickHz > 60 || b.SnapshotHz > b.TickHz || b.TickHz%b.SnapshotHz != 0 || b.TerrainResolution > 64 || b.ResourcesPerChunk > 128 || b.MaxPlayers > 2000 || b.WorldRadius < b.ChunkSize*2 { + return fmt.Errorf("invalid capacity, terrain, or tick configuration") + } + known := map[string]bool{"knife": true, "axe": true, "flint_and_steel": true, "fishing_pole": true, "wood": true, "ore": true, "herb": true, "spear": true, "bandage": true} + check := func(items map[string]int64) error { + if len(items) == 0 { + return fmt.Errorf("empty item list") + } + for k, n := range items { + if !known[k] || n < 1 || n > 1000 { + return fmt.Errorf("invalid item %q quantity %d", k, n) + } + } + return nil + } + if err := check(b.StartingKit); err != nil { + return err + } + for name, r := range b.Recipes { + if !known[name] { + return fmt.Errorf("unknown recipe %q", name) + } + if err := check(r.Inputs); err != nil { + return err + } + if err := check(r.Outputs); err != nil { + return err + } + } + return nil +} diff --git a/server/content/content_test.go b/server/content/content_test.go new file mode 100644 index 0000000..6b6cc21 --- /dev/null +++ b/server/content/content_test.go @@ -0,0 +1,17 @@ +package content + +import "testing" + +func TestBalanceValidation(t *testing.T) { + b, err := Load() + if err != nil { + t.Fatal(err) + } + b.PlayerSpeed = -1 + if b.Validate() == nil { + t.Fatal("negative speed accepted") + } + if _, err = Parse([]byte("unexpected: 1")); err == nil { + t.Fatal("unknown content key accepted") + } +} diff --git a/server/go.mod b/server/go.mod new file mode 100644 index 0000000..2857079 --- /dev/null +++ b/server/go.mod @@ -0,0 +1,31 @@ +module aeternalis/server + +go 1.26.0 + +require ( + github.com/coder/websocket v1.8.15 + github.com/coreos/go-oidc/v3 v3.21.0 + github.com/jackc/pgx/v5 v5.10.0 + github.com/ojrac/opensimplex-go v1.0.2 + go.yaml.in/yaml/v3 v3.0.5 + golang.org/x/oauth2 v0.36.0 + modernc.org/sqlite v1.58.0 +) + +require ( + github.com/dustin/go-humanize v1.0.1 // indirect + github.com/go-jose/go-jose/v4 v4.1.4 // indirect + github.com/google/uuid v1.6.0 // indirect + github.com/jackc/pgpassfile v1.0.0 // indirect + github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 // indirect + github.com/jackc/puddle/v2 v2.2.2 // indirect + github.com/mattn/go-isatty v0.0.24 // indirect + github.com/ncruces/go-strftime v1.0.0 // indirect + github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec // indirect + golang.org/x/sync v0.22.0 // indirect + golang.org/x/sys v0.47.0 // indirect + golang.org/x/text v0.29.0 // indirect + modernc.org/libc v1.75.6 // indirect + modernc.org/mathutil v1.7.1 // indirect + modernc.org/memory v1.12.1 // indirect +) diff --git a/server/go.sum b/server/go.sum new file mode 100644 index 0000000..12cd30f --- /dev/null +++ b/server/go.sum @@ -0,0 +1,86 @@ +github.com/coder/websocket v1.8.15 h1:6B2JPeOGlpff2Uz6vOEH1Vzpi0iUz20A+lPVhPHtNUA= +github.com/coder/websocket v1.8.15/go.mod h1:NX3SzP+inril6yawo5CQXx8+fk145lPDC6pumgx0mVg= +github.com/coreos/go-oidc/v3 v3.21.0 h1:wZo4Q9Pum8dYEj0eMUPrqR+kvuGkeUplbLpNCkBqoWM= +github.com/coreos/go-oidc/v3 v3.21.0/go.mod h1:DYCf24+ncYi+XkIH97GY1+dqoRlbaSI26KVTCI9SrY4= +github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c= +github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkpeCY= +github.com/dustin/go-humanize v1.0.1/go.mod h1:Mu1zIs6XwVuF/gI1OepvI0qD18qycQx+mFykh5fBlto= +github.com/go-jose/go-jose/v4 v4.1.4 h1:moDMcTHmvE6Groj34emNPLs/qtYXRVcd6S7NHbHz3kA= +github.com/go-jose/go-jose/v4 v4.1.4/go.mod h1:x4oUasVrzR7071A4TnHLGSPpNOm2a21K9Kf04k1rs08= +github.com/google/pprof v0.0.0-20260802141513-ef3492d7dac3 h1:LMLX+LgTNWpfvCBdFebv6EsYotImrt/Ppc5cXIriCSo= +github.com/google/pprof v0.0.0-20260802141513-ef3492d7dac3/go.mod h1:jl5iWTm0/hd5PjEYEOuwAJ57L/CibdZfrqZ5XA5GrCk= +github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0= +github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= +github.com/hashicorp/golang-lru/v2 v2.0.7 h1:a+bsQ5rvGLjzHuww6tVxozPZFVghXaHOwFs4luLUK2k= +github.com/hashicorp/golang-lru/v2 v2.0.7/go.mod h1:QeFd9opnmA6QUJc5vARoKUSoFhyfM2/ZepoAG6RGpeM= +github.com/jackc/pgpassfile v1.0.0 h1:/6Hmqy13Ss2zCq62VdNG8tM1wchn8zjSGOBJ6icpsIM= +github.com/jackc/pgpassfile v1.0.0/go.mod h1:CEx0iS5ambNFdcRtxPj5JhEz+xB6uRky5eyVu/W2HEg= +github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 h1:iCEnooe7UlwOQYpKFhBabPMi4aNAfoODPEFNiAnClxo= +github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761/go.mod h1:5TJZWKEWniPve33vlWYSoGYefn3gLQRzjfDlhSJ9ZKM= +github.com/jackc/pgx/v5 v5.10.0 h1:VhSvgU2jSli8o3AqIEOTJr7rZwAEUVo4E4XhR94Zfr0= +github.com/jackc/pgx/v5 v5.10.0/go.mod h1:mal1tBGAFfLHvZzaYh77YS/eC6IX9OWbRV1QIIM0Jn4= +github.com/jackc/puddle/v2 v2.2.2 h1:PR8nw+E/1w0GLuRFSmiioY6UooMp6KJv0/61nB7icHo= +github.com/jackc/puddle/v2 v2.2.2/go.mod h1:vriiEXHvEE654aYKXXjOvZM39qJ0q+azkZFrfEOc3H4= +github.com/mattn/go-isatty v0.0.24 h1:tGZZoVgT/KiqK1c8ocVLeDS8BSWMRd47J3Lbz7vsReI= +github.com/mattn/go-isatty v0.0.24/go.mod h1:nMCL3Zebbrt45jsMDgnfIwz6ydEQApk5oEI3HqDio6A= +github.com/ncruces/go-strftime v1.0.0 h1:HMFp8mLCTPp341M/ZnA4qaf7ZlsbTc+miZjCLOFAw7w= +github.com/ncruces/go-strftime v1.0.0/go.mod h1:Fwc5htZGVVkseilnfgOVb9mKy6w1naJmn9CehxcKcls= +github.com/ojrac/opensimplex-go v1.0.2 h1:l4vs0D+JCakcu5OV0kJ99oEaWJfggSc9jiLpxaWvSzs= +github.com/ojrac/opensimplex-go v1.0.2/go.mod h1:NwbXFFbXcdGgIFdiA7/REME+7n/lOf1TuEbLiZYOWnM= +github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= +github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= +github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec h1:W09IVJc94icq4NjY3clb7Lk8O1qJ8BdBEF8z0ibU0rE= +github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec/go.mod h1:qqbHyh8v60DhA7CoWK5oRCqLrMHRGoxYCSS9EjAz6Eo= +github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= +github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI= +github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= +github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U= +github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U= +go.yaml.in/yaml/v3 v3.0.5 h1:N6y/pJk8buWs9NY5ERU2HSMfm+IuD/OtfdAnq6kESPw= +go.yaml.in/yaml/v3 v3.0.5/go.mod h1:HVTZu1O7/Vkt2N+BFy8Zza+lnLsABggaTM2ZpNIGuKg= +golang.org/x/mod v0.38.0 h1:MECBjubtXD7yj4HrhIUcywNaGeNVUdfVnxmPajOk4yk= +golang.org/x/mod v0.38.0/go.mod h1:V6Xz0pq8TQ3dGqVQ1FVHuelZpAL0uNhSkk9ogYP3c40= +golang.org/x/oauth2 v0.36.0 h1:peZ/1z27fi9hUOFCAZaHyrpWG5lwe0RJEEEeH0ThlIs= +golang.org/x/oauth2 v0.36.0/go.mod h1:YDBUJMTkDnJS+A4BP4eZBjCqtokkg1hODuPjwiGPO7Q= +golang.org/x/sync v0.22.0 h1:SZjpbeLmrCk4xhRSZFNZW5gFUeCeFgjekvI/+gfScek= +golang.org/x/sync v0.22.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0= +golang.org/x/sys v0.47.0 h1:o7XGOvZQCADBQQ4Y7VNq2dRWQR7JmOUW8Kxx4ZsNgWs= +golang.org/x/sys v0.47.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw= +golang.org/x/text v0.29.0 h1:1neNs90w9YzJ9BocxfsQNHKuAT4pkghyXc4nhZ6sJvk= +golang.org/x/text v0.29.0/go.mod h1:7MhJOA9CD2qZyOKYazxdYMF85OwPdEr9jTtBpO7ydH4= +golang.org/x/tools v0.48.0 h1:3+hClM1aLL5mjMKm5ovokw9epgRXPuu2tILgismM6RE= +golang.org/x/tools v0.48.0/go.mod h1:08xX0orndb/F7jJxGDicx061tyd5pcMto75YMAXr6lk= +gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= +gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= +gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA= +gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= +modernc.org/cc/v4 v4.29.2 h1:h6+9ciCnPKutf4I03CvheAvDLX7+IHlqR6Iy6J+cgd8= +modernc.org/cc/v4 v4.29.2/go.mod h1:OnovgIhbbMXMu1aISnJ0wvVD1KnW+cAUJkIrAWh+kVI= +modernc.org/ccgo/v4 v4.35.0 h1:F+TUsmw09QxLzmi3aeYYGxjAXarmZaKgj3mKQHNaA8w= +modernc.org/ccgo/v4 v4.35.0/go.mod h1:qrVGs9S3Sr2Ztcg9ve+kTAYMp5a3YvWjo+SoN06kJ5I= +modernc.org/fileutil v1.4.0 h1:j6ZzNTftVS054gi281TyLjHPp6CPHr2KCxEXjEbD6SM= +modernc.org/fileutil v1.4.0/go.mod h1:EqdKFDxiByqxLk8ozOxObDSfcVOv/54xDs/DUHdvCUU= +modernc.org/gc/v2 v2.6.5 h1:nyqdV8q46KvTpZlsw66kWqwXRHdjIlJOhG6kxiV/9xI= +modernc.org/gc/v2 v2.6.5/go.mod h1:YgIahr1ypgfe7chRuJi2gD7DBQiKSLMPgBQe9oIiito= +modernc.org/gc/v3 v3.1.5 h1:21ldfPfRYE31Tb7B3mwAK8gy1AxP4+dKjrOQPfqakoc= +modernc.org/gc/v3 v3.1.5/go.mod h1:HFK/6AGESC7Ex+EZJhJ2Gni6cTaYpSMmU/cT9RmlfYY= +modernc.org/goabi0 v0.2.0 h1:HvEowk7LxcPd0eq6mVOAEMai46V+i7Jrj13t4AzuNks= +modernc.org/goabi0 v0.2.0/go.mod h1:CEFRnnJhKvWT1c1JTI3Avm+tgOWbkOu5oPA8eH8LnMI= +modernc.org/libc v1.75.6 h1:yKk8qo+Di4gkmvRboK8ocCqH22FiUCR6jRy2OwtCRus= +modernc.org/libc v1.75.6/go.mod h1:bO5o2ztHxBb2rjz0PgdHN0sSMw57CgxGFLZ3Qd/QpVQ= +modernc.org/mathutil v1.7.1 h1:GCZVGXdaN8gTqB1Mf/usp1Y/hSqgI2vAGGP4jZMCxOU= +modernc.org/mathutil v1.7.1/go.mod h1:4p5IwJITfppl0G4sUEDtCr4DthTaT47/N3aT6MhfgJg= +modernc.org/memory v1.12.1 h1:nFMiWrpStgZczNl6XI9GnIk/rWhYIyHGUaR04pGbp9g= +modernc.org/memory v1.12.1/go.mod h1:/JP4VbVC+K5sU2wZi9bHoq2MAkCnrt2r98UGeSK7Mjw= +modernc.org/opt v0.2.0 h1:tGyef5ApycA7FSEOMraay9SaTk5zmbx7Tu+cJs4QKZg= +modernc.org/opt v0.2.0/go.mod h1:03fq9lsNfvkYSfxrfUhZCWPk1lm4cq4N+Bh//bEtgns= +modernc.org/sortutil v1.2.1 h1:+xyoGf15mM3NMlPDnFqrteY07klSFxLElE2PVuWIJ7w= +modernc.org/sortutil v1.2.1/go.mod h1:7ZI3a3REbai7gzCLcotuw9AC4VZVpYMjDzETGsSMqJE= +modernc.org/sqlite v1.58.0 h1:38u40/bwkfM7f0Myhosl+SEMltSDxnGdQf8o6Kjmys0= +modernc.org/sqlite v1.58.0/go.mod h1:rsD2CckafgObKC4DhBlGBf+RiHxkc3hINGt1Xw32tVY= +modernc.org/strutil v1.2.1 h1:UneZBkQA+DX2Rp35KcM69cSsNES9ly8mQWD71HKlOA0= +modernc.org/strutil v1.2.1/go.mod h1:EHkiggD70koQxjVdSBM3JKM7k6L0FbGE5eymy9i3B9A= +modernc.org/token v1.1.0 h1:Xl7Ap9dKaEs5kLoOQeQmPWevfnk/DM5qcLcYlA8ys6Y= +modernc.org/token v1.1.0/go.mod h1:UGzOrNV1mAFSEB63lOFHIpNRUVMvYTc6yu1SMY/XTDM= diff --git a/server/internal/game/terrain.go b/server/internal/game/terrain.go new file mode 100644 index 0000000..79cd634 --- /dev/null +++ b/server/internal/game/terrain.go @@ -0,0 +1,69 @@ +package game + +import ( + "fmt" + "math" + "math/rand/v2" + + "aeternalis/server/content" + p "aeternalis/server/internal/protocol" + "github.com/ojrac/opensimplex-go" +) + +const GeneratorVersion = 1 + +type Terrain struct { + Seed int64 + B content.Balance + noise opensimplex.Noise +} + +func NewTerrain(seed int64, b content.Balance) *Terrain { + return &Terrain{seed, b, opensimplex.New(seed)} +} +func (t *Terrain) rawHeight(x, z float64) float64 { + // A low, flat arrival clearing blends into broad hills and fine detail. + d := math.Min(1, math.Hypot(x, z)/55) + return (t.noise.Eval2(x/220, z/220)*17 + t.noise.Eval2(x/55, z/55)*3) * d +} +func ChunkCoord(v, size float64) int { return int(math.Floor(v / size)) } +func Key(x, z int) string { return fmt.Sprintf("%d:%d", x, z) } + +// Height uses the same triangle split as the transmitted terrain mesh. +func (t *Terrain) Height(x, z float64) float64 { + step := t.B.ChunkSize / float64(t.B.TerrainResolution) + ix, iz := math.Floor(x/step), math.Floor(z/step) + fx, fz := x/step-ix, z/step-iz + a, b := t.rawHeight(ix*step, iz*step), t.rawHeight((ix+1)*step, iz*step) + c, d := t.rawHeight(ix*step, (iz+1)*step), t.rawHeight((ix+1)*step, (iz+1)*step) + if fx+fz <= 1 { + return a + (b-a)*fx + (c-a)*fz + } + return d + (c-d)*(1-fx) + (b-d)*(1-fz) +} +func (t *Terrain) Position(x, z float64) p.Vec3 { return p.Vec3{X: x, Y: t.Height(x, z), Z: z} } +func (t *Terrain) Chunk(x, z int) p.Chunk { + c := p.Chunk{Key: Key(x, z), X: int64(x), Z: int64(z), Size: t.B.ChunkSize, Resolution: int64(t.B.TerrainResolution), Biome: "highlands", Heights: []float64{}, Resources: []p.Entity{}} + for iz := 0; iz <= t.B.TerrainResolution; iz++ { + for ix := 0; ix <= t.B.TerrainResolution; ix++ { + c.Heights = append(c.Heights, t.rawHeight(float64(x)*c.Size+float64(ix)*c.Size/float64(c.Resolution), float64(z)*c.Size+float64(iz)*c.Size/float64(c.Resolution))) + } + } + rng := rand.New(rand.NewPCG(uint64(t.Seed)^uint64(int64(x)*73856093), uint64(int64(z)*19349663)^0xa341316c)) + kinds := []string{"tree", "ore", "herb"} + for i := 0; i < t.B.ResourcesPerChunk; i++ { + px, pz := (float64(x)+0.08+rng.Float64()*0.84)*c.Size, (float64(z)+0.08+rng.Float64()*0.84)*c.Size + if math.Hypot(px, pz) > t.B.WorldRadius || math.Hypot(px, pz) < 10 { + continue + } + kind := kinds[i%len(kinds)] + c.Resources = append(c.Resources, p.Entity{ID: fmt.Sprintf("r:%d:%d:%d", x, z, i), Kind: kind, Name: kind, Position: t.Position(px, pz), HP: 1, MaxHP: 1, State: "available"}) + } + // Arrival resources make the first crafting loop reachable without aimless travel. + if x == 0 && z == 0 { + for i, k := range kinds { + c.Resources = append(c.Resources, p.Entity{ID: "arrival:" + k, Kind: k, Name: k, Position: t.Position(12+float64(i)*5, 12), HP: 1, MaxHP: 1, State: "available"}) + } + } + return c +} diff --git a/server/internal/game/world.go b/server/internal/game/world.go new file mode 100644 index 0000000..b861856 --- /dev/null +++ b/server/internal/game/world.go @@ -0,0 +1,648 @@ +package game + +import ( + "crypto/rand" + "encoding/hex" + "errors" + "fmt" + "math" + "sort" + "time" + + "aeternalis/server/content" + p "aeternalis/server/internal/protocol" +) + +type Character struct { + View p.Character `json:"view"` + Account string `json:"account"` + Day string `json:"day"` + DailySeconds float64 `json:"dailySeconds"` + ReturnPosition *p.Vec3 `json:"returnPosition,omitempty"` + Sheltered bool `json:"sheltered"` + LastAttack float64 `json:"lastAttack"` + LastGather float64 `json:"lastGather"` + Online bool `json:"-"` + MoveX float64 `json:"-"` + MoveZ float64 `json:"-"` + LastMove time.Time `json:"-"` + Message string `json:"-"` +} +type Corpse struct { + Entity p.Entity `json:"entity"` + Inventory map[string]int64 `json:"inventory"` +} +type Mob struct { + Entity p.Entity `json:"entity"` + HomeX int `json:"homeX"` + HomeZ int `json:"homeZ"` + LastAttack float64 `json:"lastAttack"` + RespawnAt float64 `json:"respawnAt"` +} +type World struct { + Version int `json:"version"` + ID string `json:"id"` + Seed int64 `json:"seed"` + CreatedAt time.Time `json:"createdAt"` + EndedAt *time.Time `json:"endedAt,omitempty"` + Phase string `json:"phase"` + Tick int64 `json:"tick"` + BossHP float64 `json:"bossHp"` + BossLastAttack float64 `json:"bossLastAttack"` + Characters map[string]*Character `json:"characters"` + Corpses map[string]*Corpse `json:"corpses"` + Depleted map[string]float64 `json:"depleted"` + Mobs map[string]*Mob `json:"mobs"` + Balance content.Balance `json:"balance"` + terrain *Terrain + chunks map[string]p.Chunk + now time.Time + dirty bool +} + +func ID() string { + var b [16]byte + if _, err := rand.Read(b[:]); err != nil { + panic(err) + } + return hex.EncodeToString(b[:]) +} +func New(id string, seed int64, now time.Time, b content.Balance) *World { + w := &World{Version: GeneratorVersion, ID: id, Seed: seed, CreatedAt: now, Phase: "gathering", BossHP: b.BossHp, Characters: map[string]*Character{}, Corpses: map[string]*Corpse{}, Depleted: map[string]float64{}, Mobs: map[string]*Mob{}, Balance: b} + _ = w.Restore(now) + return w +} +func (w *World) Restore(now time.Time) error { + if w.Version != GeneratorVersion { + return errors.New("unsupported persisted generator version") + } + if err := w.Balance.Validate(); err != nil { + return err + } + if w.Characters == nil || w.Mobs == nil || w.Corpses == nil || w.Depleted == nil { + return errors.New("invalid world snapshot") + } + w.terrain = NewTerrain(w.Seed, w.Balance) + w.chunks = map[string]p.Chunk{} + w.now = now + for _, c := range w.Characters { + c.Online = false + c.MoveX = 0 + c.MoveZ = 0 + c.View.ACK = 0 + } + return nil +} +func (w *World) Age() float64 { + now := w.now + if w.EndedAt != nil { + now = *w.EndedAt + } + return math.Max(0, now.Sub(w.CreatedAt).Seconds()) +} +func (w *World) Dirty() bool { return w.dirty } +func (w *World) Saved() { w.dirty = false } +func (w *World) SafeRadius() float64 { + if w.Phase == "gathering" { + return w.Balance.WorldRadius + } + if w.Phase == "lost" { + return 0 + } + return math.Max(0, w.Balance.WorldRadius*(1-(w.Age()-w.Balance.SeasonSeconds)/w.Balance.CollapseSeconds)) +} +func (w *World) Info() p.WorldInfo { + online := int64(0) + for _, c := range w.Characters { + if c.Online { + online++ + } + } + return p.WorldInfo{ID: w.ID, Seed: w.Seed, Phase: w.Phase, AgeSeconds: w.Age(), BossInSeconds: math.Max(0, w.Balance.SeasonSeconds-w.Age()), CollapseInSeconds: math.Max(0, w.Balance.SeasonSeconds+w.Balance.CollapseSeconds-w.Age()), SafeRadius: w.SafeRadius(), Radius: w.Balance.WorldRadius, Online: online, Capacity: int64(w.Balance.MaxPlayers), BossHP: w.BossHP, BossMaxHP: w.Balance.BossHp} +} +func (w *World) ForAccount(account string) *Character { + for _, c := range w.Characters { + if c.Account == account { + return c + } + } + return nil +} +func (w *World) spawn(exclude string) (p.Vec3, error) { + for i := 0; i < 4096; i++ { + radius := math.Sqrt(float64(i)) * w.Balance.SpawnSeparation * 0.6 + angle := float64(i) * 2.399963229728653 + pos := w.terrain.Position(math.Cos(angle)*radius, math.Sin(angle)*radius) + if radius > w.Balance.WorldRadius-32 { + break + } + clear := true + for id, c := range w.Characters { + if id != exclude && c.View.Entity.State != "dead" && distance(pos, c.View.Entity.Position) < w.Balance.SpawnSeparation { + clear = false + break + } + } + if clear { + return pos, nil + } + } + return p.Vec3{}, errors.New("no separated spawn available") +} +func (w *World) Join(account, name string) (*Character, error) { + if c := w.ForAccount(account); c != nil { + return c, nil + } + if w.Phase != "gathering" { + return nil, errors.New("this world is closed to new arrivals") + } + if len(w.Characters) >= w.Balance.MaxPlayers { + return nil, errors.New("world capacity reached") + } + pos, err := w.spawn("") + if err != nil { + return nil, err + } + c := &Character{Account: account, Day: w.now.UTC().Format(time.DateOnly), View: p.Character{Entity: p.Entity{ID: ID(), Kind: "player", Name: name, Position: pos, HP: w.Balance.PlayerHp, MaxHP: w.Balance.PlayerHp, State: "alive"}, Inventory: map[string]int64{}, Skills: map[string]int64{}, RemainingSeconds: w.Balance.DailyPlaySeconds}} + for k, v := range w.Balance.StartingKit { + c.View.Inventory[k] = v + } + w.Characters[c.View.Entity.ID] = c + w.dirty = true + return c, nil +} +func (w *World) Import(c *Character) error { + if w.Phase != "gathering" || w.ForAccount(c.Account) != nil || len(w.Characters) >= w.Balance.MaxPlayers { + return errors.New("destination cannot accept character") + } + if c.View.Entity.State != "eligible" || c.View.Entity.HP <= 0 { + return errors.New("character is not a living survivor") + } + pos, err := w.spawn("") + if err != nil { + return err + } + c.View.Entity.Position = pos + c.View.Entity.State = "alive" + c.Online = false + c.MoveX = 0 + c.MoveZ = 0 + c.View.ACK = 0 + c.LastAttack = 0 + c.LastGather = 0 + c.ReturnPosition = nil + c.Sheltered = false + c.View.HasKeystone = false + w.resetDay(c) + w.Characters[c.View.Entity.ID] = c + w.dirty = true + return nil +} +func (w *World) resetDay(c *Character) { + day := w.now.UTC().Format(time.DateOnly) + if c.Day != day { + c.Day = day + c.DailySeconds = 0 + w.dirty = true + } + c.View.RemainingSeconds = math.Max(0, w.Balance.DailyPlaySeconds-c.DailySeconds) +} +func (w *World) Connect(id string) error { + c := w.Characters[id] + if c == nil { + return errors.New("character not found") + } + w.resetDay(c) + if c.View.Entity.State == "dead" { + return errors.New("this character has died permanently") + } + if c.View.RemainingSeconds <= 0 { + return errors.New("daily play limit reached; resets at 00:00 UTC") + } + if c.Online { + return errors.New("character already connected") + } + c.Online = true + c.View.ACK = 0 + c.MoveX = 0 + c.MoveZ = 0 + return nil +} +func (w *World) Disconnect(id string) { + if c := w.Characters[id]; c != nil { + c.Online = false + c.MoveX = 0 + c.MoveZ = 0 + } +} +func distance(a, b p.Vec3) float64 { return math.Hypot(a.X-b.X, a.Z-b.Z) } +func (w *World) chunk(x, z int) p.Chunk { + key := Key(x, z) + if c, ok := w.chunks[key]; ok { + return c + } + c := w.terrain.Chunk(x, z) + w.chunks[key] = c + return c +} +func (w *World) neighbors(pos p.Vec3) []p.Chunk { + x, z := ChunkCoord(pos.X, w.Balance.ChunkSize), ChunkCoord(pos.Z, w.Balance.ChunkSize) + chunks := make([]p.Chunk, 0, 9) + for dz := -1; dz <= 1; dz++ { + for dx := -1; dx <= 1; dx++ { + chunks = append(chunks, w.chunk(x+dx, z+dz)) + } + } + return chunks +} +func (w *World) Intent(id string, i p.Intent) error { + c := w.Characters[id] + if c == nil || !c.Online || c.View.Entity.State != "alive" || w.Phase == "won" || w.Phase == "lost" { + return errors.New("character cannot act") + } + if i.Seq <= c.View.ACK || i.Seq > c.View.ACK+10000 { + return errors.New("invalid input sequence") + } + if math.IsNaN(i.X) || math.IsNaN(i.Z) || math.IsInf(i.X, 0) || math.IsInf(i.Z, 0) || math.Abs(i.X) > 1 || math.Abs(i.Z) > 1 || len(i.Target) > 100 { + return errors.New("invalid intent") + } + c.View.ACK = i.Seq + if c.Sheltered && ((i.Op == "move" && (i.X != 0 || i.Z != 0)) || (i.Op != "move" && i.Op != "heal")) { + c.Sheltered = false + w.dirty = true + } + switch i.Op { + case "move": + n := math.Max(1, math.Hypot(i.X, i.Z)) + c.MoveX = i.X / n + c.MoveZ = i.Z / n + c.LastMove = w.now + return nil + case "gather": + return w.gather(c, i.Target) + case "craft": + return w.craft(c, i.Target) + case "attack": + return w.attack(c, i.Target) + case "heal": + if c.View.Inventory["bandage"] < 1 || c.View.Entity.HP >= c.View.Entity.MaxHP { + return errors.New("no bandage needed or available") + } + c.View.Inventory["bandage"]-- + c.View.Entity.HP = math.Min(c.View.Entity.MaxHP, c.View.Entity.HP+w.Balance.BandageHealing) + w.dirty = true + case "return": + if c.ReturnPosition == nil { + return errors.New("no keystone destination") + } + if math.Hypot(c.ReturnPosition.X, c.ReturnPosition.Z) > w.SafeRadius() { + return errors.New("keystone destination has been destroyed") + } + c.View.Entity.Position = *c.ReturnPosition + c.ReturnPosition = nil + c.View.HasKeystone = false + w.dirty = true + case "loot": + corpse := w.Corpses[i.Target] + if corpse == nil || distance(c.View.Entity.Position, corpse.Entity.Position) > w.Balance.GatherRange { + return errors.New("corpse out of reach") + } + for k, v := range corpse.Inventory { + c.View.Inventory[k] += v + } + delete(w.Corpses, i.Target) + w.dirty = true + default: + return errors.New("unknown intent") + } + return nil +} +func (w *World) gather(c *Character, target string) error { + if w.Age()-c.LastGather < w.Balance.GatherCooldown { + return errors.New("gathering cooldown") + } + if until := w.Depleted[target]; until > w.Age() { + return errors.New("resource depleted") + } + for _, chunk := range w.neighbors(c.View.Entity.Position) { + for _, r := range chunk.Resources { + if r.ID != target { + continue + } + if distance(c.View.Entity.Position, r.Position) > w.Balance.GatherRange { + return errors.New("resource out of reach") + } + item := map[string]string{"tree": "wood", "ore": "ore", "herb": "herb"}[r.Kind] + if item == "" { + return errors.New("not gatherable") + } + c.View.Inventory[item]++ + c.View.Skills["gathering"] += w.Balance.SkillXpPerAction + c.LastGather = w.Age() + w.Depleted[target] = w.Age() + w.Balance.ResourceRespawnSeconds + w.dirty = true + c.Message = "Gathered " + item + return nil + } + } + return errors.New("unknown resource") +} +func (w *World) craft(c *Character, name string) error { + r, ok := w.Balance.Recipes[name] + if !ok { + return errors.New("unknown recipe") + } + for k, v := range r.Inputs { + if c.View.Inventory[k] < v { + return errors.New("missing crafting materials") + } + } + for k, v := range r.Inputs { + c.View.Inventory[k] -= v + } + for k, v := range r.Outputs { + c.View.Inventory[k] += v + } + c.View.Skills["crafting"] += w.Balance.SkillXpPerAction + c.Message = "Crafted " + name + w.dirty = true + return nil +} +func (w *World) attack(c *Character, target string) error { + if w.Age()-c.LastAttack < w.Balance.AttackCooldown { + return errors.New("attack cooldown") + } + damage := w.Balance.PlayerDamage + if c.View.Inventory["spear"] > 0 { + damage = w.Balance.SpearDamage + } + if target == "boss" { + if w.Phase != "cataclysm" || distance(c.View.Entity.Position, w.terrain.Position(0, 0)) > w.Balance.AttackRange+4 { + return errors.New("boss out of reach") + } + w.BossHP = math.Max(0, w.BossHP-damage) + if w.BossHP == 0 { + w.Phase = "won" + ended := w.now + w.EndedAt = &ended + for _, survivor := range w.Characters { + if survivor.View.Entity.State == "alive" { + survivor.View.Entity.State = "eligible" + survivor.MoveX = 0 + survivor.MoveZ = 0 + survivor.Message = "The world is saved. Passage is open." + } + } + } + } else { + m := w.Mobs[target] + if m == nil || m.Entity.HP <= 0 || distance(c.View.Entity.Position, m.Entity.Position) > w.Balance.AttackRange { + return errors.New("target out of reach") + } + m.Entity.HP = math.Max(0, m.Entity.HP-damage) + if m.Entity.HP == 0 { + m.Entity.State = "dead" + m.RespawnAt = w.Age() + w.Balance.MobRespawnSeconds + c.View.Kills++ + c.View.Inventory["herb"]++ + } + } + c.LastAttack = w.Age() + c.View.Skills["combat"] += w.Balance.SkillXpPerAction + w.dirty = true + return nil +} +func (w *World) kill(c *Character, reason string) { + if c.View.Entity.State != "alive" { + return + } + e := c.View.Entity + e.ID = "corpse:" + e.ID + e.Kind = "corpse" + e.State = "dead" + e.HP = 0 + w.Corpses[e.ID] = &Corpse{Entity: e, Inventory: c.View.Inventory} + c.View.Inventory = map[string]int64{} + c.View.Entity.HP = 0 + c.View.Entity.State = "dead" + c.MoveX = 0 + c.MoveZ = 0 + c.ReturnPosition = nil + c.View.HasKeystone = false + c.Message = reason + w.dirty = true +} +func (w *World) Advance(now time.Time, dt float64) { + playedDT := math.Max(0, dt) + w.now = now + w.Tick++ + dt = math.Max(0, math.Min(dt, 0.25)) + if w.Phase == "won" || w.Phase == "lost" { + return + } + if w.Phase == "gathering" && w.Age() >= w.Balance.SeasonSeconds { + w.Phase = "cataclysm" + w.dirty = true + } + active := map[string]bool{} + for _, c := range w.Characters { + if c.View.Entity.State != "alive" { + continue + } + w.resetDay(c) + if c.Online { + midnight := time.Date(now.UTC().Year(), now.UTC().Month(), now.UTC().Day(), 0, 0, 0, 0, time.UTC) + c.DailySeconds += math.Min(playedDT, now.Sub(midnight).Seconds()) + c.View.PlayedSeconds += playedDT + c.View.RemainingSeconds = math.Max(0, w.Balance.DailyPlaySeconds-c.DailySeconds) + if c.View.RemainingSeconds <= 0 { + pos := c.View.Entity.Position + c.ReturnPosition = &pos + c.Sheltered = true + c.View.HasKeystone = true + c.View.Entity.Position = w.terrain.Position(0, 0) + c.View.Entity.HP = math.Min(c.View.Entity.MaxHP, math.Max(50, c.View.Entity.HP)) + c.Online = false + c.MoveX = 0 + c.MoveZ = 0 + c.Message = "Daily limit reached. Your keystone is ready for tomorrow." + w.dirty = true + } + } + if c.Online { + if now.Sub(c.LastMove) > 250*time.Millisecond { + c.MoveX = 0 + c.MoveZ = 0 + } + pos := c.View.Entity.Position + nx, nz := pos.X+c.MoveX*w.Balance.PlayerSpeed*dt, pos.Z+c.MoveZ*w.Balance.PlayerSpeed*dt + if math.Hypot(nx, nz) < w.Balance.WorldRadius { + c.View.Entity.Position = w.terrain.Position(nx, nz) + } + for _, ch := range w.neighbors(c.View.Entity.Position) { + active[ch.Key] = true + w.ensureMob(ch) + } + } + if w.Phase == "cataclysm" && math.Hypot(c.View.Entity.Position.X, c.View.Entity.Position.Z) > w.SafeRadius() { + c.View.Entity.HP -= w.Balance.StormDamagePerSecond * dt + w.dirty = true + } + if c.View.Entity.HP <= 0 { + w.kill(c, "The encroaching ruin claimed this character.") + } + } + w.updateMobs(active, dt) + if w.Phase == "cataclysm" { + if w.Age()-w.BossLastAttack >= w.Balance.BossCooldown { + for _, c := range w.Characters { + if c.Online && !c.Sheltered && c.View.Entity.State == "alive" && distance(c.View.Entity.Position, w.terrain.Position(0, 0)) <= w.Balance.BossRange { + c.View.Entity.HP -= w.Balance.BossDamage + w.dirty = true + if c.View.Entity.HP <= 0 { + w.kill(c, "The Harbinger ended this character's journey.") + } + } + } + w.BossLastAttack = w.Age() + } + alive := 0 + for _, c := range w.Characters { + if c.View.Entity.State == "alive" { + alive++ + } + } + if w.SafeRadius() <= 0 || (len(w.Characters) > 0 && alive == 0) { + for _, c := range w.Characters { + w.kill(c, "The world has been destroyed.") + } + w.Phase = "lost" + ended := w.now + w.EndedAt = &ended + w.dirty = true + } + } + // Keep CPU/GPU working sets bounded to subscribed chunks. Persistent deltas survive eviction. + for key := range w.chunks { + if !active[key] { + delete(w.chunks, key) + } + } + for key, until := range w.Depleted { + if until <= w.Age() { + delete(w.Depleted, key) + } + } +} +func (w *World) ensureMob(ch p.Chunk) { + id := "m:" + ch.Key + if _, ok := w.Mobs[id]; ok { + return + } + x, z := (float64(ch.X)+0.55)*ch.Size, (float64(ch.Z)+0.55)*ch.Size + if math.Hypot(x, z) > w.Balance.WorldRadius { + return + } + hp := w.Balance.MobHp * (1 + w.Age()/86400*w.Balance.MobScalePerDay) + w.Mobs[id] = &Mob{Entity: p.Entity{ID: id, Kind: "sentinel", Name: "Ash sentinel", Position: w.terrain.Position(x, z), HP: hp, MaxHP: hp, State: "alive"}, HomeX: int(ch.X), HomeZ: int(ch.Z)} +} +func (w *World) updateMobs(active map[string]bool, dt float64) { + for id, m := range w.Mobs { + key := Key(m.HomeX, m.HomeZ) + if !active[key] { + if m.Entity.HP == m.Entity.MaxHP || (m.Entity.HP <= 0 && w.Age() >= m.RespawnAt) { + delete(w.Mobs, id) + } + continue + } + if m.Entity.HP <= 0 { + if w.Age() >= m.RespawnAt { + m.Entity.HP = w.Balance.MobHp * (1 + w.Age()/86400*w.Balance.MobScalePerDay) + m.Entity.MaxHP = m.Entity.HP + m.Entity.State = "alive" + } + continue + } + var target *Character + nearest := w.Balance.MobAggroRange + for _, c := range w.Characters { + if !c.Online || c.View.Entity.State != "alive" || c.Sheltered { + continue + } + d := distance(c.View.Entity.Position, m.Entity.Position) + if d < nearest { + nearest = d + target = c + } + } + if target == nil { + continue + } + if nearest <= w.Balance.MobAttackRange { + if w.Age()-m.LastAttack >= w.Balance.MobCooldown { + target.View.Entity.HP -= w.Balance.MobDamage * (1 + w.Age()/86400*w.Balance.MobScalePerDay) + m.LastAttack = w.Age() + w.dirty = true + if target.View.Entity.HP <= 0 { + w.kill(target, "An ash sentinel ended this character's journey.") + } + } + } else { + pos, to := m.Entity.Position, target.View.Entity.Position + step := math.Min(nearest, w.Balance.MobSpeed*dt) + x, z := pos.X+(to.X-pos.X)/nearest*step, pos.Z+(to.Z-pos.Z)/nearest*step + if ChunkCoord(x, w.Balance.ChunkSize) == m.HomeX && ChunkCoord(z, w.Balance.ChunkSize) == m.HomeZ { + m.Entity.Position = w.terrain.Position(x, z) + } + } + } +} +func (w *World) Snapshot(id string, known map[string]bool) p.Snapshot { + c := w.Characters[id] + s := p.Snapshot{Type: "snapshot", Version: 1, Tick: w.Tick, World: w.Info(), Self: c.View, Message: c.Message, Entities: []p.Entity{}, Chunks: []p.Chunk{}, ChunkKeys: []string{}, UnavailableResources: []string{}} + allowed := map[string]bool{} + for _, ch := range w.neighbors(c.View.Entity.Position) { + allowed[ch.Key] = true + s.ChunkKeys = append(s.ChunkKeys, ch.Key) + if !known[ch.Key] { + s.Chunks = append(s.Chunks, ch) + } + for _, r := range ch.Resources { + if w.Depleted[r.ID] > w.Age() { + s.UnavailableResources = append(s.UnavailableResources, r.ID) + } + } + } + visible := func(pos p.Vec3) bool { + return allowed[Key(ChunkCoord(pos.X, w.Balance.ChunkSize), ChunkCoord(pos.Z, w.Balance.ChunkSize))] + } + for _, other := range w.Characters { + if other.View.Entity.ID != id && other.Online && other.View.Entity.State != "dead" && visible(other.View.Entity.Position) { + s.Entities = append(s.Entities, other.View.Entity) + } + } + for _, m := range w.Mobs { + if m.Entity.HP > 0 && visible(m.Entity.Position) { + s.Entities = append(s.Entities, m.Entity) + } + } + for _, corpse := range w.Corpses { + if visible(corpse.Entity.Position) { + s.Entities = append(s.Entities, corpse.Entity) + } + } + if w.Phase == "cataclysm" && visible(w.terrain.Position(0, 0)) { + s.Entities = append(s.Entities, p.Entity{ID: "boss", Kind: "boss", Name: "The Harbinger", HP: w.BossHP, MaxHP: w.Balance.BossHp, Position: w.terrain.Position(0, 0), State: "alive"}) + } + sort.Slice(s.Entities, func(i, j int) bool { return s.Entities[i].ID < s.Entities[j].ID }) + return s +} +func (w *World) TriggerBoss() error { + if w.Phase != "gathering" { + return fmt.Errorf("boss event already started") + } + w.CreatedAt = w.now.Add(-time.Duration(w.Balance.SeasonSeconds * float64(time.Second))) + w.Phase = "cataclysm" + w.dirty = true + return nil +} diff --git a/server/internal/game/world_test.go b/server/internal/game/world_test.go new file mode 100644 index 0000000..83d679f --- /dev/null +++ b/server/internal/game/world_test.go @@ -0,0 +1,305 @@ +package game + +import ( + "encoding/json" + "math" + "reflect" + "testing" + "time" + + "aeternalis/server/content" + p "aeternalis/server/internal/protocol" +) + +func fixture(t *testing.T) (*World, *Character) { + t.Helper() + b, err := content.Load() + if err != nil { + t.Fatal(err) + } + w := New("test", 123, time.Date(2026, 1, 1, 12, 0, 0, 0, time.UTC), b) + c, err := w.Join("account", "Traveler") + if err != nil { + t.Fatal(err) + } + if err = w.Connect(c.View.Entity.ID); err != nil { + t.Fatal(err) + } + return w, c +} +func TestTerrainDeterministicAndSeamless(t *testing.T) { + b, _ := content.Load() + a := NewTerrain(123, b) + other := NewTerrain(456, b) + if !reflect.DeepEqual(a.Chunk(-1, 0), NewTerrain(123, b).Chunk(-1, 0)) { + t.Fatal("same seed changed") + } + if reflect.DeepEqual(a.Chunk(0, 0), other.Chunk(0, 0)) { + t.Fatal("different seeds identical") + } + left, right := a.Chunk(-1, 0), a.Chunk(0, 0) + n := b.TerrainResolution + 1 + for z := 0; z < n; z++ { + if left.Heights[z*n+n-1] != right.Heights[z*n] { + t.Fatal("chunk seam") + } + } + if ChunkCoord(-0.1, 128) != -1 || ChunkCoord(-128, 128) != -1 { + t.Fatal("negative coordinates") + } + for _, r := range left.Resources { + if math.Abs(r.Position.Y-a.Height(r.Position.X, r.Position.Z)) > 1e-8 { + t.Fatal("floating resource") + } + } +} +func TestMovementAuthorityAndInterest(t *testing.T) { + w, c := fixture(t) + id := c.View.Entity.ID + w.now = w.now.Add(time.Second) + for _, intent := range []p.Intent{{Op: "move", Seq: 1, X: 2}, {Op: "move", Seq: 1, X: math.NaN()}, {Op: "move", Seq: 1, Z: math.Inf(1)}} { + if w.Intent(id, intent) == nil { + t.Fatal("invalid movement accepted") + } + } + if err := w.Intent(id, p.Intent{Op: "move", Seq: 1, X: 1, Z: 1}); err != nil { + t.Fatal(err) + } + before := c.View.Entity.Position + w.Advance(w.now.Add(50*time.Millisecond), 0.05) + if got := distance(before, c.View.Entity.Position); math.Abs(got-w.Balance.PlayerSpeed*0.05) > 1e-8 { + t.Fatalf("diagonal speed: %v", got) + } + if w.Intent(id, p.Intent{Op: "move", Seq: 1}) == nil { + t.Fatal("replayed sequence") + } + s := w.Snapshot(id, map[string]bool{}) + if len(s.Chunks) != 9 || len(s.ChunkKeys) != 9 { + t.Fatal("interest area not 3x3") + } + known := map[string]bool{} + for _, key := range s.ChunkKeys { + known[key] = true + } + if len(w.Snapshot(id, known).Chunks) != 0 { + t.Fatal("resent known terrain") + } + far, _ := w.Join("far", "Far") + far.View.Entity.Position = w.terrain.Position(700, 700) + far.Online = true + for _, e := range w.Snapshot(id, known).Entities { + if e.ID == far.View.Entity.ID { + t.Fatal("remote entity leaked outside interest") + } + } + w.Advance(w.now.Add(time.Second), 0.05) + if c.MoveX != 0 || c.MoveZ != 0 { + t.Fatal("stale input did not stop") + } +} +func TestGatherCraftAndPermanentDeath(t *testing.T) { + w, c := fixture(t) + id := c.View.Entity.ID + w.now = w.now.Add(2 * time.Second) + if w.Intent(id, p.Intent{Op: "gather", Seq: 1, Target: "arrival:ore"}) == nil { + t.Fatal("remote gather accepted") + } + c.View.Entity.Position = w.terrain.Position(17, 12) + if err := w.Intent(id, p.Intent{Op: "gather", Seq: 2, Target: "arrival:ore"}); err != nil { + t.Fatal(err) + } + if c.View.Inventory["ore"] != 1 { + t.Fatal("gather failed") + } + if w.Intent(id, p.Intent{Op: "gather", Seq: 3, Target: "arrival:ore"}) == nil { + t.Fatal("double gather") + } + if w.Intent(id, p.Intent{Op: "craft", Seq: 4, Target: "spear"}) == nil { + t.Fatal("free craft") + } + c.View.Inventory["wood"] = 3 + c.View.Inventory["ore"] = 2 + if err := w.Intent(id, p.Intent{Op: "craft", Seq: 5, Target: "spear"}); err != nil { + t.Fatal(err) + } + if c.View.Inventory["spear"] != 1 || c.View.Inventory["wood"] != 0 || c.View.Inventory["ore"] != 0 { + t.Fatal("recipe not atomic") + } + w.kill(c, "test death") + w.Disconnect(id) + if w.Connect(id) == nil { + t.Fatal("dead character reconnected") + } + same, err := w.Join(c.Account, "Replacement") + if err != nil || same.View.Entity.ID != id || same.View.Entity.State != "dead" { + t.Fatal("death bypass by rejoining") + } + if len(c.View.Inventory) != 0 || w.Corpses["corpse:"+id].Inventory["spear"] != 1 { + t.Fatal("corpse inventory") + } + raw, _ := json.Marshal(w) + var restored World + if err = json.Unmarshal(raw, &restored); err != nil { + t.Fatal(err) + } + if err = restored.Restore(w.now); err != nil { + t.Fatal(err) + } + if restored.Connect(id) == nil { + t.Fatal("restart resurrected character") + } +} + +func TestStaticResourcesAreNotReplicatedEverySnapshot(t *testing.T) { + w, c := fixture(t) + w.Depleted["arrival:ore"] = w.Age() + 60 + s := w.Snapshot(c.View.Entity.ID, map[string]bool{}) + if len(s.UnavailableResources) != 1 || s.UnavailableResources[0] != "arrival:ore" { + t.Fatal("missing authoritative resource availability") + } + for _, e := range s.Entities { + if e.Kind == "tree" || e.Kind == "ore" || e.Kind == "herb" { + t.Fatal("static resource repeated in dynamic entity snapshot") + } + } + resources := 0 + for _, ch := range s.Chunks { + resources += len(ch.Resources) + } + if resources == 0 { + t.Fatal("initial chunk does not carry resources") + } +} +func TestDailyLimitAndKeystone(t *testing.T) { + w, c := fixture(t) + w.Balance.DailyPlaySeconds = 1 + c.DailySeconds = .9 + c.View.Entity.HP = 20 + c.View.Entity.Position = w.terrain.Position(40, 40) + w.Advance(w.now.Add(200*time.Millisecond), .2) + if c.Online || c.ReturnPosition == nil || !c.View.HasKeystone || c.View.Entity.HP != 50 || distance(c.View.Entity.Position, p.Vec3{}) != 0 { + t.Fatalf("cap not enforced: %+v", c) + } + if w.Connect(c.View.Entity.ID) == nil { + t.Fatal("same-day cap bypass") + } + w.now = w.now.Add(24 * time.Hour) + if err := w.Connect(c.View.Entity.ID); err != nil { + t.Fatal(err) + } + if err := w.Intent(c.View.Entity.ID, p.Intent{Op: "return", Seq: 1}); err != nil { + t.Fatal(err) + } + if c.View.Entity.Position.X != 40 || c.ReturnPosition != nil || c.View.HasKeystone { + t.Fatal("keystone failed") + } +} + +func TestDailyBudgetUsesWallTimeDuringLag(t *testing.T) { + w, c := fixture(t) + w.Balance.DailyPlaySeconds = 2 + w.Advance(w.now.Add(3*time.Second), 3) + if c.Online || c.View.RemainingSeconds != 0 { + t.Fatal("simulation lag bypassed wall-clock play cap") + } +} + +func TestKeystoneCannotGrantRoamingInvulnerability(t *testing.T) { + w, c := fixture(t) + c.Sheltered = true + c.ReturnPosition = &p.Vec3{X: 40, Z: 40} + if err := w.Intent(c.View.Entity.ID, p.Intent{Op: "move", Seq: 1, X: 1}); err != nil { + t.Fatal(err) + } + if c.Sheltered || c.ReturnPosition == nil { + t.Fatal("leaving sanctuary must remove protection while preserving keystone") + } +} +func TestBossVictoryAndCollapse(t *testing.T) { + t.Run("victory includes offline survivors and excludes dead", func(t *testing.T) { + w, c := fixture(t) + dead, _ := w.Join("dead", "Dead") + w.kill(dead, "test") + offline, _ := w.Join("offline", "Offline") + w.now = w.now.Add(time.Second) + _ = w.TriggerBoss() + w.BossHP = 1 + if err := w.Intent(c.View.Entity.ID, p.Intent{Op: "attack", Seq: 1, Target: "boss"}); err != nil { + t.Fatal(err) + } + if w.Phase != "won" || c.View.Entity.State != "eligible" || offline.View.Entity.State != "eligible" || dead.View.Entity.State != "dead" { + t.Fatal("incorrect survivor selection") + } + radius := w.SafeRadius() + w.Advance(w.now.Add(20*24*time.Hour), .05) + if w.SafeRadius() != radius { + t.Fatal("world kept collapsing after boss death") + } + if c.View.Entity.State != "eligible" { + t.Fatal("victory not terminal") + } + if w.Intent(c.View.Entity.ID, p.Intent{Op: "move", Seq: 2, X: 1}) == nil { + t.Fatal("survivor mutated frozen world") + } + }) + t.Run("collapse kills offline and capped characters", func(t *testing.T) { + w, c := fixture(t) + c.Online = false + c.ReturnPosition = &p.Vec3{X: 40} + w.Advance(w.CreatedAt.Add(time.Duration((w.Balance.SeasonSeconds+w.Balance.CollapseSeconds+1)*float64(time.Second))), .05) + if w.Phase != "lost" || c.View.Entity.State != "dead" { + t.Fatal("world destruction bypass") + } + }) + t.Run("boss schedule survives downtime", func(t *testing.T) { + w, _ := fixture(t) + w.Advance(w.CreatedAt.Add(7*24*time.Hour+5*time.Minute), .05) + if w.Phase != "cataclysm" || w.SafeRadius() >= w.Balance.WorldRadius { + t.Fatal("deadline did not advance") + } + }) +} +func TestSpawnAndTransferPreserveBudget(t *testing.T) { + w, c := fixture(t) + other, _ := w.Join("other", "Other") + if distance(c.View.Entity.Position, other.View.Entity.Position) < w.Balance.SpawnSeparation { + t.Fatal("spawns overlap") + } + c.View.Entity.State = "eligible" + c.DailySeconds = 123 + c.View.PlayedSeconds = 456 + c.View.Skills["combat"] = 9 + c.View.Inventory["spear"] = 1 + next := New("next", 999, w.now, w.Balance) + if err := next.Import(c); err != nil { + t.Fatal(err) + } + if c.DailySeconds != 123 || c.View.PlayedSeconds != 456 || c.View.Skills["combat"] != 9 || c.View.Inventory["spear"] != 1 { + t.Fatal("transfer changed progress or budget") + } + if err := next.Import(c); err == nil { + t.Fatal("duplicate import") + } +} +func BenchmarkSnapshot100Players(b *testing.B) { + balance, _ := content.Load() + w := New("bench", 123, time.Now(), balance) + ids := []string{} + for i := 0; i < 100; i++ { + c, err := w.Join(ID(), "Traveler") + if err != nil { + b.Fatal(err) + } + c.Online = true + ids = append(ids, c.View.Entity.ID) + } + w.Advance(time.Now(), .05) + known := map[string]bool{} + b.ResetTimer() + for i := 0; i < b.N; i++ { + s := w.Snapshot(ids[i%len(ids)], known) + if _, err := json.Marshal(s); err != nil { + b.Fatal(err) + } + } +} diff --git a/server/internal/protocol/generated.go b/server/internal/protocol/generated.go new file mode 100644 index 0000000..a4ae431 --- /dev/null +++ b/server/internal/protocol/generated.go @@ -0,0 +1,81 @@ +// Code generated from schemas/protocol.json. DO NOT EDIT. +package protocol + +type Protocol struct { + Intent Intent `json:"intent"` + Snapshot Snapshot `json:"snapshot"` +} + +type Intent struct { + Op string `json:"op"` + Seq int64 `json:"seq"` + Target string `json:"target"` + X float64 `json:"x"` + Z float64 `json:"z"` +} + +type Snapshot struct { + ChunkKeys []string `json:"chunkKeys"` + Chunks []Chunk `json:"chunks"` + Entities []Entity `json:"entities"` + Message string `json:"message"` + Self Character `json:"self"` + Tick int64 `json:"tick"` + Type string `json:"type"` + UnavailableResources []string `json:"unavailableResources"` + Version int64 `json:"version"` + World WorldInfo `json:"world"` +} + +type Chunk struct { + Biome string `json:"biome"` + Heights []float64 `json:"heights"` + Key string `json:"key"` + Resolution int64 `json:"resolution"` + Resources []Entity `json:"resources"` + Size float64 `json:"size"` + X int64 `json:"x"` + Z int64 `json:"z"` +} + +type Entity struct { + HP float64 `json:"hp"` + ID string `json:"id"` + Kind string `json:"kind"` + MaxHP float64 `json:"maxHp"` + Name string `json:"name"` + Position Vec3 `json:"position"` + State string `json:"state"` +} + +type Vec3 struct { + X float64 `json:"x"` + Y float64 `json:"y"` + Z float64 `json:"z"` +} + +type Character struct { + ACK int64 `json:"ack"` + Entity Entity `json:"entity"` + HasKeystone bool `json:"hasKeystone"` + Inventory map[string]int64 `json:"inventory"` + Kills int64 `json:"kills"` + PlayedSeconds float64 `json:"playedSeconds"` + RemainingSeconds float64 `json:"remainingSeconds"` + Skills map[string]int64 `json:"skills"` +} + +type WorldInfo struct { + AgeSeconds float64 `json:"ageSeconds"` + BossHP float64 `json:"bossHp"` + BossInSeconds float64 `json:"bossInSeconds"` + BossMaxHP float64 `json:"bossMaxHp"` + Capacity int64 `json:"capacity"` + CollapseInSeconds float64 `json:"collapseInSeconds"` + ID string `json:"id"` + Online int64 `json:"online"` + Phase string `json:"phase"` + Radius float64 `json:"radius"` + SafeRadius float64 `json:"safeRadius"` + Seed int64 `json:"seed"` +} diff --git a/server/internal/store/store.go b/server/internal/store/store.go new file mode 100644 index 0000000..923172c --- /dev/null +++ b/server/internal/store/store.go @@ -0,0 +1,245 @@ +package store + +import ( + "context" + "database/sql" + "encoding/json" + "errors" + "fmt" + "strings" + + "aeternalis/server/internal/game" + _ "github.com/jackc/pgx/v5/stdlib" + _ "modernc.org/sqlite" +) + +var ErrOwnership = errors.New("world ownership or revision lost") + +type DB struct { + sql *sql.DB + postgres bool +} +type Lease struct { + DB *DB + WorldID string + Owner string + Revision int64 +} +type Passage struct { + CharacterID string `json:"characterId"` + SourceWorld string `json:"sourceWorld"` + Name string `json:"name"` +} + +func Open(ctx context.Context, dsn string) (*DB, error) { + postgres := strings.HasPrefix(dsn, "postgres://") || strings.HasPrefix(dsn, "postgresql://") + driver := "sqlite" + if postgres { + driver = "pgx" + } + conn, err := sql.Open(driver, dsn) + if err != nil { + return nil, err + } + conn.SetMaxOpenConns(8) + if !postgres { + conn.SetMaxOpenConns(1) + } + db := &DB{conn, postgres} + if err = conn.PingContext(ctx); err != nil { + conn.Close() + return nil, err + } + if !postgres { + if _, err = conn.ExecContext(ctx, "PRAGMA journal_mode=WAL"); err != nil { + conn.Close() + return nil, err + } + _, _ = conn.ExecContext(ctx, "PRAGMA busy_timeout=5000") + } + for _, stmt := range []string{ + `CREATE TABLE IF NOT EXISTS worlds(id TEXT PRIMARY KEY, owner TEXT NOT NULL, lease_until BIGINT NOT NULL, revision BIGINT NOT NULL, snapshot TEXT NOT NULL)`, + `CREATE TABLE IF NOT EXISTS passages(character_id TEXT PRIMARY KEY, account_id TEXT NOT NULL, source_world TEXT NOT NULL, character TEXT NOT NULL, claimed_world TEXT)`, + `CREATE INDEX IF NOT EXISTS passages_account ON passages(account_id)`, + `CREATE TABLE IF NOT EXISTS sessions(token_hash TEXT PRIMARY KEY, account_id TEXT NOT NULL, expires BIGINT NOT NULL)`, + `CREATE INDEX IF NOT EXISTS sessions_expiry ON sessions(expires)`, + } { + if _, err = conn.ExecContext(ctx, stmt); err != nil { + conn.Close() + return nil, err + } + } + return db, nil +} +func (d *DB) Close() error { return d.sql.Close() } +func (d *DB) q(query string) string { + if !d.postgres { + return query + } + i := 0 + var b strings.Builder + for _, c := range query { + if c == '?' { + i++ + fmt.Fprintf(&b, "$%d", i) + } else { + b.WriteRune(c) + } + } + return b.String() +} +func (d *DB) now() string { + if d.postgres { + return "CAST(EXTRACT(EPOCH FROM clock_timestamp()) AS BIGINT)" + } + return "unixepoch()" +} +func (d *DB) Acquire(ctx context.Context, w *game.World) (*Lease, []byte, error) { + data, err := json.Marshal(w) + if err != nil { + return nil, nil, err + } + tx, err := d.sql.BeginTx(ctx, nil) + if err != nil { + return nil, nil, err + } + defer tx.Rollback() + _, err = tx.ExecContext(ctx, d.q(`INSERT INTO worlds(id,owner,lease_until,revision,snapshot) VALUES(?,'',0,0,?) ON CONFLICT(id) DO NOTHING`), w.ID, string(data)) + if err != nil { + return nil, nil, err + } + owner := game.ID() + result, err := tx.ExecContext(ctx, d.q(`UPDATE worlds SET owner=?,lease_until=`+d.now()+`+30 WHERE id=? AND (owner='' OR lease_until<`+d.now()+`)`), owner, w.ID) + if err != nil { + return nil, nil, err + } + n, _ := result.RowsAffected() + if n != 1 { + return nil, nil, ErrOwnership + } + var snapshot string + var revision int64 + if err = tx.QueryRowContext(ctx, d.q(`SELECT revision,snapshot FROM worlds WHERE id=?`), w.ID).Scan(&revision, &snapshot); err != nil { + return nil, nil, err + } + if err = tx.Commit(); err != nil { + return nil, nil, err + } + return &Lease{d, w.ID, owner, revision}, []byte(snapshot), nil +} +func (l *Lease) Save(ctx context.Context, w *game.World, claimID string) error { + data, err := json.Marshal(w) + if err != nil { + return err + } + d := l.DB + tx, err := d.sql.BeginTx(ctx, nil) + if err != nil { + return err + } + defer tx.Rollback() + result, err := tx.ExecContext(ctx, d.q(`UPDATE worlds SET snapshot=?,revision=revision+1,lease_until=`+d.now()+`+30 WHERE id=? AND owner=? AND revision=? AND lease_until>=`+d.now()), string(data), l.WorldID, l.Owner, l.Revision) + if err != nil { + return err + } + n, _ := result.RowsAffected() + if n != 1 { + return ErrOwnership + } + if claimID != "" { + c := w.Characters[claimID] + if c == nil { + return errors.New("claimed character absent from target") + } + result, err = tx.ExecContext(ctx, d.q(`UPDATE passages SET claimed_world=? WHERE character_id=? AND account_id=? AND claimed_world IS NULL AND source_world<>?`), w.ID, claimID, c.Account, w.ID) + if err != nil { + return err + } + n, _ = result.RowsAffected() + if n != 1 { + return errors.New("passage already redeemed or unavailable") + } + } + if w.Phase == "won" { + for _, c := range w.Characters { + if c.View.Entity.State != "eligible" { + continue + } + encoded, err := json.Marshal(c) + if err != nil { + return err + } + _, err = tx.ExecContext(ctx, d.q(`INSERT INTO passages(character_id,account_id,source_world,character) VALUES(?,?,?,?) ON CONFLICT(character_id) DO UPDATE SET source_world=excluded.source_world,character=excluded.character,claimed_world=NULL WHERE passages.claimed_world=excluded.source_world`), c.View.Entity.ID, c.Account, w.ID, string(encoded)) + if err != nil { + return err + } + } + } + if err = tx.Commit(); err != nil { + return err + } + l.Revision++ + w.Saved() + return nil +} +func (l *Lease) Release(ctx context.Context) error { + _, err := l.DB.sql.ExecContext(ctx, l.DB.q(`UPDATE worlds SET owner='',lease_until=0 WHERE id=? AND owner=?`), l.WorldID, l.Owner) + return err +} +func (d *DB) Passages(ctx context.Context, account string) ([]Passage, error) { + rows, err := d.sql.QueryContext(ctx, d.q(`SELECT character_id,source_world,character FROM passages WHERE account_id=? AND claimed_world IS NULL`), account) + if err != nil { + return nil, err + } + defer rows.Close() + out := []Passage{} + for rows.Next() { + var p Passage + var raw string + if err = rows.Scan(&p.CharacterID, &p.SourceWorld, &raw); err != nil { + return nil, err + } + var c game.Character + if err = json.Unmarshal([]byte(raw), &c); err != nil { + return nil, err + } + p.Name = c.View.Entity.Name + out = append(out, p) + } + return out, rows.Err() +} +func (d *DB) ReadPassage(ctx context.Context, id, account string) (*game.Character, error) { + var raw string + err := d.sql.QueryRowContext(ctx, d.q(`SELECT character FROM passages WHERE character_id=? AND account_id=? AND claimed_world IS NULL`), id, account).Scan(&raw) + if err != nil { + return nil, err + } + var c game.Character + if err = json.Unmarshal([]byte(raw), &c); err != nil { + return nil, err + } + return &c, nil +} +func (d *DB) CreateSession(ctx context.Context, hash, account string) error { + tx, err := d.sql.BeginTx(ctx, nil) + if err != nil { + return err + } + defer tx.Rollback() + if _, err = tx.ExecContext(ctx, `DELETE FROM sessions WHERE expires<`+d.now()); err != nil { + return err + } + if _, err = tx.ExecContext(ctx, d.q(`INSERT INTO sessions(token_hash,account_id,expires) VALUES(?,?,`+d.now()+`+86400)`), hash, account); err != nil { + return err + } + return tx.Commit() +} +func (d *DB) Session(ctx context.Context, hash string) (string, error) { + var account string + err := d.sql.QueryRowContext(ctx, d.q(`SELECT account_id FROM sessions WHERE token_hash=? AND expires>`+d.now()), hash).Scan(&account) + return account, err +} +func (d *DB) DeleteSession(ctx context.Context, hash string) error { + _, err := d.sql.ExecContext(ctx, d.q(`DELETE FROM sessions WHERE token_hash=?`), hash) + return err +} diff --git a/server/internal/store/store_test.go b/server/internal/store/store_test.go new file mode 100644 index 0000000..325029a --- /dev/null +++ b/server/internal/store/store_test.go @@ -0,0 +1,210 @@ +package store + +import ( + "context" + "encoding/json" + "os" + "path/filepath" + "sync" + "testing" + "time" + + "aeternalis/server/content" + "aeternalis/server/internal/game" +) + +func TestStoreLifecycle(t *testing.T) { + runStoreTests(t, "file:"+filepath.ToSlash(filepath.Join(t.TempDir(), "world.db"))) +} + +func TestConcurrentPassageRedemption(t *testing.T) { + ctx := context.Background() + db, err := Open(ctx, "file:"+filepath.ToSlash(filepath.Join(t.TempDir(), "race.db"))) + if err != nil { + t.Fatal(err) + } + defer db.Close() + b, _ := content.Load() + now := time.Now().UTC() + source := game.New("source", 1, now, b) + lease, _, err := db.Acquire(ctx, source) + if err != nil { + t.Fatal(err) + } + c, _ := source.Join("account", "Survivor") + c.View.Entity.State = "eligible" + source.Phase = "won" + if err = lease.Save(ctx, source, ""); err != nil { + t.Fatal(err) + } + targets := []*game.World{game.New("target-a", 2, now, b), game.New("target-b", 3, now, b)} + leases := make([]*Lease, 2) + for i, w := range targets { + leases[i], _, err = db.Acquire(ctx, w) + if err != nil { + t.Fatal(err) + } + copy, err := db.ReadPassage(ctx, c.View.Entity.ID, c.Account) + if err != nil { + t.Fatal(err) + } + if err = w.Import(copy); err != nil { + t.Fatal(err) + } + } + var wg sync.WaitGroup + results := make(chan error, 2) + for i := range targets { + wg.Add(1) + go func(i int) { defer wg.Done(); results <- leases[i].Save(ctx, targets[i], c.View.Entity.ID) }(i) + } + wg.Wait() + close(results) + successes := 0 + for err := range results { + if err == nil { + successes++ + } + } + if successes != 1 { + t.Fatalf("expected one successful redemption, got %d", successes) + } + durableCopies := 0 + for _, w := range targets { + var raw string + if err := db.sql.QueryRowContext(ctx, db.q("SELECT snapshot FROM worlds WHERE id=?"), w.ID).Scan(&raw); err != nil { + t.Fatal(err) + } + var restored game.World + if err := json.Unmarshal([]byte(raw), &restored); err != nil { + t.Fatal(err) + } + if restored.Characters[c.View.Entity.ID] != nil { + durableCopies++ + } + } + if durableCopies != 1 { + t.Fatal("failed redemption left a durable duplicate") + } +} +func TestPostgresLifecycle(t *testing.T) { + dsn := os.Getenv("TEST_DATABASE_URL") + if dsn == "" { + t.Skip("TEST_DATABASE_URL not configured") + } + runStoreTests(t, dsn) +} +func runStoreTests(t *testing.T, dsn string) { + ctx := context.Background() + db, err := Open(ctx, dsn) + if err != nil { + t.Fatal(err) + } + defer db.Close() + balance, _ := content.Load() + prefix := game.ID() + now := time.Now().UTC() + source := game.New(prefix+"-source", 123, now, balance) + lease, _, err := db.Acquire(ctx, source) + if err != nil { + t.Fatal(err) + } + if _, _, err = db.Acquire(ctx, source); err == nil { + t.Fatal("two simultaneous world owners") + } + c, _ := source.Join("account:"+prefix, "Traveler") + c.View.Inventory["spear"] = 1 + c.DailySeconds = 123 + c.View.Entity.State = "eligible" + source.Phase = "won" + if err = lease.Save(ctx, source, ""); err != nil { + t.Fatal(err) + } + if err = lease.Save(ctx, source, ""); err != nil { + t.Fatal(err) + } + passages, err := db.Passages(ctx, c.Account) + if err != nil || len(passages) != 1 { + t.Fatalf("idempotent survivor grant %v %v", passages, err) + } + if _, err = db.ReadPassage(ctx, c.View.Entity.ID, "attacker"); err == nil { + t.Fatal("another account stole transfer") + } + target := game.New(prefix+"-target", 456, now, balance) + targetLease, _, err := db.Acquire(ctx, target) + if err != nil { + t.Fatal(err) + } + survivor, err := db.ReadPassage(ctx, c.View.Entity.ID, c.Account) + if err != nil { + t.Fatal(err) + } + if err = target.Import(survivor); err != nil { + t.Fatal(err) + } + if err = targetLease.Save(ctx, target, c.View.Entity.ID); err != nil { + t.Fatal(err) + } + if _, err = db.ReadPassage(ctx, c.View.Entity.ID, c.Account); err == nil { + t.Fatal("passage can be redeemed twice") + } + third := game.New(prefix+"-third", 789, now, balance) + thirdLease, _, err := db.Acquire(ctx, third) + if err != nil { + t.Fatal(err) + } + copy := *survivor + copy.View.Entity.State = "eligible" + if err = third.Import(©); err != nil { + t.Fatal(err) + } + if err = thirdLease.Save(ctx, third, c.View.Entity.ID); err == nil { + t.Fatal("duplicate transfer committed") + } + if err = targetLease.Release(ctx); err != nil { + t.Fatal(err) + } + freshLease, raw, err := db.Acquire(ctx, target) + if err != nil { + t.Fatal(err) + } + var restored game.World + if err = json.Unmarshal(raw, &restored); err != nil { + t.Fatal(err) + } + loaded := restored.Characters[c.View.Entity.ID] + if loaded == nil || loaded.DailySeconds != 123 || loaded.View.Inventory["spear"] != 1 { + t.Fatal("transfer not durable") + } + if err = targetLease.Save(ctx, target, ""); err == nil { + t.Fatal("stale owner wrote state") + } + // A subsequent victory grants a fresh passage for the same permanent character ID. + loaded.View.Entity.State = "eligible" + restored.Phase = "won" + if err = freshLease.Save(ctx, &restored, ""); err != nil { + t.Fatal(err) + } + if err = lease.Save(ctx, source, ""); err != nil { + t.Fatal(err) + } + passages, err = db.Passages(ctx, c.Account) + if err != nil || len(passages) != 1 || passages[0].SourceWorld != target.ID { + t.Fatal("old world overwrote next passage") + } + if err = db.CreateSession(ctx, "hash:"+prefix, c.Account); err != nil { + t.Fatal(err) + } + if account, err := db.Session(ctx, "hash:"+prefix); err != nil || account != c.Account { + t.Fatal("session roundtrip") + } + if err = db.DeleteSession(ctx, "hash:"+prefix); err != nil { + t.Fatal(err) + } + if _, err = db.Session(ctx, "hash:"+prefix); err == nil { + t.Fatal("revoked session remains valid") + } + _ = lease.Release(ctx) + _ = freshLease.Release(ctx) + _ = thirdLease.Release(ctx) +} diff --git a/server/internal/transport/auth.go b/server/internal/transport/auth.go new file mode 100644 index 0000000..ffe6173 --- /dev/null +++ b/server/internal/transport/auth.go @@ -0,0 +1,149 @@ +package transport + +import ( + "context" + "crypto/sha256" + "encoding/hex" + "errors" + "net/http" + "net/url" + "strings" + "sync" + "time" + + "aeternalis/server/internal/game" + "aeternalis/server/internal/store" + "github.com/coreos/go-oidc/v3/oidc" + "golang.org/x/oauth2" +) + +type Auth struct { + db *store.DB + dev bool + base string + oauth *oauth2.Config + verifier *oidc.IDTokenVerifier + mu sync.Mutex + flows map[string]flow +} +type flow struct { + verifier string + expires time.Time +} + +func NewAuth(ctx context.Context, db *store.DB, dev bool, base, issuer, client, secret string) (*Auth, error) { + a := &Auth{db: db, dev: dev, base: base, flows: map[string]flow{}} + if dev { + return a, nil + } + if !strings.HasPrefix(base, "https://") || !strings.HasPrefix(issuer, "https://") || client == "" { + return nil, errors.New("production requires HTTPS PUBLIC_URL, OIDC_ISSUER, and OIDC_CLIENT_ID") + } + provider, err := oidc.NewProvider(ctx, issuer) + if err != nil { + return nil, err + } + a.oauth = &oauth2.Config{ClientID: client, ClientSecret: secret, Endpoint: provider.Endpoint(), RedirectURL: base + "/auth/callback", Scopes: []string{oidc.ScopeOpenID}} + a.verifier = provider.Verifier(&oidc.Config{ClientID: client}) + return a, nil +} +func hash(s string) string { b := sha256.Sum256([]byte(s)); return hex.EncodeToString(b[:]) } +func (a *Auth) cookieName() string { + if a.dev { + return "aeternalis_session" + } + return "__Host-aeternalis_session" +} +func (a *Auth) account(r *http.Request) (string, error) { + c, err := r.Cookie(a.cookieName()) + if err != nil || len(c.Value) != 64 { + return "", errors.New("not authenticated") + } + return a.db.Session(r.Context(), hash(c.Value)) +} +func (a *Auth) session(w http.ResponseWriter, r *http.Request, account string) error { + token := game.ID() + game.ID() + if err := a.db.CreateSession(r.Context(), hash(token), account); err != nil { + return err + } + http.SetCookie(w, &http.Cookie{Name: a.cookieName(), Value: token, Path: "/", HttpOnly: true, Secure: !a.dev, SameSite: http.SameSiteLaxMode, MaxAge: 86400}) + return nil +} +func (a *Auth) login(w http.ResponseWriter, r *http.Request) { + if a.dev { + http.Redirect(w, r, "/", http.StatusSeeOther) + return + } + state := game.ID() + game.ID() + v := oauth2.GenerateVerifier() + a.mu.Lock() + for key, f := range a.flows { + if time.Now().After(f.expires) { + delete(a.flows, key) + } + } + if len(a.flows) >= 4096 { + a.mu.Unlock() + fail(w, 503, "login capacity reached") + return + } + a.flows[state] = flow{v, time.Now().Add(10 * time.Minute)} + a.mu.Unlock() + http.SetCookie(w, &http.Cookie{Name: "__Host-aeternalis_login", Value: state, Path: "/", HttpOnly: true, Secure: true, SameSite: http.SameSiteLaxMode, MaxAge: 600}) + http.Redirect(w, r, a.oauth.AuthCodeURL(state, oauth2.S256ChallengeOption(v), oidc.Nonce(state)), http.StatusSeeOther) +} +func (a *Auth) callback(w http.ResponseWriter, r *http.Request) { + if a.dev { + fail(w, 404, "not enabled") + return + } + state := r.URL.Query().Get("state") + cookie, err := r.Cookie("__Host-aeternalis_login") + if err != nil || state == "" || cookie.Value != state { + fail(w, 400, "invalid login state") + return + } + a.mu.Lock() + f, ok := a.flows[state] + delete(a.flows, state) + a.mu.Unlock() + if !ok || time.Now().After(f.expires) { + fail(w, 400, "login expired") + return + } + ctx, cancel := context.WithTimeout(r.Context(), 10*time.Second) + defer cancel() + token, err := a.oauth.Exchange(ctx, r.URL.Query().Get("code"), oauth2.VerifierOption(f.verifier)) + if err != nil { + fail(w, 401, "login exchange failed") + return + } + raw, ok := token.Extra("id_token").(string) + if !ok { + fail(w, 401, "identity token missing") + return + } + identity, err := a.verifier.Verify(ctx, raw) + if err != nil || identity.Nonce != state { + fail(w, 401, "invalid identity token") + return + } + if err = a.session(w, r, hash(identity.Issuer+"\x00"+identity.Subject)); err != nil { + fail(w, 503, "session unavailable") + return + } + http.SetCookie(w, &http.Cookie{Name: "__Host-aeternalis_login", Path: "/", HttpOnly: true, Secure: true, SameSite: http.SameSiteLaxMode, MaxAge: -1}) + http.Redirect(w, r, "/", http.StatusSeeOther) +} +func validOrigin(r *http.Request, base string) bool { + origin := r.Header.Get("Origin") + if origin == "" { + return false + } + expected, err := url.Parse(base) + if err != nil { + return false + } + actual, err := url.Parse(origin) + return err == nil && actual.Scheme == expected.Scheme && actual.Host == expected.Host && actual.Path == "" && actual.RawQuery == "" && actual.User == nil +} diff --git a/server/internal/transport/http.go b/server/internal/transport/http.go new file mode 100644 index 0000000..a3848ea --- /dev/null +++ b/server/internal/transport/http.go @@ -0,0 +1,408 @@ +package transport + +import ( + "bytes" + "context" + "encoding/json" + "io" + "net" + "net/http" + "os" + "path/filepath" + "regexp" + "strings" + "sync" + "time" + + "aeternalis/server/internal/game" + p "aeternalis/server/internal/protocol" + "github.com/coder/websocket" +) + +type Destination struct { + ID string `json:"id"` + URL string `json:"url"` +} +type HTTP struct { + s *Service + auth *Auth + assets string + worlds []Destination + mu sync.Mutex + rates map[string]*bucket +} +type bucket struct { + tokens float64 + updated time.Time +} + +func NewHTTP(s *Service, a *Auth, assets string, worlds []Destination) *HTTP { + return &HTTP{s: s, auth: a, assets: assets, worlds: worlds, rates: map[string]*bucket{}} +} +func respond(w http.ResponseWriter, status int, v any) { + w.Header().Set("Content-Type", "application/json") + w.WriteHeader(status) + _ = json.NewEncoder(w).Encode(v) +} +func fail(w http.ResponseWriter, status int, msg string) { + respond(w, status, map[string]string{"error": msg}) +} +func decode(w http.ResponseWriter, r *http.Request, v any) error { + r.Body = http.MaxBytesReader(w, r.Body, 4096) + d := json.NewDecoder(r.Body) + d.DisallowUnknownFields() + if err := d.Decode(v); err != nil { + return err + } + var extra any + if err := d.Decode(&extra); err != io.EOF { + return io.ErrUnexpectedEOF + } + return nil +} +func (h *HTTP) allow(r *http.Request) bool { + // RemoteAddr is authoritative here. Proxy headers are deliberately not trusted. + key, _, err := net.SplitHostPort(r.RemoteAddr) + if err != nil { + key = r.RemoteAddr + } + h.mu.Lock() + defer h.mu.Unlock() + now := time.Now() + b := h.rates[key] + if b == nil { + if len(h.rates) >= 4096 { + for k, v := range h.rates { + if now.Sub(v.updated) > time.Minute { + delete(h.rates, k) + } + } + if len(h.rates) >= 4096 { + return false + } + } + b = &bucket{60, now} + h.rates[key] = b + } + b.tokens = min(60, b.tokens+now.Sub(b.updated).Seconds()*5) + b.updated = now + if b.tokens < 1 { + return false + } + b.tokens-- + return true +} +func (h *HTTP) Handler() http.Handler { + mux := http.NewServeMux() + mux.HandleFunc("GET /healthz", func(w http.ResponseWriter, r *http.Request) { + if !h.s.ready.Load() { + fail(w, 503, "world frozen") + return + } + respond(w, 200, map[string]string{"status": "alive"}) + }) + mux.HandleFunc("GET /readyz", func(w http.ResponseWriter, r *http.Request) { + if !h.s.ready.Load() { + fail(w, 503, "world unavailable") + return + } + respond(w, 200, map[string]string{"status": "ready"}) + }) + mux.HandleFunc("GET /auth/login", h.auth.login) + mux.HandleFunc("GET /auth/callback", h.auth.callback) + mux.HandleFunc("POST /auth/dev", func(w http.ResponseWriter, r *http.Request) { + if !h.auth.dev { + fail(w, 404, "not enabled") + return + } + if account, err := h.auth.account(r); err == nil { + respond(w, 200, map[string]bool{"authenticated": account != ""}) + return + } + if err := h.auth.session(w, r, "dev:"+game.ID()); err != nil { + fail(w, 503, "session unavailable") + return + } + respond(w, 200, map[string]bool{"authenticated": true}) + }) + mux.HandleFunc("POST /auth/logout", func(w http.ResponseWriter, r *http.Request) { + account, _ := h.auth.account(r) + if cookie, err := r.Cookie(h.auth.cookieName()); err == nil { + _ = h.auth.db.DeleteSession(r.Context(), hash(cookie.Value)) + } + h.s.mu.Lock() + if c := h.s.world.ForAccount(account); c != nil { + if p := h.s.peers[c.View.Entity.ID]; p != nil { + p.close() + } + } + h.s.mu.Unlock() + http.SetCookie(w, &http.Cookie{Name: h.auth.cookieName(), Path: "/", HttpOnly: true, Secure: !h.auth.dev, SameSite: http.SameSiteLaxMode, MaxAge: -1}) + respond(w, 200, map[string]bool{"ok": true}) + }) + mux.HandleFunc("GET /api/config", func(w http.ResponseWriter, r *http.Request) { + h.s.mu.Lock() + defer h.s.mu.Unlock() + b := h.s.world.Balance + respond(w, 200, map[string]any{"worldId": h.s.world.ID, "development": h.auth.dev, "worlds": h.worlds, "chunkSize": b.ChunkSize, "playerSpeed": b.PlayerSpeed, "attackRange": b.AttackRange, "gatherRange": b.GatherRange, "recipes": b.Recipes, "tickHz": b.TickHz}) + }) + mux.HandleFunc("GET /api/preview", func(w http.ResponseWriter, r *http.Request) { + h.s.mu.Lock() + defer h.s.mu.Unlock() + t := game.NewTerrain(h.s.world.Seed, h.s.world.Balance) + chunks := []p.Chunk{} + for z := -1; z <= 1; z++ { + for x := -1; x <= 1; x++ { + chunks = append(chunks, t.Chunk(x, z)) + } + } + respond(w, 200, chunks) + }) + mux.HandleFunc("GET /api/me", func(w http.ResponseWriter, r *http.Request) { + account, err := h.auth.account(r) + if err != nil { + fail(w, 401, "sign in required") + return + } + h.s.mu.Lock() + defer h.s.mu.Unlock() + if c := h.s.world.ForAccount(account); c != nil { + respond(w, 200, map[string]any{"character": c.View, "world": h.s.world.Info()}) + return + } + respond(w, 200, map[string]any{"character": nil, "world": h.s.world.Info()}) + }) + mux.HandleFunc("POST /api/join", func(w http.ResponseWriter, r *http.Request) { + account, err := h.auth.account(r) + if err != nil { + fail(w, 401, "sign in required") + return + } + var req struct { + Name string `json:"name"` + Passage string `json:"passage"` + } + if decode(w, r, &req) != nil { + fail(w, 400, "invalid request") + return + } + req.Name = strings.TrimSpace(req.Name) + if req.Passage == "" && !regexp.MustCompile(`^[A-Za-z0-9][A-Za-z0-9 _-]{1,23}$`).MatchString(req.Name) { + fail(w, 400, "Name must be 2-24 letters, numbers, spaces, or hyphens.") + return + } + c, err := h.s.join(r.Context(), account, req.Name, req.Passage) + if err != nil { + fail(w, 409, err.Error()) + return + } + respond(w, 200, c) + }) + mux.HandleFunc("GET /api/passages", func(w http.ResponseWriter, r *http.Request) { + account, err := h.auth.account(r) + if err != nil { + fail(w, 401, "sign in required") + return + } + passages, err := h.auth.db.Passages(r.Context(), account) + if err != nil { + fail(w, 503, "passages unavailable") + return + } + respond(w, 200, passages) + }) + mux.HandleFunc("POST /api/dev/boss", func(w http.ResponseWriter, r *http.Request) { + if !h.auth.dev { + fail(w, 404, "not enabled") + return + } + if _, err := h.auth.account(r); err != nil { + fail(w, 401, "sign in required") + return + } + h.s.mu.Lock() + defer h.s.mu.Unlock() + if !h.s.ready.Load() { + fail(w, 503, "world unavailable") + return + } + if err := h.s.world.TriggerBoss(); err != nil { + fail(w, 409, err.Error()) + return + } + if err := h.s.persist(r.Context(), ""); err != nil { + fail(w, 503, "save failed") + return + } + respond(w, 200, map[string]bool{"ok": true}) + }) + mux.HandleFunc("GET /ws", h.socket) + files := http.FileServer(http.Dir(h.assets)) + mux.HandleFunc("GET /", func(w http.ResponseWriter, r *http.Request) { + clean := filepath.Clean(filepath.FromSlash(r.URL.Path)) + if strings.HasPrefix(r.URL.Path, "/api/") { + fail(w, 404, "not found") + return + } + if r.URL.Path == "/" { + w.Header().Set("Cache-Control", "no-cache") + } + if strings.Contains(clean, ".env") || strings.HasPrefix(r.URL.Path, "/.") { + fail(w, 404, "not found") + return + } + if _, err := os.Stat(filepath.Join(h.assets, strings.TrimPrefix(clean, string(filepath.Separator)))); err != nil { + http.NotFound(w, r) + return + } + files.ServeHTTP(w, r) + }) + return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + w.Header().Set("X-Content-Type-Options", "nosniff") + w.Header().Set("Referrer-Policy", "no-referrer") + w.Header().Set("X-Frame-Options", "DENY") + w.Header().Set("Permissions-Policy", "camera=(), microphone=(), geolocation=()") + w.Header().Set("Content-Security-Policy", "default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; connect-src 'self'; object-src 'none'; base-uri 'none'; frame-ancestors 'none'; form-action 'self'") + if !h.auth.dev { + w.Header().Set("Strict-Transport-Security", "max-age=31536000") + } + if strings.HasPrefix(r.URL.Path, "/api/") || strings.HasPrefix(r.URL.Path, "/auth/") { + w.Header().Set("Cache-Control", "no-store") + if !h.allow(r) { + fail(w, 429, "too many requests") + return + } + } + if r.Method == "POST" && !validOrigin(r, h.auth.base) { + fail(w, 403, "origin rejected") + return + } + mux.ServeHTTP(w, r) + }) +} +func (h *HTTP) socket(w http.ResponseWriter, r *http.Request) { + if !validOrigin(r, h.auth.base) { + fail(w, 403, "origin rejected") + return + } + if !h.allow(r) { + fail(w, 429, "too many connections") + return + } + account, err := h.auth.account(r) + if err != nil { + fail(w, 401, "sign in required") + return + } + h.s.mu.Lock() + if !h.s.ready.Load() { + h.s.mu.Unlock() + fail(w, 503, "world unavailable") + return + } + c := h.s.world.ForAccount(account) + if c == nil { + h.s.mu.Unlock() + fail(w, 403, "create a character first") + return + } + id := c.View.Entity.ID + if h.s.peers[id] != nil { + h.s.mu.Unlock() + fail(w, 409, "character already connected") + return + } + if err = h.s.world.Connect(id); err != nil { + h.s.mu.Unlock() + fail(w, 403, err.Error()) + return + } + conn, err := websocket.Accept(w, r, &websocket.AcceptOptions{CompressionMode: websocket.CompressionDisabled}) + if err != nil { + h.s.world.Disconnect(id) + h.s.mu.Unlock() + return + } + conn.SetReadLimit(1024) + ctx, cancel := context.WithCancel(r.Context()) + peer := &peer{character: id, out: make(chan []byte, 2), known: map[string]bool{}, close: func() { cancel(); _ = conn.CloseNow() }} + h.s.peers[id] = peer + h.s.mu.Unlock() + defer func() { + cancel() + _ = conn.CloseNow() + h.s.mu.Lock() + delete(h.s.peers, id) + h.s.world.Disconnect(id) + h.s.mu.Unlock() + }() + go func() { + for { + select { + case <-ctx.Done(): + return + case data := <-peer.out: + writeCtx, stop := context.WithTimeout(ctx, 3*time.Second) + err := conn.Write(writeCtx, websocket.MessageText, data) + stop() + if err != nil { + peer.close() + return + } + var snap p.Snapshot + if json.Unmarshal(data, &snap) == nil && snap.Self.RemainingSeconds <= 0 { + _ = conn.Close(websocket.StatusPolicyViolation, "daily play limit reached") + peer.close() + return + } + } + } + }() + tokens := float64(40) + last := time.Now() + lastSessionCheck := last + for { + readCtx, stop := context.WithTimeout(ctx, 45*time.Second) + kind, data, err := conn.Read(readCtx) + stop() + if err != nil { + return + } + now := time.Now() + tokens = min(40, tokens+now.Sub(last).Seconds()*30) + last = now + if tokens < 1 { + _ = conn.Close(websocket.StatusPolicyViolation, "input rate exceeded") + return + } + tokens-- + if now.Sub(lastSessionCheck) > time.Minute { + if _, err = h.auth.account(r); err != nil { + return + } + lastSessionCheck = now + } + if kind != websocket.MessageText { + return + } + var intent p.Intent + d := json.NewDecoder(bytes.NewReader(data)) + d.DisallowUnknownFields() + if d.Decode(&intent) != nil { + return + } + var extra any + if d.Decode(&extra) != io.EOF { + return + } + h.s.mu.Lock() + if !h.s.ready.Load() { + h.s.mu.Unlock() + return + } + if err = h.s.world.Intent(id, intent); err != nil { + c.Message = err.Error() + } + h.s.mu.Unlock() + } +} diff --git a/server/internal/transport/http_test.go b/server/internal/transport/http_test.go new file mode 100644 index 0000000..c85c981 --- /dev/null +++ b/server/internal/transport/http_test.go @@ -0,0 +1,139 @@ +package transport + +import ( + "bytes" + "context" + "encoding/json" + "io" + "net/http" + "net/http/httptest" + "path/filepath" + "strings" + "testing" + "time" + + "aeternalis/server/content" + "aeternalis/server/internal/game" + p "aeternalis/server/internal/protocol" + "aeternalis/server/internal/store" + "github.com/coder/websocket" +) + +func TestHTTPAndSocketSecurity(t *testing.T) { + ctx, cancel := context.WithCancel(context.Background()) + defer cancel() + db, err := store.Open(ctx, "file:"+filepath.ToSlash(filepath.Join(t.TempDir(), "http.db"))) + if err != nil { + t.Fatal(err) + } + defer db.Close() + b, _ := content.Load() + w := game.New("test", 123, time.Now(), b) + lease, _, err := db.Acquire(ctx, w) + if err != nil { + t.Fatal(err) + } + svc := NewService(w, lease) + auth, _ := NewAuth(ctx, db, true, "http://127.0.0.1", "", "", "") + server := httptest.NewServer(NewHTTP(svc, auth, t.TempDir(), nil).Handler()) + defer server.Close() + auth.base = server.URL + go svc.Run(ctx) + defer func() { cancel(); <-svc.done; _ = svc.Stop(context.Background()) }() + request := func(path, origin, body string, cookie *http.Cookie) *http.Response { + t.Helper() + req, _ := http.NewRequest(http.MethodPost, server.URL+path, strings.NewReader(body)) + if origin != "" { + req.Header.Set("Origin", origin) + } + req.Header.Set("Content-Type", "application/json") + if cookie != nil { + req.AddCookie(cookie) + } + response, err := server.Client().Do(req) + if err != nil { + t.Fatal(err) + } + return response + } + for _, origin := range []string{"", "https://evil.example", "null", server.URL + ".evil"} { + r := request("/auth/dev", origin, "{}", nil) + r.Body.Close() + if r.StatusCode != 403 { + t.Fatalf("accepted origin %q", origin) + } + } + r := request("/auth/dev", server.URL, "{}", nil) + cookies := r.Cookies() + r.Body.Close() + if len(cookies) != 1 || !cookies[0].HttpOnly { + t.Fatal("missing HttpOnly session") + } + cookie := cookies[0] + r = request("/api/join", server.URL, `{"name":"Traveler","passage":"","hp":999}`, cookie) + r.Body.Close() + if r.StatusCode != 400 { + t.Fatal("unknown join field accepted") + } + r = request("/api/join", server.URL, `{"name":"Traveler","passage":""}`, cookie) + raw, _ := io.ReadAll(r.Body) + r.Body.Close() + if r.StatusCode != 200 { + t.Fatalf("join %d %s", r.StatusCode, raw) + } + var character p.Character + if err = json.Unmarshal(raw, &character); err != nil { + t.Fatal(err) + } + wsURL := "ws" + strings.TrimPrefix(server.URL, "http") + "/ws" + badCtx, stop := context.WithTimeout(ctx, time.Second) + _, response, err := websocket.Dial(badCtx, wsURL, &websocket.DialOptions{HTTPHeader: http.Header{"Origin": []string{"https://evil.example"}, "Cookie": []string{cookie.String()}}}) + stop() + if err == nil || response.StatusCode != 403 { + t.Fatal("cross-origin websocket accepted") + } + socketCtx, stopSocket := context.WithTimeout(ctx, 5*time.Second) + defer stopSocket() + conn, _, err := websocket.Dial(socketCtx, wsURL, &websocket.DialOptions{HTTPHeader: http.Header{"Origin": []string{server.URL}, "Cookie": []string{cookie.String()}}}) + if err != nil { + t.Fatal(err) + } + defer conn.CloseNow() + conn.SetReadLimit(2 << 20) + _, data, err := conn.Read(socketCtx) + if err != nil { + t.Fatal(err) + } + var s p.Snapshot + if err = json.Unmarshal(data, &s); err != nil { + t.Fatal(err) + } + if len(s.Chunks) != 9 { + t.Fatal("missing chunk snapshot") + } + if bytes.Contains(data, []byte(`"account"`)) { + t.Fatal("account identity leaked") + } + intent := p.Intent{Op: "move", Seq: 1, X: 1} + payload, _ := json.Marshal(intent) + if err = conn.Write(socketCtx, websocket.MessageText, payload); err != nil { + t.Fatal(err) + } + if err = conn.Write(socketCtx, websocket.MessageText, []byte(`{"op":"move","seq":2,"x":1,"z":0,"target":"","hp":999}`)); err != nil { + t.Fatal(err) + } + for { + _, _, err = conn.Read(socketCtx) + if err != nil { + break + } + } + if err == nil { + t.Fatal("malformed intent was not disconnected") + } +} +func TestProductionAuthRequiresOIDC(t *testing.T) { + if _, err := NewAuth(context.Background(), nil, false, "http://insecure", "", "", ""); err == nil { + t.Fatal("insecure production auth accepted") + } +} diff --git a/server/internal/transport/service.go b/server/internal/transport/service.go new file mode 100644 index 0000000..78e6091 --- /dev/null +++ b/server/internal/transport/service.go @@ -0,0 +1,149 @@ +package transport + +import ( + "context" + "encoding/json" + "errors" + "log/slog" + "maps" + "sync" + "sync/atomic" + "time" + + "aeternalis/server/internal/game" + p "aeternalis/server/internal/protocol" + "aeternalis/server/internal/store" +) + +type peer struct { + character string + out chan []byte + known map[string]bool + close func() +} +type Service struct { + mu sync.Mutex + world *game.World + lease *store.Lease + peers map[string]*peer + ready atomic.Bool + lastSave time.Time + done chan struct{} +} + +func NewService(w *game.World, l *store.Lease) *Service { + s := &Service{world: w, lease: l, peers: map[string]*peer{}, lastSave: time.Now(), done: make(chan struct{})} + s.ready.Store(true) + return s +} +func (s *Service) persist(ctx context.Context, claim string) error { + err := s.lease.Save(ctx, s.world, claim) + if err != nil { + s.ready.Store(false) + slog.Error("world frozen: persistence failed", "error", err) + for _, p := range s.peers { + p.close() + } + return err + } + s.lastSave = time.Now() + return nil +} +func (s *Service) Run(ctx context.Context) { + defer close(s.done) + ticker := time.NewTicker(time.Second / time.Duration(s.world.Balance.TickHz)) + defer ticker.Stop() + last := time.Now() + for { + select { + case <-ctx.Done(): + return + case now := <-ticker.C: + s.mu.Lock() + if !s.ready.Load() { + s.mu.Unlock() + return + } + s.world.Advance(now, now.Sub(last).Seconds()) + last = now + if s.world.Dirty() || now.Sub(s.lastSave) >= time.Second { + saveCtx, cancel := context.WithTimeout(ctx, 5*time.Second) + err := s.persist(saveCtx, "") + cancel() + if err != nil { + s.mu.Unlock() + return + } + } + if s.world.Tick%int64(s.world.Balance.TickHz/s.world.Balance.SnapshotHz) == 0 { + for id, p := range s.peers { + snapshot := s.world.Snapshot(id, p.known) + data, err := json.Marshal(snapshot) + if err != nil { + slog.Error("snapshot encoding failed", "error", err) + p.close() + continue + } + select { + case p.out <- data: + for key := range p.known { + delete(p.known, key) + } + for _, key := range snapshot.ChunkKeys { + p.known[key] = true + } + default: + p.close() + } + } + } + s.mu.Unlock() + } + } +} +func (s *Service) Stop(ctx context.Context) error { + s.mu.Lock() + defer s.mu.Unlock() + wasReady := s.ready.Swap(false) + for id, p := range s.peers { + s.world.Disconnect(id) + p.close() + } + if !wasReady { + return errors.New("world already frozen; lease will expire") + } + if err := s.lease.Save(ctx, s.world, ""); err != nil { + return err + } + return s.lease.Release(ctx) +} +func (s *Service) join(ctx context.Context, account, name, claim string) (p.Character, error) { + s.mu.Lock() + defer s.mu.Unlock() + if !s.ready.Load() { + return p.Character{}, errors.New("world unavailable") + } + var c *game.Character + var err error + if claim != "" { + c, err = s.lease.DB.ReadPassage(ctx, claim, account) + if err != nil { + return p.Character{}, errors.New("passage unavailable") + } + if err = s.world.Import(c); err != nil { + return p.Character{}, err + } + } else { + c, err = s.world.Join(account, name) + if err != nil { + return p.Character{}, err + } + } + if err = s.persist(ctx, claim); err != nil { + return p.Character{}, errors.New("world persistence unavailable") + } + view := c.View + view.Inventory = maps.Clone(view.Inventory) + view.Skills = maps.Clone(view.Skills) + return view, nil +} diff --git a/tests/game.spec.ts b/tests/game.spec.ts new file mode 100644 index 0000000..a6d6492 --- /dev/null +++ b/tests/game.spec.ts @@ -0,0 +1,88 @@ +import { test, expect } from '@playwright/test'; + +async function enter(page, name = 'Wayfarer') { + await page.goto('/'); + await expect(page.locator('#connection-status')).toHaveText('World online'); + await page.getByLabel('Character name').fill(name); + await page.getByRole('button', { name: 'Enter world' }).click(); + await expect(page.locator('#connection-status')).toHaveText('Connected'); + await expect(page.locator('#game-controls')).toBeVisible(); + await expect.poll(() => page.evaluate(() => (window as any).__aeternalis?.diagnostics().chunks)).toBe(9); +} + +test('desktop renders models, moves authoritatively, gathers, and reconnects', async ({ page }) => { + const errors: string[] = []; + page.on('pageerror', error => errors.push(error.message)); + await page.setViewportSize({ width: 1440, height: 900 }); + await enter(page); + const before = await page.evaluate(() => (window as any).__aeternalis.snapshot.self.entity.position); + await page.keyboard.down('d'); await page.waitForTimeout(1000); await page.keyboard.up('d'); + await expect.poll(() => page.evaluate(() => (window as any).__aeternalis.snapshot.self.entity.position.x)).toBeGreaterThan(before.x + 3); + await page.getByRole('button', { name: 'Gather', exact: true }).click(); + await expect.poll(() => page.evaluate(() => Object.values((window as any).__aeternalis.snapshot.self.skills).reduce((sum: number, n: any) => sum + n, 0)), { timeout: 15000 }).toBeGreaterThan(0); + await page.getByRole('button', { name: 'Inventory and crafting' }).click(); + await expect(page.locator('#inventory')).toBeVisible(); + await expect(page.locator('#inventory-items')).toContainText('Knife'); + await page.getByRole('button', { name: 'Close inventory', exact: true }).click(); + const id = await page.evaluate(() => (window as any).__aeternalis.snapshot.self.entity.id); + await page.screenshot({ path: 'test-results/desktop.png' }); + const pixels = await page.evaluate(async () => { + const canvas = document.getElementById('world') as HTMLCanvasElement; + // Read in the animation frame immediately after rendering; avoid a cleared backbuffer. + return new Promise(resolve => requestAnimationFrame(() => { + const gl = canvas.getContext('webgl2')!; + const data = new Uint8Array(64 * 64 * 4); + gl.readPixels(Math.floor(canvas.width / 2) - 32, Math.floor(canvas.height / 2) - 32, 64, 64, gl.RGBA, gl.UNSIGNED_BYTE, data); + const colors = new Set(); for (let i = 0; i < data.length; i += 4) colors.add(`${data[i]},${data[i+1]},${data[i+2]}`); + resolve(colors.size); + })); + }); + expect(pixels).toBeGreaterThan(8); + const diagnostics = await page.evaluate(() => (window as any).__aeternalis.diagnostics()); + expect(diagnostics.models).toBe(6); expect(diagnostics.frames).toBeGreaterThan(10); expect(diagnostics.triangles).toBeGreaterThan(1000); + await page.reload(); + await expect(page.locator('#connection-status')).toHaveText('Connected'); + await expect.poll(() => page.evaluate(() => (window as any).__aeternalis?.snapshot?.self.entity.id)).toBe(id); + expect(errors).toEqual([]); +}); + +test('mobile controls fit and move the character', async ({ page }) => { + await page.setViewportSize({ width: 390, height: 844 }); + await enter(page, 'Mobile'); + await expect(page.getByRole('button', { name: 'Move north' })).toBeVisible(); + const before = await page.evaluate(() => (window as any).__aeternalis.snapshot.self.entity.position.z); + const button = page.getByRole('button', { name: 'Move north' }); + await button.dispatchEvent('pointerdown', { pointerId: 1 }); await page.waitForTimeout(650); await button.dispatchEvent('pointerup', { pointerId: 1 }); + await expect.poll(() => page.evaluate(() => (window as any).__aeternalis.snapshot.self.entity.position.z)).toBeLessThan(before - 2); + expect(await page.evaluate(() => document.documentElement.scrollWidth <= innerWidth)).toBe(true); + await page.getByRole('button', { name: 'Inventory and crafting' }).click(); + const box = await page.locator('#inventory').boundingBox(); + expect(box!.x).toBeGreaterThanOrEqual(0); expect(box!.x + box!.width).toBeLessThanOrEqual(390); + await page.screenshot({ path: 'test-results/mobile.png' }); + await page.getByRole('button', { name: 'Close inventory', exact: true }).click(); + await page.setViewportSize({ width: 844, height: 390 }); + await page.screenshot({ path: 'test-results/mobile-landscape.png' }); + expect(await page.evaluate(() => document.documentElement.scrollWidth <= innerWidth)).toBe(true); +}); + +test('unauthenticated API and hostile origins cannot mutate state', async ({ request }) => { + expect((await request.post('/api/join', { data: { name: 'Intruder' }, headers: { Origin: 'https://evil.example' } })).status()).toBe(403); + expect((await request.get('/api/me')).status()).toBe(401); + const response = await request.get('/api/config'); + expect(response.headers()['content-security-policy']).toContain("frame-ancestors 'none'"); + expect(response.headers()['x-content-type-options']).toBe('nosniff'); +}); + +test('boss event is visible and accepts server-authoritative combat', async ({ page }) => { + await page.setViewportSize({ width: 1440, height: 900 }); + await enter(page, 'Boss witness'); + await page.getByRole('button', { name: 'Display settings' }).click(); + await page.getByRole('button', { name: 'Awaken Harbinger' }).click(); + await expect(page.locator('#phase-label')).toHaveText('THE UNRAVELING'); + await page.getByRole('button', { name: 'Close display settings' }).click(); + const hp = await page.evaluate(() => (window as any).__aeternalis.snapshot.world.bossHp); + await page.getByRole('button', { name: 'Target Harbinger', exact: true }).click(); + await expect.poll(() => page.evaluate(() => (window as any).__aeternalis.snapshot.world.bossHp), { timeout: 15000 }).toBeLessThan(hp); + await expect(page.locator('#boss-bar')).toBeVisible(); + await page.screenshot({ path: 'test-results/boss.png' }); +}); diff --git a/tools/bootstrap-go.ps1 b/tools/bootstrap-go.ps1 new file mode 100644 index 0000000..482435b --- /dev/null +++ b/tools/bootstrap-go.ps1 @@ -0,0 +1,12 @@ +$ErrorActionPreference = 'Stop' +$toolsDir = Join-Path $PSScriptRoot '..\.tools' +New-Item -ItemType Directory -Force -Path $toolsDir | Out-Null +$releases = Invoke-RestMethod 'https://go.dev/dl/?mode=json' +$release = $releases | Where-Object stable | Select-Object -First 1 +$archive = $release.files | Where-Object { $_.os -eq 'windows' -and $_.arch -eq 'amd64' -and $_.kind -eq 'archive' } | Select-Object -First 1 +if (-not $archive) { throw 'No stable Windows Go archive found.' } +$destination = Join-Path $toolsDir $archive.filename +Invoke-WebRequest ('https://go.dev/dl/' + $archive.filename) -OutFile $destination +if ((Get-FileHash $destination -Algorithm SHA256).Hash.ToLowerInvariant() -ne $archive.sha256) { throw 'Go checksum mismatch.' } +Expand-Archive -LiteralPath $destination -DestinationPath $toolsDir -Force +& (Join-Path $toolsDir 'go\bin\go.exe') version diff --git a/tools/bootstrap-helm.ps1 b/tools/bootstrap-helm.ps1 new file mode 100644 index 0000000..fe6f6e4 --- /dev/null +++ b/tools/bootstrap-helm.ps1 @@ -0,0 +1,13 @@ +$ErrorActionPreference = 'Stop' +[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 +$toolsDir = Join-Path $PSScriptRoot '..\.tools' +New-Item -ItemType Directory -Force -Path $toolsDir | Out-Null +$name = 'helm-v3.18.6-windows-amd64.zip' +$destination = Join-Path $toolsDir $name +$checksumResponse = (Invoke-WebRequest ('https://get.helm.sh/' + $name + '.sha256sum') -UseBasicParsing).Content +$checksumText = if ($checksumResponse -is [byte[]]) { [Text.Encoding]::ASCII.GetString($checksumResponse) } else { [string]$checksumResponse } +$expected = ($checksumText.Trim() -split '\s+')[0] +Invoke-WebRequest ('https://get.helm.sh/' + $name) -UseBasicParsing -OutFile $destination +if ((Get-FileHash $destination -Algorithm SHA256).Hash.ToLowerInvariant() -ne $expected) { throw 'Helm checksum mismatch.' } +Expand-Archive -LiteralPath $destination -DestinationPath $toolsDir -Force +& (Join-Path $toolsDir 'windows-amd64\helm.exe') version --short diff --git a/tools/copy-to-aeternalis.ps1 b/tools/copy-to-aeternalis.ps1 new file mode 100644 index 0000000..c56b867 --- /dev/null +++ b/tools/copy-to-aeternalis.ps1 @@ -0,0 +1,36 @@ +$ErrorActionPreference = 'Stop' +$source = [IO.Path]::GetFullPath((Join-Path $PSScriptRoot '..')).TrimEnd('\') +$target = 'C:\Dev\aeternalis' +if ($source -ne 'C:\Dev\RPGTheory\aeternalis-build') { throw 'Unexpected source workspace.' } +if (-not (Test-Path -LiteralPath (Join-Path $target 'planning\VISION.md'))) { throw 'Original target planning document not found.' } +$visionHash = (Get-FileHash -LiteralPath (Join-Path $target 'planning\VISION.md') -Algorithm SHA256).Hash +$excluded = @('.git', '.tools', '.local', 'node_modules', 'test-results', 'playwright-report') +$copied = 0 +foreach ($entry in Get-ChildItem -Force -LiteralPath $source) { + if ($entry.Name -in $excluded) { continue } + if ($entry.PSIsContainer) { + foreach ($file in Get-ChildItem -File -Recurse -Force -LiteralPath $entry.FullName) { + $relative = $file.FullName.Substring($source.Length + 1) + if ($relative -eq 'planning\VISION.md') { continue } + $destination = [IO.Path]::GetFullPath((Join-Path $target $relative)) + if (-not $destination.StartsWith($target + '\', [StringComparison]::OrdinalIgnoreCase)) { throw 'Copy escaped destination.' } + New-Item -ItemType Directory -Force -Path (Split-Path -Parent $destination) | Out-Null + Copy-Item -LiteralPath $file.FullName -Destination $destination -Force + if ((Get-FileHash -LiteralPath $destination -Algorithm SHA256).Hash -ne (Get-FileHash -LiteralPath $file.FullName -Algorithm SHA256).Hash) { throw "Copy mismatch: $relative" } + $copied++ + } + } else { + Copy-Item -LiteralPath $entry.FullName -Destination (Join-Path $target $entry.Name) -Force + $copied++ + } +} +if ((Get-FileHash -LiteralPath (Join-Path $target 'planning\VISION.md') -Algorithm SHA256).Hash -ne $visionHash) { throw 'Original vision changed unexpectedly.' } +$binary = Join-Path $source '.local\world-001.exe' +if (Test-Path -LiteralPath $binary) { + New-Item -ItemType Directory -Force -Path (Join-Path $target '.local') | Out-Null + $binaryDestination = Join-Path $target '.local\world-001.exe' + Copy-Item -LiteralPath $binary -Destination $binaryDestination -Force + if ((Get-FileHash -LiteralPath $binaryDestination -Algorithm SHA256).Hash -ne (Get-FileHash -LiteralPath $binary -Algorithm SHA256).Hash) { throw 'Server binary copy mismatch.' } + $copied++ +} +Write-Output "Copied $copied files into $target. Original vision and .git preserved." diff --git a/tools/create-models.py b/tools/create-models.py new file mode 100644 index 0000000..86fe865 --- /dev/null +++ b/tools/create-models.py @@ -0,0 +1,119 @@ +"""Rebuild original placeholder meshes: blender --background --python tools/create-models.py.""" +import bpy +import math +from pathlib import Path + +ROOT = Path(__file__).resolve().parent.parent +OUT = ROOT / "client" / "public" / "models" +OUT.mkdir(parents=True, exist_ok=True) + +def material(name, color, metallic=0): + mat = bpy.data.materials.new(name) + mat.diffuse_color = (*color, 1) + mat.use_nodes = True + node = mat.node_tree.nodes.get("Principled BSDF") + node.inputs["Base Color"].default_value = (*color, 1) + node.inputs["Roughness"].default_value = 0.85 + node.inputs["Metallic"].default_value = metallic + return mat + +pine = material("pine needles", (0.15, 0.34, 0.25)) +tips = material("fresh needles", (0.28, 0.48, 0.3)) +bark = material("bark", (0.24, 0.22, 0.2)) +rock = material("stone", (0.42, 0.47, 0.48)) +iron = material("iron", (0.23, 0.29, 0.3), 0.4) +cloth = material("traveler green", (0.24, 0.45, 0.41)) +linen = material("linen", (0.73, 0.76, 0.71)) +skin = material("skin", (0.7, 0.49, 0.34)) +ember = material("ember", (0.88, 0.16, 0.16)) +leaf = material("sage", (0.41, 0.64, 0.3)) +flower = material("flowers", (0.89, 0.75, 0.29)) + +def clear(): + bpy.ops.object.select_all(action="SELECT") + bpy.ops.object.delete(use_global=False) + +def cone(name, pos, radius, depth, mat, top=0, vertices=7): + bpy.ops.mesh.primitive_cone_add(vertices=vertices, radius1=radius, radius2=top, depth=depth, location=pos) + obj = bpy.context.object + obj.name = name + obj.data.materials.append(mat) + return obj + +def cube(name, pos, scale, mat): + bpy.ops.mesh.primitive_cube_add(size=1, location=pos) + obj = bpy.context.object + obj.name = name + obj.scale = scale + obj.data.materials.append(mat) + bevel = obj.modifiers.new("worn edges", "BEVEL") + bevel.width = 0.09 + bevel.segments = 1 + bpy.ops.object.transform_apply(location=False, rotation=False, scale=True) + return obj + +def ico(name, pos, scale, mat): + bpy.ops.mesh.primitive_ico_sphere_add(subdivisions=1, radius=1, location=pos) + obj = bpy.context.object + obj.name = name + obj.scale = scale + obj.data.materials.append(mat) + return obj + +def export(name): + bpy.ops.export_scene.gltf(filepath=str(OUT / (name + ".glb")), export_format="GLB", export_yup=True) + +clear() +cone("trunk", (0,0,3.7), 0.6, 7.4, bark, 0.22) +for z,r in [(5,3.8),(7.5,3),(9.5,2.2)]: + cone("canopy", (0,0,z), r, 5.2, pine if z<9 else tips) +export("tree") + +clear() +ico("boulder", (0,0,1), (2.3,1.7,1.5), rock) +for x,y in [(-0.8,0.3),(0.6,-0.7),(1,0.6)]: + cone("iron vein", (x,y,1.7), 0.35, 1.8, iron, 0.1, 5) +export("ore") + +clear() +for i in range(6): + a = i*math.tau/6 + x,y = math.cos(a)*0.6,math.sin(a)*0.6 + cone("stem",(x,y,0.6),0.09,1.2,leaf,0.04,5) + ico("leaf",(x,y,0.9),(0.6,0.3,0.2),leaf) + ico("flower",(x,y,1.4),(0.3,0.3,0.25),flower) +export("herb") + +def humanoid(boss=False): + body_mat = iron if boss else cloth + cube("torso", (0,0,1.7), (0.9,0.5,1.1), body_mat) + cube("belt", (0,0,1.22), (1,0.6,0.2), bark) + ico("head", (0,0,2.55), (0.37,0.34,0.43), rock if boss else skin) + cone("hood", (0,0.05,2.83), 0.46, 0.5, body_mat, 0.18) + for sign in [-1,1]: + cube("leg", (sign*0.24,0,0.65), (0.32,0.34,1.2), iron if boss else linen) + cube("boot", (sign*0.24,-0.12,0.15), (0.37,0.58,0.3), bark) + cube("arm", (sign*0.64,0,1.67), (0.3,0.35,1), body_mat) + ico("hand", (sign*0.64,0,1.03), (0.18,0.18,0.2), rock if boss else skin) + if boss: + for sign in [-1,1]: + horn=cone("crown", (sign*0.4,0,3.2),0.2,1.2,ember,0,5) + horn.rotation_euler[1] = sign*0.4 + cube("heart", (0,-0.28,1.9), (0.3,0.12,0.5),ember) + else: + cube("pack", (0,0.38,1.8), (0.72,0.4,0.85),bark) + cone("knife", (0.7,-0.05,0.75),0.13,0.6,iron,0,4) + +clear() +humanoid() +export("player") +clear() +humanoid(True) +export("sentinel") +clear() +humanoid(True) +for obj in bpy.context.scene.objects: + obj.location *= 4 + obj.scale *= 4 +export("boss") +bpy.ops.wm.save_as_mainfile(filepath=str(ROOT / "assets" / "harbinger.blend")) diff --git a/tools/dev-server.mjs b/tools/dev-server.mjs new file mode 100644 index 0000000..af64481 --- /dev/null +++ b/tools/dev-server.mjs @@ -0,0 +1,23 @@ +import { existsSync, mkdirSync } from 'node:fs'; +import { spawn, spawnSync } from 'node:child_process'; +import { resolve } from 'node:path'; + +const localGo = resolve('.tools/go/bin/go.exe'); +const go = process.env.GO_EXE || (existsSync(localGo) ? localGo : 'go'); +mkdirSync('.local', { recursive: true }); +const executable = resolve(`.local/world${process.platform === 'win32' ? '.exe' : ''}`); +const environment = { ...process.env, GOCACHE: resolve('.local/go-cache') }; +const result = spawnSync(go, ['build', '-o', executable, './cmd/world'], { cwd: resolve('server'), env: environment, stdio: 'inherit' }); +if (result.status !== 0) process.exit(result.status || 1); +const port = process.env.PORT || '18080'; +const child = spawn(executable, [], { + cwd: resolve('server'), stdio: 'inherit', + env: { + ...environment, APP_ENV: 'development', LISTEN_ADDR: `127.0.0.1:${port}`, + PUBLIC_URL: process.env.PUBLIC_URL || `http://127.0.0.1:${port}`, CLIENT_DIR: resolve('client/dist'), + DATABASE_URL: process.env.DATABASE_URL || `file:${resolve('.local', process.env.E2E ? `e2e-${Date.now()}.db` : 'aeternalis.db')}`, + WORLD_ID: process.env.WORLD_ID || 'world-001', + }, +}); +for (const signal of ['SIGINT', 'SIGTERM']) process.on(signal, () => { child.kill('SIGTERM'); }); +child.on('exit', code => process.exit(code || 0)); diff --git a/tools/generate-protocol.mjs b/tools/generate-protocol.mjs new file mode 100644 index 0000000..21ffcbd --- /dev/null +++ b/tools/generate-protocol.mjs @@ -0,0 +1,22 @@ +import { readFile, writeFile, mkdir } from 'node:fs/promises'; +import { quicktype, InputData, JSONSchemaInput, FetchingJSONSchemaStore } from 'quicktype-core'; + +const schema = await readFile(new URL('../schemas/protocol.json', import.meta.url), 'utf8'); +const input = new JSONSchemaInput(new FetchingJSONSchemaStore()); +await input.addSource({ name: 'Protocol', schema }); +const inputData = new InputData(); +inputData.addInput(input); +for (const [lang, path, rendererOptions] of [ + ['go', '../server/internal/protocol/generated.go', { package: 'protocol', 'just-types': 'true' }], + ['typescript', '../client/src/generated.ts', { 'just-types': 'true' }], +]) { + const result = await quicktype({ inputData, lang, rendererOptions, alphabetizeProperties: true }); + const output = '// Code generated from schemas/protocol.json. DO NOT EDIT.\n' + (lang === 'go' ? 'package protocol\n\n' : '') + result.lines.join('\n').trimEnd() + '\n'; + const url = new URL(path, import.meta.url); + if (process.argv.includes('--check')) { + if (await readFile(url, 'utf8') !== output) throw new Error(`Stale generated contract: ${path}`); + } else { + await mkdir(new URL('.', url), { recursive: true }); + await writeFile(url, output); + } +} diff --git a/tools/promote-gitops.mjs b/tools/promote-gitops.mjs new file mode 100644 index 0000000..415a9f0 --- /dev/null +++ b/tools/promote-gitops.mjs @@ -0,0 +1,34 @@ +import { spawnSync } from 'node:child_process'; +import { mkdir, readFile, writeFile } from 'node:fs/promises'; +import { resolve, relative, isAbsolute } from 'node:path'; +import YAML from 'yaml'; + +const env = process.env; +for (const key of ['GITOPS_REPOSITORY', 'GITOPS_USERNAME', 'GITOPS_TOKEN', 'IMAGE_REPOSITORY', 'IMAGE_DIGEST']) if (!env[key]) throw new Error(`Missing ${key}`); +if (!/^sha256:[a-f0-9]{64}$/.test(env.IMAGE_DIGEST)) throw new Error('Invalid image digest'); +const repository = new URL(env.GITOPS_REPOSITORY); +if (repository.protocol !== 'https:' || repository.username || repository.password) throw new Error('GITOPS_REPOSITORY must be HTTPS without credentials'); +const root = resolve('.local/gitops'); +const askpass = resolve('.local/git-askpass.cjs'); +await mkdir(resolve('.local'), { recursive: true }); +await writeFile(askpass, '#!/usr/bin/env node\nprocess.stdout.write(process.argv[2].toLowerCase().includes("username") ? process.env.GITOPS_USERNAME : process.env.GITOPS_TOKEN);\n', { mode: 0o700 }); +function git(args, cwd = process.cwd()) { + const result = spawnSync('git', args, { cwd, env: { ...env, GIT_ASKPASS: askpass, GIT_TERMINAL_PROMPT: '0' }, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] }); + if (result.status !== 0) throw new Error(`Git operation failed (${args[0]}): ${result.stderr.replaceAll(env.GITOPS_TOKEN, '[redacted]')}`); + return result.stdout; +} +git(['clone', '--branch', env.GITOPS_BRANCH || 'main', '--depth', '1', '--', repository.href, root]); +const file = resolve(root, env.GITOPS_VALUES_FILE || 'apps/aeternalis/values.yaml'); +const local = relative(root, file); +if (local.startsWith('..') || isAbsolute(local) || !/\.ya?ml$/.test(local)) throw new Error('Values file must stay inside the GitOps checkout'); +const document = YAML.parseDocument(await readFile(file, 'utf8')); +document.setIn(['image', 'repository'], env.IMAGE_REPOSITORY); +document.setIn(['image', 'digest'], env.IMAGE_DIGEST); +await writeFile(file, document.toString()); +git(['config', 'user.name', 'Aeternalis CI'], root); +git(['config', 'user.email', 'aeternalis-ci@localhost'], root); +git(['add', '--', local], root); +if (git(['diff', '--cached', '--name-only'], root).trim()) { + git(['commit', '-m', `Deploy Aeternalis ${env.IMAGE_DIGEST.slice(0,19)}`], root); + git(['push', 'origin', `HEAD:${env.GITOPS_BRANCH || 'main'}`], root); +} diff --git a/tools/start-local.ps1 b/tools/start-local.ps1 new file mode 100644 index 0000000..dd669d9 --- /dev/null +++ b/tools/start-local.ps1 @@ -0,0 +1,26 @@ +param([int]$Port = 18080, [string]$WorldId = 'world-001', [int]$Seed = 734291, [switch]$UseExisting) +$ErrorActionPreference = 'Stop' +$root = [IO.Path]::GetFullPath((Join-Path $PSScriptRoot '..')) +if ($WorldId -notmatch '^[a-z][a-z0-9-]{0,30}$') { throw 'Invalid world ID.' } +if (-not (Test-Path -LiteralPath (Join-Path $root 'client\dist\index.html'))) { throw 'Run npm ci and npm run build first.' } +$listener = [Net.Sockets.TcpListener]::new([Net.IPAddress]::Loopback, $Port) +try { $listener.Start() } finally { $listener.Stop() } +New-Item -ItemType Directory -Force -Path (Join-Path $root '.local') | Out-Null +$exe = Join-Path $root ".local\$WorldId.exe" +$env:GOCACHE = Join-Path $root '.local\go-cache' +if (-not $UseExisting) { + $go = Join-Path $root '.tools\go\bin\go.exe' + if (-not (Test-Path -LiteralPath $go)) { $go = (Get-Command go -ErrorAction Stop).Source } + Push-Location (Join-Path $root 'server') + try { & $go build -o $exe ./cmd/world; if ($LASTEXITCODE -ne 0) { throw 'Go build failed.' } } finally { Pop-Location } +} +if (-not (Test-Path -LiteralPath $exe)) { throw "Missing server binary: $exe" } +$env:APP_ENV = 'development' +$env:LISTEN_ADDR = "127.0.0.1:$Port" +$env:PUBLIC_URL = "http://127.0.0.1:$Port" +$env:CLIENT_DIR = Join-Path $root 'client\dist' +$env:DATABASE_URL = 'file:' + ((Join-Path $root '.local\aeternalis.db') -replace '\\','/') +$env:WORLD_ID = $WorldId +$env:WORLD_SEED = "$Seed" +$process = Start-Process -FilePath $exe -WorkingDirectory (Join-Path $root 'server') -WindowStyle Hidden -PassThru -RedirectStandardOutput (Join-Path $root ".local\$WorldId.stdout.log") -RedirectStandardError (Join-Path $root ".local\$WorldId.stderr.log") +Write-Output "World ${WorldId}: http://127.0.0.1:$Port (PID $($process.Id))"