Compare commits

..
18 Commits
Author SHA1 Message Date
Дмитрий 162bfd1e04 Release Manager 0.6.0 with Chinese localization, realm sync and Linux preview 2026-10-03 22:50:01 +05:00
Дмитрий 85963b0bf0 Merge branch 'review/pr11' into release/0.6.0 2026-10-03 22:45:53 +05:00
Дмитрий 79d293e120 Merge branch 'review/pr5' into release/0.6.0
# Conflicts:
#	src-tauri/src/lib.rs
2026-10-03 22:45:53 +05:00
Дмитрий 46ba3fa3dc Merge branch 'review/pr9' into release/0.6.0 2026-10-03 22:45:37 +05:00
Дмитрий beb3b03010 Merge branch 'review/pr4' into release/0.6.0 2026-10-03 22:45:37 +05:00
Fabien F. 3da9628b79 feat: Docker runtime backend for Linux (start, stop, status)
A server folder with Settings/docker.json is a Docker installation: MySQL, the
auth server and the world server run in containers controlled through the
docker command line. Every other folder is a repack and goes through the
unchanged Windows code. driver::run, process::observe and layout::scan check
for the marker first and hand over to coa_core::docker.

- start: network, runtime image (libraries only, binaries are mounted from
  Core/), database healthy, world listening, then auth. A container that stops
  while starting reports the cause found in its log (DatabaseNotRunning,
  PortInUse, ...). New error code DockerUnavailable (docker missing, stopped,
  or not usable by this user).
- stop: world (180 s to save), auth, database; exit code 0 observed.
- observe: container state, health and port readiness mapped to the existing
  ServiceState. Readiness is a connection that stays open, because Docker's
  proxy accepts connections before the server inside listens.
- passwords go by environment, never on a command line; the remote console is
  published on 127.0.0.1 only; the server's own database updater is turned off
  (it needs a mysql client the image does not have and stops the server).

Tested: 18 new tests with an in-memory Docker, and a real run through
examples/drive: database, world (ready in 11 s) and auth started from a
package-shaped folder, stopped with exit code 0 and restarted.
Not included: installation, database setup, backups and SQL through the
container, updates, firewall/exposure, the client under Wine/Proton.
2026-10-03 12:44:20 +02:00
Corfirean 1bcef5f8c2 Add CoA / Wildcard realm profiles for v0.5.0 (#10)
* Add isolated Wildcard realm profiles and release v0.5.0

* Document realm validation and align npm lock version
2026-10-03 11:12:04 +05:00
Дмитрий e7113f3ceb Test the content-scaling master switch against the bundled catalog 2026-10-03 07:24:21 +05:00
CorfireanandClaude Sonnet 5.5 831685dbd7 Changelog fragments (changelog.d) and the shared rules for people and AIs
Rules and format: https://github.com/Corfirean/coa-server-build/blob/main/changelog/GUIDE.md

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-03 07:05:52 +05:00
CorfireanandClaude Sonnet 5.5 50b48e8af5 Changelog fragments (changelog.d) and the shared rules for people and AIs
Rules and format: https://github.com/Corfirean/coa-server-build/blob/main/changelog/GUIDE.md

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-03 07:05:07 +05:00
Дмитрий c0c414f5a8 fix(report): open GitHub reports with the system URL opener (#8) 2026-10-03 06:22:49 +05:00
CorfireanandClaude Sonnet 5.5 5c21ef106d fix(config): an imported server gets the module config files it lacks at start and after an update
A server without a module's active file (an old repack updated by the Manager) made two modules log a
'missing property' line on every world tick.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-03 05:39:12 +05:00
CorfireanandClaude Sonnet 5.5 375be1b2c5 fix(nav): a module's page is hidden when the module is not on the server at all
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-03 05:18:14 +05:00
CorfireanandClaude Sonnet 5.5 1181b920d3 fix(modules): announced (Soon) modules stay greyed out, with no 'always on' note or settings
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-02 22:54:25 +05:00
CorfireanandClaude Sonnet 5.5 42dbdeae1f feat(client): updating the game client shows a progress bar on its button, no window over the app
A choice about files the owner changed appears in place below the buttons. First-time client setup keeps its dialog.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-02 22:49:36 +05:00
CorfireanandClaude Sonnet 5.5 dffb4811aa fix(update): add the new module config keys before the update's check start
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-02 21:45:56 +05:00
Fabien F. e889e0a789 feat: the Manager starts and finds its folders on Linux
- main: set WEBKIT_DISABLE_DMABUF_RENDERER=1 on Linux unless the user did.
  WebKitGTK's DMA-BUF renderer ended the process at startup with a Wayland
  "Protocol error" (seen with an NVIDIA card on Wayland).
- data_dir: use $XDG_DATA_HOME (absolute only) or ~/.local/share on Linux
  instead of the temp folder. Windows keeps %LOCALAPPDATA%.
- open_link: xdg-open on Linux, explorer.exe on Windows as before.
- tailscale_exe: look in the usual Linux locations.

Every Windows branch is the previous code unchanged.
2026-10-02 18:40:07 +02:00
Fabien F. d638bf3304 fix: snapshot ids, file modes and path case on Linux
- config snapshots: two snapshots of the same scope in the same millisecond
  shared one folder. A restore snapshots the current state just before reading
  the snapshot it restores, so on a fast disk the snapshot being restored was
  overwritten with the current files and the restore did nothing. Each snapshot
  now gets its own folder (numeric suffix when the name is taken). This was the
  intermittent failure of snapshot_restore_roundtrip_is_byte_exact_and_undoable.
- package extract: restore the execute bit on ELF binaries and #! scripts (the
  archive carries no modes). No effect on Windows.
- fsx::starts_with_ci: case-insensitive on Windows only; /srv/CoA and /srv/coa
  are different folders on Linux.
- registry test: use a root path that is a root on the running OS.

cargo test --workspace on Linux: 157 passed, 0 failed.
2026-10-02 18:40:07 +02:00
80 changed files with 4719 additions and 66 deletions

No files matched your search

+14
View File
@@ -0,0 +1,14 @@
name: changelog
# Checks the changelog.d/ fragment files with the shared rules (https://github.com/Corfirean/coa-server-build/blob/main/changelog/GUIDE.md).
on:
push:
paths: ['changelog.d/**']
pull_request:
paths: ['changelog.d/**']
permissions:
contents: read
jobs:
check:
uses: Corfirean/coa-server-build/.github/workflows/changelog-check.yml@main
+28
View File
@@ -0,0 +1,28 @@
name: check
on:
push:
branches: [master, 'release/**']
pull_request:
workflow_dispatch:
permissions:
contents: read
jobs:
test:
strategy:
fail-fast: false
matrix:
os: [windows-latest, ubuntu-latest]
runs-on: ${{ matrix.os }}
timeout-minutes: 40
steps:
- uses: actions/checkout@v7
- uses: actions/setup-node@v4
with:
node-version: 22
- name: Linux build dependencies
if: runner.os == 'Linux'
run: sudo apt-get update && sudo apt-get install -y libwebkit2gtk-4.1-dev build-essential libxdo-dev libssl-dev librsvg2-dev libayatana-appindicator3-dev
- run: npm ci
- run: node tools/check-i18n.mjs
- run: npm run build
- run: cargo test --workspace --locked
+31
View File
@@ -0,0 +1,31 @@
# AGENTS.md
<!-- changelog:start (managed by coa-server-build/changelog/changelog.py sync-instructions) -->
## Changelog (shared by all CoA repositories)
Every CoA project (server fork, bots, Content Scaling, Manager, renderer) feeds **one** changelog that is posted to the
community. When you finish a change that a **player** or a **server owner** would notice (a new feature, a changed
behaviour, a fix for something people ran into, a removed feature, a known issue), add **one small file to
`changelog.d/` in the same commit**. Do not add one for internal work (refactors, tests, CI, documentation).
File name: `YYYYMMDD-short-slug.md` (today's date). Content:
```
---
area: bots # server | bots | scaling | modules | manager | addon | client | renderer
type: fixed # added | changed | fixed | removed | known-issue
audience: players # players | admins (admins = people who run a server or use the Manager)
title: Bots no longer take Realm First achievements
---
Optional: one short paragraph in plain English for the reader (at most 300 characters).
```
- English only. The title says what changed **for the reader**, not how (at most 90 characters, starts with a capital,
no full stop). No code names, file names or commit language in the title.
- One file per change. Never edit or delete files that are already released; never write version numbers (the release
step adds them).
- Check your file: `python changelog.py check --dir changelog.d` (download the script from
https://raw.githubusercontent.com/Corfirean/coa-server-build/main/changelog/changelog.py ), or create it with
`python changelog.py new --area bots --type fixed --audience players --title "..."`.
- Full guide with examples: https://github.com/Corfirean/coa-server-build/blob/main/changelog/GUIDE.md
<!-- changelog:end -->
+17
View File
@@ -0,0 +1,17 @@
# CoA Server Manager changelog
## 0.6.0 — 2026-10-03
- Added Simplified Chinese for the interface and all server and bot settings.
- The closed game client now follows the selected CoA or Wildcard realm. Play checks the saved realm before launching; existing settings are preserved and backed up.
- Fixed GitHub reports opening Windows Explorer instead of the default browser. Long reports use the clipboard fallback.
- Fixed configuration snapshots created in the same millisecond overwriting each other during restore.
- Added experimental Linux startup: persistent state uses the XDG data folder, Tailscale detection supports Linux, and a Wayland rendering workaround respects existing user settings.
- Added experimental start, stop and status controls for manually prepared Docker servers, with private database networking and a remote console bound to localhost.
- Linux extraction restores executable permissions for ELF binaries and scripts, and paths retain case-sensitive filesystem semantics.
### Availability
This release ships the Windows installer and signed updater assets. Linux support is a development preview, not a one-click installation flow. Docker installation/database setup, SQL operations and backups, updates, Wildcard realm profiles, and Wine/Proton client launching remain unfinished. Servers must be prepared manually and use Linux binaries built with the packaged configuration layout.
Server shutdown and starting-zone scaling issues require separate server releases and are not fixed by updating the Manager alone.
+1
View File
@@ -0,0 +1 @@
@AGENTS.md
Generated
+448 -3
View File
@@ -56,6 +56,137 @@ dependencies = [
"derive_arbitrary",
]
[[package]]
name = "async-broadcast"
version = "0.7.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "435a87a52755b8f27fcf321ac4f04b2802e337c8c4872923137471ec39c37532"
dependencies = [
"event-listener",
"event-listener-strategy",
"futures-core",
"pin-project-lite",
]
[[package]]
name = "async-channel"
version = "2.5.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "924ed96dd52d1b75e9c1a3e6275715fd320f5f9439fb5a4a11fa51f4221158d2"
dependencies = [
"concurrent-queue",
"event-listener-strategy",
"futures-core",
"pin-project-lite",
]
[[package]]
name = "async-executor"
version = "1.14.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "c96bf972d85afc50bf5ab8fe2d54d1586b4e0b46c97c50a0c9e71e2f7bcd812a"
dependencies = [
"async-task",
"concurrent-queue",
"fastrand",
"futures-lite",
"pin-project-lite",
"slab",
]
[[package]]
name = "async-io"
version = "2.6.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "456b8a8feb6f42d237746d4b3e9a178494627745c3c56c6ea55d92ba50d026fc"
dependencies = [
"autocfg",
"cfg-if",
"concurrent-queue",
"futures-io",
"futures-lite",
"parking",
"polling",
"rustix",
"slab",
"windows-sys 0.61.2",
]
[[package]]
name = "async-lock"
version = "3.4.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "290f7f2596bd5b78a9fec8088ccd89180d7f9f55b94b0576823bbbdc72ee8311"
dependencies = [
"event-listener",
"event-listener-strategy",
"pin-project-lite",
]
[[package]]
name = "async-process"
version = "2.5.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "fc50921ec0055cdd8a16de48773bfeec5c972598674347252c0399676be7da75"
dependencies = [
"async-channel",
"async-io",
"async-lock",
"async-signal",
"async-task",
"blocking",
"cfg-if",
"event-listener",
"futures-lite",
"rustix",
]
[[package]]
name = "async-recursion"
version = "1.1.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "3b43422f69d8ff38f95f1b2bb76517c91589a924d1559a0e935d7c8ce0274c11"
dependencies = [
"proc-macro2",
"quote",
"syn 2.0.119",
]
[[package]]
name = "async-signal"
version = "0.2.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "52b5aaafa020cf5053a01f2a60e8ff5dccf550f0f77ec54a4e47285ac2bab485"
dependencies = [
"async-io",
"async-lock",
"atomic-waker",
"cfg-if",
"futures-core",
"futures-io",
"rustix",
"signal-hook-registry",
"slab",
"windows-sys 0.61.2",
]
[[package]]
name = "async-task"
version = "4.7.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "8b75356056920673b02621b35afd0f7dda9306d03c79a30f5c56c44cf256e3de"
[[package]]
name = "async-trait"
version = "0.1.92"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "82f6aeea286b8eb4dd3431a1be1b59d290ace00f5bfd8e2a159bc2a05e2c1667"
dependencies = [
"proc-macro2",
"quote",
"syn 3.0.6",
]
[[package]]
name = "atk"
version = "0.18.2"
@@ -163,6 +294,19 @@ dependencies = [
"objc2",
]
[[package]]
name = "blocking"
version = "1.7.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a70e4329df6cb94385eed412ec92375c3cdd8a6e502493d1229b6414e4036dfa"
dependencies = [
"async-channel",
"async-task",
"futures-io",
"futures-lite",
"piper",
]
[[package]]
name = "brotli"
version = "9.0.0"
@@ -347,7 +491,7 @@ dependencies = [
[[package]]
name = "coa-core"
version = "0.4.0"
version = "0.6.0"
dependencies = [
"base64 0.22.1",
"chrono",
@@ -375,7 +519,7 @@ dependencies = [
[[package]]
name = "coa-release"
version = "0.4.0"
version = "0.6.0"
dependencies = [
"chrono",
"coa-core",
@@ -384,7 +528,7 @@ dependencies = [
[[package]]
name = "coa-server-manager"
version = "0.4.0"
version = "0.6.0"
dependencies = [
"coa-core",
"serde",
@@ -392,6 +536,7 @@ dependencies = [
"tauri",
"tauri-build",
"tauri-plugin-dialog",
"tauri-plugin-opener",
"tauri-plugin-process",
"tauri-plugin-updater",
"tracing",
@@ -407,6 +552,15 @@ dependencies = [
"memchr",
]
[[package]]
name = "concurrent-queue"
version = "2.5.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "4ca0197aee26d1ae37445ee532fefce43251d24cc7c166799f4d46817f1d3973"
dependencies = [
"crossbeam-utils",
]
[[package]]
name = "const-oid"
version = "0.9.6"
@@ -872,6 +1026,33 @@ version = "1.2.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "4ef6b89e5b37196644d8796de5268852ff179b44e96276cf4290264843743bb7"
[[package]]
name = "endi"
version = "1.1.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "66b7e2430c6dff6a955451e2cfc438f09cea1965a9d6f87f7e3b90decc014099"
[[package]]
name = "enumflags2"
version = "0.7.12"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1027f7680c853e056ebcec683615fb6fbbc07dbaa13b4d5d9442b146ded4ecef"
dependencies = [
"enumflags2_derive",
"serde",
]
[[package]]
name = "enumflags2_derive"
version = "0.7.12"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "67c78a4d8fdf9953a5c9d458f9efe940fd97a0cab0941c075a813ac594733827"
dependencies = [
"proc-macro2",
"quote",
"syn 2.0.119",
]
[[package]]
name = "equivalent"
version = "1.0.2"
@@ -899,6 +1080,26 @@ dependencies = [
"windows-sys 0.61.2",
]
[[package]]
name = "event-listener"
version = "5.4.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "5a23add41df1562121a9393cb065eab5146a1242410f23a644851e90cfd669d2"
dependencies = [
"parking",
"pin-project-lite",
]
[[package]]
name = "event-listener-strategy"
version = "0.5.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "8be9f3dfaaffdae2972880079a491a1a8bb7cbed0b8dd7a347f668b4150a3b93"
dependencies = [
"event-listener",
"pin-project-lite",
]
[[package]]
name = "fastrand"
version = "2.5.0"
@@ -1063,6 +1264,19 @@ version = "0.3.34"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "53c0fa8157de1303bfffdaa1cc2a673bfffb60102f76b0ef4441659124373fed"
[[package]]
name = "futures-lite"
version = "2.6.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f78e10609fe0e0b3f4157ffab1876319b5b0db102a2c60dc4626306dc46b44ad"
dependencies = [
"fastrand",
"futures-core",
"futures-io",
"parking",
"pin-project-lite",
]
[[package]]
name = "futures-macro"
version = "0.3.34"
@@ -1417,6 +1631,12 @@ version = "0.5.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
[[package]]
name = "hermit-abi"
version = "0.5.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e17592d60ebacc7d5e169f4663c5f84f9161cc90328abcfe8456f41e4dfcb284"
[[package]]
name = "hex"
version = "0.4.3"
@@ -1731,6 +1951,25 @@ version = "2.12.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "791930b43c0d5973160d90a8f3894509f2b273430f5c5c73b668636d0287c5c0"
[[package]]
name = "is-docker"
version = "0.2.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "928bae27f42bc99b60d9ac7334e3a21d10ad8f1835a4e12ec3ec0464765ed1b3"
dependencies = [
"once_cell",
]
[[package]]
name = "is-wsl"
version = "0.4.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "173609498df190136aa7dea1a91db051746d339e18476eed5ca40521f02d7aa5"
dependencies = [
"is-docker",
"once_cell",
]
[[package]]
name = "itoa"
version = "1.0.18"
@@ -2446,6 +2685,17 @@ version = "1.21.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
[[package]]
name = "open"
version = "5.4.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "aa576c76302b7b808eecc68061e67336c47833ef9d22caa74dda10fa9675eebc"
dependencies = [
"dunce",
"is-wsl",
"libc",
]
[[package]]
name = "openssl"
version = "0.10.81"
@@ -2495,6 +2745,16 @@ version = "0.2.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "04744f49eae99ab78e0d5c0b603ab218f515ea8cfe5a456d7629ad883a3b6e7d"
[[package]]
name = "ordered-stream"
version = "0.2.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "9aa2b01e1d916879f73a53d01d1d6cee68adbb31d6d9177a8cfce093cced1d50"
dependencies = [
"futures-core",
"pin-project-lite",
]
[[package]]
name = "osakit"
version = "0.3.1"
@@ -2534,6 +2794,12 @@ dependencies = [
"system-deps",
]
[[package]]
name = "parking"
version = "2.2.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f38d5652c16fde515bb1ecef450ab0f6a219d619a7274976324d5e377f7dceba"
[[package]]
name = "parking_lot"
version = "0.12.5"
@@ -2622,6 +2888,17 @@ version = "0.2.17"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a89322df9ebe1c1578d689c92318e070967d1042b512afbe49518723f4e6d5cd"
[[package]]
name = "piper"
version = "0.2.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "c835479a4443ded371d6c535cbfd8d31ad92c5d23ae9770a61bc155e4992a3c1"
dependencies = [
"atomic-waker",
"fastrand",
"futures-io",
]
[[package]]
name = "pkcs8"
version = "0.10.2"
@@ -2677,6 +2954,20 @@ dependencies = [
"miniz_oxide 0.8.9",
]
[[package]]
name = "polling"
version = "3.11.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "5d0e4f59085d47d8241c88ead0f274e8a0cb551f3625263c05eb8dd897c34218"
dependencies = [
"cfg-if",
"concurrent-queue",
"hermit-abi",
"pin-project-lite",
"rustix",
"windows-sys 0.61.2",
]
[[package]]
name = "portable-atomic"
version = "1.15.0"
@@ -3451,6 +3742,16 @@ version = "2.0.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f8fadd59c855ef2080decdef8ff161eb6661b86933c9d82e5ba29dc602a55aba"
[[package]]
name = "signal-hook-registry"
version = "1.4.8"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "c4db69cba1110affc0e9f7bcd48bbf87b3f4fc7c61fc9155afd4c469eb3d6c1b"
dependencies = [
"errno",
"libc",
]
[[package]]
name = "signature"
version = "2.2.0"
@@ -3946,6 +4247,28 @@ dependencies = [
"url",
]
[[package]]
name = "tauri-plugin-opener"
version = "2.7.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d39404b2572927e0d3ed30a7ca226037f7508d22e79c96ee6ef0d42b6a4b3345"
dependencies = [
"dunce",
"glob",
"objc2-app-kit",
"objc2-foundation",
"open",
"schemars 0.8.22",
"serde",
"serde_json",
"tauri",
"tauri-plugin",
"thiserror 2.0.21",
"url",
"windows",
"zbus",
]
[[package]]
name = "tauri-plugin-process"
version = "2.4.0"
@@ -4476,6 +4799,17 @@ version = "1.20.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b6f5e870be6c3b371b77fe0ee0bafb859fa4964b4404c27de1d380043c4dda20"
[[package]]
name = "uds_windows"
version = "1.2.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f2f6fb2847f6742cd76af783a2a2c49e9375d0a111c7bef6f71cd9e738c72d6e"
dependencies = [
"memoffset",
"tempfile",
"windows-sys 0.61.2",
]
[[package]]
name = "unicode-ident"
version = "1.0.26"
@@ -5343,6 +5677,76 @@ dependencies = [
"synstructure",
]
[[package]]
name = "zbus"
version = "5.19.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "5db4be7c075cb421e4b7ee645541604239bd243ba7c357511f4ff3a74b555907"
dependencies = [
"async-broadcast",
"async-executor",
"async-io",
"async-lock",
"async-process",
"async-recursion",
"async-task",
"async-trait",
"blocking",
"enumflags2",
"event-listener",
"futures-core",
"futures-lite",
"hex",
"libc",
"ordered-stream",
"rustix",
"serde",
"serde_repr",
"tracing",
"uds_windows",
"uuid",
"windows-sys 0.61.2",
"winnow 1.0.4",
"zbus_macros",
"zbus_names",
"zvariant",
]
[[package]]
name = "zbus_macros"
version = "5.19.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "2990635d09ade6df1868f72f8cac69a876a90981e8bd3c40b1be413f8dc88f40"
dependencies = [
"proc-macro-crate 3.5.0",
"proc-macro2",
"quote",
"syn 3.0.6",
"zbus_names",
"zvariant",
"zvariant_utils",
]
[[package]]
name = "zbus_names"
version = "4.3.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d8bf88b4a3ff53e883001e0e0115b297a9d53c31b9c1edd2bfdd853e3428624e"
dependencies = [
"serde",
"winnow 1.0.4",
"zvariant",
]
[[package]]
name = "zcheapstr"
version = "1.1.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d1afec51604565183aeb5c54c20aeab286120d4e4460f7f76e3e8bb8c0d99473"
dependencies = [
"serde",
]
[[package]]
name = "zerofrom"
version = "0.1.8"
@@ -5483,3 +5887,44 @@ dependencies = [
"cc",
"pkg-config",
]
[[package]]
name = "zvariant"
version = "5.15.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "c1d34c27cc6cdd1f458427519dd6b8612f7b7e3f7b9a0b2355d041dda9869147"
dependencies = [
"endi",
"enumflags2",
"serde",
"winnow 1.0.4",
"zcheapstr",
"zvariant_derive",
"zvariant_utils",
]
[[package]]
name = "zvariant_derive"
version = "5.15.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "864155e69b4352db0c7f374917bf45d1e0c8d17659c8b3dbf9795f3673f8c497"
dependencies = [
"proc-macro-crate 3.5.0",
"proc-macro2",
"quote",
"syn 3.0.6",
"zvariant_utils",
]
[[package]]
name = "zvariant_utils"
version = "4.2.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "bad0294361a320b694a328460dc73add56c306150f5cb6bfafc44446120008a3"
dependencies = [
"proc-macro2",
"quote",
"serde",
"syn 3.0.6",
"winnow 1.0.4",
]
+1 -1
View File
@@ -3,7 +3,7 @@ resolver = "2"
members = ["crates/coa-core", "crates/coa-release", "src-tauri"]
[workspace.package]
version = "0.4.0"
version = "0.6.0"
edition = "2021"
license = "AGPL-3.0-only"
+1
View File
@@ -0,0 +1 @@
@AGENTS.md
+8
View File
@@ -18,6 +18,14 @@ no console, no config files, no database tools. Tauri 2 + Rust + React.
into **UPDATE**. Updates are authenticated (Ed25519), back up first, keep files you changed and can be rolled back.
* **Backups.** Characters, accounts and settings on demand, automatically before every update; verify and restore
from the app.
* **CoA / Wildcard realms.** Choose the active realm on Overview. A server build with Wildcard support is required;
the first switch copies world data and creates an empty character database. Accounts are shared, characters and
module settings are separate, and only one world runs. Switching a running server saves characters and restarts it.
The closed client's saved realm follows this selection and is checked again before PLAY. If the client is open,
the change is applied on the next launch through the Manager.
CoA companions are unavailable on Wildcard; other optional modules are experimental. Backups include both realms,
and database updates apply to both.
See [realm profiles and validation](docs/WILDCARD.md).
* **Companions (bots).** Fill the world with level-appropriate bots, see progress, stop spawning, take them offline,
despawn N to relieve the server, and choose how many log in at server start.
* **Realmlist switcher.** Keep named realmlists (for example *Solo* and *PTR*) and switch the game client between them from a
@@ -0,0 +1,6 @@
---
area: manager
type: added
audience: admins
title: Collections tab with transmog, vanity, riding and companion switches
---
@@ -0,0 +1,6 @@
---
area: manager
type: fixed
audience: admins
title: Companion bots are recognised from their default config file
---
@@ -0,0 +1,7 @@
---
area: manager
type: added
audience: admins
title: Delete an account from the Players page
---
You type the account name to confirm; online and system accounts are refused.
@@ -0,0 +1,6 @@
---
area: manager
type: changed
audience: admins
title: Importing a server suggests the right folder when you pick the wrong one
---
@@ -0,0 +1,7 @@
---
area: manager
type: added
audience: admins
title: Modules page with cards, status badges and per-module settings
---
Switch the companion bots and NPC Enchanter on and off; a module's settings open under its card.
@@ -0,0 +1,6 @@
---
area: manager
type: changed
audience: admins
title: Report a problem collects more and ignores repeated config warnings
---
@@ -0,0 +1,6 @@
---
area: manager
type: changed
audience: admins
title: Server settings in one panel with search, tabs and a single Save bar
---
@@ -0,0 +1,6 @@
---
area: manager
type: fixed
audience: admins
title: The update check says you are up to date instead of offering the same version
---
@@ -0,0 +1,7 @@
---
area: manager
type: fixed
audience: players
title: The game client follows the realm selected in the Manager
---
Switching realms updates the closed client's saved realm automatically. Play checks it again before launch, preventing login attempts to the previous realm. If the client is running, the update waits until the next launch.
@@ -0,0 +1,7 @@
---
area: manager
type: fixed
audience: admins
title: Configuration snapshots no longer overwrite each other
---
Snapshots created close together keep separate copies, so restoring a configuration reliably restores the selected snapshot.
@@ -0,0 +1,7 @@
---
area: manager
type: fixed
audience: admins
title: Imported servers get the module config files they lack
---
They are created at start and after an update; existing files are never changed.
+7
View File
@@ -0,0 +1,7 @@
---
area: manager
type: added
audience: admins
title: Experimental Linux startup and Docker server controls
---
The Manager can start on Linux and control manually prepared Docker servers. One-click installation, updates, backups and Wine or Proton client launch are not available yet.
@@ -0,0 +1,6 @@
---
area: manager
type: fixed
audience: admins
title: Modules marked Soon stay greyed out
---
+7
View File
@@ -0,0 +1,7 @@
---
area: manager
type: fixed
audience: admins
title: Problem reports open in the default browser
---
GitHub reports open in the default browser instead of Windows Explorer. Long reports use the clipboard fallback.
@@ -0,0 +1,7 @@
---
area: manager
type: added
audience: admins
title: Simplified Chinese is available in the Manager
---
The interface and server and bot settings are now available in Simplified Chinese. Choose Simplified Chinese in the language selector.
@@ -0,0 +1,6 @@
---
area: manager
type: fixed
audience: admins
title: The Bots page is hidden when the module is not on the server
---
@@ -0,0 +1,7 @@
---
area: manager
type: changed
audience: admins
title: Updating the game client shows a progress bar on its button
---
No window covers the app while the client updates.
@@ -0,0 +1,7 @@
---
area: manager
type: added
audience: admins
title: Switch between CoA and Wildcard while keeping separate characters and module settings
---
Run one world at a time with shared accounts. Wildcard keeps its own progress; CoA companions are unavailable there, and other modules show experimental compatibility. Backups and server updates cover both realms.
+7
View File
@@ -0,0 +1,7 @@
# changelog.d
One small Markdown file per change that a player or a server owner would notice. They are collected from every CoA
repository when a release is made. The rules and the file format are in `AGENTS.md` (section "Changelog") and, in full,
in https://github.com/Corfirean/coa-server-build/blob/main/changelog/GUIDE.md
This README is ignored by the collector.
+92
View File
@@ -0,0 +1,92 @@
//! Native smoke checks for the disposable fixture created by tools/make-fixture.ps1.
//! Never point these probes at an owned server.
use std::path::Path;
use coa_core::db::{Account, Db};
use coa_core::driver::{self, Verb};
use coa_core::realms::{self, Mode};
use coa_core::{Error, Result};
fn main() -> Result<()> {
let args: Vec<String> = std::env::args().collect();
let root = Path::new("C:/games/coa-wildcard-fixture");
let action = args.get(1).map(String::as_str).unwrap_or("view");
match action {
"select" => {
let mode = if args.get(2).map(String::as_str) == Some("wildcard") { Mode::Wildcard } else { Mode::Coa };
println!("{}", serde_json::to_string(&realms::select(root, mode)?)?);
}
"start" | "stop" => {
let out = driver::run(root, if action == "start" { Verb::StartAll } else { Verb::StopAll })?;
println!("{}", serde_json::to_string(&out)?);
if !out.ok { return Err(Error::Invalid("Fixture operation failed".into())); }
}
"probe" => {
let db = Db::from_repack(root, Account::Admin)?;
let s = realms::state(root)?;
println!("{}", db.query("SELECT * FROM acore_characters.manager_profile_probe;")?);
println!("active={} chars={} world={}", s.active.name(), s.active.schema("characters")?, s.active.schema("world")?);
}
"mark" => {
Db::from_repack(root, Account::Admin)?.query("INSERT INTO acore_characters.manager_profile_probe VALUES (22);")?;
}
"backup" => {
use coa_core::backup::{self, Kind, Trigger};
let meta = root.join("fixture-manager");
let point = backup::create(root, &meta, Kind::Full, Trigger::Manual, Some("realm isolation check".into()), &|step| println!("{step}"))?;
assert_eq!(point.realm, Mode::Wildcard);
for name in ["characters", "world", "auth", "coa-characters", "coa-world", "configs"] {
assert!(point.components.iter().any(|c| c.name == name), "Missing {name}");
}
assert!(backup::verify(&meta, &point.id)?.ok);
println!("Verified both realm backups: {}", point.id);
}
"database-checks" => {
use coa_core::backup::{self, Kind, Trigger};
use coa_core::manifest::{Manifest, Migration};
use coa_core::update::{Env, RepackEnv};
let meta = root.join("fixture-manager");
let env = RepackEnv { root, meta_dir: &meta };
env.ensure_stopped()?;
let staged = root.join("fixture-migrations");
let mut manifest: Manifest = serde_json::from_value(serde_json::json!({
"schema": 1, "kind": "update", "version": "0.5.0", "core": {"commit": null},
"builtAt": "fixture", "minManagerVersion": "0.5.0"
}))?;
for kind in ["characters", "world", "auth"] {
let sql = format!("CREATE TABLE acore_{kind}.manager_migration_probe (value INT); INSERT INTO acore_{kind}.manager_migration_probe VALUES (42);");
let path = staged.join(format!("{kind}/manager_realm_fixture.sql"));
std::fs::create_dir_all(path.parent().unwrap())?;
std::fs::write(&path, sql)?;
manifest.migrations.push(Migration { id: "manager_realm_fixture".into(), db: kind.into(), sha256: coa_core::fsx::sha256_file(&path)?, destructive: false });
}
let result = env.migrate(&manifest, &staged)?;
assert!(result.failed.is_none());
backup::with_database(root, |db| {
for mode in [Mode::Coa, Mode::Wildcard] {
let realm = db.clone().for_realm(mode);
for kind in ["characters", "world", "auth"] {
assert_eq!(realm.query(&format!("SELECT COUNT(*) FROM acore_{kind}.manager_migration_probe;"))?, "1");
}
}
Ok(())
})?;
assert!(env.migrate(&manifest, &staged)?.applied.is_empty());
let point = backup::create(root, &meta, Kind::Quick, Trigger::Manual, None, &|_| {})?;
backup::with_database(root, |db| {
db.query("INSERT INTO acore_characters.manager_profile_probe VALUES (22);")?;
Ok(())
})?;
backup::restore_database(root, &meta, &point.id, "characters")?;
backup::with_database(root, |db| {
assert_eq!(db.query("SELECT COUNT(*) FROM acore_characters.manager_profile_probe;")?, "0");
assert_eq!(db.clone().for_realm(Mode::Coa).query("SELECT value FROM acore_characters.manager_profile_probe;")?, "11");
Ok(())
})?;
println!("Both realms migrated once; shared auth migrated once; Wildcard restore left CoA intact.");
}
"view" => println!("{}", serde_json::to_string(&realms::view(root)?)?),
_ => return Err(Error::Invalid("Unknown fixture action".into())),
}
Ok(())
}
+24 -4
View File
@@ -63,6 +63,8 @@ pub struct RecoveryPoint {
pub created_at: String,
pub manager_version: String,
pub components: Vec<Component>,
#[serde(default)]
pub realm: crate::realms::Mode,
}
fn backups_dir(meta: &Path) -> PathBuf {
@@ -127,6 +129,8 @@ pub fn config_files(root: &Path) -> Vec<String> {
if root.join("RELEASE.json").is_file() {
out.push("RELEASE.json".into());
}
walk(root, &root.join("Settings/realm-profiles"), &mut out);
if root.join("Settings/realm-profile.json").is_file() { out.push("Settings/realm-profile.json".into()); }
out.sort();
out
}
@@ -191,16 +195,24 @@ pub fn create(root: &Path, meta: &Path, kind: Kind, trigger: Trigger, label: Opt
let build = || -> Result<Vec<Component>> {
let mut components = Vec::new();
for name in wanted_databases(kind) {
let schema = db::schema_of(name)?;
let realm = crate::realms::state(root)?;
let mut databases: Vec<(String, &str)> = wanted_databases(kind).iter()
.map(|name| Ok((name.to_string(), realm.active.schema(name)?))).collect::<Result<_>>()?;
if realm.wildcard_created && kind != Kind::Config {
let other = if realm.active == crate::realms::Mode::Coa { crate::realms::Mode::Wildcard } else { crate::realms::Mode::Coa };
databases.push((format!("{}-characters", other.name()), other.schema("characters")?));
if kind == Kind::Full { databases.push((format!("{}-world", other.name()), other.schema("world")?)); }
}
for (name, schema) in databases {
progress(&format!("Backing up {name} database"));
let component = with_database(root, |db| {
let db = db.clone().for_realm(crate::realms::Mode::Coa);
let size = db.schema_bytes(schema)?;
fsx::require_space(&partial, size / 2 + 32 * 1024 * 1024)?;
let tables = db.tables(schema)?.len();
let file = format!("{name}.sql.zst");
let (bytes, sha) = db.dump_to(schema, &partial.join(&file))?;
Ok(Component { name: (*name).into(), path: file, bytes, sha256: Some(sha), tables: Some(tables), files: None })
Ok(Component { name, path: file, bytes, sha256: Some(sha), tables: Some(tables), files: None })
})?;
components.push(component);
}
@@ -219,6 +231,7 @@ pub fn create(root: &Path, meta: &Path, kind: Kind, trigger: Trigger, label: Opt
}
};
let point = RecoveryPoint {
realm: crate::realms::state(root)?.active,
schema: 1,
id: id.clone(),
kind,
@@ -289,6 +302,9 @@ pub fn delete(meta: &Path, id: &str) -> Result<()> {
/// Put configuration files back. Files the backup does not contain are left alone. A safety point is taken first.
pub fn restore_configs(root: &Path, meta: &Path, id: &str) -> Result<RecoveryPoint> {
let point = get(meta, id)?;
if point.realm != crate::realms::state(root)?.active {
return Err(Error::Invalid("Select the realm this backup belongs to before restoring it.".into()));
}
let comp = point.components.iter().find(|c| c.name == "configs").ok_or_else(|| Error::Invalid("this backup has no configuration".into()))?;
if !verify(meta, id)?.ok {
return Err(Error::Invalid("This backup is damaged and cannot be restored.".into()));
@@ -314,6 +330,9 @@ pub struct DbRestore {
/// import into a staging schema, sanity-check it, then swap tables atomically and keep the old schema.
pub fn restore_database(root: &Path, meta: &Path, id: &str, name: &str) -> Result<DbRestore> {
let point = get(meta, id)?;
if point.realm != crate::realms::state(root)?.active {
return Err(Error::Invalid("Select the realm this backup belongs to before restoring it.".into()));
}
let comp = point.components.iter().find(|c| c.name == name && c.sha256.is_some()).ok_or_else(|| Error::Invalid(format!("this backup has no {name} database")))?;
if !verify(meta, id)?.ok {
return Err(Error::Invalid("This backup is damaged and cannot be restored.".into()));
@@ -322,7 +341,7 @@ pub fn restore_database(root: &Path, meta: &Path, id: &str, name: &str) -> Resul
if now.world.state != ServiceState::Stopped || now.auth.state != ServiceState::Stopped {
return Err(Error::Invalid("Stop the server before restoring a database.".into()));
}
let live = db::schema_of(name)?;
let live = if name.contains('-') { db::schema_of(name)? } else { point.realm.schema(name)? };
let expected_tables = comp.tables.unwrap_or(0);
let dump = point_dir(meta, id)?.join(&comp.path);
let stamp = chrono::Utc::now().format("%Y%m%d%H%M%S").to_string();
@@ -331,6 +350,7 @@ pub fn restore_database(root: &Path, meta: &Path, id: &str, name: &str) -> Resul
let safety = create(root, meta, Kind::Database, Trigger::BeforeRestore, Some(format!("before restoring {name} from {id}")), &|_| {})?;
with_database(root, |db| {
let db = db.clone().for_realm(crate::realms::Mode::Coa);
let staging = format!("{live}_restore_{stamp}");
let old = format!("{live}_before_restore_{stamp}");
if db.schema_exists(&staging)? || db.schema_exists(&old)? {
+103 -2
View File
@@ -1,6 +1,7 @@
//! The game client is a separate object: detected read-only, and touched only in two narrow ways -
//! The game client is a separate object: detected read-only, with targeted updates to
//! `realmlist.wtf` (backed up first) and the `Interface/AddOns/CoABotUI` folder (backed up when it differs).
//! WTF, Cache, other addons and the executable are never modified.
//! The selected realm in WTF/Config.wtf is synchronized while the client is closed.
//! Cache, other addons and the executable are never modified.
use std::collections::BTreeMap;
use std::fs;
@@ -15,6 +16,67 @@ use crate::fsx;
pub const ADDON_NAME: &str = "CoABotUI";
const EXECUTABLES: [&str; 3] = ["Ascension.exe", "Wow.exe", "WoW.exe"];
pub fn is_running(client: &Path) -> bool {
EXECUTABLES.iter().any(|exe| {
let path = client.join(exe);
let path = dunce::canonicalize(&path).unwrap_or(path);
!crate::process::find_by_exe(&path).is_empty()
})
}
fn realm_config(old: &[u8], realm: &str) -> Vec<u8> {
let eol: &[u8] = if old.windows(2).any(|w| w == b"\r\n") { b"\r\n" } else { b"\n" };
let mut out = Vec::new();
let mut replaced = false;
for line in old.split_inclusive(|b| *b == b'\n') {
let body = line.strip_prefix(b"\xef\xbb\xbf").unwrap_or(line);
let mut words = body.split(|b| b.is_ascii_whitespace()).filter(|w| !w.is_empty());
let matches = words.next().is_some_and(|w| w.eq_ignore_ascii_case(b"SET"))
&& words.next().is_some_and(|w| w.eq_ignore_ascii_case(b"realmName"));
if matches {
if line.starts_with(b"\xef\xbb\xbf") { out.extend_from_slice(b"\xef\xbb\xbf"); }
out.extend_from_slice(format!("SET realmName \"{realm}\"").as_bytes());
if line.ends_with(b"\r\n") { out.extend_from_slice(b"\r\n"); }
else if line.ends_with(b"\n") { out.push(b'\n'); }
replaced = true;
} else {
out.extend_from_slice(line);
}
}
if !replaced {
if !out.is_empty() && !out.ends_with(b"\n") { out.extend_from_slice(eol); }
out.extend_from_slice(format!("SET realmName \"{realm}\"").as_bytes());
out.extend_from_slice(eol);
}
out
}
pub fn sync_realm(client: &Path, meta: &Path, mode: crate::realms::Mode) -> Result<bool> {
sync_realm_when_closed(client, meta, mode, is_running(client))
}
fn sync_realm_when_closed(client: &Path, meta: &Path, mode: crate::realms::Mode, running: bool) -> Result<bool> {
if running { return Ok(false); }
let file = client.join("WTF/Config.wtf");
let old = match fs::read(&file) {
Ok(bytes) => bytes,
Err(e) if e.kind() == std::io::ErrorKind::NotFound => Vec::new(),
Err(e) => return Err(e.into()),
};
let realm = match mode {
crate::realms::Mode::Coa => "Conquest of Azeroth",
crate::realms::Mode::Wildcard => "Wildcard",
};
let new = realm_config(&old, realm);
if new == old { return Ok(true); }
if file.exists() {
let saved = backup_dir(meta).join(format!("config-realm-{}.wtf", uuid::Uuid::new_v4()));
fsx::atomic_write(&saved, &old)?;
}
fsx::atomic_write(&file, &new)?;
Ok(true)
}
#[derive(Debug, Clone, Serialize)]
pub struct Realmlist {
pub path: String,
@@ -253,6 +315,45 @@ pub fn launch(client: &Path) -> Result<u32> {
mod tests {
use super::*;
#[test]
fn realm_selection_preserves_other_settings_bytes_and_line_endings() {
let old = b"\xef\xbb\xbfSET realmName \"Wildcard\"\r\nSET accountName \"\xff\"\r\nset REALMNAME \"old\"\r\nSET realmList \"127.0.0.1\"";
let expected = b"\xef\xbb\xbfSET realmName \"Conquest of Azeroth\"\r\nSET accountName \"\xff\"\r\nSET realmName \"Conquest of Azeroth\"\r\nSET realmList \"127.0.0.1\"";
assert_eq!(realm_config(old, "Conquest of Azeroth"), expected);
assert_eq!(realm_config(b"SET sound 1", "Wildcard"), b"SET sound 1\nSET realmName \"Wildcard\"\n");
}
#[test]
fn realm_sync_backs_up_config_and_is_idempotent() {
let d = tempfile::tempdir().unwrap();
let c = fake_client(d.path());
let meta = d.path().join("meta");
let original = b"SET sound 1\r\nSET realmName \"Wildcard\"\r\n";
fs::write(c.join("WTF/Config.wtf"), original).unwrap();
assert!(sync_realm(&c, &meta, crate::realms::Mode::Coa).unwrap());
let backups: Vec<_> = fs::read_dir(backup_dir(&meta)).unwrap().flatten().collect();
assert_eq!(backups.len(), 1);
assert_eq!(fs::read(backups[0].path()).unwrap(), original);
assert!(sync_realm(&c, &meta, crate::realms::Mode::Coa).unwrap());
assert_eq!(fs::read_dir(backup_dir(&meta)).unwrap().count(), 1);
assert!(sync_realm(&c, &meta, crate::realms::Mode::Wildcard).unwrap());
assert_eq!(fs::read(c.join("WTF/Config.wtf")).unwrap(), original);
}
#[test]
fn running_client_defers_realm_update_until_closed() {
let d = tempfile::tempdir().unwrap();
let c = fake_client(d.path());
let meta = d.path().join("meta");
let original = b"SET realmName \"Wildcard\"\n";
fs::write(c.join("WTF/Config.wtf"), original).unwrap();
assert!(!sync_realm_when_closed(&c, &meta, crate::realms::Mode::Coa, true).unwrap());
assert_eq!(fs::read(c.join("WTF/Config.wtf")).unwrap(), original);
assert!(!backup_dir(&meta).exists());
assert!(sync_realm_when_closed(&c, &meta, crate::realms::Mode::Coa, false).unwrap());
assert_eq!(fs::read(c.join("WTF/Config.wtf")).unwrap(), b"SET realmName \"Conquest of Azeroth\"\n");
}
fn fake_client(d: &Path) -> PathBuf {
let c = d.join("wow");
fs::create_dir_all(c.join("Data/enUS")).unwrap();
+64 -3
View File
@@ -131,6 +131,17 @@ pub struct SettingsView {
/// so a server updated to a build with a new setting gets that setting's documented default. Files the launcher writes
/// itself are skipped. Returns what was created (`name.conf`) or extended (`name.conf (+n keys)`).
pub fn materialize_module_configs(root: &Path) -> Result<Vec<String>> {
materialize(root, true)
}
/// Only the missing active files, created from their `.dist`; a file that exists is not touched at all. This is what a
/// server the Manager imported (not installed) gets: without its file a module logs a "missing property" line for every
/// setting it reads, and some modules read them on every world tick.
pub fn create_missing_module_configs(root: &Path) -> Result<Vec<String>> {
materialize(root, false)
}
fn materialize(root: &Path, extend_existing: bool) -> Result<Vec<String>> {
let dir = root.join("Core").join("configs").join("modules");
let mut created = Vec::new();
let Ok(entries) = fs::read_dir(&dir) else { return Ok(created) };
@@ -155,6 +166,8 @@ pub fn materialize_module_configs(root: &Path) -> Result<Vec<String>> {
}
}
created.push(format!("{stem}.conf"));
} else if !extend_existing {
continue;
} else if let (Ok(have), Ok(dist)) = (fs::read(&active), fs::read(e.path())) {
if let (Ok(mut conf), Ok(dist)) = (parser::ConfFile::parse_bytes(&have), parser::ConfFile::parse_bytes(&dist)) {
let plan = merge::apply(&mut conf, &dist);
@@ -328,9 +341,23 @@ pub struct SnapshotInfo {
}
pub(crate) fn take_snapshot(meta_dir: &Path, scope: Scope, reason: &str, files: &[(PathBuf, Vec<u8>)]) -> Result<String> {
let id = format!("{}-{}", chrono::Utc::now().format("%Y%m%d-%H%M%S%3f"), scope.name());
let dir = snapshot_root(meta_dir).join(&id);
fs::create_dir_all(&dir)?;
let root = snapshot_root(meta_dir);
fs::create_dir_all(&root)?;
// The id is a timestamp to the millisecond. Two snapshots of the same scope can land in the same one (a restore
// snapshots the current state just before reading the snapshot it restores), and reusing the folder would overwrite
// the files about to be restored. Take a fresh folder, with a numeric suffix when the name is already used.
let base = format!("{}-{}", chrono::Utc::now().format("%Y%m%d-%H%M%S%3f"), scope.name());
let (id, dir) = (1u32..)
.map(|n| if n == 1 { base.clone() } else { format!("{base}-{n}") })
.find_map(|id| {
let dir = root.join(&id);
match fs::create_dir(&dir) {
Ok(()) => Some(Ok((id, dir))),
Err(e) if e.kind() == std::io::ErrorKind::AlreadyExists => None,
Err(e) => Some(Err(e)),
}
})
.expect("the suffix range is unbounded")?;
let mut entries = Vec::new();
for (i, (path, bytes)) in files.iter().enumerate() {
let stored = format!("{i}_{}", path.file_name().map(|n| n.to_string_lossy().into_owned()).unwrap_or_default());
@@ -423,6 +450,7 @@ fn quiet_debug_loggers(root: &Path) -> Result<Vec<String>> {
/// Apply validated `changes`. Nothing is written unless every change is valid; previous contents are snapshotted first.
pub fn save(root: &Path, meta_dir: &Path, scope: Scope, changes: &BTreeMap<String, Value>) -> Result<SaveReport> {
if scope == Scope::Bots { crate::realms::guard_module(root, "companions")?; }
let raws = validate(root, scope, changes)?;
let schema = scope.schema();
let t = targets(root, scope)?;
@@ -630,6 +658,24 @@ Spellbook.New = 5
assert!(materialize_module_configs(&root).unwrap().is_empty());
}
#[test]
fn an_imported_server_only_gets_the_files_it_lacks() {
let (_d, root, _m) = fixture();
let m = root.join("Core/configs/modules");
fs::create_dir_all(&m).unwrap();
fs::write(m.join("dynamicxp.conf.dist"), "Dynamic.XP.Reminder.Interval = 40
").unwrap();
fs::write(m.join("spellbook.conf.dist"), "Spellbook.Enable = 1
Spellbook.New = 5
").unwrap();
fs::write(m.join("spellbook.conf"), "Spellbook.Enable = 0
").unwrap();
assert_eq!(create_missing_module_configs(&root).unwrap(), vec!["dynamicxp.conf".to_string()]);
assert!(fs::read_to_string(m.join("dynamicxp.conf")).unwrap().contains("Dynamic.XP.Reminder.Interval = 40"));
assert_eq!(fs::read_to_string(m.join("spellbook.conf")).unwrap(), "Spellbook.Enable = 0
", "an existing file stays byte for byte");
}
#[test]
fn schemas_and_presets_are_self_consistent() {
for scope in [Scope::Bots, Scope::Server] {
@@ -716,6 +762,21 @@ Spellbook.New = 5
assert!(restore_snapshot(&meta, "../evil").is_err());
}
#[test]
fn snapshots_taken_in_the_same_millisecond_keep_their_own_files() {
let dir = tempfile::tempdir().unwrap();
let mut ids = std::collections::HashSet::new();
for i in 0..40 {
let path = dir.path().join("worldserver.conf");
let id = take_snapshot(dir.path(), Scope::Server, "test", &[(path, format!("version {i}").into_bytes())]).unwrap();
assert!(ids.insert(id.clone()), "snapshot id {id} was handed out twice");
}
for info in list_snapshots(dir.path()) {
assert_eq!(info.files.len(), 1);
}
assert_eq!(list_snapshots(dir.path()).len(), 40.min(KEEP_SNAPSHOTS));
}
#[test]
fn a_repeated_key_with_the_same_effective_value_is_not_drift() {
let (_d, root, _m) = fixture();
+103 -2
View File
@@ -44,6 +44,7 @@ pub struct Db {
port: u16,
user: &'static str,
password: Secret,
realm: crate::realms::Mode,
}
#[derive(Deserialize)]
@@ -67,6 +68,8 @@ fn no_window(cmd: &mut Command) {
pub const SCHEMAS: [(&str, &str); 3] = [("characters", "acore_characters"), ("auth", "acore_auth"), ("world", "acore_world")];
pub fn schema_of(kind: &str) -> Result<&'static str> {
if let Some(kind) = kind.strip_prefix("wildcard-") { return crate::realms::Mode::Wildcard.schema(kind); }
if let Some(kind) = kind.strip_prefix("coa-") { return crate::realms::Mode::Coa.schema(kind); }
SCHEMAS.iter().find(|(k, _)| *k == kind).map(|(_, s)| *s).ok_or_else(|| Error::Invalid(format!("unknown database {kind}")))
}
@@ -74,6 +77,13 @@ fn ident_ok(name: &str) -> bool {
!name.is_empty() && name.len() <= 64 && name.chars().all(|c| c.is_ascii_alphanumeric() || c == '_')
}
/// (root password, application password) from `Settings/database.json`.
pub(crate) fn credentials(root: &Path) -> Result<(String, String)> {
let c: Credentials = fsx::read_json(&root.join("Settings/database.json"))
.map_err(|_| Error::Invalid("The database settings of this server could not be read.".into()))?;
Ok((c.root_password, c.app_password))
}
impl Db {
pub fn from_repack(root: &Path, account: Account) -> Result<Db> {
let creds: Credentials = fsx::read_json(&root.join("Settings/database.json"))
@@ -87,7 +97,38 @@ impl Db {
Account::Admin => ("root", creds.root_password),
Account::App => ("acore", creds.app_password),
};
Ok(Db { bin, port: ports.mysql, user, password: Secret(password) })
Ok(Db { bin, port: ports.mysql, user, password: Secret(password), realm: crate::realms::state(root)?.active })
}
pub fn for_realm(mut self, realm: crate::realms::Mode) -> Self { self.realm = realm; self }
pub fn realm_schema<'a>(&self, name: &'a str) -> &'a str {
if self.realm == crate::realms::Mode::Wildcard {
match name {
"acore_world" => "acore_world_wildcard",
"acore_characters" => "acore_characters_wildcard",
_ => name,
}
} else { name }
}
pub fn clone_structure(&self, source: &str, dest: &str, cache: &Path) -> Result<()> {
if !ident_ok(source) || !ident_ok(dest) { return Err(Error::Invalid("Invalid schema name.".into())); }
let path = cache.join("characters-structure.sql");
self.dump_structure_to(source, &path)?;
self.run_sql_file(dest, &path)?;
std::fs::remove_file(path)?;
Ok(())
}
pub fn dump_structure_to(&self, source: &str, path: &Path) -> Result<()> {
if !ident_ok(source) { return Err(Error::Invalid("Invalid schema name.".into())); }
let mut c = self.command("mysqldump.exe");
c.args(["--no-data", "--no-tablespaces", "--skip-comments", "--default-character-set=utf8mb4", source]);
c.stdout(Stdio::from(File::create(&path)?));
let out = c.output()?;
if !out.status.success() { return Err(self.fail(&out.stderr)); }
Ok(())
}
fn command(&self, tool: &str) -> Command {
@@ -123,9 +164,10 @@ impl Db {
pub fn query(&self, sql: &str) -> Result<String> {
let mut c = self.command("mysql.exe");
c.args(["--batch", "--skip-column-names", "--connect-timeout=5"]);
c.args(["--default-character-set=utf8mb4", "--max-allowed-packet=128M"]);
c.stdin(Stdio::piped());
let mut child = c.spawn()?;
child.stdin.take().expect("piped").write_all(sql.as_bytes())?;
child.stdin.take().expect("piped").write_all(route_sql(sql, self.realm).as_bytes())?;
let out = child.wait_with_output()?;
if !out.status.success() {
return Err(self.fail(&out.stderr));
@@ -134,6 +176,7 @@ impl Db {
}
pub fn schema_exists(&self, name: &str) -> Result<bool> {
let name = self.realm_schema(name);
if !ident_ok(name) {
return Err(Error::Invalid("bad schema name".into()));
}
@@ -141,6 +184,7 @@ impl Db {
}
pub fn tables(&self, schema: &str) -> Result<Vec<String>> {
let schema = self.realm_schema(schema);
if !ident_ok(schema) {
return Err(Error::Invalid("bad schema name".into()));
}
@@ -150,6 +194,7 @@ impl Db {
/// Bytes of data + index the schema occupies (used to estimate backup size).
pub fn schema_bytes(&self, schema: &str) -> Result<u64> {
let schema = self.realm_schema(schema);
if !ident_ok(schema) {
return Err(Error::Invalid("bad schema name".into()));
}
@@ -159,6 +204,7 @@ impl Db {
/// Stored routines / triggers / views make a table-level swap unsafe; count them.
pub fn extra_objects(&self, schema: &str) -> Result<u64> {
let schema = self.realm_schema(schema);
if !ident_ok(schema) {
return Err(Error::Invalid("bad schema name".into()));
}
@@ -170,6 +216,7 @@ impl Db {
/// Consistent dump of one schema, zstd-compressed to `out`. Returns (compressed bytes, sha256 of the file).
pub fn dump_to(&self, schema: &str, out: &Path) -> Result<(u64, String)> {
let schema = self.realm_schema(schema);
if !ident_ok(schema) {
return Err(Error::Invalid("bad schema name".into()));
}
@@ -203,9 +250,15 @@ impl Db {
/// Run a plain SQL file against `schema`; the first error aborts and is returned.
pub fn run_sql_file(&self, schema: &str, file: &Path) -> Result<()> {
let schema = self.realm_schema(schema);
if !ident_ok(schema) {
return Err(Error::Invalid("bad schema name".into()));
}
if self.realm == crate::realms::Mode::Wildcard {
let sql = std::fs::read_to_string(file)?;
self.query(&format!("SET NAMES utf8mb4 COLLATE utf8mb4_unicode_ci; USE `{schema}`;\n{sql}"))?;
return Ok(());
}
let mut c = self.command("mysql.exe");
c.args(["--default-character-set=utf8mb4", "--init-command=SET NAMES utf8mb4 COLLATE utf8mb4_unicode_ci", "--max-allowed-packet=128M"]);
c.arg(schema);
@@ -219,6 +272,7 @@ impl Db {
/// Import a dump produced by `dump_to` into `schema` (which must already exist and be empty).
pub fn import_from(&self, schema: &str, dump: &Path) -> Result<()> {
let schema = self.realm_schema(schema);
if !ident_ok(schema) {
return Err(Error::Invalid("bad schema name".into()));
}
@@ -278,3 +332,50 @@ pub fn write_console_credentials(root: &Path, password: &str) -> Result<()> {
pub fn valid_identifier(name: &str) -> bool {
ident_ok(name)
}
// Route only SQL identifiers. User names, values, comments and longer identifiers remain untouched.
fn route_sql(sql: &str, realm: crate::realms::Mode) -> String {
if realm == crate::realms::Mode::Coa { return sql.into(); }
let bytes = sql.as_bytes();
let mut out = String::new();
let mut i = 0;
while i < bytes.len() {
let start = i;
if matches!(bytes[i], b'\'' | b'"') {
let quote = bytes[i]; i += 1;
while i < bytes.len() {
if bytes[i] == b'\\' { i = (i + 2).min(bytes.len()); }
else if bytes[i] == quote {
i += 1;
if i < bytes.len() && bytes[i] == quote { i += 1; } else { break; }
} else { i += 1; }
}
out.push_str(&sql[start..i]);
} else if bytes[i] == b'#' || sql[i..].starts_with("--") || sql[i..].starts_with("/*") {
if sql[i..].starts_with("/*") {
i = sql[i + 2..].find("*/").map(|p| i + p + 4).unwrap_or(bytes.len());
} else { i = sql[i..].find('\n').map(|p| i + p).unwrap_or(bytes.len()); }
out.push_str(&sql[start..i]);
} else if bytes[i].is_ascii_alphanumeric() || bytes[i] == b'_' {
while i < bytes.len() && (bytes[i].is_ascii_alphanumeric() || bytes[i] == b'_') { i += 1; }
out.push_str(match &sql[start..i] {
"acore_world" => "acore_world_wildcard",
"acore_characters" => "acore_characters_wildcard",
other => other,
});
} else {
let c = sql[i..].chars().next().unwrap(); out.push(c); i += c.len_utf8();
}
}
out
}
#[cfg(test)]
mod realm_tests {
use super::*;
#[test]
fn routes_schema_identifiers_without_rewriting_account_values() {
let sql = "SELECT * FROM `acore_characters`.characters WHERE name='acore_world' AND x=\"acore_characters\"; -- acore_world\nSELECT * FROM acore_world.items;";
assert_eq!(route_sql(sql, crate::realms::Mode::Wildcard), "SELECT * FROM `acore_characters_wildcard`.characters WHERE name='acore_world' AND x=\"acore_characters\"; -- acore_world\nSELECT * FROM acore_world_wildcard.items;");
}
}
@@ -0,0 +1,7 @@
# Runtime image of the CoA server. It holds only the shared libraries the server binaries need (checked with ldd on
# Ubuntu 26.04: libmysqlclient24, ICU 78, ncurses 6 and readline 8); the binaries themselves are mounted from the
# server folder, so an update replaces files and does not rebuild this image.
FROM ubuntu:26.04
RUN apt-get update \
&& apt-get install -y --no-install-recommends libmysqlclient24 libicu78 libncurses6 libreadline8t64 \
&& rm -rf /var/lib/apt/lists/*
+151
View File
@@ -0,0 +1,151 @@
//! The one place that runs the `docker` command line. Everything else talks to the `Docker` trait, so the logic can
//! be tested without Docker. Only the `docker` client is needed on the computer (no `docker compose`).
use std::io::{Read, Write};
use std::net::{SocketAddr, TcpStream};
use std::process::{Command, Stdio};
use std::time::{Duration, Instant};
use crate::error::{Error, Result};
#[derive(Debug, Clone, Default)]
pub struct Output {
/// None when the command timed out.
pub code: Option<i32>,
pub stdout: String,
pub stderr: String,
}
impl Output {
pub fn ok(&self) -> bool {
self.code == Some(0)
}
/// stdout and stderr, trimmed, for the technical details shown to the user.
pub fn text(&self) -> String {
format!("{}\n{}", self.stdout.trim(), self.stderr.trim()).trim().to_string()
}
}
/// What to run. `env` is where secrets go: a container option `-e NAME` (without a value) copies it from the
/// environment of the docker client, so a password never appears on a command line.
pub struct Call<'a> {
pub args: Vec<String>,
pub env: Vec<(String, String)>,
pub stdin: Option<&'a [u8]>,
pub timeout: Duration,
}
impl<'a> Call<'a> {
pub fn new(args: &[&str], timeout: Duration) -> Call<'a> {
Call { args: args.iter().map(|a| a.to_string()).collect(), env: Vec::new(), stdin: None, timeout }
}
}
pub trait Docker {
/// Err only when `docker` cannot be started at all (not installed).
fn run(&self, call: &Call) -> Result<Output>;
/// Is a server really listening on this address? Docker's own proxy accepts connections on a published port even
/// when nothing listens inside the container, and closes them at once; so a connection that stays open (or gets
/// data, as the world server's greeting) is the proof, a connect alone is not.
fn port_open(&self, addr: SocketAddr) -> bool {
let Ok(mut s) = TcpStream::connect_timeout(&addr, Duration::from_millis(400)) else { return false };
let _ = s.set_read_timeout(Some(Duration::from_millis(300)));
match s.read(&mut [0u8; 1]) {
Ok(0) => false,
Ok(_) => true,
Err(e) => matches!(e.kind(), std::io::ErrorKind::WouldBlock | std::io::ErrorKind::TimedOut),
}
}
fn pause(&self, d: Duration) {
std::thread::sleep(d);
}
}
pub struct SystemDocker;
impl Docker for SystemDocker {
fn run(&self, call: &Call) -> Result<Output> {
let mut cmd = Command::new("docker");
cmd.args(&call.args).envs(call.env.iter().map(|(k, v)| (k, v))).stdout(Stdio::piped()).stderr(Stdio::piped());
cmd.stdin(if call.stdin.is_some() { Stdio::piped() } else { Stdio::null() });
#[cfg(windows)]
{
use std::os::windows::process::CommandExt;
cmd.creation_flags(0x0800_0000); // CREATE_NO_WINDOW
}
let mut child = cmd.spawn().map_err(|e| Error::Invalid(format!("docker could not be started: {e}")))?;
if let (Some(data), Some(mut stdin)) = (call.stdin, child.stdin.take()) {
// Closing stdin at the end of this block tells docker the input is complete.
let _ = stdin.write_all(data);
}
let mut out = child.stdout.take().expect("piped");
let mut err = child.stderr.take().expect("piped");
let out_t = std::thread::spawn(move || {
let mut s = String::new();
let _ = out.read_to_string(&mut s);
s
});
let err_t = std::thread::spawn(move || {
let mut s = String::new();
let _ = err.read_to_string(&mut s);
s
});
let deadline = Instant::now() + call.timeout;
let code = loop {
if let Some(st) = child.try_wait()? {
break st.code();
}
if Instant::now() > deadline {
// Only the docker client is stopped; the containers it started keep running.
let _ = child.kill();
let _ = child.wait();
break None;
}
std::thread::sleep(Duration::from_millis(50));
};
Ok(Output { code, stdout: out_t.join().unwrap_or_default(), stderr: err_t.join().unwrap_or_default() })
}
}
#[cfg(test)]
mod tests {
use super::*;
use std::net::TcpListener;
#[test]
fn a_published_port_with_nothing_behind_it_does_not_count_as_open() {
let sys = SystemDocker;
// Closed port.
let closed = TcpListener::bind("127.0.0.1:0").unwrap();
let closed_addr = closed.local_addr().unwrap();
drop(closed);
assert!(!sys.port_open(closed_addr));
// Like docker-proxy without a backend: accepts, then closes at once.
let proxy = TcpListener::bind("127.0.0.1:0").unwrap();
let proxy_addr = proxy.local_addr().unwrap();
let t = std::thread::spawn(move || drop(proxy.accept().unwrap()));
assert!(!sys.port_open(proxy_addr));
t.join().unwrap();
// A server that waits for the client (auth server) and one that greets first (world server).
let quiet = TcpListener::bind("127.0.0.1:0").unwrap();
let quiet_addr = quiet.local_addr().unwrap();
let t = std::thread::spawn(move || {
let (_s, _) = quiet.accept().unwrap();
std::thread::sleep(Duration::from_millis(700));
});
assert!(sys.port_open(quiet_addr));
t.join().unwrap();
let greeter = TcpListener::bind("127.0.0.1:0").unwrap();
let greeter_addr = greeter.local_addr().unwrap();
let t = std::thread::spawn(move || {
let (mut s, _) = greeter.accept().unwrap();
s.write_all(b"hello").unwrap();
std::thread::sleep(Duration::from_millis(400));
});
assert!(sys.port_open(greeter_addr));
t.join().unwrap();
}
}
+903
View File
@@ -0,0 +1,903 @@
//! Start, stop and observe the three containers of a Docker installation.
//!
//! Start order matters: the database must be healthy before the game servers, and the world server must be listening
//! before the auth server, because the auth server refuses to run while no realm is online.
use std::collections::HashMap;
use std::net::{IpAddr, Ipv4Addr, SocketAddr};
use std::path::Path;
use std::time::Duration;
use serde_json::Value;
use super::cli::{Call, Docker, SystemDocker};
use super::{runtime_image, Config, Names, RUNTIME_DOCKERFILE};
use crate::driver::{DriverOutcome, Verb};
use crate::error::{ErrorCode, Result};
use crate::layout::{read_ports, Ports};
use crate::process::{Observed, ServiceState, ServiceStatus};
/// Where the server folder and the game data appear inside the containers.
const CORE: &str = "/srv/core";
const DATA: &str = "/srv/data";
/// Fixed ports inside the containers; the host side comes from `Settings/repack.json`.
const AUTH_PORT: u16 = 3724;
const WORLD_PORT: u16 = 8085;
const RA_PORT: u16 = 3443;
const QUICK: Duration = Duration::from_secs(20);
const POLL: Duration = Duration::from_secs(1);
const DB_WAIT: u32 = 120;
const WORLD_WAIT: u32 = 300;
const AUTH_WAIT: u32 = 60;
struct Failure {
code: ErrorCode,
output: String,
}
type Step<T> = std::result::Result<T, Failure>;
#[derive(Default)]
struct Log(Vec<String>);
impl Log {
fn say(&mut self, line: impl Into<String>) {
self.0.push(line.into());
}
}
fn fail<T>(code: ErrorCode, output: impl Into<String>) -> Step<T> {
Err(Failure { code, output: output.into() })
}
pub fn run(root: &Path, verb: Verb) -> Result<DriverOutcome> {
run_with(&SystemDocker, root, verb)
}
pub fn run_with(d: &dyn Docker, root: &Path, verb: Verb) -> Result<DriverOutcome> {
let cfg = Config::load(root)?;
let mut log = Log::default();
let result = match verb {
Verb::StartAll => start(d, root, &cfg, true, &mut log),
Verb::StartMysql => start(d, root, &cfg, false, &mut log),
Verb::StopAll => stop(d, &cfg, &mut log),
};
Ok(match result {
Ok(()) => DriverOutcome { ok: true, exit_code: Some(0), code: None, human: None, output: log.0.join("\n") },
Err(f) => {
log.say(f.output);
DriverOutcome { ok: false, exit_code: None, code: Some(f.code), human: Some(f.code.human()), output: log.0.join("\n") }
}
})
}
// ---------------------------------------------------------------------------------------------------- docker calls
/// Run docker; only "docker cannot be started" is an error here, a non-zero exit is returned for the caller to judge.
fn docker(d: &dyn Docker, args: &[&str], timeout: Duration) -> Step<super::cli::Output> {
d.run(&Call::new(args, timeout)).or_else(|e| fail(ErrorCode::DockerUnavailable, e.to_string()))
}
fn preflight(d: &dyn Docker, log: &mut Log) -> Step<()> {
let o = docker(d, &["version", "--format", "{{.Server.Version}}"], QUICK)?;
if !o.ok() {
// Typical causes: the service is stopped, or the user is not allowed to talk to it.
return fail(ErrorCode::DockerUnavailable, o.text());
}
log.say(format!("docker {}", o.stdout.trim()));
Ok(())
}
#[derive(Debug, Clone, PartialEq)]
pub(crate) struct Container {
pub status: String,
pub exit_code: i64,
pub oom_killed: bool,
pub pid: Option<u32>,
pub started_at: Option<String>,
/// "healthy", "unhealthy" or "starting" when the container has a health check.
pub health: Option<String>,
}
impl Container {
fn running(&self) -> bool {
self.status == "running"
}
}
/// State of the named containers that exist (the others are simply absent from the result).
fn inspect(d: &dyn Docker, names: &[&str]) -> Step<HashMap<String, Container>> {
let mut args = vec!["inspect"];
args.extend_from_slice(names);
let o = docker(d, &args, QUICK)?;
// docker prints what it found and complains about the rest with a non-zero exit code.
let found = parse_inspect(&o.stdout);
if !o.ok() && found.is_empty() && !o.stderr.contains("No such object") && !o.stderr.contains("no such object") {
return fail(ErrorCode::DockerUnavailable, o.text());
}
Ok(found)
}
pub(crate) fn parse_inspect(json: &str) -> HashMap<String, Container> {
let Ok(Value::Array(items)) = serde_json::from_str::<Value>(json) else { return HashMap::new() };
items
.iter()
.filter_map(|v| {
let name = v["Name"].as_str()?.trim_start_matches('/').to_string();
let s = &v["State"];
Some((
name,
Container {
status: s["Status"].as_str()?.to_string(),
exit_code: s["ExitCode"].as_i64().unwrap_or(0),
oom_killed: s["OOMKilled"].as_bool().unwrap_or(false),
pid: s["Pid"].as_u64().filter(|p| *p > 0).map(|p| p as u32),
started_at: s["StartedAt"].as_str().map(str::to_string),
health: s["Health"]["Status"].as_str().map(str::to_string),
},
))
})
.collect()
}
fn strip_ansi(s: &str) -> String {
let mut out = String::with_capacity(s.len());
let mut chars = s.chars().peekable();
while let Some(c) = chars.next() {
if c == '\u{1b}' && chars.peek() == Some(&'[') {
for n in chars.by_ref() {
if n.is_ascii_alphabetic() {
break;
}
}
} else {
out.push(c);
}
}
out
}
/// Last lines a container wrote, as the technical details of a failure, and the cause they point to.
fn why_stopped(d: &dyn Docker, name: &str) -> (ErrorCode, String) {
let text = d.run(&Call::new(&["logs", "--tail", "60", name], QUICK)).map(|o| strip_ansi(&o.text())).unwrap_or_default();
(crate::health::diagnose(&text).unwrap_or(ErrorCode::StartupFailed), format!("--- last lines of {name}\n{text}"))
}
// ------------------------------------------------------------------------------------------------------------ start
struct Secrets {
root: String,
app: String,
}
fn start(d: &dyn Docker, root: &Path, cfg: &Config, with_game: bool, log: &mut Log) -> Step<()> {
preflight(d, log)?;
let n = cfg.names();
let secrets = crate::db::credentials(root).map(|(root, app)| Secrets { root, app }).or_else(|e| fail(ErrorCode::ServerFilesIncomplete, e.to_string()))?;
let ports = read_ports(root);
let state = inspect(d, &[&n.db, &n.world, &n.auth])?;
if !docker(d, &["network", "inspect", &n.network], QUICK)?.ok() {
let o = docker(d, &["network", "create", &n.network], QUICK)?;
if !o.ok() {
return fail(ErrorCode::StartupFailed, o.text());
}
log.say(format!("created network {}", n.network));
}
if !state.get(&n.db).is_some_and(Container::running) {
remove(d, &n.db);
let mut call = Call::new(&[], Duration::from_secs(120));
call.args = db_args(cfg, &n);
call.env = vec![("MYSQL_ROOT_PASSWORD".into(), secrets.root.clone())];
let o = d.run(&call).or_else(|e| fail(ErrorCode::DockerUnavailable, e.to_string()))?;
if !o.ok() {
return fail(ErrorCode::StartupFailed, o.text());
}
log.say(format!("started {}", n.db));
}
wait_database(d, &n, log)?;
if !with_game {
return Ok(());
}
ensure_image(d, log)?;
std::fs::create_dir_all(root.join("Core/Logs")).map_err(|e| Failure { code: ErrorCode::ServerFilesIncomplete, output: e.to_string() })?;
let owner = owner_of(root);
let host = std::fs::canonicalize(root).unwrap_or_else(|_| root.to_path_buf());
let host = crate::fsx::canonicalize_lenient(&host).unwrap_or(host);
if !state.get(&n.world).is_some_and(Container::running) {
remove(d, &n.world);
let mut call = Call::new(&[], Duration::from_secs(60));
call.args = game_args(cfg, &n, GameKind::World, &host, ports.world, ports.ra, owner.as_deref());
call.env = database_env(&secrets, true);
run_container(d, &call, &n.world, log)?;
}
wait_listening(d, cfg, &n.world, ports.world, WORLD_WAIT, log)?;
if !state.get(&n.auth).is_some_and(Container::running) {
remove(d, &n.auth);
let mut call = Call::new(&[], Duration::from_secs(60));
call.args = game_args(cfg, &n, GameKind::Auth, &host, ports.auth, 0, owner.as_deref());
call.env = database_env(&secrets, false);
run_container(d, &call, &n.auth, log)?;
}
wait_listening(d, cfg, &n.auth, ports.auth, AUTH_WAIT, log)?;
Ok(())
}
fn remove(d: &dyn Docker, name: &str) {
// A stopped container of the same name is replaced, so its settings always match the files on disk.
let _ = d.run(&Call::new(&["rm", "-f", name], QUICK));
}
fn run_container(d: &dyn Docker, call: &Call, name: &str, log: &mut Log) -> Step<()> {
let o = d.run(call).or_else(|e| fail(ErrorCode::DockerUnavailable, e.to_string()))?;
if !o.ok() {
let text = o.text();
let code = if text.contains("port is already allocated") || text.contains("address already in use") { ErrorCode::PortInUse } else { ErrorCode::StartupFailed };
return fail(code, text);
}
log.say(format!("started {name}"));
Ok(())
}
fn ensure_image(d: &dyn Docker, log: &mut Log) -> Step<()> {
let image = runtime_image();
if docker(d, &["image", "inspect", &image], QUICK)?.ok() {
return Ok(());
}
log.say(format!("building {image} (first start only)"));
let mut call = Call::new(&["build", "--tag", &image, "-"], Duration::from_secs(900));
call.stdin = Some(RUNTIME_DOCKERFILE.as_bytes());
let o = d.run(&call).or_else(|e| fail(ErrorCode::DockerUnavailable, e.to_string()))?;
if !o.ok() {
return fail(ErrorCode::StartupFailed, o.text());
}
Ok(())
}
fn wait_database(d: &dyn Docker, n: &Names, log: &mut Log) -> Step<()> {
for _ in 0..DB_WAIT {
let state = inspect(d, &[&n.db])?;
match state.get(&n.db) {
Some(c) if c.running() && c.health.as_deref() == Some("healthy") => {
log.say("database is ready");
return Ok(());
}
Some(c) if !c.running() => {
let (code, text) = why_stopped(d, &n.db);
return fail(if code == ErrorCode::StartupFailed { ErrorCode::DatabaseNotRunning } else { code }, text);
}
None => return fail(ErrorCode::DatabaseNotRunning, "the database container does not exist"),
_ => d.pause(POLL),
}
}
fail(ErrorCode::DatabaseNotRunning, "the database did not become ready in time")
}
/// Wait until the container accepts connections on its published port; give up when it stops or on timeout.
fn wait_listening(d: &dyn Docker, cfg: &Config, name: &str, port: u16, seconds: u32, log: &mut Log) -> Step<()> {
let addr = SocketAddr::new(connect_ip(cfg), port);
for _ in 0..seconds {
let state = inspect(d, &[name])?;
match state.get(name) {
Some(c) if c.running() => {
if d.port_open(addr) {
log.say(format!("{name} is listening on port {port}"));
return Ok(());
}
d.pause(POLL);
}
_ => {
let (code, text) = why_stopped(d, name);
return fail(code, text);
}
}
}
let (code, text) = why_stopped(d, name);
fail(code, format!("{name} was not listening on port {port} after {seconds} seconds\n{text}"))
}
/// Address to test a published port on from this computer.
fn connect_ip(cfg: &Config) -> IpAddr {
match cfg.bind_address.parse::<IpAddr>() {
Ok(ip) if !ip.is_unspecified() => ip,
_ => IpAddr::V4(Ipv4Addr::LOCALHOST),
}
}
// ------------------------------------------------------------------------------------------------- argument lists
fn db_args(cfg: &Config, n: &Names) -> Vec<String> {
let mut a: Vec<String> = ["run", "--detach", "--name"].iter().map(|s| s.to_string()).collect();
a.push(n.db.clone());
a.extend(["--network".into(), n.network.clone(), "--network-alias".into(), "db".into()]);
a.extend(["--label".into(), format!("coa.project={}", cfg.project)]);
a.extend(["--volume".into(), format!("{}:/var/lib/mysql", n.volume)]);
// The password comes from the environment of the docker client, not from this command line.
a.extend(["--env".into(), "MYSQL_ROOT_PASSWORD".into()]);
// "mysqladmin ping" succeeds as soon as the server answers, with or without a login.
a.extend(["--health-cmd".into(), "mysqladmin ping --silent".into()]);
a.extend(["--health-interval".into(), "5s".into(), "--health-timeout".into(), "5s".into(), "--health-retries".into(), "40".into()]);
a.extend(["--stop-timeout".into(), "60".into()]);
a.push(cfg.mysql_image.clone());
a
}
#[derive(Clone, Copy, PartialEq)]
enum GameKind {
World,
Auth,
}
/// Connection strings: host;port;user;password;database. They hold the password, so they travel by environment.
fn database_env(s: &Secrets, world: bool) -> Vec<(String, String)> {
let info = |db: &str| format!("db;3306;acore;{};{db}", s.app);
let mut env = vec![("AC_LOGIN_DATABASE_INFO".to_string(), info("acore_auth"))];
if world {
env.push(("AC_WORLD_DATABASE_INFO".into(), info("acore_world")));
env.push(("AC_CHARACTER_DATABASE_INFO".into(), info("acore_characters")));
}
env
}
fn game_args(cfg: &Config, n: &Names, kind: GameKind, host: &Path, port: u16, ra_port: u16, owner: Option<&str>) -> Vec<String> {
let (name, alias, binary, conf, inner_port) = match kind {
GameKind::World => (&n.world, "world", "./worldserver", "configs/worldserver.conf", WORLD_PORT),
GameKind::Auth => (&n.auth, "auth", "./authserver", "configs/authserver.conf", AUTH_PORT),
};
let mut a: Vec<String> = vec!["run".into(), "--detach".into(), "--name".into(), name.clone()];
a.extend(["--network".into(), n.network.clone(), "--network-alias".into(), alias.into()]);
a.extend(["--label".into(), format!("coa.project={}", cfg.project)]);
if let Some(o) = owner {
// The server writes logs and configuration into the folder: do it as the person who owns it.
a.extend(["--user".into(), o.into()]);
}
a.extend(["--workdir".into(), CORE.into()]);
a.extend(["--volume".into(), format!("{}:{CORE}", host.join("Core").display())]);
a.extend(["--publish".into(), format!("{}:{port}:{inner_port}", cfg.bind_address)]);
// Settings that must not depend on the configuration files: where things are inside the container, and listening
// on every interface of the container (the published address decides who can connect).
let env = |k: &str, v: &str| ["--env".to_string(), format!("{k}={v}")];
a.extend(env("AC_BIND_IP", "0.0.0.0"));
a.extend(env(if kind == GameKind::World { "AC_WORLD_SERVER_PORT" } else { "AC_REALM_SERVER_PORT" }, &inner_port.to_string()));
a.extend(env("AC_LOGS_DIR", &format!("{CORE}/Logs")));
// The Manager applies database updates itself. The server's own updater would need a `mysql` client program inside
// the container and stops the server when it cannot find one.
a.extend(env("AC_UPDATES_ENABLE_DATABASES", "0"));
if kind == GameKind::World {
a.extend(["--volume".into(), format!("{}:{DATA}:ro", host.join("Data").display())]);
a.extend(env("AC_DATA_DIR", DATA));
// The remote console is only ever reachable from this computer.
a.extend(["--publish".into(), format!("127.0.0.1:{ra_port}:{RA_PORT}")]);
a.extend(env("AC_RA_ENABLE", "1"));
a.extend(env("AC_RA_IP", "0.0.0.0"));
a.extend(env("AC_RA_PORT", &RA_PORT.to_string()));
// Saving every character can take a while.
a.extend(["--stop-timeout".into(), "180".into()]);
a.extend(["--env".into(), "AC_WORLD_DATABASE_INFO".into(), "--env".into(), "AC_CHARACTER_DATABASE_INFO".into()]);
} else {
a.extend(["--restart".into(), "on-failure:3".into(), "--stop-timeout".into(), "30".into()]);
}
a.extend(["--env".into(), "AC_LOGIN_DATABASE_INFO".into()]);
a.push(runtime_image());
a.extend([binary.to_string(), "-c".into(), conf.into()]);
a
}
#[cfg(unix)]
fn owner_of(root: &Path) -> Option<String> {
use std::os::unix::fs::MetadataExt;
let m = std::fs::metadata(root).ok()?;
Some(format!("{}:{}", m.uid(), m.gid()))
}
#[cfg(not(unix))]
fn owner_of(_root: &Path) -> Option<String> {
None
}
// ------------------------------------------------------------------------------------------------------------- stop
fn stop(d: &dyn Docker, cfg: &Config, log: &mut Log) -> Step<()> {
preflight(d, log)?;
let n = cfg.names();
let state = inspect(d, &[&n.db, &n.world, &n.auth])?;
// Game servers first, the database last. The world server gets time to save every character.
for (name, seconds) in [(&n.world, 180u64), (&n.auth, 30), (&n.db, 60)] {
if state.get(name).is_some_and(Container::running) {
let t = seconds.to_string();
let o = docker(d, &["stop", "--time", &t, name], Duration::from_secs(seconds + 30))?;
if !o.ok() {
return fail(ErrorCode::StartupFailed, o.text());
}
log.say(format!("stopped {name}"));
}
}
Ok(())
}
// ---------------------------------------------------------------------------------------------------------- observe
pub fn observe(root: &Path, ports: &Ports) -> Observed {
observe_with(&SystemDocker, root, ports)
}
pub fn observe_with(d: &dyn Docker, root: &Path, ports: &Ports) -> Observed {
let unknown = |name: &'static str, port: u16| ServiceStatus { name, state: ServiceState::Unknown, pid: None, port, port_ready: false, conflict: None, uptime_secs: None };
let Ok(cfg) = Config::load(root) else {
return Observed { mysql: unknown("mysql", ports.mysql), auth: unknown("auth", ports.auth), world: unknown("world", ports.world) };
};
let n = cfg.names();
let Ok(state) = inspect(d, &[&n.db, &n.world, &n.auth]) else {
return Observed { mysql: unknown("mysql", ports.mysql), auth: unknown("auth", ports.auth), world: unknown("world", ports.world) };
};
let ip = connect_ip(&cfg);
let listening = |c: Option<&Container>, port: u16| c.is_some_and(Container::running) && d.port_open(SocketAddr::new(ip, port));
Observed {
mysql: status("mysql", state.get(&n.db), ports.mysql, state.get(&n.db).is_some_and(|c| c.health.as_deref() == Some("healthy"))),
auth: status("auth", state.get(&n.auth), ports.auth, listening(state.get(&n.auth), ports.auth)),
world: status("world", state.get(&n.world), ports.world, listening(state.get(&n.world), ports.world)),
}
}
fn status(name: &'static str, c: Option<&Container>, port: u16, ready: bool) -> ServiceStatus {
let Some(c) = c else {
return ServiceStatus { name, state: ServiceState::Stopped, pid: None, port, port_ready: false, conflict: None, uptime_secs: None };
};
let state = match c.status.as_str() {
"running" if ready => ServiceState::Running,
"running" | "created" | "restarting" => ServiceState::Starting,
// Stopped by `docker stop` (SIGTERM, then SIGKILL after the grace period) is a normal stop; anything else is a crash.
"exited" if c.exit_code == 0 || ((c.exit_code == 137 || c.exit_code == 143) && !c.oom_killed) => ServiceState::Stopped,
"exited" => ServiceState::Crashed,
_ => ServiceState::Unknown,
};
let running = c.running();
ServiceStatus {
name,
state,
pid: if running { c.pid } else { None },
port,
port_ready: running && ready,
conflict: None,
uptime_secs: if running { c.started_at.as_deref().and_then(uptime_since) } else { None },
}
}
fn uptime_since(started: &str) -> Option<u64> {
let t = chrono::DateTime::parse_from_rfc3339(started).ok()?;
u64::try_from((chrono::Utc::now() - t.with_timezone(&chrono::Utc)).num_seconds()).ok()
}
#[cfg(test)]
mod tests {
use super::*;
use crate::docker::cli::Output;
use std::cell::RefCell;
use std::collections::{BTreeMap, HashSet};
use std::fs;
const ROOT_PW: &str = "rootpw-ZZ1";
const APP_PW: &str = "apppw-QQ2";
/// A tiny in-memory Docker: containers, one network, one image. It answers the few commands the backend uses.
struct Sim {
calls: RefCell<Vec<Call2>>,
running: RefCell<HashSet<String>>,
exited: RefCell<BTreeMap<String, (i64, bool)>>,
network: RefCell<bool>,
image: RefCell<bool>,
logs: RefCell<String>,
unavailable: bool,
daemon_error: Option<String>,
/// `docker run` of this container fails with this message.
run_error: Option<(String, String)>,
/// A container that stops right after it was created, with this exit code.
dies: Option<(String, i64)>,
port_open: bool,
}
#[derive(Clone)]
struct Call2 {
args: Vec<String>,
env: Vec<(String, String)>,
stdin: bool,
}
impl Sim {
fn new() -> Sim {
Sim {
calls: Default::default(),
running: Default::default(),
exited: Default::default(),
network: RefCell::new(false),
image: RefCell::new(false),
logs: Default::default(),
unavailable: false,
daemon_error: None,
run_error: None,
dies: None,
port_open: true,
}
}
fn verbs(&self) -> Vec<String> {
self.calls.borrow().iter().map(|c| c.args.iter().take(2).cloned().collect::<Vec<_>>().join(" ")).collect()
}
fn calls_of(&self, verb: &str) -> Vec<Call2> {
self.calls.borrow().iter().filter(|c| c.args[0] == verb).cloned().collect()
}
fn inspect_json(&self, names: &[String]) -> (String, bool) {
let mut items = Vec::new();
let mut missing = false;
for n in names {
if self.running.borrow().contains(n) {
let health = if n.ends_with("-db") { r#","Health":{"Status":"healthy"}"# } else { "" };
items.push(format!(
r#"{{"Name":"/{n}","State":{{"Status":"running","Running":true,"ExitCode":0,"OOMKilled":false,"Pid":4242,"StartedAt":"2026-10-02T12:27:26.892949316Z"{health}}}}}"#
));
} else if let Some((code, oom)) = self.exited.borrow().get(n) {
items.push(format!(
r#"{{"Name":"/{n}","State":{{"Status":"exited","Running":false,"ExitCode":{code},"OOMKilled":{oom},"Pid":0,"StartedAt":"2026-10-02T12:27:26.892949316Z"}}}}"#
));
} else {
missing = true;
}
}
(format!("[{}]", items.join(",")), missing)
}
}
fn out(code: i32, stdout: &str, stderr: &str) -> Output {
Output { code: Some(code), stdout: stdout.into(), stderr: stderr.into() }
}
impl Docker for Sim {
fn run(&self, call: &Call) -> Result<Output> {
self.calls.borrow_mut().push(Call2 { args: call.args.clone(), env: call.env.clone(), stdin: call.stdin.is_some() });
if self.unavailable {
return Err(crate::error::Error::Invalid("docker could not be started: No such file or directory".into()));
}
let a: Vec<&str> = call.args.iter().map(String::as_str).collect();
Ok(match a.as_slice() {
["version", ..] => match &self.daemon_error {
Some(e) => out(1, "", e),
None => out(0, "27.3.1\n", ""),
},
["network", "inspect", ..] => if *self.network.borrow() { out(0, "[]", "") } else { out(1, "[]", "Error: No such network") },
["network", "create", ..] => {
*self.network.borrow_mut() = true;
out(0, "id\n", "")
}
["image", "inspect", ..] => if *self.image.borrow() { out(0, "[]", "") } else { out(1, "[]", "Error: No such image") },
["build", ..] => {
*self.image.borrow_mut() = true;
out(0, "built", "")
}
["inspect", names @ ..] => {
let names: Vec<String> = names.iter().map(|s| s.to_string()).collect();
let (json, missing) = self.inspect_json(&names);
if missing { out(1, &json, "Error: No such object: x") } else { out(0, &json, "") }
}
["rm", "-f", name] => {
self.running.borrow_mut().remove(*name);
self.exited.borrow_mut().remove(*name);
out(0, "", "")
}
["run", ..] => {
let name = call.args[call.args.iter().position(|x| x == "--name").unwrap() + 1].clone();
if let Some((n, e)) = &self.run_error {
if *n == name {
return Ok(out(125, "", e));
}
}
match &self.dies {
Some((n, code)) if *n == name => {
self.exited.borrow_mut().insert(name, (*code, false));
}
_ => {
self.running.borrow_mut().insert(name);
}
}
out(0, "containerid\n", "")
}
["stop", "--time", _, name] => {
self.running.borrow_mut().remove(*name);
self.exited.borrow_mut().insert(name.to_string(), (0, false));
out(0, "", "")
}
["logs", ..] => out(0, &self.logs.borrow(), ""),
other => panic!("unexpected docker call: {other:?}"),
})
}
fn port_open(&self, _addr: SocketAddr) -> bool {
self.port_open
}
fn pause(&self, _d: Duration) {}
}
fn server(project: &str) -> (tempfile::TempDir, std::path::PathBuf) {
let d = tempfile::tempdir().unwrap();
let root = d.path().join("srv");
fs::create_dir_all(root.join("Settings")).unwrap();
fs::write(root.join("Settings/docker.json"), format!(r#"{{"project":"{project}"}}"#)).unwrap();
fs::write(root.join("Settings/database.json"), format!(r#"{{"rootPassword":"{ROOT_PW}","appPassword":"{APP_PW}"}}"#)).unwrap();
(d, root)
}
fn start_all(sim: &Sim, root: &Path) -> DriverOutcome {
run_with(sim, root, Verb::StartAll).unwrap()
}
#[test]
fn a_first_start_creates_the_network_the_image_and_the_containers_in_order() {
let (_d, root) = server("t1");
let sim = Sim::new();
let o = start_all(&sim, &root);
assert!(o.ok, "{}", o.output);
let verbs = sim.verbs();
let at = |needle: &str| verbs.iter().position(|v| v.starts_with(needle)).unwrap_or_else(|| panic!("{needle} not called: {verbs:?}"));
assert!(at("version") < at("network create"));
assert!(at("network create") < at("run --detach"), "database comes first");
let runs: Vec<String> = sim.calls_of("run").iter().map(|c| c.args[c.args.iter().position(|x| x == "--name").unwrap() + 1].clone()).collect();
assert_eq!(runs, ["coa-t1-db", "coa-t1-world", "coa-t1-auth"], "database, then world, then auth");
assert!(at("build") < verbs.iter().rposition(|v| v.starts_with("run")).unwrap(), "the runtime image exists before the game servers");
assert!(sim.calls_of("build")[0].stdin, "the Dockerfile travels on stdin");
}
#[test]
fn passwords_travel_by_environment_and_never_on_a_command_line() {
let (_d, root) = server("t1");
let sim = Sim::new();
assert!(start_all(&sim, &root).ok);
for c in sim.calls.borrow().iter() {
for arg in &c.args {
assert!(!arg.contains(ROOT_PW) && !arg.contains(APP_PW), "secret on a command line: {arg}");
}
}
let runs = sim.calls_of("run");
assert!(runs[0].env.contains(&("MYSQL_ROOT_PASSWORD".into(), ROOT_PW.into())));
assert!(runs[1].env.iter().any(|(k, v)| k == "AC_LOGIN_DATABASE_INFO" && v == &format!("db;3306;acore;{APP_PW};acore_auth")));
assert!(runs[1].env.iter().any(|(k, _)| k == "AC_CHARACTER_DATABASE_INFO"));
assert!(runs[2].env.iter().any(|(k, _)| k == "AC_LOGIN_DATABASE_INFO"));
assert!(!runs[2].env.iter().any(|(k, _)| k == "AC_WORLD_DATABASE_INFO"), "auth does not need the world database");
assert!(runs[1].args.windows(2).any(|w| w == ["--env", "AC_WORLD_DATABASE_INFO"]), "name only, the value is in the environment");
}
#[test]
fn the_world_container_is_wired_like_the_repack_layout() {
let (_d, root) = server("t1");
let sim = Sim::new();
assert!(start_all(&sim, &root).ok);
let world = &sim.calls_of("run")[1].args;
let has = |s: &str| world.iter().any(|a| a == s);
assert!(has("127.0.0.1:8085:8085"), "game port on this computer only by default");
assert!(has("127.0.0.1:3443:3443"), "the remote console is never exposed beyond this computer");
assert!(has("AC_BIND_IP=0.0.0.0") && has("AC_RA_ENABLE=1") && has("AC_RA_IP=0.0.0.0"));
assert!(has("AC_UPDATES_ENABLE_DATABASES=0"), "the server's own database updater needs a mysql client the image does not have");
assert!(sim.calls_of("run")[2].args.iter().any(|a| a == "AC_UPDATES_ENABLE_DATABASES=0"));
assert!(has("AC_DATA_DIR=/srv/data") && has("AC_LOGS_DIR=/srv/core/Logs"));
assert!(world.iter().any(|a| a.ends_with(":/srv/data:ro")), "game data is read-only");
assert!(world.iter().any(|a| a.ends_with(":/srv/core") && a.contains("Core")));
assert!(world.windows(2).any(|w| w == ["--workdir", "/srv/core"]));
assert!(world.windows(2).any(|w| w == ["--stop-timeout", "180"]));
let n = world.len();
assert_eq!(&world[n - 3..], ["./worldserver", "-c", "configs/worldserver.conf"]);
assert!(world[n - 4].starts_with("coa-runtime:"));
assert!(root.join("Core/Logs").is_dir(), "created by the Manager so it belongs to the user");
}
#[test]
fn the_published_address_follows_the_setting() {
let (_d, root) = server("t1");
fs::write(root.join("Settings/docker.json"), r#"{"project":"t1","bindAddress":"0.0.0.0"}"#).unwrap();
let sim = Sim::new();
assert!(start_all(&sim, &root).ok);
let runs = sim.calls_of("run");
assert!(runs[1].args.iter().any(|a| a == "0.0.0.0:8085:8085"));
assert!(runs[1].args.iter().any(|a| a == "127.0.0.1:3443:3443"), "the console stays private");
assert!(runs[2].args.iter().any(|a| a == "0.0.0.0:3724:3724"));
}
#[test]
fn custom_host_ports_keep_the_container_listeners_on_the_mapped_ports() {
let (_d, root) = server("ports");
let cfg = Config::load(&root).unwrap();
let n = cfg.names();
let world = game_args(&cfg, &n, GameKind::World, &root, 18085, 13443, None);
let auth = game_args(&cfg, &n, GameKind::Auth, &root, 13724, 0, None);
assert!(world.iter().any(|a| a == "127.0.0.1:18085:8085"));
assert!(world.iter().any(|a| a == "127.0.0.1:13443:3443"));
assert!(world.iter().any(|a| a == "AC_WORLD_SERVER_PORT=8085"));
assert!(world.iter().any(|a| a == "AC_RA_PORT=3443"));
assert!(auth.iter().any(|a| a == "127.0.0.1:13724:3724"));
assert!(auth.iter().any(|a| a == "AC_REALM_SERVER_PORT=3724"));
}
#[test]
fn a_second_start_leaves_running_containers_alone() {
let (_d, root) = server("t1");
let sim = Sim::new();
assert!(start_all(&sim, &root).ok);
let before = sim.calls_of("run").len();
assert!(start_all(&sim, &root).ok);
assert_eq!(sim.calls_of("run").len(), before, "nothing was recreated");
}
#[test]
fn start_database_only_does_not_touch_the_game_servers() {
let (_d, root) = server("t1");
let sim = Sim::new();
assert!(run_with(&sim, &root, Verb::StartMysql).unwrap().ok);
assert_eq!(sim.calls_of("run").len(), 1);
assert!(sim.calls_of("build").is_empty());
}
#[test]
fn stop_goes_world_then_auth_then_database_with_time_to_save() {
let (_d, root) = server("t1");
let sim = Sim::new();
assert!(start_all(&sim, &root).ok);
sim.calls.borrow_mut().clear();
let o = run_with(&sim, &root, Verb::StopAll).unwrap();
assert!(o.ok, "{}", o.output);
let stops: Vec<(String, String)> = sim.calls_of("stop").iter().map(|c| (c.args[3].clone(), c.args[2].clone())).collect();
assert_eq!(stops, [("coa-t1-world".into(), "180".into()), ("coa-t1-auth".into(), "30".into()), ("coa-t1-db".into(), "60".into())]);
assert!(sim.running.borrow().is_empty());
// Stopping what is already stopped is fine.
sim.calls.borrow_mut().clear();
assert!(run_with(&sim, &root, Verb::StopAll).unwrap().ok);
assert!(sim.calls_of("stop").is_empty());
}
#[test]
fn docker_not_installed_is_reported_as_unavailable() {
let (_d, root) = server("t1");
let mut sim = Sim::new();
sim.unavailable = true;
let o = start_all(&sim, &root);
assert!(!o.ok);
assert_eq!(o.code, Some(ErrorCode::DockerUnavailable));
assert!(o.output.contains("could not be started"));
}
#[test]
fn a_refused_connection_to_the_docker_service_shows_docker_own_words() {
let (_d, root) = server("t1");
let mut sim = Sim::new();
sim.daemon_error = Some("permission denied while trying to connect to the Docker daemon socket".into());
let o = start_all(&sim, &root);
assert_eq!(o.code, Some(ErrorCode::DockerUnavailable));
assert!(o.output.contains("permission denied"), "{}", o.output);
assert!(sim.calls_of("run").is_empty(), "nothing is started when docker is not usable");
}
#[test]
fn a_world_server_that_stops_while_starting_reports_the_cause_found_in_its_log() {
let (_d, root) = server("t1");
let mut sim = Sim::new();
sim.dies = Some(("coa-t1-world".into(), 1));
*sim.logs.borrow_mut() = "\u{1b}[31mCould not connect to MySQL database at db: Can't connect to MySQL server on 'db:3306' (111)\u{1b}[0m".into();
let o = start_all(&sim, &root);
assert!(!o.ok);
assert_eq!(o.code, Some(ErrorCode::DatabaseNotRunning));
assert!(o.output.contains("Can't connect to MySQL server"), "{}", o.output);
assert!(!o.output.contains('\u{1b}'), "colour codes are removed");
assert!(sim.calls_of("run").len() == 2, "auth is not started after a failed world");
}
#[test]
fn a_port_that_is_taken_is_reported_as_such() {
let (_d, root) = server("t1");
let mut sim = Sim::new();
sim.run_error = Some(("coa-t1-world".into(), "Bind for 127.0.0.1:8085 failed: port is already allocated".into()));
let o = start_all(&sim, &root);
assert_eq!(o.code, Some(ErrorCode::PortInUse));
}
#[test]
fn a_server_that_never_listens_times_out_with_its_log() {
let (_d, root) = server("t1");
let mut sim = Sim::new();
sim.port_open = false;
*sim.logs.borrow_mut() = "still loading".into();
let o = start_all(&sim, &root);
assert!(!o.ok);
assert!(o.output.contains("was not listening on port 8085") && o.output.contains("still loading"), "{}", o.output);
}
#[test]
fn invalid_settings_are_refused_before_anything_runs() {
for (project, bind, image) in [("Bad Name", "127.0.0.1", "mysql:8.4"), ("", "127.0.0.1", "mysql:8.4"), ("ok", "not-an-ip", "mysql:8.4"), ("ok", "127.0.0.1", "mysql:8.4; rm -rf /"), ("-lead", "127.0.0.1", "mysql:8.4")] {
let (_d, root) = server("t1");
fs::write(root.join("Settings/docker.json"), format!(r#"{{"project":"{project}","bindAddress":"{bind}","mysqlImage":"{image}"}}"#)).unwrap();
let sim = Sim::new();
assert!(run_with(&sim, &root, Verb::StartAll).is_err(), "{project} / {bind} / {image}");
assert!(sim.calls.borrow().is_empty());
}
}
#[test]
fn inspect_output_is_read_like_docker_prints_it() {
// Shape taken from `docker inspect` on a stopped database container and a world server.
let json = r#"[{"Id":"abc","Name":"/coa-t1-db","State":{"Status":"running","Running":true,"Paused":false,"Restarting":false,"OOMKilled":false,"Dead":false,"Pid":2402,"ExitCode":0,"Error":"","StartedAt":"2026-10-02T12:27:26.892949316Z","FinishedAt":"0001-01-01T00:00:00Z","Health":{"Status":"healthy","FailingStreak":0,"Log":[]}}},
{"Name":"/coa-t1-world","State":{"Status":"exited","Running":false,"OOMKilled":false,"Pid":0,"ExitCode":137,"StartedAt":"2026-10-02T12:40:06.76552263Z"}}]"#;
let m = parse_inspect(json);
assert_eq!(m["coa-t1-db"].pid, Some(2402));
assert_eq!(m["coa-t1-db"].health.as_deref(), Some("healthy"));
assert_eq!(m["coa-t1-world"].exit_code, 137);
assert_eq!(m["coa-t1-world"].pid, None);
assert!(parse_inspect("[]").is_empty() && parse_inspect("").is_empty() && parse_inspect("nonsense").is_empty());
}
#[test]
fn observation_maps_container_states_to_service_states() {
let ports = Ports::default();
let (_d, root) = server("t1");
// Nothing created yet.
let sim = Sim::new();
let o = observe_with(&sim, &root, &ports);
assert!([o.mysql.state, o.auth.state, o.world.state].iter().all(|s| *s == ServiceState::Stopped));
// Everything up.
assert!(start_all(&sim, &root).ok);
let o = observe_with(&sim, &root, &ports);
assert_eq!((o.mysql.state, o.auth.state, o.world.state), (ServiceState::Running, ServiceState::Running, ServiceState::Running));
assert!(o.world.port_ready && o.world.pid == Some(4242) && o.world.uptime_secs.is_some());
assert_eq!(o.world.port, ports.world);
// Running but not listening yet.
let mut slow = Sim::new();
slow.port_open = false;
slow.running.borrow_mut().insert("coa-t1-world".into());
let o = observe_with(&slow, &root, &ports);
assert_eq!(o.world.state, ServiceState::Starting);
assert!(!o.world.port_ready);
// Stopped cleanly, killed after the grace period, crashed, killed for lack of memory.
let mut sim = Sim::new();
for (name, code, oom) in [("coa-t1-db", 0, false), ("coa-t1-auth", 137, false), ("coa-t1-world", 1, false)] {
sim.exited.borrow_mut().insert(name.into(), (code, oom));
}
let o = observe_with(&sim, &root, &ports);
assert_eq!((o.mysql.state, o.auth.state, o.world.state), (ServiceState::Stopped, ServiceState::Stopped, ServiceState::Crashed));
sim.exited.borrow_mut().insert("coa-t1-auth".into(), (137, true));
assert_eq!(observe_with(&sim, &root, &ports).auth.state, ServiceState::Crashed);
sim.unavailable = true;
assert_eq!(observe_with(&sim, &root, &ports).world.state, ServiceState::Unknown, "docker unreachable: unknown, not stopped");
}
#[test]
fn the_runtime_image_is_named_after_its_dockerfile() {
let name = runtime_image();
assert!(name.starts_with("coa-runtime:") && name.len() == "coa-runtime:".len() + 12, "{name}");
assert!(RUNTIME_DOCKERFILE.contains("libmysqlclient24") && RUNTIME_DOCKERFILE.contains("libreadline8t64"));
}
#[test]
fn a_docker_folder_is_scanned_without_the_repack_files() {
let (_d, root) = server("t1");
assert!(crate::docker::is_docker(&root));
for f in ["Core/worldserver", "Core/authserver", "Core/configs/worldserver.conf", "Core/configs/authserver.conf", "Data/dbc/x", "Data/maps/x"] {
let p = root.join(f);
fs::create_dir_all(p.parent().unwrap()).unwrap();
fs::write(p, "x").unwrap();
}
let r = crate::layout::scan(&root).unwrap();
assert_eq!(r.classification, crate::layout::Classification::Healthy);
assert!(r.worldserver.is_some() && r.authserver.is_some() && !r.modifies_files);
fs::remove_file(root.join("Core/authserver")).unwrap();
assert_eq!(crate::layout::scan(&root).unwrap().classification, crate::layout::Classification::Partial);
fs::remove_file(root.join("Settings/docker.json")).unwrap();
assert!(!crate::docker::is_docker(&root), "without the marker it is scanned as a repack");
}
}
+159
View File
@@ -0,0 +1,159 @@
//! Docker backend. The three services (MySQL, authserver, worldserver) run in containers that the Manager creates
//! and controls through the `docker` command line; the server folder keeps the same shape as a repack where it
//! matters (`Core/configs`, `Core/Logs`, `Settings/*.json`, `Data/`) so configuration, logs and the RA console work
//! unchanged. This is the only runtime available on Linux. The Windows repack path is not touched: an
//! installation is a Docker one only when `Settings/docker.json` exists.
//!
//! ```text
//! <server>/
//! Core/worldserver, authserver mounted at /srv/core (working directory of both containers)
//! Core/configs/ Core/Logs/ read and written by the Manager as usual
//! Data/ mounted read-only at /srv/data
//! Settings/docker.json marks the installation and names its containers
//! Settings/repack.json ports and RA login (same file as a repack)
//! Settings/database.json database passwords (same file as a repack)
//! ```
mod cli;
mod lifecycle;
pub use cli::{Call, Docker, Output, SystemDocker};
pub use lifecycle::{observe, observe_with, run, run_with};
use std::net::IpAddr;
use std::path::Path;
use serde::{Deserialize, Serialize};
use crate::error::{Error, Result};
use crate::fsx;
use crate::layout::{self, Classification, ScanReport};
/// Present in a Docker installation, absent from a repack.
pub const MARKER: &str = "Settings/docker.json";
const MYSQL_IMAGE: &str = "mysql:8.4";
const RUNTIME_DOCKERFILE: &str = include_str!("Dockerfile.runtime");
pub fn is_docker(root: &Path) -> bool {
root.join(MARKER).is_file()
}
fn loopback() -> String {
"127.0.0.1".into()
}
fn mysql_image() -> String {
MYSQL_IMAGE.into()
}
/// `Settings/docker.json`.
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct Config {
/// Short unique name of this installation; part of every container, network and volume name.
pub project: String,
/// Host address the game ports are published on: `127.0.0.1` (this computer only) or `0.0.0.0` / a LAN address.
#[serde(default = "loopback")]
pub bind_address: String,
#[serde(default = "mysql_image")]
pub mysql_image: String,
}
pub(crate) struct Names {
pub network: String,
pub volume: String,
pub db: String,
pub world: String,
pub auth: String,
}
impl Config {
pub fn load(root: &Path) -> Result<Config> {
let cfg: Config = fsx::read_json(&root.join(MARKER)).map_err(|_| Error::Invalid("The Docker settings of this server could not be read.".into()))?;
cfg.validate()?;
Ok(cfg)
}
fn validate(&self) -> Result<()> {
let name_ok = !self.project.is_empty()
&& self.project.len() <= 32
&& self.project.starts_with(|c: char| c.is_ascii_lowercase() || c.is_ascii_digit())
&& self.project.chars().all(|c| c.is_ascii_lowercase() || c.is_ascii_digit() || c == '-');
if !name_ok {
return Err(Error::Invalid("The Docker project name must be 1-32 characters: lower-case letters, digits and dashes.".into()));
}
if self.bind_address.parse::<IpAddr>().is_err() {
return Err(Error::Invalid(format!("{} is not an IP address.", self.bind_address)));
}
let image_ok = !self.mysql_image.is_empty() && self.mysql_image.chars().all(|c| c.is_ascii_alphanumeric() || "._/:@-".contains(c));
if !image_ok {
return Err(Error::Invalid("The database image name is not valid.".into()));
}
Ok(())
}
pub(crate) fn names(&self) -> Names {
let p = &self.project;
Names { network: format!("coa-{p}"), volume: format!("coa-{p}-db"), db: format!("coa-{p}-db"), world: format!("coa-{p}-world"), auth: format!("coa-{p}-auth") }
}
}
/// Name of the runtime image: it follows the content of its Dockerfile, so changing the libraries builds a new image.
pub(crate) fn runtime_image() -> String {
format!("coa-runtime:{}", &fsx::sha256_bytes(RUNTIME_DOCKERFILE.as_bytes())[..12])
}
/// Read-only description of a Docker installation, shaped like the scan of a repack so the screens that list what a
/// server holds work for both.
pub(crate) fn scan(root: &Path) -> Result<ScanReport> {
let cfg = Config::load(root);
let world = layout::hash_exe(&root.join("Core/worldserver"), None, "worldserver");
let auth = layout::hash_exe(&root.join("Core/authserver"), None, "authserver");
let modules_dir = root.join("Core/configs/modules");
let mut module_configs: Vec<String> = std::fs::read_dir(&modules_dir)
.map(|rd| rd.filter_map(|e| e.ok()).filter_map(|e| e.file_name().into_string().ok()).filter(|n| n.ends_with(".conf")).collect())
.unwrap_or_default();
module_configs.sort();
let bot_active = modules_dir.join("mod_coa_playerbots.conf");
let bot_conf = if bot_active.is_file() { bot_active } else { modules_dir.join("mod_coa_playerbots.conf.dist") };
let bot_config_keys = layout::count_bot_keys(&bot_conf);
let has_data = layout::exists(root, "Data/dbc") && layout::exists(root, "Data/maps");
let has_confs = layout::exists(root, "Core/configs/worldserver.conf") && layout::exists(root, "Core/configs/authserver.conf");
let items = vec![
layout::item("worldserver", "World server", world.is_some(), None),
layout::item("authserver", "Auth server", auth.is_some(), None),
layout::item("worldserver_conf", "World server configuration", layout::exists(root, "Core/configs/worldserver.conf"), None),
layout::item("authserver_conf", "Auth server configuration", layout::exists(root, "Core/configs/authserver.conf"), None),
layout::item("modules_conf", "Module configuration", modules_dir.is_dir(), Some(format!("{} files", module_configs.len()))),
layout::item("game_data", "Game data (maps, DBC)", has_data, None),
layout::item("database_runtime", "Database runtime", cfg.is_ok(), cfg.as_ref().ok().map(|c| c.mysql_image.clone())),
layout::item("launcher", "Docker settings", cfg.is_ok(), cfg.as_ref().ok().map(|c| c.project.clone())),
layout::item("companions", "CoA Companions (bots)", bot_conf.is_file(), (bot_config_keys > 0).then(|| format!("{bot_config_keys} settings"))),
];
let mut notes = Vec::new();
if let Err(e) = &cfg {
notes.push(e.to_string());
}
let healthy = cfg.is_ok() && world.is_some() && auth.is_some() && has_data && has_confs;
Ok(ScanReport {
path: root.to_string_lossy().into_owned(),
classification: if healthy { Classification::Healthy } else { Classification::Partial },
items,
worldserver: world,
authserver: auth,
release: None,
banner_revision: layout::banner_revision_in_log(&root.join("Core/Logs/Server.log")),
module_configs,
bot_config_keys,
ports: layout::read_ports(root),
database_schemas: Vec::new(),
client: ["Client", "client"].iter().find_map(|d| layout::detect_client(&root.join(d))),
notes,
suggested_path: None,
hint: None,
modifies_files: false,
})
}
+14
View File
@@ -80,6 +80,20 @@ fn launcher(root: &Path) -> Result<(PathBuf, PathBuf)> {
/// Run a launcher verb to completion (blocking; call from a worker thread).
pub fn run(root: &Path, verb: Verb) -> Result<DriverOutcome> {
let root = fsx::canonicalize_lenient(root)?;
if crate::docker::is_docker(&root) {
return crate::docker::run(&root, verb);
}
if verb == Verb::StartAll {
crate::realms::before_start(&root)?;
if root.join("Settings/realm-profile.json").exists() {
let db = crate::db::Db::from_repack(&root, crate::db::Account::Admin)?;
if !db.ping() {
let out = run(&root, Verb::StartMysql)?;
if !out.ok { return Ok(out); }
}
crate::realms::setup_realmlist(&root)?;
}
}
let (python, script) = launcher(&root)?;
let mut cmd = Command::new(&python);
cmd.arg("-B").arg(&script).arg(verb.arg()).current_dir(&root).stdin(Stdio::null()).stdout(Stdio::piped()).stderr(Stdio::piped());
+6
View File
@@ -52,6 +52,7 @@ pub enum ErrorCode {
DiskFull,
OperationInProgress,
StartupFailed,
DockerUnavailable,
HashMismatch,
PathRejected,
PackageNotPublished,
@@ -128,6 +129,11 @@ impl ErrorCode {
"A service stopped while starting. Check the details for the cause.",
&[FixAutomatically, ShowDetails],
),
ErrorCode::DockerUnavailable => (
"Docker is not available",
"This server runs in Docker. Install Docker, start it, and make sure your user account may use it, then try again.",
&[Retry, ShowDetails],
),
ErrorCode::HashMismatch => (
"A downloaded file is damaged",
"The file did not match its checksum and was not used.",
+2 -1
View File
@@ -117,7 +117,8 @@ pub fn apply_realm_address(root: &Path, host: &str) -> Result<()> {
return Err(Error::Invalid("That address is not valid.".into()));
}
let db = Db::from_repack(root, Account::Admin)?;
db.query(&format!("UPDATE acore_auth.realmlist SET address='{host}', localAddress='{host}' WHERE id=1;"))?;
let realm = crate::realms::state(root)?.active.realm_id();
db.query(&format!("UPDATE acore_auth.realmlist SET address='{host}', localAddress='{host}' WHERE id={realm};"))?;
Ok(())
}
+5 -2
View File
@@ -27,11 +27,14 @@ pub fn normalize_lexical(path: &Path) -> PathBuf {
fn key(path: &Path) -> Vec<String> {
path.components()
.map(|c| c.as_os_str().to_string_lossy().to_lowercase())
.map(|c| {
let c = c.as_os_str().to_string_lossy();
if cfg!(windows) { c.to_lowercase() } else { c.into_owned() }
})
.collect()
}
/// Case-insensitive component-wise prefix test (Windows semantics).
/// Component-wise prefix test: case-insensitive on Windows, exact elsewhere (`/srv/CoA` and `/srv/coa` are two folders).
pub fn starts_with_ci(path: &Path, prefix: &Path) -> bool {
let (p, q) = (key(path), key(prefix));
p.len() >= q.len() && p[..q.len()] == q[..]
+7 -4
View File
@@ -110,15 +110,15 @@ pub struct ScanReport {
pub modifies_files: bool,
}
fn exists(root: &Path, rel: &str) -> bool {
pub(crate) fn exists(root: &Path, rel: &str) -> bool {
root.join(rel).exists()
}
fn item(key: &'static str, label: &'static str, present: bool, detail: Option<String>) -> Item {
pub(crate) fn item(key: &'static str, label: &'static str, present: bool, detail: Option<String>) -> Item {
Item { key, label, status: if present { Status::Found } else { Status::Missing }, detail }
}
fn hash_exe(path: &Path, release: Option<&ReleaseJson>, name: &str) -> Option<ExeInfo> {
pub(crate) fn hash_exe(path: &Path, release: Option<&ReleaseJson>, name: &str) -> Option<ExeInfo> {
let meta = fs::metadata(path).ok()?;
if !meta.is_file() {
return None;
@@ -192,7 +192,7 @@ pub fn detect_client(dir: &Path) -> Option<ClientInfo> {
None
}
fn count_bot_keys(conf: &Path) -> usize {
pub(crate) fn count_bot_keys(conf: &Path) -> usize {
fs::read_to_string(conf)
.map(|t| t.lines().filter(|l| l.trim_start().starts_with("CoaBots.")).count())
.unwrap_or(0)
@@ -204,6 +204,9 @@ pub fn scan(root: &Path) -> Result<ScanReport> {
return Err(crate::error::Error::Invalid(format!("{} is not a folder", root.display())));
}
let root = fsx::canonicalize_lenient(root)?;
if crate::docker::is_docker(&root) {
return crate::docker::scan(&root);
}
let mut notes = Vec::new();
let release: Option<ReleaseJson> = fsx::read_json(&root.join("RELEASE.json")).ok();
+2
View File
@@ -8,6 +8,7 @@ pub mod config;
pub mod console;
pub mod db;
pub mod diag;
pub mod docker;
pub mod download;
pub mod driver;
pub mod error;
@@ -29,6 +30,7 @@ pub mod ra;
pub mod allsettings;
pub mod modules;
pub mod realmlist;
pub mod realms;
pub mod registry;
pub mod release;
pub mod update;
+27 -2
View File
@@ -97,6 +97,7 @@ pub struct ModuleView {
pub icon: String,
pub page: Option<String>,
pub hidden: bool,
pub compatibility: String,
}
pub fn list(root: &Path) -> Vec<ModuleView> {
@@ -116,6 +117,7 @@ fn conf_name(root: &Path, e: &Entry) -> String {
}
fn list_in(cat: &[Entry], root: &Path) -> Vec<ModuleView> {
let wildcard = crate::realms::state(root).map(|s| s.active == crate::realms::Mode::Wildcard).unwrap_or(true);
cat.iter()
.cloned()
.map(|e| {
@@ -126,14 +128,16 @@ fn list_in(cat: &[Entry], root: &Path) -> Vec<ModuleView> {
// the active file decides; without one the documented default is what the server will use
let enabled = !e.switchable
|| read(&conf).or_else(|| read(&dist)).and_then(|c| c.get(&e.enable_key).map(truthy)).unwrap_or(e.default_on);
let blocked = wildcard && matches!(e.id.as_str(), "companions" | "playerbots");
ModuleView {
compatibility: if blocked { "unsupported" } else if wildcard && e.id != "client-compat" { "experimental" } else { "compatible" }.into(),
id: e.id,
name: e.name,
description: e.description,
repo: e.repo,
installed,
enabled,
switchable: e.switchable,
enabled: enabled && !blocked,
switchable: e.switchable && !blocked,
status: e.status,
icon: e.icon,
page: e.page,
@@ -164,6 +168,7 @@ fn backup(meta: &Path, conf: &Path) -> Result<()> {
}
pub fn set_enabled(root: &Path, meta: &Path, id: &str, on: bool) -> Result<()> {
if on { crate::realms::guard_module(root, id)?; }
set_enabled_in(&catalog(), root, meta, id, on)
}
@@ -217,6 +222,7 @@ fn settings_in(cat: &[Entry], root: &Path, id: &str) -> Result<Vec<Setting>> {
/// Change values of settings the module already has. A value is one line of at most 500 characters.
pub fn save_settings(root: &Path, meta: &Path, id: &str, changes: &BTreeMap<String, String>) -> Result<Vec<String>> {
crate::realms::guard_module(root, id)?;
save_settings_in(&catalog(), root, meta, id, changes)
}
@@ -306,6 +312,25 @@ mod tests {
assert!(!list_in(&test_catalog(), &root).into_iter().find(|m| m.id == "spellbook").unwrap().installed, "no configuration of that module on this server");
}
#[test]
fn the_content_scaling_switch_persists_the_master_flag_and_preserves_other_settings() {
let d = tempfile::tempdir().unwrap();
let (root, meta) = server(d.path());
let e = entry_in(&catalog(), "content-scaling").unwrap();
assert_eq!(e.enable_key, "CoAContentScaling.Enable");
let defaults = "CoAContentScaling.Enable = 1\nCoAContentScaling.ScaleItems = 1\nCoAContentScaling.GroupScaling.Enable = 1\n";
fs::write(dir(&root).join(format!("{}.dist", e.conf)), defaults).unwrap();
set_enabled(&root, &meta, &e.id, false).unwrap();
let active = read(&dir(&root).join(&e.conf)).unwrap();
assert_eq!(active.get("CoAContentScaling.Enable"), Some("0"));
assert_eq!(active.get("CoAContentScaling.ScaleItems"), Some("1"));
assert_eq!(active.get("CoAContentScaling.GroupScaling.Enable"), Some("1"));
assert!(!list(&root).into_iter().find(|m| m.id == e.id).unwrap().enabled);
set_enabled(&root, &meta, &e.id, true).unwrap();
assert_eq!(read(&dir(&root).join(&e.conf)).unwrap().get("CoAContentScaling.Enable"), Some("1"));
assert!(list(&root).into_iter().find(|m| m.id == e.id).unwrap().enabled);
}
#[test]
fn switching_a_module_creates_its_file_saves_the_old_one_and_changes_only_that_line() {
let d = tempfile::tempdir().unwrap();
+6
View File
@@ -88,10 +88,16 @@ pub struct Tailscale {
pub connected: bool,
}
#[cfg(windows)]
fn tailscale_exe() -> Option<PathBuf> {
["C:/Program Files/Tailscale/tailscale.exe", "C:/Program Files (x86)/Tailscale/tailscale.exe"].iter().map(PathBuf::from).find(|p| p.is_file())
}
#[cfg(not(windows))]
fn tailscale_exe() -> Option<PathBuf> {
["/usr/bin/tailscale", "/usr/local/bin/tailscale", "/usr/sbin/tailscale"].iter().map(PathBuf::from).find(|p| p.is_file())
}
pub fn parse_tailscale_ip(out: &str) -> Option<String> {
out.lines().map(str::trim).find(|l| l.parse::<Ipv4Addr>().map(is_cgnat_range).unwrap_or(false)).map(str::to_string)
}
+36
View File
@@ -298,11 +298,15 @@ pub fn extract(parts_dir: &Path, manifest: &Manifest, dest: &Path, progress: &dy
let mut hasher = Sha256::new();
let mut buf = vec![0u8; 1 << 20];
let mut size = 0u64;
let mut head = Vec::with_capacity(4);
loop {
let n = entry.read(&mut buf)?;
if n == 0 {
break;
}
if head.len() < 4 {
head.extend_from_slice(&buf[..n.min(4 - head.len())]);
}
size += n as u64;
if size > want.size {
return Err(Error::HashMismatch { path: rel, expected: format!("{} bytes", want.size), actual: "more".into() });
@@ -315,6 +319,13 @@ pub fn extract(parts_dir: &Path, manifest: &Manifest, dest: &Path, progress: &dy
if size != want.size || !actual.eq_ignore_ascii_case(&want.sha256) {
return Err(Error::HashMismatch { path: rel, expected: want.sha256.clone(), actual });
}
// The archive does not carry per-file modes, so a Linux binary or script would be extracted unusable.
// Recognise them by content (ELF header or `#!`); Windows has no execute bit and ignores this.
#[cfg(unix)]
if head.starts_with(b"\x7fELF") || head.starts_with(b"#!") {
use std::os::unix::fs::PermissionsExt;
fs::set_permissions(&target, fs::Permissions::from_mode(0o755))?;
}
done += size;
progress(done, archive.unpacked_size);
}
@@ -373,6 +384,31 @@ mod tests {
(d, src)
}
#[cfg(unix)]
#[test]
fn extract_makes_binaries_and_scripts_executable_and_nothing_else() {
use std::os::unix::fs::PermissionsExt;
let d = tempfile::tempdir().unwrap();
let src = d.path().join("src");
for (p, c) in [
("Core/worldserver", &b"\x7fELF\x02\x01\x01 binary"[..]),
("Scripts/tool.sh", &b"#!/bin/sh\necho hi\n"[..]),
("Core/configs/worldserver.conf.dist", &b"Setting = 1\n"[..]),
] {
let f = src.join(p);
fs::create_dir_all(f.parent().unwrap()).unwrap();
fs::write(f, c).unwrap();
}
let out = d.path().join("out");
let m = build(&src, &out, &opts(64 * 1024), &|_| {}).unwrap();
let dest = d.path().join("dest");
extract(&out, &m, &dest, &|_, _| {}).unwrap();
let mode = |p: &str| fs::metadata(dest.join(p)).unwrap().permissions().mode() & 0o111;
assert_ne!(mode("Core/worldserver"), 0, "ELF binary must be executable");
assert_ne!(mode("Scripts/tool.sh"), 0, "script with a shebang must be executable");
assert_eq!(mode("Core/configs/worldserver.conf.dist"), 0, "plain files stay non-executable");
}
#[test]
fn build_split_extract_roundtrip_excludes_noise_and_secrets() {
let (d, src) = source();
+3
View File
@@ -293,6 +293,9 @@ fn service(root: &Path, name: &'static str, exe: PathBuf, port: u16, listen: &[(
/// Snapshot the three services of an installation without touching anything.
pub fn observe(root: &Path, ports: &Ports) -> Observed {
if crate::docker::is_docker(root) {
return crate::docker::observe(root, ports);
}
let listen = listeners();
let (world, auth, mysql) = crate::layout::executables(root);
Observed {
+371
View File
@@ -0,0 +1,371 @@
use std::collections::BTreeMap;
use std::fs;
use std::path::Path;
use serde::{Deserialize, Serialize};
use crate::config::parser::ConfFile;
use crate::db::{Account, Db};
use crate::error::{Error, Result};
use crate::{fsx, layout, process};
const STATE: &str = "Settings/realm-profile.json";
const JOURNAL: &str = "Settings/realm-switch.json";
#[derive(Debug, Clone, Copy, Default, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "lowercase")]
pub enum Mode {
#[default]
Coa,
Wildcard,
}
impl Mode {
pub fn name(self) -> &'static str {
match self { Self::Coa => "coa", Self::Wildcard => "wildcard" }
}
pub fn realm_id(self) -> u32 { if self == Self::Coa { 1 } else { 2 } }
pub fn schema(self, kind: &str) -> Result<&'static str> {
match (self, kind) {
(_, "auth") => Ok("acore_auth"),
(Self::Coa, "characters") => Ok("acore_characters"),
(Self::Coa, "world") => Ok("acore_world"),
(Self::Wildcard, "characters") => Ok("acore_characters_wildcard"),
(Self::Wildcard, "world") => Ok("acore_world_wildcard"),
_ => Err(Error::Invalid("Unknown realm database.".into())),
}
}
}
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct RealmState {
pub active: Mode,
pub wildcard_created: bool,
}
#[derive(Debug, Serialize)]
pub struct View {
pub active: Mode,
pub wildcard_created: bool,
pub supported: bool,
pub recovery_pending: bool,
}
pub fn state(root: &Path) -> Result<RealmState> {
if !root.join(STATE).exists() { return Ok(RealmState::default()); }
fsx::read_json(&root.join(STATE))
}
pub fn view(root: &Path) -> Result<View> {
let s = state(root)?;
// Inspect the binary itself; templates or an old log cannot prove installed support.
let supported = fs::read(root.join("Core/worldserver.exe"))?
.windows(b"Wildcard synergy settings".len()).any(|w| w == b"Wildcard synergy settings");
Ok(View { active: s.active, wildcard_created: s.wildcard_created, supported, recovery_pending: root.join(JOURNAL).exists() })
}
pub fn guard_module(root: &Path, id: &str) -> Result<()> {
if state(root)?.active == Mode::Wildcard && matches!(id, "companions" | "playerbots") {
return Err(Error::Invalid("CoA companion class mechanics have not been validated for Wildcard. This module is unavailable on this realm.".into()));
}
Ok(())
}
type Files = BTreeMap<String, Vec<u8>>;
fn configs(root: &Path) -> Result<Files> {
let mut files = Files::new();
for rel in crate::backup::config_files(root) {
if rel.starts_with("Core/configs/") && rel.ends_with(".conf")
|| rel.starts_with("Settings/") && rel.ends_with(".template") {
files.insert(rel.clone(), fs::read(fsx::safe_join(root, &rel)?)?);
}
}
Ok(files)
}
fn snapshot(root: &Path, mode: Mode) -> std::path::PathBuf {
root.join(format!("Settings/realm-profiles/{}.json", mode.name()))
}
fn write_configs(root: &Path, files: &Files) -> Result<()> {
for rel in configs(root)?.keys() {
if !files.contains_key(rel) { fs::remove_file(fsx::safe_join(root, rel)?)?; }
}
for (rel, bytes) in files {
if !(rel.starts_with("Core/configs/") && rel.ends_with(".conf")
|| rel.starts_with("Settings/") && rel.ends_with(".template")) {
return Err(Error::Invalid("Invalid realm configuration path.".into()));
}
fsx::atomic_write(&fsx::ensure_within(root, &fsx::safe_join(root, rel)?)?, bytes)?;
}
Ok(())
}
fn set(files: &mut Files, path: &str, key: &str, value: &str) -> Result<()> {
let mut conf = ConfFile::parse_bytes(files.entry(path.into()).or_insert_with(|| b"[worldserver]\n".to_vec()))?;
conf.set(key, value, &[]);
files.insert(path.into(), conf.to_text().into_bytes());
Ok(())
}
fn wildcard_configs(mut files: Files) -> Result<Files> {
for (key, value) in [
("CoA.ClassModel", "\"hero\""), ("CoA.GameModeMask", "64"),
("CoA.MapClass10ToWarrior", "0"), ("CoA.RealmType", "\"live seasonal\""),
("CoA.ClientBooleanConfigs", "\"CONFIG_LEGACY_CHARACTER_ADVANCEMENT_ENABLED=0\""),
] { set(&mut files, "Core/configs/modules/coa.conf", key, value)?; }
set(&mut files, "Core/configs/modules/mod-coa-challenges.conf", "CoAChallenges.GameModes.Realm", "WildCard")?;
set(&mut files, "Core/configs/modules/mod-coa-challenges.conf", "CoAChallenges.GameModes.Enable", "1")?;
for (key, value) in [("ChancePercent", "65"), ("LinkWeight", "3"), ("RelatedWeight", "2"), ("SpecTagWeight", "2"), ("SchoolTagWeight", "1"), ("TooltipWeight", "3"), ("TalentsNeedTarget", "1"), ("LogRolls", "1")] {
set(&mut files, "Core/configs/modules/wildcard.conf", &format!("Wildcard.Synergy.{key}"), value)?;
}
for path in ["Settings/worldserver.conf.template", "Core/configs/worldserver.conf"] {
if files.contains_key(path) {
for (key, value) in [("RealmID", "2"), ("AlwaysMaxSkillForLevel", "1"), ("PlayerStart.CustomSpells", "1")] {
set(&mut files, path, key, value)?;
}
}
}
for (key, value) in [("CoaBots.Enable", "0"), ("CoaBots.AutoLoginOnStartup", "0")] {
set(&mut files, "Core/configs/modules/mod_coa_playerbots.conf", key, value)?;
}
Ok(files)
}
#[derive(Serialize, Deserialize)]
struct Journal { before: RealmState, files: Files }
fn require_world_stopped(root: &Path) -> Result<()> {
let observed = process::observe(root, &layout::read_ports(root));
if observed.world.state != process::ServiceState::Stopped || observed.auth.state != process::ServiceState::Stopped {
return Err(Error::Invalid("Stop the server before switching realms. Your characters will be saved.".into()));
}
Ok(())
}
pub fn recover(root: &Path) -> Result<()> {
if !root.join(JOURNAL).exists() { return Ok(()); }
require_world_stopped(root)?;
let journal: Journal = fsx::read_json(&root.join(JOURNAL))?;
write_configs(root, &journal.files)?;
fsx::atomic_write_json(&root.join(STATE), &journal.before)?;
fs::remove_file(root.join(JOURNAL))?;
Ok(())
}
fn create_databases(root: &Path) -> Result<()> {
crate::backup::with_database(root, |_| {
let db = Db::from_repack(root, Account::Admin)?.for_realm(Mode::Coa);
if db.query("SELECT COUNT(*) FROM acore_auth.realmlist WHERE id=2;")? != "0" {
return Err(Error::Invalid("Realm ID 2 is already in use. Its settings were left intact.".into()));
}
for kind in ["world", "characters"] {
let source = Mode::Coa.schema(kind)?;
let dest = Mode::Wildcard.schema(kind)?;
if db.schema_exists(dest)? {
return Err(Error::Invalid(format!("Database {dest} already exists. It was left intact; inspect it before creating a realm.")));
}
if db.extra_objects(source)? != 0 {
return Err(Error::Invalid("Realm creation does not support databases with routines, triggers or views.".into()));
}
}
for (schema, tables) in [
("acore_world", &["ascension_wildcard_boss_marks", "ascension_wildcard_tooltip_links"][..]),
("acore_characters", &["coa_wildcard_skill_card", "coa_wildcard_skill_card_pending", "coa_wildcard_skill_card_account", "coa_wildcard_skill_card_purchase", "coa_wildcard_specialization_cache"][..]),
] {
let present = db.tables(schema)?;
if tables.iter().any(|table| !present.iter().any(|p| p == table)) {
return Err(Error::Invalid("Wildcard database migrations are missing. Update the server database before creating this realm.".into()));
}
}
let cache = root.join("Settings/realm-profiles/staging");
fs::create_dir_all(&cache)?;
fsx::require_space(&cache, db.schema_bytes("acore_world")?.saturating_mul(2) + 512 * 1024 * 1024)?;
let dump = cache.join("world.sql.zst");
db.dump_to("acore_world", &dump)?;
let stage_world = format!("coa_realm_world_{}", uuid::Uuid::new_v4().simple());
let stage_chars = format!("coa_realm_chars_{}", uuid::Uuid::new_v4().simple());
db.query(&format!("CREATE DATABASE `{stage_world}` CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE DATABASE `{stage_chars}` CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"))?;
db.import_from(&stage_world, &dump)?;
db.clone_structure("acore_characters", &stage_chars, &cache)?;
for table in ["active_arena_season", "addons", "updates", "updates_include", "warden_action"] {
db.query(&format!("INSERT INTO `{stage_chars}`.`{table}` SELECT * FROM acore_characters.`{table}`;"))?;
}
// The newly empty realm inherits schema migration history, never the owner's characters or cards.
if db.tables("acore_world")?.iter().any(|t| t == "coa_manager_migrations") {
db.query(&format!("CREATE TABLE IF NOT EXISTS `{stage_world}`.coa_manager_migrations LIKE acore_world.coa_manager_migrations;"))?;
}
db.query("CREATE DATABASE acore_world_wildcard CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE DATABASE acore_characters_wildcard CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;")?;
let mut renames = Vec::new();
for (stage, dest) in [(&stage_world, "acore_world_wildcard"), (&stage_chars, "acore_characters_wildcard")] {
for table in db.tables(stage)? {
if !crate::db::valid_identifier(&table) { return Err(Error::Invalid("Unsupported table name.".into())); }
renames.push(format!("`{stage}`.`{table}` TO `{dest}`.`{table}`"));
}
}
db.query(&format!("RENAME TABLE {};", renames.join(", ")))?;
for host in db.query("SELECT host FROM mysql.user WHERE user='acore';")?.lines() {
let host = hex::encode(host.as_bytes());
// Host names are trusted database data, but still quote them through a hex SQL literal.
db.query(&format!("SET @host=CONVERT(UNHEX('{host}') USING utf8mb4); SET @grant=CONCAT('GRANT ALL ON acore_world_wildcard.* TO ', QUOTE('acore'), '@', QUOTE(@host)); PREPARE realm_grant FROM @grant; EXECUTE realm_grant; DEALLOCATE PREPARE realm_grant; SET @grant=CONCAT('GRANT ALL ON acore_characters_wildcard.* TO ', QUOTE('acore'), '@', QUOTE(@host)); PREPARE realm_grant FROM @grant; EXECUTE realm_grant; DEALLOCATE PREPARE realm_grant;"))?;
}
db.query(&format!("DROP DATABASE `{stage_world}`; DROP DATABASE `{stage_chars}`;"))?;
fs::remove_file(&dump)?;
Ok(())
})
}
pub fn select(root: &Path, mode: Mode) -> Result<View> {
require_world_stopped(root)?;
recover(root)?;
let mut s = state(root)?;
if mode == s.active { return view(root); }
if mode == Mode::Wildcard && !view(root)?.supported {
return Err(Error::Invalid("Update the server to a build with Wildcard support first.".into()));
}
// Verify launcher support before creating databases or changing the selected realm.
prepare_launcher(root)?;
let before = configs(root)?;
fsx::atomic_write_json(&snapshot(root, s.active), &before)?;
if mode == Mode::Wildcard && !s.wildcard_created {
fsx::atomic_write_json(&snapshot(root, mode), &wildcard_configs(before.clone())?)?;
create_databases(root)?;
s.wildcard_created = true;
fsx::atomic_write_json(&root.join(STATE), &s)?;
}
let target: Files = fsx::read_json(&snapshot(root, mode))?;
// The launcher and batch files share this lock; recheck after the potentially long database copy.
fs::create_dir_all(root.join(".state"))?;
let lock = fs::OpenOptions::new().read(true).write(true).create(true).truncate(false).open(root.join(".state/control.lock"))?;
fs4::fs_std::FileExt::try_lock_exclusive(&lock).map_err(|_| Error::Invalid("Another start/stop action is in progress.".into()))?;
require_world_stopped(root)?;
let original = state(root)?;
fsx::atomic_write_json(&root.join(JOURNAL), &Journal { before: original, files: before })?;
let result = (|| {
write_configs(root, &target)?;
s.active = mode;
fsx::atomic_write_json(&root.join(STATE), &s)?;
Ok(())
})();
if let Err(e) = result { drop(lock); recover(root)?; return Err(e); }
fs::remove_file(root.join(JOURNAL))?;
view(root)
}
/// Adapt the bundled launcher's canonical schema and realm choices without changing its supervision logic.
pub fn prepare_launcher(root: &Path) -> Result<()> {
let path = root.join("Scripts/manage.py");
let source = fs::read_to_string(&path)?;
let patched = patch_launcher(&source)?;
if patched != source { fsx::atomic_write(&path, patched.as_bytes())?; }
Ok(())
}
fn patch_launcher(source: &str) -> Result<String> {
if source.contains("# coa-manager-realm-profiles-v1") { return Ok(source.into()); }
let replacements = [
("(\"WorldDatabaseInfo\", \"acore_world\")", "(\"WorldDatabaseInfo\", \"acore_world_wildcard\" if coa_realm() == 'wildcard' else \"acore_world\")"),
("(\"CharacterDatabaseInfo\", \"acore_characters\")", "(\"CharacterDatabaseInfo\", \"acore_characters_wildcard\" if coa_realm() == 'wildcard' else \"acore_characters\")"),
("SET name='AzerothCore',address=", "SET name='{coa_realm_name()}',address="),
("WHERE id=1;", "WHERE id={coa_realm_id()};"),
("mysql(\"UPDATE acore_auth.realmlist SET flag=0", "mysql(f\"UPDATE acore_auth.realmlist SET flag=0"),
];
let mut out = source.to_string();
for (from, to) in replacements {
if !out.contains(from) { return Err(Error::Invalid("This launcher does not support realm profiles. Update the server package first.".into())); }
out = out.replace(from, to);
}
let insert = "# coa-manager-realm-profiles-v1\ndef coa_realm():\n path = ROOT / 'Settings/realm-profile.json'\n return json.loads(path.read_text(encoding='utf-8')).get('active', 'coa') if path.exists() else 'coa'\n\ndef coa_realm_id():\n return 2 if coa_realm() == 'wildcard' else 1\n\ndef coa_realm_name():\n return 'Wildcard' if coa_realm() == 'wildcard' else 'Conquest of Azeroth'\n\n";
// Insert before the entry point so ROOT, json and functions are all defined when called.
let marker = "if __name__ == \"__main__\":";
if !out.contains(marker) { return Err(Error::Invalid("Unrecognised server launcher entry point.".into())); }
Ok(out.replace(marker, &format!("{insert}{marker}")))
}
pub fn before_start(root: &Path) -> Result<()> {
recover(root)?;
let s = state(root)?;
if !root.join(STATE).exists() { return Ok(()); }
prepare_launcher(root)?;
if s.active == Mode::Wildcard {
if !view(root)?.supported { return Err(Error::Invalid("The installed server build does not support Wildcard.".into())); }
let path = root.join("Core/configs/modules/mod_coa_playerbots.conf");
let mut conf = ConfFile::parse_bytes(&fs::read(&path)?)?;
conf.set("CoaBots.Enable", "0", &[]);
fsx::atomic_write(&path, conf.to_text().as_bytes())?;
}
Ok(())
}
pub fn setup_realmlist(root: &Path) -> Result<()> {
let s = state(root)?;
if !root.join(STATE).exists() || !s.wildcard_created { return Ok(()); }
let db = Db::from_repack(root, Account::Admin)?;
let port = layout::read_ports(root).world;
db.query(&format!("INSERT INTO acore_auth.realmlist (id,name,address,localAddress,localSubnetMask,port,icon,flag,timezone,gamebuild) SELECT 2,'Wildcard',address,localAddress,localSubnetMask,{port},icon,2,timezone,gamebuild FROM acore_auth.realmlist WHERE id=1 ON DUPLICATE KEY UPDATE port={port}; UPDATE acore_auth.realmlist SET flag=2 WHERE id IN (1,2) AND id<>{};", s.active.realm_id()))?;
Ok(())
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn fresh_wildcard_disables_bots_and_preserves_scaling() {
let mut f = Files::new();
f.insert("Core/configs/modules/mod-coa-content-scaling.conf".into(), b"[worldserver]\nCoAContentScaling.Enable = 1\n".to_vec());
f.insert("Settings/worldserver.conf.template".into(), b"[worldserver]\nRealmID = 1\n".to_vec());
let w = wildcard_configs(f.clone()).unwrap();
assert_eq!(w["Core/configs/modules/mod-coa-content-scaling.conf"], f["Core/configs/modules/mod-coa-content-scaling.conf"]);
let c = ConfFile::parse_bytes(&w["Core/configs/modules/mod_coa_playerbots.conf"]).unwrap();
assert_eq!(c.get("CoaBots.Enable"), Some("0"));
assert_eq!(ConfFile::parse_bytes(&w["Settings/worldserver.conf.template"]).unwrap().get("RealmID"), Some("2"));
}
#[test]
fn corrupt_state_is_not_silently_treated_as_coa() {
let t = tempfile::tempdir().unwrap();
fs::create_dir(t.path().join("Settings")).unwrap();
fs::write(t.path().join(STATE), "broken").unwrap();
assert!(state(t.path()).is_err());
}
#[test]
fn recovery_restores_original_settings() {
let t = tempfile::tempdir().unwrap();
let mut files = Files::new();
files.insert("Core/configs/modules/coa.conf".into(), b"CoA.ClassModel = coa\n".to_vec());
fsx::atomic_write_json(&t.path().join(JOURNAL), &Journal { before: RealmState::default(), files }).unwrap();
recover(t.path()).unwrap();
assert_eq!(state(t.path()).unwrap().active, Mode::Coa);
assert_eq!(fs::read_to_string(t.path().join("Core/configs/modules/coa.conf")).unwrap(), "CoA.ClassModel = coa\n");
assert!(!t.path().join(JOURNAL).exists());
}
#[test]
fn reverting_to_coa_removes_wildcard_only_config_files() {
let t = tempfile::tempdir().unwrap();
let mut coa = Files::new();
coa.insert("Core/configs/modules/coa.conf".into(), b"[worldserver]\nCoA.ClassModel = coa\n".to_vec());
let wildcard = wildcard_configs(coa.clone()).unwrap();
write_configs(t.path(), &wildcard).unwrap();
write_configs(t.path(), &coa).unwrap();
assert!(!t.path().join("Core/configs/modules/mod-coa-challenges.conf").exists());
assert_eq!(configs(t.path()).unwrap(), coa);
}
#[test]
fn wildcard_blocks_bot_settings_and_enable_calls() {
let t = tempfile::tempdir().unwrap();
fsx::atomic_write_json(&t.path().join(STATE), &RealmState { active: Mode::Wildcard, wildcard_created: true }).unwrap();
assert!(crate::modules::set_enabled(t.path(), t.path(), "companions", true).is_err());
assert!(crate::config::save(t.path(), t.path(), crate::config::Scope::Bots, &BTreeMap::new()).is_err());
assert!(guard_module(t.path(), "content-scaling").is_ok());
}
#[test]
fn unknown_launcher_is_refused_without_partial_patching() {
assert!(patch_launcher("print('custom launcher')").is_err());
}
}
+2 -1
View File
@@ -267,6 +267,7 @@ mod tests {
fn drive_root_and_missing_folder_are_rejected() {
let meta = InstallMeta::new(InstallKind::New, Path::new("C:/nope"));
assert!(MetaDir::create(Path::new("C:/definitely/missing/folder"), &meta).is_err());
assert!(metadata_dir_for(Path::new("C:/")).is_err());
let root = if cfg!(windows) { "C:/" } else { "/" };
assert!(metadata_dir_for(Path::new(root)).is_err());
}
}
+29 -3
View File
@@ -476,14 +476,40 @@ impl Env for RepackEnv<'_> {
fn migrate(&self, manifest: &Manifest, staged: &Path) -> Result<ApplyReport> {
let (root, meta) = (self.root, self.meta_dir);
crate::backup::with_database(root, |db| {
crate::migrations::apply_pending(db, &manifest.migrations, staged, &|| {
Ok(crate::backup::create(root, meta, crate::backup::Kind::Database, crate::backup::Trigger::BeforeMigration, None, &|_| {})?.id)
})
let realms = crate::realms::state(root)?;
let mut result = crate::migrations::apply_pending(db, &manifest.migrations, staged, &|| {
Ok(crate::backup::create(root, meta, crate::backup::Kind::Full, crate::backup::Trigger::BeforeMigration, None, &|_| {})?.id)
})?;
if realms.wildcard_created && result.failed.is_none() {
let other = if realms.active == crate::realms::Mode::Coa { crate::realms::Mode::Wildcard } else { crate::realms::Mode::Coa };
let other_db = db.clone().for_realm(other);
let shared_snapshot = result.snapshot.clone();
let migrations: Vec<_> = manifest.migrations.iter().filter(|m| m.db != "auth").cloned().collect();
let extra = crate::migrations::apply_pending(&other_db, &migrations, staged, &|| {
if let Some(id) = &shared_snapshot { return Ok(id.clone()); }
Ok(crate::backup::create(root, meta, crate::backup::Kind::Full, crate::backup::Trigger::BeforeMigration, None, &|_| {})?.id)
})?;
result.applied.extend(extra.applied);
result.failed = extra.failed;
if result.snapshot.is_none() { result.snapshot = extra.snapshot; }
}
Ok(result)
})
}
fn validate(&self) -> Result<()> {
use crate::process::{observe, ServiceState};
// The check start is the first start of the new build: give the module configs the settings the update added
// (as a normal start does), or the server logs a "missing property" line for every one of them.
match crate::registry::MetaDir::open(self.meta_dir) {
Ok((_, meta)) if meta.kind == crate::registry::InstallKind::New => {
let _ = crate::config::materialize_module_configs(self.root);
}
// An imported server gets the files it lacks (nothing it has is changed).
_ => {
let _ = crate::config::create_missing_module_configs(self.root);
}
}
let started = crate::driver::run(self.root, crate::driver::Verb::StartAll)?;
let ports = crate::layout::read_ports(self.root);
let healthy = started.ok && {
+31
View File
@@ -337,6 +337,37 @@ Base package (≈3.2 GB; Data 3.8 GB + mysql data) is split into ≤ 1.9 GB part
with a parts manifest. Reproducibility: pinned runner image label, recorded compiler/vcpkg versions, source SHAs,
build timestamp written into RELEASE.json.
### D13. Linux: the servers run in Docker (experimental)
Linux has no repack launcher and no Win32 process API, and the host should need nothing but Docker. A server folder
that contains `Settings/docker.json` is a **Docker installation**; every other folder is a repack, handled by the
code above without any change. `driver::run`, `process::observe` and `layout::scan` check for the marker first and
hand over to `coa_core::docker`; nothing else needed to change for start, stop, status and the server list.
* **Containers** (`docker/lifecycle.rs`): `coa-<project>-db` (official `mysql:8.4`, data in a named volume, not
published on the host), `-world` and `-auth` (a small runtime image holding only the shared libraries; the
binaries are mounted from `Core/`, so an update replaces files and never rebuilds an image). The image tag is a
hash of its Dockerfile.
* **Why the `docker` command line and not `docker compose`**: the compose plugin is missing from some distributions'
Docker packages, and the plan is to ask for as little as possible on the host. The command line is wrapped by a
`Docker` trait (`docker/cli.rs`), so the logic is tested with an in-memory fake.
* **Same folder shape as a repack where it matters**: `Core/configs`, `Core/Logs`, `Settings/repack.json`
(ports, RA login), `Settings/database.json` and `Data/`. Configuration editing, log tailing and the RA console
therefore work as they do on Windows. The container runs as the owner of the folder and starts in `Core/`.
* **Settings forced by environment** (the core reads `AC_<KEY>` before the `.conf`): `AC_BIND_IP=0.0.0.0` (the
published address, `bindAddress`, decides who can connect), `AC_DATA_DIR`, `AC_LOGS_DIR`, `AC_RA_ENABLE`,
`AC_RA_IP`, and `AC_UPDATES_ENABLE_DATABASES=0`: the server's own database updater needs a `mysql` client program and
stops the server without one; the Manager applies database updates itself (section 1.4). The remote console is published
on `127.0.0.1` only.
* **Secrets** go to `docker` by environment (`--env NAME` without a value), never on a command line.
* **Order**: database healthy, then world listening, then auth. The auth server exits when no realm is online.
Readiness is a connection that stays open: Docker's proxy accepts connections on a published port before the server
inside listens, so a plain connect proves nothing.
* **Configuration path in the binaries**: Linux builds must use `-DCONF_DIR=configs` (see `coa-server-build`),
otherwise the core looks for module configs in a path baked in at build time.
* **Not done yet**: installation and the database setup (schemas, `acore` user), backups and database access through the
container, updates, port conflict detection, the firewall and exposure checks, and the client under Wine/Proton.
---------------------------------------------------------------------------------------------------------
## 3. Flows
+42
View File
@@ -0,0 +1,42 @@
# Realm profiles
Overview offers CoA and Wildcard. The installed worldserver must contain Wildcard support and the database must
already have its Wildcard migrations. The Manager refuses an unsupported binary, an occupied realm ID 2 or an
existing destination database rather than overwrite them.
The first switch copies the CoA world into `acore_world_wildcard` and creates `acore_characters_wildcard` from
the character schema and neutral server seed tables. Existing characters, card collections and progress are not
copied. Accounts remain in shared `acore_auth`. Realm IDs 1 and 2 share the world port; only the selected world
runs, and the inactive realm is listed offline. A switch while running stops the server gracefully and restarts it.
Configuration profiles are saved under `Settings/realm-profiles`. An interrupted switch can restore its previous
configuration from the journal. CoA companion bots cannot be enabled on Wildcard. Content Scaling and the other
optional modules retain their settings but show experimental compatibility; class mechanics need separate gameplay
validation. Switching back restores the CoA module settings.
Quick/database backups include both character databases and shared auth. Full backups also include both worlds.
Recovery points identify their active realm; select that realm before restoring them. Server migrations apply to
both realms, with auth applied once. The server updater can replace its launcher: the Manager reapplies the realm
adapter before the next start.
![Wildcard overview](screenshots/wildcard-demo/overview.jpg)
![Module compatibility](screenshots/wildcard-demo/modules.jpg)
## Validation for v0.5.0
- `cargo test --workspace`: 178 core tests passed; command layer and examples compiled.
- `npm run build`, translation key checks and changelog validation passed.
- Native disposable fixture on offset ports: fresh Wildcard creation and startup, CoA startup after switching back,
separate probe values and restored CoA configuration. A second fresh creation verified the arena-season seed fix.
- Full backup verified both worlds, both character databases, shared auth and configurations.
- Native migration probe applied once to each realm and once to auth; repeating it did nothing.
- Restoring Wildcard characters removed a fixture-only change and preserved the CoA probe value.
- Core gameplay wrapper: `VERIFY ALL: PASSED`, gameplay stage only, real clock. First login (7 assertions),
level rolls/reroll (31), skill card rolls (13), stat path (12). The level-roll and skill-card scenarios passed on isolated
reruns after failing in the shared batch; the wrapper records two batch-sensitive cases.
- Browser demo verified active profile, hidden Bots navigation and module compatibility labels. Screenshots show
mock IPC; native checks above exercised the actual backend and server.
The gameplay harness required fixture-only synchronization of already applied migration history by verified SQL
hashes and its normal Windows module config path. Owned server files and databases were not modified.
Binary file not shown.

After

Width:  |  Height:  |  Size: 86 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 57 KiB

+2 -2
View File
@@ -1,12 +1,12 @@
{
"name": "coa-server-manager",
"version": "0.1.0",
"version": "0.6.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "coa-server-manager",
"version": "0.1.0",
"version": "0.6.0",
"dependencies": {
"@tauri-apps/api": "^2.12.0",
"@tauri-apps/plugin-dialog": "^2.8.0",
+1 -1
View File
@@ -1,7 +1,7 @@
{
"name": "coa-server-manager",
"private": true,
"version": "0.4.0",
"version": "0.6.0",
"license": "AGPL-3.0-only",
"type": "module",
"scripts": {
+1
View File
@@ -16,6 +16,7 @@ tauri = { version = "2", features = [] }
tauri-plugin-dialog = "2"
tauri-plugin-updater = "2"
tauri-plugin-process = "2"
tauri-plugin-opener = "2"
serde = { version = "1", features = ["derive"] }
serde_json = "1"
coa-core = { path = "../crates/coa-core" }
+94 -6
View File
@@ -70,11 +70,24 @@ struct StatusView {
path_exists: bool,
}
/// Where the Manager keeps its own state (server list, logs). `%LOCALAPPDATA%` on Windows, the XDG data folder elsewhere.
fn data_dir() -> PathBuf {
#[cfg(windows)]
let base = std::env::var_os("LOCALAPPDATA").map(PathBuf::from).unwrap_or_else(std::env::temp_dir);
#[cfg(not(windows))]
let base = unix_data_home(std::env::var_os("XDG_DATA_HOME"), std::env::var_os("HOME"));
base.join("CoAServerManager")
}
/// `$XDG_DATA_HOME` when it is an absolute path (the spec says to ignore relative ones), else `~/.local/share`.
#[cfg(not(windows))]
fn unix_data_home(xdg: Option<std::ffi::OsString>, home: Option<std::ffi::OsString>) -> PathBuf {
xdg.map(PathBuf::from)
.filter(|p| p.is_absolute())
.or_else(|| home.map(|h| PathBuf::from(h).join(".local/share")))
.unwrap_or_else(std::env::temp_dir)
}
fn path_of(state: &AppState, id: &str) -> Result<PathBuf> {
state
.registry
@@ -189,13 +202,17 @@ async fn run_verb(state: &AppState, id: String, verb: Verb) -> std::result::Resu
#[tauri::command]
async fn start_server(state: State<'_, AppState>, id: String) -> std::result::Result<DriverOutcome, UiError> {
let _guard = BusyGuard::acquire(&state, &id)?;
// Servers installed before module configs were created automatically get them now (missing files only). Imported
// servers are never written to by the Manager outside the launcher's own start-up.
// servers only get the module files they lack (see below); nothing they have is changed.
if let Ok(root) = path_of(&state, &id) {
let _ = tauri::async_runtime::spawn_blocking(move || {
let (_, meta) = install_meta(&root)?;
if meta.kind == coa_core::registry::InstallKind::New {
coa_core::config::materialize_module_configs(&root)?;
} else {
// Imported: only the module files that are missing (a module without its file logs every setting it reads).
let _ = coa_core::config::create_missing_module_configs(&root);
}
let dir = meta_dir(&root)?;
coa_core::friends::ensure_bind(&root, &dir)?;
@@ -206,12 +223,14 @@ async fn start_server(state: State<'_, AppState>, id: String) -> std::result::Re
})
.await;
}
let out = run_verb(&state, id.clone(), Verb::StartAll).await?;
let root = path_of(&state, &id)?;
let out = blocking(move || driver::run(&root, Verb::StartAll)).await?;
if out.ok {
if let Ok(root) = path_of(&state, &id) {
// Companions requested while the server was stopped are created now (once; a failure is only logged).
let r = root.clone();
let _ = tauri::async_runtime::spawn_blocking(move || -> Result<()> {
if coa_core::realms::guard_module(&r, "companions").is_err() { return Ok(()); }
let pending = meta_dir(&r)?.join("companions.pending.json");
if let Ok(v) = coa_core::fsx::read_json::<serde_json::Value>(&pending) {
let _ = std::fs::remove_file(&pending);
@@ -275,6 +294,7 @@ async fn save_settings(
changes: BTreeMap<String, Value>,
) -> std::result::Result<config::SaveReport, UiError> {
let root = path_of(&state, &id)?;
let _guard = BusyGuard::acquire(&state, &id)?;
blocking(move || {
let meta = meta_dir(&root)?;
config::save(&root, &meta, scope, &changes)
@@ -509,9 +529,39 @@ async fn modules_list(state: State<'_, AppState>, id: String) -> std::result::Re
blocking(move || Ok(coa_core::modules::list(&root))).await
}
#[tauri::command]
async fn realm_profiles(state: State<'_, AppState>, id: String) -> std::result::Result<coa_core::realms::View, UiError> {
let root = path_of(&state, &id)?;
blocking(move || coa_core::realms::view(&root)).await
}
#[tauri::command]
async fn realm_select(state: State<'_, AppState>, id: String, mode: coa_core::realms::Mode, restart: bool) -> std::result::Result<coa_core::realms::View, UiError> {
let root = path_of(&state, &id)?;
let _guard = BusyGuard::acquire(&state, &id)?;
let result = blocking(move || {
if restart {
let out = driver::run(&root, Verb::StopAll)?;
if !out.ok { return Err(Error::Invalid(out.output)); }
}
let view = coa_core::realms::select(&root, mode)?;
let (dir, meta) = install_meta(&root)?;
if let Some(client) = meta.client_path {
coa_core::client::sync_realm(std::path::Path::new(&client), &dir, view.active)?;
}
if restart {
let out = driver::run(&root, Verb::StartAll)?;
if !out.ok { return Err(Error::Invalid(format!("Realm selected, but startup failed: {}", out.output))); }
}
Ok(view)
}).await;
result
}
#[tauri::command]
async fn module_set_enabled(state: State<'_, AppState>, id: String, module: String, enabled: bool) -> std::result::Result<(), UiError> {
let root = path_of(&state, &id)?;
let _guard = BusyGuard::acquire(&state, &id)?;
blocking(move || {
let (dir, _) = install_meta(&root)?;
coa_core::modules::set_enabled(&root, &dir, &module, enabled)
@@ -528,6 +578,7 @@ async fn module_settings(state: State<'_, AppState>, id: String, module: String)
#[tauri::command]
async fn module_save_settings(state: State<'_, AppState>, id: String, module: String, changes: BTreeMap<String, String>) -> std::result::Result<Vec<String>, UiError> {
let root = path_of(&state, &id)?;
let _guard = BusyGuard::acquire(&state, &id)?;
blocking(move || {
let (dir, _) = install_meta(&root)?;
coa_core::modules::save_settings(&root, &dir, &module, &changes)
@@ -544,6 +595,7 @@ async fn all_settings(state: State<'_, AppState>, id: String) -> std::result::Re
#[tauri::command]
async fn all_settings_save(state: State<'_, AppState>, id: String, changes: BTreeMap<String, String>) -> std::result::Result<Vec<String>, UiError> {
let root = path_of(&state, &id)?;
let _guard = BusyGuard::acquire(&state, &id)?;
blocking(move || {
let (dir, _) = install_meta(&root)?;
coa_core::allsettings::save(&root, &dir, &changes)
@@ -1072,19 +1124,27 @@ fn end_client_job(state: &AppState) {
#[tauri::command]
async fn play(state: State<'_, AppState>, id: String) -> std::result::Result<DriverOutcome, UiError> {
let root = path_of(&state, &id)?;
let (_, _, client) = client_of(&root)?;
let (dir, _, client) = client_of(&root)?;
let client = client.unwrap();
if coa_core::client::is_running(&client) {
return Err(Error::Invalid("Close the game client before pressing Play so its selected realm can be updated.".into()).into());
}
let ready = {
let o = coa_core::process::observe(&root, &layout::read_ports(&root));
[&o.mysql, &o.auth, &o.world].iter().all(|s| s.state == coa_core::process::ServiceState::Running)
};
if !ready {
let out = run_verb(&state, id, Verb::StartAll).await?;
let out = run_verb(&state, id.clone(), Verb::StartAll).await?;
if !out.ok {
return Ok(out);
}
}
let _guard = BusyGuard::acquire(&state, &id)?;
blocking(move || {
let mode = coa_core::realms::state(&root)?.active;
if !coa_core::client::sync_realm(&client, &dir, mode)? {
return Err(Error::Invalid("Close the game client before pressing Play so its selected realm can be updated.".into()));
}
coa_core::client::launch(&client)?;
Ok(DriverOutcome { ok: true, exit_code: None, code: None, human: None, output: String::new() })
})
@@ -1120,8 +1180,7 @@ fn open_link(url: String) -> std::result::Result<(), UiError> {
if !(issue || catalog || ALLOWED.iter().any(|p| url.starts_with(p))) || !chars_ok || url.len() > 12_000 {
return Err(Error::Invalid("That link is not allowed.".into()).into());
}
// explorer.exe opens the address in the default browser without going through a shell.
std::process::Command::new("explorer.exe").arg(&url).spawn().map_err(|e| Error::Invalid(e.to_string()))?;
tauri_plugin_opener::open_url(&url, None::<&str>).map_err(|e| Error::Invalid(e.to_string()))?;
Ok(())
}
@@ -1392,6 +1451,8 @@ pub fn run() {
realmlist_delete,
realmlist_activate,
modules_list,
realm_profiles,
realm_select,
module_set_enabled,
module_settings,
module_save_settings,
@@ -1442,3 +1503,30 @@ pub fn run() {
.run(tauri::generate_context!())
.expect("error while running CoA Server Manager");
}
#[cfg(all(test, not(windows)))]
mod tests {
use super::unix_data_home;
use std::ffi::OsString;
use std::path::PathBuf;
fn os(s: &str) -> Option<OsString> {
Some(s.into())
}
#[test]
fn data_home_prefers_an_absolute_xdg_folder() {
assert_eq!(unix_data_home(os("/data/xdg"), os("/home/u")), PathBuf::from("/data/xdg"));
}
#[test]
fn data_home_ignores_a_relative_xdg_folder_and_falls_back_to_home() {
assert_eq!(unix_data_home(os("relative/dir"), os("/home/u")), PathBuf::from("/home/u/.local/share"));
assert_eq!(unix_data_home(None, os("/home/u")), PathBuf::from("/home/u/.local/share"));
}
#[test]
fn data_home_without_any_variable_uses_the_temp_folder() {
assert_eq!(unix_data_home(None, None), std::env::temp_dir());
}
}
+6
View File
@@ -1,5 +1,11 @@
#![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]
fn main() {
// WebKitGTK's DMA-BUF renderer ends the process with a Wayland "Protocol error" on some graphics stacks (seen with
// an NVIDIA card on Wayland). The path without it works everywhere; a value set by the user is left alone.
#[cfg(target_os = "linux")]
if std::env::var_os("WEBKIT_DISABLE_DMABUF_RENDERER").is_none() {
std::env::set_var("WEBKIT_DISABLE_DMABUF_RENDERER", "1");
}
coa_server_manager_lib::run()
}
+1 -1
View File
@@ -1,7 +1,7 @@
{
"$schema": "https://schema.tauri.app/config/2",
"productName": "CoA Server Manager",
"version": "0.4.0",
"version": "0.6.0",
"identifier": "com.coa.servermanager",
"build": {
"beforeDevCommand": "npm run dev",
+8 -4
View File
@@ -6,9 +6,10 @@ import serverPresets from "../../schemas/presets/server.json";
export {};
(() => {
let added = false, running = false;
let added = new URLSearchParams(location.search).has("demo"), running = false;
let realm: "coa" | "wildcard" = "coa", wildcardCreated = false;
const modState: Record<string, boolean> = { "companions": true, "content-scaling": true, "client-compat": true, "tbc-content": true, "wotlk-content": true, "npc-enchanter": true };
const report = {path:"C:\games\CoA-Repack",classification:"healthy",items:[
const report = {path:"C:\\games\\CoA-Repack",classification:"healthy",items:[
{key:"worldserver",label:"World server",status:"found",detail:null},
{key:"authserver",label:"Auth server",status:"found",detail:null},
{key:"database_content",label:"Auth / Characters / World databases",status:"found",detail:"acore_auth, acore_characters, acore_world"},
@@ -17,16 +18,19 @@ export {};
worldserver:null,authserver:null,banner_revision:"3567e2f8e9d5",bot_config_keys:71,client:null,
notes:["worldserver.exe differs from the one listed in RELEASE.json (release 2026-09-11); this looks like a customised build."],modifies_files:false};
const svc=(n: string,p: number,st: string)=>({name:n,state:st,pid:st==="running"?100:null,port:p,port_ready:st==="running",conflict:null,uptime_secs:st==="running"?4206:null});
{ const q = new URLSearchParams(location.search); const w0 = window as any; if (q.get("client")) w0.__client = q.get("client"); if (q.get("modified")) w0.__modified = true; }
(window as any).__TAURI_INTERNALS__ = {
transformCallback: (cb: unknown)=>cb, unregisterCallback(){}, convertFileSrc:(x: unknown)=>x,
invoke: async (cmd: string, args?: any)=>{
if(cmd==="realm_profiles") return {active:realm,wildcard_created:wildcardCreated,supported:true,recovery_pending:false};
if(cmd==="realm_select"){await new Promise(r=>setTimeout(r,600));realm=args.mode;wildcardCreated ||= realm==="wildcard";modState.companions=realm==="coa";return {active:realm,wildcard_created:wildcardCreated,supported:true,recovery_pending:false};}
if(cmd==="list_servers") return added?[{id:"1",name:"CoA-Repack",path:report.path}]:[];
if(cmd==="scan_server") return report;
if(cmd==="add_server"){added=true;return {id:"1",name:"CoA-Repack",path:report.path};}
if(cmd==="server_status"){const s=running?"running":"stopped";return {observed:{mysql:svc("mysql",3307,s),auth:svc("auth",3724,s),world:svc("world",8085,s)},busy:false,path_exists:true};}
if(cmd==="start_server"){await new Promise((r: any)=>setTimeout(r,1500));running=true;return {ok:true,exit_code:0,code:null,human:null,output:""};}
if(cmd==="stop_server"){await new Promise((r: any)=>setTimeout(r,1500));running=false;return {ok:true,exit_code:0,code:null,human:null,output:""};}
if(cmd.startsWith("plugin:dialog")) return "C:\games\CoA-Repack";
if(cmd.startsWith("plugin:dialog")) return "C:\\games\\CoA-Repack";
if(cmd==="get_settings"){const sc=args?.scope==="server"?serverSchema:botsSchema;return {scope:args?.scope,categories:sc.categories,settings:(sc.settings as any[]).map(x=>({...x,options:x.options??[],value:x.default,is_default:true,present:true,problem:null,drift:false})),unknown_keys:3,drift_keys:[],files:[]};}
if(cmd==="list_presets"){const pr=args?.scope==="server"?serverPresets:botsPresets;return (pr.presets as any[]).map(p=>({id:p.id,title:p.title,description:p.description}));}
if(cmd==="preview_preset"){const a=args;const sc=a.scope==="server"?serverSchema:botsSchema;const pr=(a.scope==="server"?serverPresets:botsPresets).presets as any[];const p=pr.find(x=>x.id===a.preset)??{id:a.preset??"defaults",title:"Recommended defaults",description:"Every setting returns to its default value."};const st=(sc.settings as any[]).filter(x=>x.type==="int"||x.type==="float"||x.type==="enum").slice(0,3);return {id:p.id,title:p.title,description:p.description,changes:st.map(x=>({key:x.key,title:x.title,from:x.default,to:x.type==="enum"?(x.options?.[1]?.value??x.default):(Number(x.default)||1)*2,dangerous:false}))};}
@@ -55,7 +59,7 @@ export {};
if(cmd==="realmlist_save"){const w=window as any;const rl=w.__rl;if(args.profileId){const p=rl.profiles.find((x: any)=>x.id===args.profileId);p.name=args.name;p.data=args.data;return p;}if(rl.profiles.some((x: any)=>x.name.toLowerCase()===String(args.name).toLowerCase()))throw {human:{code:"unknown",title:"",message:"",actions:[]},technical:"A realmlist with that name already exists."};const p={id:String(args.name).toLowerCase().replace(/[^a-z0-9]+/g,"-"),name:args.name,data:(/\s/.test(args.data.trim())?args.data.trim():"set realmlist "+args.data.trim())+"\r\n"};rl.profiles.push(p);return p;}
if(cmd==="realmlist_delete"){const rl=(window as any).__rl;rl.profiles=rl.profiles.filter((x: any)=>x.id!==args.profileId);return null;}
if(cmd==="account_delete") return null;
if(cmd==="modules_list") return [{id:"companions",name:"CoA Companions",description:{en:"Companion bots for groups, dungeons and your guild.",ru:"Боты-компаньоны для групп, подземелий и гильдии."},repo:"https://github.com/Corfirean/mod-coa-playerbots",installed:true,enabled:modState["companions"],switchable:true,status:"beta",icon:"bot",page:"bots"},{id:"content-scaling",name:"Content Scaling",description:{en:"Scales dungeons and raids to your group, with solo modes.",ru:"Подстраивает подземелья и рейды под вашу группу, есть соло-режимы."},repo:"https://github.com/Corfirean/mod-coa-content-scaling",installed:true,enabled:modState["content-scaling"],switchable:true,status:"early",icon:"scaling",page:null},{id:"tbc-content",name:"TBC Content",description:{en:"Outland dungeons and raids, scaled to your level range.",ru:"Подземелья и рейды Запределья, подогнанные под ваши уровни."},repo:"https://github.com/Corfirean/mod-coa-content-scaling/tree/main/content-packs/mod-coa-tbc-content",installed:true,enabled:modState["tbc-content"],switchable:true,status:"early",icon:"tbc",page:null},{id:"wotlk-content",name:"WotLK Content",description:{en:"Northrend dungeons and raids, scaled to your level range.",ru:"Подземелья и рейды Нордскола, подогнанные под ваши уровни."},repo:"https://github.com/Corfirean/mod-coa-content-scaling/tree/main/content-packs/mod-coa-wotlk-content",installed:true,enabled:modState["wotlk-content"],switchable:true,status:"early",icon:"wotlk",page:null},{id:"ah-bot",name:"Auction House Bot",description:{en:"Fills the auction house with realistic, adjustable listings.",ru:"Наполняет аукцион реалистичными настраиваемыми лотами."},repo:"https://github.com/NathanHandley/mod-ah-bot-plus",installed:false,enabled:false,switchable:false,status:"soon",icon:"gavel",page:null,hidden:false},{id:"npc-enchanter",name:"NPC Enchanter",description:{en:"An NPC that enchants your gear for you.",ru:"НПС, который зачаровывает ваше снаряжение."},repo:"https://github.com/azerothcore/mod-npc-enchanter",installed:true,enabled:modState["npc-enchanter"],switchable:true,status:"early",icon:"sparkles",page:null,hidden:false},{id:"playerbots",name:"SQUID's Playerbots",description:{en:"An alternative bot system with random bots and full AI.",ru:"Альтернативная система ботов со случайными ботами и полным ИИ."},repo:"https://github.com/Zyth45/mod-playerbots",installed:false,enabled:false,switchable:false,status:"soon",icon:"swords",page:null,hidden:false},{id:"client-compat",name:"Client compatibility",description:{en:"Client-server link and appearance unlocks.",ru:"Связь клиента с сервером и разблокировка внешних видов."},repo:"https://github.com/Corfirean/azerothcore-wotlk-coa",installed:true,enabled:modState["client-compat"],switchable:false,status:"release",icon:"plug",page:null,hidden:true}];
if(cmd==="modules_list") return [{id:"companions",name:"CoA Companions",description:{en:"Companion bots for groups, dungeons and your guild.",ru:"Боты-компаньоны для групп, подземелий и гильдии."},repo:"https://github.com/Corfirean/mod-coa-playerbots",installed:true,enabled:modState["companions"],switchable:true,status:"beta",icon:"bot",page:"bots"},{id:"content-scaling",name:"Content Scaling",description:{en:"Scales dungeons and raids to your group, with solo modes.",ru:"Подстраивает подземелья и рейды под вашу группу, есть соло-режимы."},repo:"https://github.com/Corfirean/mod-coa-content-scaling",installed:true,enabled:modState["content-scaling"],switchable:true,status:"early",icon:"scaling",page:null},{id:"tbc-content",name:"TBC Content",description:{en:"Outland dungeons and raids, scaled to your level range.",ru:"Подземелья и рейды Запределья, подогнанные под ваши уровни."},repo:"https://github.com/Corfirean/mod-coa-content-scaling/tree/main/content-packs/mod-coa-tbc-content",installed:true,enabled:modState["tbc-content"],switchable:true,status:"early",icon:"tbc",page:null},{id:"wotlk-content",name:"WotLK Content",description:{en:"Northrend dungeons and raids, scaled to your level range.",ru:"Подземелья и рейды Нордскола, подогнанные под ваши уровни."},repo:"https://github.com/Corfirean/mod-coa-content-scaling/tree/main/content-packs/mod-coa-wotlk-content",installed:true,enabled:modState["wotlk-content"],switchable:true,status:"early",icon:"wotlk",page:null},{id:"ah-bot",name:"Auction House Bot",description:{en:"Fills the auction house with realistic, adjustable listings.",ru:"Наполняет аукцион реалистичными настраиваемыми лотами."},repo:"https://github.com/NathanHandley/mod-ah-bot-plus",installed:false,enabled:false,switchable:false,status:"soon",icon:"gavel",page:null,hidden:false},{id:"npc-enchanter",name:"NPC Enchanter",description:{en:"An NPC that enchants your gear for you.",ru:"НПС, который зачаровывает ваше снаряжение."},repo:"https://github.com/azerothcore/mod-npc-enchanter",installed:true,enabled:modState["npc-enchanter"],switchable:true,status:"early",icon:"sparkles",page:null,hidden:false},{id:"playerbots",name:"SQUID's Playerbots",description:{en:"An alternative bot system with random bots and full AI.",ru:"Альтернативная система ботов со случайными ботами и полным ИИ."},repo:"https://github.com/Zyth45/mod-playerbots",installed:false,enabled:false,switchable:false,status:"soon",icon:"swords",page:null,hidden:false},{id:"client-compat",name:"Client compatibility",description:{en:"Client-server link and appearance unlocks.",ru:"Связь клиента с сервером и разблокировка внешних видов."},repo:"https://github.com/Corfirean/azerothcore-wotlk-coa",installed:true,enabled:modState["client-compat"],switchable:false,status:"release",icon:"plug",page:null,hidden:true}].map(m => ({...m, compatibility: realm === "wildcard" ? (["companions", "playerbots"].includes(m.id) ? "unsupported" : m.id === "client-compat" ? "compatible" : "experimental") : "compatible", switchable: realm === "wildcard" && ["companions", "playerbots"].includes(m.id) ? false : m.switchable}));
if(cmd==="module_set_enabled"){ modState[args.module]=args.enabled; return null; }
if(cmd==="all_settings") return [{key:"Visibility.Distance.Continents",value:"100",default:"90",doc:"Description: Visibility distance on continents. Range: 45-250 Default: 90",changed:true},{key:"Death.SicknessLevel",value:"11",default:"11",doc:"Description: Character level up to which characters get resurrection sickness. Default: 11",changed:false},{key:"Rate.Drop.Item.Epic",value:"3",default:"1",doc:"Description: Drop rates for money and items based on quality. Default: 1",changed:true},{key:"Instance.ResetTimeHour",value:"4",default:"4",doc:"Description: Hour of the day when the global instance reset occurs. Range: 0-23 Default: 4 - (04:00 AM)",changed:false},{key:"PlayerLimit",value:"1000",default:"1000",doc:"Description: Maximum number of players in the world.",changed:false}];
if(cmd==="all_settings_save") return Object.keys(args&&args.changes||{});
+6 -3
View File
@@ -4,12 +4,14 @@ import ru from "./locales/ru";
import de from "./locales/de";
import fr from "./locales/fr";
import es from "./locales/es";
import zh from "./locales/zh";
import ruSchema from "./schema/ru.json";
import deSchema from "./schema/de.json";
import frSchema from "./schema/fr.json";
import esSchema from "./schema/es.json";
import zhSchema from "./schema/zh.json";
export type Locale = "en" | "ru" | "de" | "fr" | "es";
export type Locale = "en" | "ru" | "de" | "fr" | "es" | "zh";
export type Key = keyof typeof en;
type Vars = Record<string, string | number>;
@@ -19,9 +21,10 @@ export const LOCALES: { id: Locale; name: string }[] = [
{ id: "de", name: "Deutsch" },
{ id: "fr", name: "Français" },
{ id: "es", name: "Español" },
{ id: "zh", name: "简体中文" },
];
const DICTS: Record<Locale, Partial<Record<Key, string>>> = { en, ru, de, fr, es };
const DICTS: Record<Locale, Partial<Record<Key, string>>> = { en, ru, de, fr, es, zh };
const STORAGE_KEY = "coa-locale";
function initialLocale(): Locale {
@@ -95,7 +98,7 @@ interface SchemaOverlay {
options: Record<string, string>;
presets: Record<string, { t: string; d: string }>;
}
const SCHEMA: Partial<Record<Locale, SchemaOverlay>> = { ru: ruSchema, de: deSchema, fr: frSchema, es: esSchema };
const SCHEMA: Partial<Record<Locale, SchemaOverlay>> = { ru: ruSchema, de: deSchema, fr: frSchema, es: esSchema, zh: zhSchema };
export function useSchemaText() {
const { locale } = useContext(I18n);
+14
View File
@@ -697,6 +697,18 @@ const de: Partial<Record<keyof typeof en, string>> = {
"rep.copied": "In die Zwischenablage kopiert.",
// Realmlist switcher and modules page
"realm.profileLabel": "Realm",
"realm.switching": "Realm wird gewechselt…",
"realm.create": "Wildcard-Realm erstellen",
"realm.restart": "Wechseln und neu starten",
"realm.select": "Realm auswählen",
"realm.active": "Aktiv: {name}",
"realm.separate": "Es läuft jeweils eine Welt. Jeder Realm behält eigene Charaktere, Fortschritte und Moduleinstellungen.",
"realm.modules": "CoA-Begleiter sind hier nicht verfügbar. Content Scaling und andere Module sind auf Wildcard experimentell.",
"realm.update": "Aktualisiere den Server auf eine Version mit Wildcard-Unterstützung, um diesen Realm zu erstellen.",
"realm.recovery": "Ein Realm-Wechsel wurde unterbrochen. Wähle einen Realm, um die gespeicherte Konfiguration wiederherzustellen.",
"realm.unsupported": "Auf Wildcard nicht verfügbar: Die Klassenmechanik wurde noch nicht geprüft.",
"realm.experimental": "Experimentell auf Wildcard · Spielkompatibilität noch nicht geprüft.",
"realm.label": "Realm",
"realm.other": "Anderer",
"realm.add": "Realmlist hinzufügen …",
@@ -773,6 +785,8 @@ const de: Partial<Record<keyof typeof en, string>> = {
"set.searchAll": "Alle Einstellungen nach Name oder Beschreibung durchsuchen…",
"set.search": "Einstellungen durchsuchen…",
"upd.current": "Du bist auf dem neuesten Stand (Version {v}).",
"client.job.checking": "Client wird geprüft…",
"client.job.updating": "Client wird aktualisiert",
};
export default de;
+16
View File
@@ -1,5 +1,17 @@
/** English is the source of truth: every key must exist here; other locales fall back to it. */
const en = {
"realm.profileLabel": "Realm",
"realm.switching": "Switching realm…",
"realm.create": "Create Wildcard realm",
"realm.restart": "Switch and restart",
"realm.select": "Select realm",
"realm.active": "Active: {name}",
"realm.separate": "One world runs at a time. Each realm keeps its own characters, progress and module settings.",
"realm.modules": "CoA companions are unavailable here. Content Scaling and other modules remain experimental on Wildcard.",
"realm.update": "Update the server to a build with Wildcard support to create this realm.",
"realm.recovery": "A realm switch was interrupted. Select a realm to recover the saved configuration.",
"realm.unsupported": "Unavailable on Wildcard: class mechanics have not been validated.",
"realm.experimental": "Experimental on Wildcard · gameplay compatibility is not yet verified.",
"app.name": "CoA Server Manager",
"nav.overview": "Overview",
@@ -92,6 +104,8 @@ const en = {
"err.operation_in_progress.message": "The server is busy starting or stopping. Wait a moment and try again.",
"err.startup_failed.title": "Server could not start",
"err.startup_failed.message": "A service stopped while starting. Check the details for the cause.",
"err.docker_unavailable.title": "Docker is not available",
"err.docker_unavailable.message": "This server runs in Docker. Install Docker, start it, and make sure your user account may use it, then try again.",
"err.hash_mismatch.title": "A downloaded file is damaged",
"err.hash_mismatch.message": "The file did not match its checksum and was not used.",
"err.path_rejected.title": "That location is not allowed",
@@ -773,6 +787,8 @@ const en = {
"set.searchAll": "Search all settings by name or description…",
"set.search": "Search settings…",
"upd.current": "You are up to date (version {v}).",
"client.job.checking": "Checking the client…",
"client.job.updating": "Updating the client",
} as const;
export default en;
+14
View File
@@ -697,6 +697,18 @@ const es: Partial<Record<keyof typeof en, string>> = {
"rep.copied": "Copiado al portapapeles.",
// Realmlist switcher and modules page
"realm.profileLabel": "Reino",
"realm.switching": "Cambiando de reino…",
"realm.create": "Crear reino Wildcard",
"realm.restart": "Cambiar y reiniciar",
"realm.select": "Seleccionar reino",
"realm.active": "Activo: {name}",
"realm.separate": "Solo funciona un mundo a la vez. Cada reino conserva sus personajes, progreso y ajustes de módulos.",
"realm.modules": "Los compañeros de CoA no están disponibles aquí. Content Scaling y los demás módulos siguen siendo experimentales en Wildcard.",
"realm.update": "Actualiza el servidor a una versión compatible con Wildcard para crear este reino.",
"realm.recovery": "Se interrumpió un cambio de reino. Selecciona un reino para recuperar la configuración guardada.",
"realm.unsupported": "No disponible en Wildcard: las mecánicas de clase aún no se han validado.",
"realm.experimental": "Experimental en Wildcard · compatibilidad en juego sin verificar.",
"realm.label": "Reino",
"realm.other": "Otro",
"realm.add": "Añadir una realmlist…",
@@ -773,6 +785,8 @@ const es: Partial<Record<keyof typeof en, string>> = {
"set.searchAll": "Buscar en todos los ajustes por nombre o descripción…",
"set.search": "Buscar ajustes…",
"upd.current": "Estás al día (versión {v}).",
"client.job.checking": "Comprobando el cliente…",
"client.job.updating": "Actualizando el cliente",
};
export default es;
+14
View File
@@ -697,6 +697,18 @@ const fr: Partial<Record<keyof typeof en, string>> = {
"rep.copied": "Copié dans le presse-papiers.",
// Realmlist switcher and modules page
"realm.profileLabel": "Royaume",
"realm.switching": "Changement de royaume…",
"realm.create": "Créer le royaume Wildcard",
"realm.restart": "Changer et redémarrer",
"realm.select": "Choisir le royaume",
"realm.active": "Actif : {name}",
"realm.separate": "Un seul monde fonctionne à la fois. Chaque royaume conserve ses personnages, sa progression et les paramètres de ses modules.",
"realm.modules": "Les compagnons CoA sont indisponibles ici. Content Scaling et les autres modules restent expérimentaux sur Wildcard.",
"realm.update": "Mettez le serveur à jour vers une version compatible avec Wildcard pour créer ce royaume.",
"realm.recovery": "Un changement de royaume a été interrompu. Choisissez un royaume pour restaurer la configuration enregistrée.",
"realm.unsupported": "Indisponible sur Wildcard : les mécaniques de classe ne sont pas encore validées.",
"realm.experimental": "Expérimental sur Wildcard · compatibilité en jeu non vérifiée.",
"realm.label": "Royaume",
"realm.other": "Autre",
"realm.add": "Ajouter une realmlist…",
@@ -773,6 +785,8 @@ const fr: Partial<Record<keyof typeof en, string>> = {
"set.searchAll": "Rechercher dans tous les réglages par nom ou description…",
"set.search": "Rechercher un réglage…",
"upd.current": "Vous êtes à jour (version {v}).",
"client.job.checking": "Vérification du client…",
"client.job.updating": "Mise à jour du client",
};
export default fr;
+14
View File
@@ -2,6 +2,18 @@ import type en from "./en";
/** Русский. Черновой перевод; требует проверки носителем перед релизом. */
const ru: Partial<Record<keyof typeof en, string>> = {
"realm.profileLabel": "Реалм",
"realm.switching": "Переключение реалма…",
"realm.create": "Создать реалм Wildcard",
"realm.restart": "Переключить и перезапустить",
"realm.select": "Выбрать реалм",
"realm.active": "Активен: {name}",
"realm.separate": "Работает один мир. У каждого реалма свои персонажи, прогресс и настройки модулей.",
"realm.modules": "CoA-боты здесь недоступны. Скалирование и другие модули пока экспериментальны для Wildcard.",
"realm.update": "Для создания реалма обновите сервер до сборки с поддержкой Wildcard.",
"realm.recovery": "Переключение прервалось. Выберите реалм, чтобы восстановить сохранённые настройки.",
"realm.unsupported": "Недоступен в Wildcard: классовые механики ещё не проверены.",
"realm.experimental": "Экспериментально в Wildcard · игровая совместимость пока не проверена.",
"nav.overview": "Обзор",
"nav.bots": "Боты",
"nav.server": "Сервер",
@@ -773,6 +785,8 @@ const ru: Partial<Record<keyof typeof en, string>> = {
"set.searchAll": "Поиск по всем настройкам: название или описание…",
"set.search": "Поиск по настройкам…",
"upd.current": "У вас последняя версия ({v}).",
"client.job.checking": "Проверка клиента…",
"client.job.updating": "Обновление клиента",
};
export default ru;
+794
View File
@@ -0,0 +1,794 @@
/** Simplified Chinese localization (zh-CN) */
const zh = {
"realm.profileLabel": "服务器",
"realm.switching": "正在切换服务器…",
"realm.create": "创建 Wildcard 服务器",
"realm.restart": "切换并重启",
"realm.select": "选择服务器",
"realm.active": "当前活跃:{name}",
"realm.separate": "同时仅运行一个世界服务器。每个服务器保留独立的角色、进度和模块设置。",
"realm.modules": "此处无法使用 CoA 随从。动态难度等级缩放及其他模块在 Wildcard 上仍处于实验阶段。",
"realm.update": "请先将服务器更新至支持 Wildcard 的版本以创建此服务器。",
"realm.recovery": "服务器切换被中断。请选择一个服务器以恢复保存的配置。",
"realm.unsupported": "在 Wildcard 上不可用:职业机制尚未验证通过。",
"realm.experimental": "在 Wildcard 上处于实验阶段 · 游戏玩法兼容性尚未验证。",
"app.name": "CoA Server Manager",
"nav.overview": "概览",
"nav.bots": "机器人",
"nav.server": "服务器",
"nav.players": "玩家",
"nav.friends": "好友联机",
"nav.backups": "备份",
"nav.console": "控制台",
"nav.settings": "设置",
"nav.addAnother": "管理另一个服务器",
"nav.main": "主要",
"nav.serverPicker": "服务器",
"q.overview": "服务器当前是否正在运行?",
"q.bots": "机器人目前是如何配置的?",
"q.server": "服务器机制与规则是如何运行的?",
"q.players": "当前有哪些玩家在线?",
"q.friends": "好友如何加入我的服务器?",
"q.backups": "我的数据是否安全?",
"q.console": "服务器正在输出什么日志?",
"q.settings": "管理器自身如何运行?",
"welcome.title": "欢迎使用 CoA Server Manager",
"welcome.subtitle": "轻松运行专属的征服艾泽拉斯 (CoA) 服务器 —— 无需任何技术知识。",
"welcome.install.title": "安装全新服务器",
"welcome.install.text": "一键自动配置,包含运行所需的所有内容。",
"welcome.import.title": "已有服务器",
"welcome.import.text": "添加现有服务器。仅进行读取,不会更改任何原始文件。",
"welcome.back": "返回我的服务器",
"overview.server": "服务器",
"overview.database": "数据库",
"overview.auth": "登录服务器",
"overview.world": "世界服务器",
"overview.uptime": "运行时间",
"overview.players": "在线玩家",
"overview.companions": "+ {n} 名随从",
"overview.checking": "正在检查服务器状态…",
"overview.partial": "部分服务正在运行。点击“启动”运行其余服务,或点击“停止”完全关闭。",
"overview.portTitle": "服务器所需的端口已被占用",
"overview.portText": "端口 {port} 正在被其他程序占用:{exe}。",
"overview.missingTitle": "未找到服务器文件夹",
"overview.missingText": "{path} 缺失或已被移动。",
"overview.forget": "从管理器中移除(不会删除任何文件)",
"status.online": "在线",
"status.offline": "离线",
"status.starting": "正在启动…",
"status.stopping": "正在停止…",
"status.attention": "需要注意",
"status.running": "运行中",
"status.stopped": "已停止",
"btn.start": "启动服务器",
"btn.stop": "停止服务器",
"btn.stopSmall": "停止",
"btn.restart": "重启",
"btn.play": "开始游戏",
"btn.startPlay": "启动并开始游戏",
"btn.startingCaps": "正在启动…",
"btn.stoppingCaps": "正在停止…",
"common.viewDetails": "查看详情",
"common.hideDetails": "隐藏详情",
"common.copyError": "复制错误信息",
"common.noOutput": "(无输出)",
"common.cancel": "取消",
"common.save": "保存",
"settings.title": "设置",
"settings.language": "语言",
"settings.languageHint": "选择程序界面语言。翻译由母语者校对;尚未翻译的内容将显示为英文。",
"err.database_not_running.title": "数据库未运行",
"err.database_not_running.message": "服务器启动需要数据库支持。请先启动数据库。",
"err.port_in_use.title": "服务器端口已被占用",
"err.port_in_use.message": "其他程序(或另一个服务器)正在使用此服务器所需的端口。",
"err.server_files_incomplete.title": "服务器文件不完整",
"err.server_files_incomplete.message": "部分服务器文件缺失或损坏。",
"err.world_db_incompatible.title": "世界数据库与当前版本不兼容",
"err.world_db_incompatible.message": "此服务器版本启动前需要先执行数据库更新。",
"err.worldserver_already_running.title": "另一个 worldserver 进程已在运行",
"err.worldserver_already_running.message": "请在启动此服务器前先停止另一个服务器。",
"err.invalid_config_value.title": "服务器配置包含无效值",
"err.invalid_config_value.message": "请修正高亮显示的设置并重新保存。",
"err.disk_full.title": "磁盘可用空间不足",
"err.disk_full.message": "请清理部分空间或选择其他驱动器,然后重试。",
"err.operation_in_progress.title": "另一项操作仍在进行中",
"err.operation_in_progress.message": "服务器正忙于启动或停止。请稍等片刻后重试。",
"err.startup_failed.title": "服务器无法启动",
"err.startup_failed.message": "某个服务在启动过程中停止。请查看详细信息了解原因。",
"err.hash_mismatch.title": "下载的文件已损坏",
"err.hash_mismatch.message": "文件校验和不匹配,已放弃使用。",
"err.path_rejected.title": "不允许使用该路径",
"err.path_rejected.message": "请求的文件路径超出了服务器文件夹范围。",
"err.unknown.title": "出现异常",
"err.unknown.message": "请查看技术详情。",
// Import server
"import.title": "添加现有服务器",
"import.subtitle": "选择服务器运行所在的文件夹。仅进行读取。",
"import.dialogTitle": "选择服务器文件夹",
"import.choose": "选择文件夹…",
"import.chooseAnother": "选择其他文件夹",
"import.looking": "正在检查服务器…",
"import.healthy.title": "检测到现有服务器",
"import.healthy.text": "运行此服务器所需的所有文件均已找到。",
"import.partial.title": "服务器部分文件已找到",
"import.partial.text": "缺少部分组件。你仍可添加它;不会自动修复任何内容。",
"import.custom.title": "检测到自定义服务器",
"import.custom.text": "无法识别该构建版本。部分更新和安装功能将被禁用。",
"import.incompatible.title": "这不是有效的服务器文件夹",
"import.incompatible.text": "请选择主服务器文件夹:即包含 Core、Data、mysql、Scripts 和 Settings 的文件夹(而不是 Core 文件夹本身)。",
"import.techDetails": "显示技术详情",
"import.detected": "已检测到",
"import.notInstalled": "未安装",
"import.notFound": "未找到",
"import.noChanges": "导入过程中不会更改任何文件。",
"import.add": "添加服务器",
// Install server
"install.title": "安装全新服务器",
"install.subtitle": "选择一个文件夹,或使用推荐位置。其余所有配置都会为你自动完成。",
"install.installTo": "安装到",
"install.browse": "浏览…",
"install.dialogTitle": "选择服务器安装位置",
"install.pkgDialogTitle": "选择服务器离线安装包文件夹",
"install.ready": "此文件夹已就绪。剩余可用空间 {gb} GB。",
"install.failedTitle": "安装未能完成",
"install.nothingInstalled": "未安装任何内容。你可以重试;已下载的文件会保留。",
"install.showTech": "显示技术详情",
"install.hideTech": "隐藏技术详情",
"install.advanced": "高级选项",
"install.localPkg": "从本地离线包文件夹安装,无需在线下载",
"install.localPkgHint": "(留空则在线下载)",
"install.button": "安装",
"install.progressTitle": "正在准备服务器",
"install.progressText": "这可能需要几分钟。你可以保持此窗口开启。",
"install.step.checking": "检查电脑环境",
"install.step.downloading": "下载服务器",
"install.step.unpacking": "解压文件",
"install.step.database": "准备数据库",
"install.step.finishing": "完成安装",
"install.doneTitle": "服务器已就绪",
"install.doneText": "所有组件均已安装完成。可在下一个界面中启动它。",
"install.open": "打开我的服务器",
// Players
"players.title": "玩家",
"players.createTitle": "创建游戏账号",
"players.createText": "用于登录游戏的账号名称和密码。",
"players.startFirst": "请先启动服务器 —— 账号需要在服务器运行时创建。",
"players.username": "账号名",
"players.password": "密码",
"players.admin": "设为管理员账号",
"players.adminHint": "管理员可以在游戏中使用 GM 命令。请仅对信任的账号开启。",
"players.create": "创建账号",
"players.created": "账号“{name}”创建成功。现在可以使用它登录游戏了。",
// Companions
"comp.title": "AI 随从伙伴",
"comp.population": "当前在线 {online} · 共创建 {total}",
"comp.reading": "正在读取当前人口…",
"comp.startToSee": "启动服务器以查看在线随从数量。",
"comp.wantMore": "想要添加更多随从吗?",
"comp.custom": "自定义",
"comp.numberLabel": "随从数量",
"comp.largeWarning": "较大的人口规模可能需要更多 CPU 和内存。建议逐步增加。",
"comp.hardware": "当前电脑:{cores} 核心,{ram} GB 内存。",
"comp.add": "添加 {n} 名随从",
"comp.addPlain": "添加随从",
"comp.stoppedHint": "服务器已停止:随从将在下次服务器运行时创建。",
"comp.spawned": "正在创建 {n} 名随从。它们将在接下来的几分钟内陆续上线。",
"comp.saved": "已保存。{n} 名随从将在服务器启动时创建。",
// Client
"client.title": "游戏客户端",
"client.looking": "正在寻找…",
"client.intro": "指定游戏客户端安装路径即可启用“开始游戏”按钮。除服务器地址和随从插件外,你的游戏文件绝不会被修改。",
"client.chooseFolder": "选择游戏文件夹…",
"client.dialogTitle": "选择游戏客户端文件夹",
"client.connectsTo": "连接到",
"client.thisComputer": "✓ 本机",
"client.notThisServer": "非此服务器",
"client.addon": "随从管理插件",
"client.installedVersion": "已安装 (版本 {v})",
"client.installed": "已安装",
"client.addonNotInstalled": "未安装",
"client.updateAvailable": "有可用更新",
"client.otherAddons": "其他插件",
"client.leftAsIs": "{n} 个 —— 完全保持原样",
"client.pointLocal": "将游戏连接指向此服务器",
"client.pointedNote": "游戏现在将连接到本机。先前的地址已备份保存。",
"client.installAddon": "安装随从插件",
"client.updateAddon": "更新随从插件",
"client.addonNote": "随从插件已安装。其他插件未受任何影响。",
"client.changeFolder": "更换文件夹…",
// Diagnostics
"diag.title": "诊断",
"diag.text": "检查常见问题。不会修改任何文件。",
"diag.run": "运行诊断",
"diag.verify": "校验服务器文件",
"diag.export": "导出诊断包",
"diag.saved": "已保存供问题反馈使用:{path}",
"diag.allGood": "一切运行正常。",
"diag.problems_one": "发现 {n} 处需要注意",
"diag.problems_few": "发现 {n} 处需要注意",
"diag.problems_many": "发现 {n} 处需要注意",
"diag.problems_other": "发现 {n} 处需要注意",
"diag.word.ok": "正常",
"diag.word.warn": "注意",
"diag.word.fail": "异常",
"diag.filesOk": "所有程序文件完好无损。",
"diag.filesDiffer": "{n} 个程序文件与原始安装不一致。你自己的配置文件绝不会出现在这里。“检查更新”可恢复缺失的文件。",
"diag.fileMissing": "缺失",
"diag.fileChanged": "已修改",
// About Manager
"about.version": "版本 {v}。程序本身的更新绝不会改动你的服务器数据。",
"about.check": "检查新版本",
"about.install": "安装 {v} 并重启",
"about.upToDate": "CoA Server Manager 已是最新版本。",
"about.checkFailed": "检查新版本失败。请检查网络连接后重试。",
"about.installFailed": "无法安装更新。你的服务器未受任何影响。",
// Backups
"bk.title": "备份",
"bk.trigger.manual": "手动备份",
"bk.trigger.automatic": "自动备份",
"bk.trigger.before-update": "更新前自动备份",
"bk.trigger.before-restore": "还原前安全备份",
"bk.trigger.before-migration": "数据库升级前备份",
"bk.trigger.before-bots": "安装随从前备份",
"bk.trigger.before-repair": "修复前备份",
"bk.trigger.before-dangerous-change": "高风险更改前备份",
"bk.kind.quick": "角色、账号与设置",
"bk.kind.full": "完整数据(含世界数据库)",
"bk.kind.config": "仅配置文件",
"bk.kind.database": "角色与账号数据",
"bk.db.characters": "角色数据",
"bk.db.auth": "账号数据",
"bk.db.world": "世界数据",
"bk.today": "今天 {time}",
"bk.yesterday": "昨天 {time}",
"bk.created": "备份创建成功。",
"bk.last": "上次备份:{when}",
"bk.none": "暂无备份",
"bk.keptNext": "备份存放在服务器目录旁,绝不会覆盖你的线上数据。",
"bk.backUpNow": "立即备份",
"bk.full": "完整备份",
"bk.fullHint": "同时保存体积较大的世界数据库",
"bk.settingsOnly": "仅配置文件",
"bk.working": "正在处理…",
"bk.failed": "操作未能完成",
"bk.restoreFrom": "还原来自 {what} 的备份({when})",
"bk.restoreNote": "不会删除任何数据。当前数据会先被安全备份,被替换的数据库将以新名称保留。",
"bk.stopFirst": "请先停止服务器 —— 数据库仅可在服务器停止时还原。",
"bk.settingsRestored": "设置已还原。先前的配置已生成安全副本。",
"bk.restoreSettings": "还原设置",
"bk.confirmDb": "是否从该备份还原 {db} 数据库?自 {when} 以来的新进度将被归档保留(不会被删除)。",
"bk.dbRestored": "成功还原 {n} 张数据表。先前的数据已保留为 {schema}。",
"bk.restoreDb": "还原 {db}",
"bk.loading": "正在加载…",
"bk.empty": "你的备份将显示在此处。",
"bk.restore": "还原",
"bk.verify": "校验",
"bk.intact": "该备份完整无损。",
"bk.problem": "发现问题:{details}",
"bk.delete": "删除",
"bk.confirmDelete": "确定删除此备份吗?仅会删除此备份文件,服务器本身不受影响。",
// Friends
"fr.title": "好友联机",
"fr.looking": "正在检测连接状态…",
"fr.ok": "正常",
"fr.notYet": "尚未就绪",
"fr.mode.lan.title": "局域网联机",
"fr.mode.lan.text": "适用于处于同一家庭网络或 Wi-Fi 下的好友。",
"fr.mode.direct.title": "公网直连",
"fr.mode.direct.text": "跨互联网联机。需要你的路由器支持并开放端口映射。",
"fr.mode.private.title": "虚拟私有网",
"fr.mode.private.text": "跨互联网联机,无需配置路由器。使用免费的 Tailscale 软件。",
"fr.restartToApply": "重启服务器以使配置生效。",
"fr.ready": "已准备好接受好友连接。",
"fr.exposedTitle": "私有服务正暴露在网络中",
"fr.exposedText": "{what} 当前允许来自其他电脑的连接。请通过本管理器重启服务器以关闭外部访问。",
"fr.what.database": "数据库",
"fr.what.console": "服务器控制台",
"fr.and": " 和 ",
"fr.status": "状态",
"fr.st.running": "服务器正在运行",
"fr.st.open": "登录与游戏服务器已向其他电脑开放",
"fr.st.firewall": "Windows 防火墙已放行游戏端口",
"fr.st.private": "数据库与控制台仅限本机访问",
"fr.inUse": "使用中",
"fr.yourLan": "你在局域网中的 IP 地址:",
"fr.unknown": "未知",
"fr.checkConn": "检查我的网络连接",
"fr.cgnat": "你的宽带运营商处于大内网环境 (CGNAT),不支持公网直连。请改用虚拟私有网模式。",
"fr.publicAddr": "你的公网 IP 地址:",
"fr.noRouter": " · 路由器无法自动设置;请手动转发两个游戏端口",
"fr.noInternet": "无法连接到互联网以获取公网 IP 地址。",
"fr.tsMissing": "尚未安装 Tailscale。请下载并安装该免费应用、登录账号后重试。",
"fr.tsOff": "Tailscale 已安装但未连接。请先登录该软件。",
"fr.privateAddr": "你的私有 IP 地址:",
"fr.checkFirst": "请先检测网络连接",
"fr.reapply": "重新应用",
"fr.enable": "启用",
"fr.onlyLocal": "当前仅限本机连接。",
"fr.stopSharing": "停止共享(仅本机连接)",
"fr.giveTitle": "将此信息发送给好友",
"fr.giveText": "好友只需将这行配置写入游戏客户端的 realmlist.wtf 文件。密码与敏感设置绝不会泄露。",
"fr.copied": "已复制",
"fr.copy": "复制连接信息",
"fr.pkg": "打包好友联机补丁 (zip)",
"fr.pkgSaved": "已保存:{path}",
// Console
"con.title": "控制台",
"con.tab.world": "世界",
"con.tab.auth": "登录",
"con.tab.database": "数据库",
"con.tab.manager": "管理器",
"con.searchLabel": "搜索日志",
"con.search": "搜索…",
"con.follow": "滚动到底部",
"con.copied": "已复制",
"con.copyErrors": "仅复制错误日志",
"con.empty": "暂无日志输出。",
"con.commandsNote": "命令将直接发送给正在运行的世界服务器。高风险操作(关机、删除、封禁)会要求二次确认。",
"con.commandLabel": "命令",
"con.send": "发送",
"con.confirmRisky": "指令“{cmd}”可能导致停机或批量修改数据。确定发送吗?",
// Server updates
"upd.act.create": "新增文件",
"upd.act.replace": "已更新",
"upd.act.merge-config": "已合并新配置项",
"upd.act.skip": "保持不变",
"upd.act.conflict": "需要手动决定",
"upd.updatedTo": "已成功更新至版本 {v}。",
"upd.confirmBack": "是否回滚至上一个版本?你的角色与账号数据不会受到影响。",
"upd.wentBack": "已回滚至上一个版本。你的个人数据完好无损。",
"upd.dialogTitle": "选择更新包文件夹",
"upd.pendingBad": "更新后的服务器未能正常启动",
"upd.pendingUnfinished": "先前的更新尚未完成",
"upd.safeBack": "你可以安全回滚至先前的稳定版本。",
"upd.backNote": "回滚操作将恢复程序文件与配置文件。角色和账号数据绝不会被自动回滚。",
"upd.goBackTo": "回滚至版本 {v}",
"upd.goBackBefore": "回滚至更新前的版本",
"upd.title": "服务器更新",
"upd.text": "更新均经过真实性签名校验,并在执行前自动备份,随时可安全撤销。",
"upd.check": "检查更新",
"upd.folderLabel": "更新包文件夹",
"upd.folderHint": "更新包文件夹(留空则从官方源下载)",
"upd.available": "检测到新版本 {to}",
"upd.availableFrom": "检测到新版本 {to}(当前为 {from})",
"upd.summary": "需下载 {size} · 变更 {files} 个文件",
"upd.summaryDb": "需下载 {size} · 变更 {files} 个文件 · {db} 次数据库升级",
"upd.conflict": "此文件曾在管理器外部被手动修改。",
"upd.keep": "保留我的本地文件",
"upd.replace": "使用更新覆盖",
"upd.now": "立即更新",
"upd.stopNote": "更新期间服务器将暂时停止,并在完成后重新启动以验证可用性。",
// Settings editor
"set.restart.runtime": "立即生效",
"set.restart.world": "需要重启世界服务器",
"set.restart.full": "需要完全重启服务器",
"set.on": "开启",
"set.off": "关闭",
"set.enterNumber": "输入数值",
"set.enterInt": "输入整数",
"set.atLeast": "不得小于 {n}",
"set.atMost": "不得大于 {n}",
"set.careful": "谨慎修改",
"set.changed": "已修改",
"set.default": "默认:{v}",
"set.range": "有效范围 {min}–{max}",
"set.badValue": "文件中包含无法使用的值 ({problem});当前显示默认值。",
"set.drift": "在生成的配置文件中被手动修改 —— 除非在此处保存,否则下次启动时管理器将重置该项。",
"set.reset": "恢复默认值",
"set.resetItem": "将 {name} 恢复为默认值",
"set.nothingYet": "暂无需要配置的内容",
"set.loading": "正在加载设置…",
"set.confirmCareful": "你正在修改 {n} 项标记为“谨慎修改”的设置。当前配置已先保存为快照以供撤销。是否继续?",
"set.driftTitle": "有 {n} 项设置曾在外部被手动修改",
"set.driftText": "服务器每次启动都会从模板重新生成 worldserver.conf,以下手动修改的内容将会丢失:",
"set.presets": "预设方案:",
"set.restoreDefaults": "恢复推荐默认值",
"set.matches": "无需更改 —— 你的设置已完全一致。",
"set.willChange_one": "将更改 {n} 项设置:",
"set.willChange_few": "将更改 {n} 项设置:",
"set.willChange_many": "将更改 {n} 项设置:",
"set.willChange_other": "将更改 {n} 项设置:",
"set.apply": "应用",
"set.nothingChanged": "未做任何修改。",
"set.saved": "已保存。",
"set.restartRequired_one": "应用这 {n} 项设置需要重启服务器。",
"set.restartRequired_few": "应用这 {n} 项设置需要重启服务器。",
"set.restartRequired_many": "应用这 {n} 项设置需要重启服务器。",
"set.restartRequired_other": "应用这 {n} 项设置需要重启服务器。",
"set.appliesNextStart": "更改将在下次服务器启动时生效。",
"set.restartNow": "立即重启",
"set.later": "稍后",
"set.notSaved": "未保存任何更改。请修正高亮项后重试。",
"set.advanced": "高级设置 ({n})",
"set.unknownKept": "配置文件中的其他 {n} 项设置完全保持原样。",
"set.unsaved_one": "{n} 项未保存的修改",
"set.unsaved_few": "{n} 项未保存的修改",
"set.unsaved_many": "{n} 项未保存的修改",
"set.unsaved_other": "{n} 项未保存的修改",
"set.discard": "放弃修改",
"set.save": "保存修改",
// Download errors
"err.package_not_published.title": "该服务器安装包尚未发布",
"err.package_not_published.message": "下载源中未找到对应包。请稍后重试,或通过“高级选项”从本地文件夹安装。",
"err.network_unreachable.title": "无法连接到下载服务器",
"err.network_unreachable.message": "请检查网络连接后重试。",
// Manager self-update
"selfupd.ready": "管理器 {v} 已就绪可安装",
"selfupd.onClose": "将在退出管理器时自动安装。你的服务器将继续保持运行。",
"selfupd.installing": "正在安装… 管理器即将关闭。",
"selfupd.now": "立即安装",
"about.auto": "在后台自动下载更新并在退出管理器时安装",
"about.autoHint": "管理器的更新绝不会中断或改动你的游戏服务器。",
// Friends line
"fr.copyLine": "复制配置行",
// Diagnostics checks
"dg.title.files": "服务器文件",
"dg.title.missing_parts": "缺失组件",
"dg.title.mysql": "数据库",
"dg.title.auth": "登录服务器",
"dg.title.world": "世界服务器",
"dg.title.configs": "配置文件",
"dg.title.config_values": "配置数值",
"dg.title.disk": "磁盘可用空间",
"dg.title.permissions": "文件权限",
"dg.title.client": "游戏客户端",
"dg.title.exposure": "私有服务",
"dg.files.ok": "已找到所有预期的服务器组件。",
"dg.files.partial": "部分服务器组件缺失。",
"dg.files.custom": "这是自定义服务器版本;部分功能受限。",
"dg.files.bad": "该文件夹看起来不像有效的 CoA 服务器目录。",
"dg.svc.running": "运行中",
"dg.svc.port": "端口 {port} 正被其他程序占用 (进程 PID {pid})。",
"dg.svc.starting": "正在启动,尚未开始监听响应。",
"dg.svc.stopped": "未运行。",
"dg.configs.ok": "配置文件读取正常。",
"dg.configs.bad": "无法读取以下文件:{files}",
"dg.values.bad": "以下项包含无效值:{keys}",
"dg.disk.ok": "剩余 {gb} GB 可用空间",
"dg.disk.low": "仅剩 {gb} GB 可用空间;备份与更新需要更多存储空间。",
"dg.perm.ok": "服务器目录具有正常写入权限。",
"dg.perm.bad": "管理器无法写入服务器目录(请尝试更换路径或以管理员身份运行一次)。",
"dg.client.missing": "未找到先前设置的游戏客户端路径;请在“设置”中重新选择。",
"dg.exposure.ok": "数据库与控制台未向外部网络暴露。",
"dg.exposure.bad": "以下服务暴露于外部网络中:{what}。",
// Update steps
"ustep.Starting": "正在启动",
"ustep.Checking the update": "正在检查更新",
"ustep.Downloading the update": "正在下载更新",
"ustep.Verifying the update": "正在校验更新包",
"ustep.Making sure the server is stopped": "正在确认服务器已停止",
"ustep.Saving a recovery point": "正在创建恢复点",
"ustep.Applying the update": "正在应用更新文件",
"ustep.Updating the database": "正在更新数据库结构",
"ustep.Starting the updated server": "正在启动更新后的服务器",
"ustep.Finishing": "正在收尾完成",
"ustep.Undoing the update": "正在撤销更新并回滚",
"ustep.Done": "已完成",
// Companion sizes
"comp.size.small": "小型",
"comp.size.medium": "中型",
"comp.size.large": "大型",
"comp.warnHardware": "{n} 名随从可能需要超出本机硬件配置的 CPU 和内存资源(本机:{cores} 核,{ram} GB)。",
"comp.warnMemory": "请先释放部分系统内存;其他程序当前占用了大部分可用内存。",
// Friends notes
"fr.note.forwarded": "已向路由器请求自动端口映射。",
"fr.note.manual": "你的路由器不支持自动端口映射;请手动转发两个游戏端口或使用虚拟私有网。",
// Import labels and placeholder
"scan.label.worldserver": "世界服务器 (worldserver)",
"scan.label.authserver": "登录服务器 (authserver)",
"scan.label.database_content": "账号 / 角色 / 世界数据库",
"scan.label.companions": "CoA 随从伙伴 (机器人)",
"scan.label.client": "游戏客户端",
"placeholder.soon": "该模块将在后续版本中开放支持。",
// Tick rate
"overview.tick": "世界运算帧率",
"overview.tickUnit": "次心跳/秒",
"overview.tickGood": "流畅",
"overview.tickBusy": "负载较高",
"overview.tickLag": "存在卡顿",
"overview.tickDetail": "平均心跳延迟 {mean} ms · 95% 低于 {p95} ms · 峰值 {max} ms",
"overview.tickHint": "世界服务器的循环处理速度。高于每秒 20 次心跳时体验流畅;低于 10 次会出现明显延迟感。",
// Companions start
"err.companion_templates_missing.title": "尚未生成随从模板数据",
"err.companion_templates_missing.message": "新随从基于各职业的 80 级角色模板克隆。请在任意普通玩家账号下为每个职业创建一个 80 级角色,然后重试。",
// Friends guides
"fr.tsDownload": "下载 Tailscale (免费)",
"fr.guide": "联机配置指南",
"fr.g.net.1": "点击“检查我的网络连接”:管理器会自动获取你的公网 IP,并尝试通过 UPnP 自动配置路由器端口转发。",
"fr.g.net.2": "如果无法自动打开,请登录路由器管理后台(通常为 192.168.0.1 或 192.168.1.1),找到“端口转发 (Port Forwarding)”或“虚拟服务器 / NAT”。",
"fr.g.net.3": "将两个 TCP 端口映射到本机的内网 IP ({lan}):{auth}(登录)与 {world}(游戏)。内外部端口号保持一致。",
"fr.g.net.4": "切勿转发数据库端口 (3307) 或服务器控制台端口 (3443)。",
"fr.g.net.5": "点击“启用”,重启服务器,并将上方的配置行(“set realmlist …”)发送给好友。好友将其写入游戏目录下的 realmlist.wtf 文件即可。",
"fr.g.net.6": "如果你的宽带是运营商大内网 (CGNAT),将无法开放公网端口:请改用下方的虚拟私有网方案。",
"fr.g.routerHelp": "常见路由器端口转发分步指南 (portforward.com)",
"fr.g.ts.1": "你和好友均下载安装免费的 Tailscale 客户端(上方链接)并登录账号。",
"fr.g.ts.2": "将你的电脑共享给好友:打开 Tailscale 后台管理页面,在设备列表中找到本机,选择“Share…”,将邀请链接发给好友。好友在自己的 Tailscale 账号中接受即可。",
"fr.g.ts.3": "无需任何路由器配置。点击“启用”,重启服务器,并将包含你 Tailscale IP 的配置行发送给好友。",
"fr.g.ts.4": "联机游玩期间双方均需保持 Tailscale 客户端在后台运行。",
"fr.g.ts.admin": "打开 Tailscale 管理控制台",
"fr.g.ts.share": "了解设备共享机制 (tailscale.com)",
// Bots at start
"comp.startTitle": "服务器启动时随从设置",
"comp.startAuto": "服务器启动时自动让随从上线",
"comp.startCount": "自动登录随从数量",
"comp.startSave": "保存",
"comp.startSaved": "已保存。将在下次服务器启动时生效。",
"comp.startHint": "未登录的随从仍保留在数据库中,随时可在需要时手动调出上线。",
"comp.startInvalid": "请输入 0 到 5000 之间的整数。",
// Overview start bots
"overview.startBots": "开机自动登录随从:{n}",
"overview.startBotsOff": "开机自动登录随从:关闭",
// Offline bots
"comp.offlineDone": "已成功创建 {n} 名随从及初始装备。它们将在下次服务器启动时登录游戏。",
// Companions progress
"comp.progress": "已添加 {done} / {target}",
"comp.progressDone": "所有 {n} 名随从创建完毕。正在陆续登录上线。",
"comp.progressOffline": "正在为 {n} 名随从配置装备与数据… 这需要几分钟时间。",
"comp.progressStalled": "正在等待服务器完成批量生成…",
// Companions control
"comp.stop": "停止创建",
"comp.stopped": "已停止。排队中的 {n} 名随从已取消创建;已经生成的随从将保留。",
"comp.manageTitle": "管理现有随从",
"comp.offline": "全部下线",
"comp.offlineConfirm": "是否将所有随从踢出游戏?它们的数据仍完好保存在数据库中,可在下次启动或手动添加时重新上线。",
"comp.offlineDone2": "已将 {n} 名随从下线。数据已保留。",
"comp.delete": "永久删除所有随从…",
"comp.deleteConfirm": "是否彻底删除所有 {n} 名随从?系统会先自动保存恢复点。你自己的玩家角色绝不会受影响。",
"comp.deleteDone": "所有随从已成功删除。操作前已保存安全恢复点。",
"err.companion_command_unsupported.title": "当前服务器核心版本不支持该命令",
"err.companion_command_unsupported.message": "当前构建版本的随从模块缺少该指令。请更新服务器,或通过重启服务器来中止当前任务。",
// Despawn some
"comp.despawnSome": "减少 {n} 名随从",
"comp.despawnCount": "让多少名随从下线",
"comp.despawnHint": "可立即降低服务器负载:每个在线随从都会消耗计算资源。随从数据保留在数据库中,若开启了自动登录则会在下次启动时恢复。",
"comp.despawnSomeDone": "已让 {n} 名随从下线。数据已保存。",
// Server update button
"btn.update": "更新",
"btn.updating": "正在更新…",
"btn.updateTo": "更新至 {v}",
"overview.updateAvail": "检测到服务器新版本:{to}(当前为 {from})。",
"overview.updateConflicts": "部分文件被你手动修改过。请在“设置”中选择如何处理冲突。",
"overview.openUpdates": "打开更新界面",
"overview.updatingNote": "正在更新:服务器将自动停止、备份、应用更新并重新启动以验证可用性。",
"nav.updateDot": "有可用更新",
// Game client download and update
"btn.close": "关闭",
"btn.setupClient": "配置游戏客户端",
"btn.updateClient": "更新客户端",
"client.setup.title": "配置游戏客户端",
"client.setup.intro": "进行游戏需要安装匹配的客户端。你可以关联已有的游戏客户端,也可以让管理器为你自动下载。",
"client.setup.have": "已有游戏客户端",
"client.setup.download": "下载全新客户端",
"client.setup.downloadHint": "约 43 GB",
"client.dl.pickParent": "选择游戏客户端存放位置",
"client.dl.confirmText": "版本 {v},体积 {size}。将被保存在以下文件夹中:",
"client.dl.free": "该驱动器剩余空间:{free}。",
"client.dl.notEnough": "磁盘剩余空间不足:需要 {need},可用 {free}。请选择其他驱动器。",
"client.dl.otherFolder": "选择其他文件夹…",
"client.dl.start": "开始下载",
"client.dl.back": "返回",
"client.dl.retry": "重试",
"client.dl.resume": "继续下载",
"client.dl.cancel": "停止",
"client.dl.cancelled": "下载已暂停。已下载的文件将被保留;随时可继续断点续传。",
"client.dl.scanning": "正在比对文件…",
"client.dl.downloading": "正在下载",
"client.dl.progress": "{done} / {total}",
"client.dl.speed": "{speed}/秒",
"client.dl.done": "游戏客户端已就绪",
"client.dl.doneText": "已成功关联至此服务器。你可以点击“开始游戏”了。",
"client.upd.title": "客户端更新",
"client.upd.available": "检测到更新的游戏客户端版本:{v}。",
"client.upd.summary": "需下载 {n} 个文件,共计 {size}。",
"client.upd.upToDate": "你的客户端已与版本 {v} 完全一致。",
"client.upd.modifiedTitle": "检测到 {n} 个文件曾被你修改",
"client.upd.modifiedText": "例如打过补丁的可执行程序。你可以选择保留它们,或替换为官方版本;被替换的文件将保存在客户端的 .coa-manager 文件夹中以作备份。图形渲染增强补丁(如 d3d9.dll 等)及配置文件始终会保留原样。",
"client.upd.keep": "保留我修改过的文件",
"client.upd.more": "… 以及另外 {n} 个",
"client.upd.start": "更新客户端",
"client.upd.later": "暂不更新",
"client.upd.playAnyway": "跳过更新直接进入游戏",
"client.upd.done": "游戏客户端已是最新版本",
"client.upd.doneText": "当发布更高版本时,管理器会及时提醒你。",
"client.track.title": "保持客户端为最新版本",
"client.track.text": "管理器会先比对你的客户端与官方版本,并在后续像检查服务器更新一样检测新版本。除非你明确选择,否则你修改过的文件绝不会被自动替换。",
"client.track.start": "保持更新",
"client.track.startUpdate": "更新并保持同步",
"client.track.button": "为该客户端开启自动检查更新…",
"client.version": "客户端版本",
"client.versionUntracked": "未由管理器追踪",
"client.versionUnfinished": "下载尚未完成",
"client.downloadInstead": "下载全新客户端…",
// Accounts panel, password toggle, install size, addon explanation
"pw.show": "显示密码",
"pw.hide": "隐藏密码",
"install.size": "服务器安装将占用约 {size} 磁盘空间。下载包体积为 {download};安装过程中峰值约需 {peak} 临时空间。",
"client.addonWhat": "在游戏内通过小地图图标打开的管理面板,用于指挥你的随从:补齐五人小队、分配坦克治疗输出职责与阵型、下达攻击/拉怪/停留等指令,并实时查看他们的装备与任务状态。即使不安装插件游戏也能正常运行,此时随从将完全由其自主 AI 驱动。",
"acc.title": "账号管理",
"acc.text": "可登录该服务器的所有账号。修改密码及权限需要服务器处于运行状态。",
"acc.refresh": "刷新列表",
"acc.unavailable": "账号列表当前不可用。请启动服务器后重试。",
"acc.empty": "暂无账号。可在上方创建第一个账号。",
"acc.col.name": "账号",
"acc.col.chars": "角色数量",
"acc.col.access": "权限等级",
"acc.col.last": "最后登录",
"acc.online": "在线",
"acc.never": "从未登录",
"acc.level.0": "普通玩家",
"acc.level.1": "版主 (Moderator)",
"acc.level.2": "游戏管理员 (GM)",
"acc.level.3": "最高管理员 (Admin)",
"acc.changePassword": "修改密码",
"acc.rename": "重命名",
"acc.needsRunning": "请先启动服务器再管理账号。",
"acc.changeFor": "为 {name} 设置新密码",
"acc.renameFor": "重命名账号 {name}",
"acc.newName": "新账号名称",
"acc.newPassword": "新密码",
"acc.nameRule": "3–17 位英文字母或数字。",
"acc.passRule": "6–16 位字符,不可包含空格或引号。",
"acc.renameNote": "由于魔兽认证协议中的密码散列依赖账号名称,重命名后必须设置新密码。玩家将使用新账号名和此密码登录。操作时该账号必须处于离线状态。",
"acc.save": "保存",
"acc.passwordChanged": "账号 {name} 的密码已成功修改。",
"acc.renamed": "账号 {name} 现已更名为 {new}。",
"acc.accessChanged": "账号 {name} 的权限现已调整为:{level}。",
// Problem report (GitHub issue)
"nav.report": "问题反馈",
"q.report": "遇到了功能异常?",
"rep.title": "报告问题",
"rep.intro": "描述遇到的问题。管理器会据此生成一份 GitHub Issue 报告并在浏览器中打开;你可以在网页上核对内容、添加截图并提交。需要免费的 GitHub 账号。本窗口不会直接向外发送任何数据。",
"rep.autoTitle": "自动填充的系统环境",
"rep.manager": "管理器版本",
"rep.windows": "Windows 版本",
"rep.kind": "服务器类型",
"rep.kindNew": "全新安装",
"rep.kindImported": "导入现有服务器",
"rep.server": "服务器核心版本",
"rep.summary": "问题简述",
"rep.summaryHint": "例如:创建角色后卡在加载画面",
"rep.what": "具体发生了什么?",
"rep.whatHint": "详细描述故障现象。",
"rep.expected": "你预期的行为是什么?",
"rep.expectedHint": "描述你期望的正常表现。",
"rep.steps": "复现步骤",
"rep.attachTitle": "日志与截图附件",
"rep.attachText": "生成一份诊断包文件(已自动脱敏密码与私有 IP 等敏感信息),并在浏览器打开 GitHub 页面后,将其连同截图或录屏一起拖拽上传。",
"rep.makeFile": "生成诊断包文件",
"rep.fileSaved": "已保存至 {path}。请将该文件拖入 GitHub Issue 中。",
"rep.privacy": "上传前请注意检查并移除日志中可能包含的私有密码、Token 或其他敏感隐私信息。",
"rep.open": "在 GitHub 上打开报告",
"rep.copy": "复制报告文本",
"rep.preview": "预览报告文本",
"rep.needFields": "请先填写问题简述和发生的情况。",
"rep.githubNote": "报告内容会自动整理为英文以便开发者阅读;你填写的文字将按原样保留。",
"rep.opened": "已在浏览器中打开 GitHub。请检查内容、附上日志文件并点击“Submit new issue”。",
"rep.openedLong": "报告内容较长超出 URL 长度限制,已自动复制到剪贴板。请在已打开的 GitHub 页面中按 Ctrl+V 粘贴描述,附上文件后提交。",
"rep.copied": "已复制到剪贴板。",
// Realmlist switcher and modules page
"realm.label": "服务器列表",
"realm.other": "其他",
"realm.add": "添加服务器地址…",
"realm.addTitle": "新增 realmlist 配置",
"realm.editTitle": "编辑 realmlist 配置",
"realm.name": "名称",
"realm.nameHint": "例如 单机服 或 PTR测试服",
"realm.data": "Realmlist 地址",
"realm.dataHint": "即 realmlist.wtf 文件的内容,例如:set realmlist play.example.com。也可以直接输入域名或 IP。选择该项会将其写入游戏客户端,先前的配置会自动备份。",
"realm.switched": "游戏客户端现已切换至“{name}”。",
"realm.edit": "编辑 {name}",
"realm.delete": "删除 {name}",
"realm.confirmDelete": "是否删除 realmlist 配置“{name}”?游戏客户端将继续保留其当前的文件内容。",
"nav.modules": "扩展模块",
"q.modules": "服务器支持哪些扩展模块?",
"mod.title": "模块管理",
"mod.intro": "服务器内置的可选扩展特性。可按需开关、访问其 GitHub 页面或调整独立参数。",
"mod.restart": "更改将在世界服务器重启后生效。",
"mod.switch": "开启或关闭 {name}",
"mod.notHere": "未包含在当前服务器中",
"mod.github": "GitHub 页面",
"mod.settings": "模块设置",
"mod.default": "恢复为默认值 ({v})",
"mod.saved": "已保存(修改了 {n} 项)。",
// Modules page: nothing yet
"mod.empty": "此处暂无内容。随着后续添加,可选模块将展示在此页面。",
// Settings page: the full searchable list
"all.title": "所有服务器设置",
"all.intro": "世界服务器的全部其他已收录设置项及详细说明。其他选项卡已有的设置此处不重复罗列,但上方搜索框可全局检索。请仅修改你理解的选项:错误的配置可能导致服务器无法启动。修改前会自动保存旧配置以供随时恢复。",
"all.search": "按名称或描述搜索…",
"all.onlyChanged": "仅显示已修改",
"all.count": "正在显示 {shown} / {total} 项。使用搜索可快速缩小范围。",
"all.none": "未找到匹配的设置项。",
"all.changed": "已修改",
"all.useDefault": "恢复默认值 ({v})",
"all.save": "保存 {n} 项修改",
"all.saved": "已保存。请重启服务器使更改生效。",
"import.suggest.title": "你是否是指此文件夹?",
"import.suggest.text": "所选文件夹属于某个服务器子目录。检测到的主服务器根目录为:",
"import.suggest.use": "使用该主文件夹",
"import.notRepack": "该目录看起来是独立的 AzerothCore 原版服务器。本管理器专为 CoA Repack 架构设计(包含 Core、mysql、Scripts 和 Settings 的目录)。请使用“安装全新服务器”或导入 CoA Repack。",
"acc.delete": "删除",
"acc.deleteFor": "删除账号 {name}?",
"acc.deleteWarn": "此操作将永久删除该账号及其名下的所有角色 ({n})。该操作无法撤销;如有需要请先创建备份。",
"acc.deleteConfirm": "请输入 {name} 以确认删除",
"acc.deleteButton": "彻底删除账号",
"acc.deleted": "账号 {name} 已成功删除。",
"mod.status.early": "早期预览",
"mod.status.beta": "测试版",
"mod.status.release": "正式版",
"mod.hint.early": "实验性功能:可能变更或不稳定。",
"mod.hint.beta": "功能正常,仍在持续测试中。",
"mod.hint.release": "稳定可靠。",
"mod.legend": "模块状态",
"mod.alwaysOn": "始终启用",
"mod.settingsOf": "{name}:详细设置",
"col.title": "外观与收藏",
"col.intro": "游戏客户端的外观收集与便利功能开关。将在世界服务器重启后生效。",
"col.appearances": "解锁全部幻化外观",
"col.appearances.text": "所有装备外观从一开始就直接收录在试衣间衣橱中。",
"col.vanity": "解锁全部 Vanity 物品收藏",
"col.vanity.text": "所有 Vanity 收藏品默认对全服每个账号开放拥有。",
"col.auto": "自动收集装备外观",
"col.auto.text": "角色获得的装备会自动加入账号幻化外观库。",
"col.companions": "自动学会已拥有的坐骑与宠物",
"col.companions.text": "背包中的坐骑与宠物直接永久学会。",
"col.riding": "出生即可拥有满级骑术",
"col.riding.text": "1 级即可掌握所有级别骑术及寒冷飞行技能。",
"mod.status.soon": "即将推出",
"mod.hint.soon": "规划中:当前版本尚不可用。",
"set.tab.collections": "外观收藏",
"set.tab.all": "其他设置",
"set.searchAll": "按名称或描述搜索全部设置…",
"set.search": "搜索设置…",
"upd.current": "当前已是最新版本 ({v})。",
"client.job.checking": "正在检查游戏客户端…",
"client.job.updating": "正在更新游戏客户端",
"err.docker_unavailable.title": "Docker 不可用",
"err.docker_unavailable.message": "此服务器通过 Docker 运行。请安装并启动 Docker,确保当前用户有权使用它,然后重试。",
} as const;
export default zh;
+601
View File
@@ -0,0 +1,601 @@
{
"categories": {
"bots.general": "常规",
"bots.population": "人口与数量",
"bots.login": "登录",
"bots.roles": "职责分配",
"bots.openworld": "野外世界",
"bots.quests": "任务系统",
"bots.combat": "战斗",
"bots.dungeon": "地下城",
"bots.battlegrounds": "战场",
"bots.social": "社交与互助",
"bots.advanced": "高级设置",
"server.gameplay": "游戏玩法",
"server.rates": "倍率",
"server.characters": "角色",
"server.world": "游戏世界",
"server.network": "网络",
"server.accounts": "账号",
"server.logging": "日志",
"server.performance": "性能",
"server.advanced": "高级设置"
},
"units": {
"ms": "毫秒",
"%": "%",
"yards": "码",
"levels": "级",
"x": "倍",
"min": "分钟",
"copper": "铜币"
},
"settings": {
"CoaBots.RandomSpawn.DefaultCount": {
"t": "单次生成命令创建数量",
"d": "当生成命令未指定数量时,默认创建的机器人数量。"
},
"CoaBots.RandomSpawn.MaxCount": {
"t": "单次最大生成上限",
"d": "单次生成命令的安全上限。批量创建过多可能导致服务器短暂卡顿,建议仅在无其他玩家在线时调高。"
},
"CoaBots.LeveledSpawn.Brackets": {
"t": "新机器人等级分布",
"d": "新生成机器人的等级分布区间与权重(例如 1-20:40 表示等级 1 到 20 占比 40)。"
},
"CoaBots.RandomSpawn.AutoLogin": {
"t": "新机器人立即上线",
"d": "新创建的机器人立即登录游戏,而不是留在数据库中等待。"
},
"CoaBots.RandomSpawn.AccountPrefix": {
"t": "机器人账号前缀",
"d": "机器人所使用的账号名称前缀。修改此项会导致现有机器人无法自动登录。"
},
"CoaBots.RandomSpawn.BatchSize": {
"t": "每批次生成数量",
"d": "将创建过程分批分散进行以保证服务器流畅。数值越大越快,但可能引起卡顿。"
},
"CoaBots.RandomSpawn.BatchIntervalMs": {
"t": "批次生成间隔",
"d": "每次批量生成之间的间隔时间。数值越小生成越快,但可能引起卡顿。"
},
"CoaBots.AutoLoginOnStartup": {
"t": "开机自动登录机器人",
"d": "服务器每次启动时,现有的机器人自动登录上线。"
},
"CoaBots.AutoLogin.MaxCount": {
"t": "最大在线机器人数量",
"d": "服务器启动时自动登录的机器人上限数量。"
},
"CoaBots.AutoLogin.BatchSize": {
"t": "每批次登录数量",
"d": "将登录分散进行。数值越高上线越快,但对服务器负载更大。"
},
"CoaBots.AutoLogin.BatchIntervalMs": {
"t": "批次登录间隔",
"d": "每次批量登录之间的间隔时间。"
},
"CoaBots.SpecBalance.TankTargetPct": {
"t": "坦克职业目标比例",
"d": "机器人中坦克专精的目标占比百分比。"
},
"CoaBots.SpecBalance.HealerTargetPct": {
"t": "治疗职业目标比例",
"d": "机器人中治疗专精的目标占比百分比。"
},
"CoaBots.TalentBuildsPath": {
"t": "天赋数据文件路径",
"d": "社区天赋方案配置文件的保存路径。留空则使用内置搜索。"
},
"CoaBots.World.Enable": {
"t": "野外差事与漫游",
"d": "允许机器人在野外世界中游荡、采集、钓鱼与刷怪。"
},
"CoaBots.World.ThinkIntervalMs": {
"t": "差事决策间隔",
"d": "每个机器人重新评估其当前差事的时间间隔。"
},
"CoaBots.World.IdleBeforeErrandMs": {
"t": "开始差事前发呆时间",
"d": "机器人在无所事事多久后会开始新的差事活动。"
},
"CoaBots.World.AreaRadius": {
"t": "差事搜索区域半径",
"d": "机器人寻找采集或刷怪地点的最大范围。"
},
"CoaBots.World.ServiceRadius": {
"t": "城镇设施搜索半径",
"d": "机器人寻找商人、修理工和邮箱的最大距离。"
},
"CoaBots.World.VerboseLog": {
"t": "详细差事日志",
"d": "将差事的每一步都记录到日志中。适用于调试,机器人较多时会产生大量日志。"
},
"CoaBots.Grind.SearchRadius": {
"t": "刷怪搜索半径",
"d": "机器人寻找野怪进行刷怪升级的范围半径。"
},
"CoaBots.Grind.MaxLevelAbove": {
"t": "刷怪最高超出自身等级",
"d": "机器人在野外刷怪时愿意挑战高于自身多少级的怪物。"
},
"CoaBots.Profile.IntentMinMs": {
"t": "意图持续最短时间",
"d": "机器人保持从事同一种活动的最短持续时间。"
},
"CoaBots.Profile.IntentMaxMs": {
"t": "意图持续最长时间",
"d": "机器人保持从事同一种活动的最长持续时间。"
},
"CoaBots.WorldBrain.Enable": {
"t": "自主任务AI",
"d": "机器人会自主接取并完成任务。关闭时机器人只会采集、钓鱼、刷怪和游荡。"
},
"CoaBots.WorldBrain.MaxActiveQuests": {
"t": "最大同时进行任务数",
"d": "单个机器人任务日志中同时拥有的最大任务数量。"
},
"CoaBots.WorldBrain.AcceptEliteQuests": {
"t": "单人接取精英任务",
"d": "单人机器人是否接取精英任务。默认关闭,因为通常无法单人完成。"
},
"CoaBots.WorldBrain.QuestLevelBelow": {
"t": "接取低于自身等级任务",
"d": "机器人仍愿意接取低于自身多少级的低级任务。"
},
"CoaBots.WorldBrain.QuestLevelAbove": {
"t": "接取高于自身等级任务",
"d": "机器人愿意接取高于自身多少级的高级任务。"
},
"CoaBots.WorldBrain.MaxMobLevelAbove": {
"t": "任务怪最高超出等级",
"d": "任务目标怪物允许超出机器人自身等级的上限。"
},
"CoaBots.WorldBrain.MaxObjectiveDistance": {
"t": "任务目标最远距离",
"d": "目标地点超过此距离的任务将不会被接取。"
},
"CoaBots.WorldBrain.GiverSearchRadius": {
"t": "任务发布者搜索半径",
"d": "机器人寻找可接任务 NPC 的搜索范围。"
},
"CoaBots.WorldBrain.SearchRadius": {
"t": "任务目标搜索半径",
"d": "机器人在目标区域内寻找任务怪或任务道具的扫描范围。"
},
"CoaBots.WorldBrain.EngageRange": {
"t": "开战交战距离",
"d": "机器人发现任务目标怪并开始主动进入战斗的距离。"
},
"CoaBots.WorldBrain.ApproachTimeoutMs": {
"t": "接近目标超时时间",
"d": "机器人向已选定目标移动的最长允许时间。"
},
"CoaBots.WorldBrain.SearchTimeoutMs": {
"t": "区域搜索超时时间",
"d": "机器人在空无一物的区域中搜索多久后会尝试寻找下一个地点。"
},
"CoaBots.WorldBrain.TravelTimeoutMs": {
"t": "路途总时长上限",
"d": "前往某区域的整个行程允许花费的最长时间。"
},
"CoaBots.WorldBrain.MaxBadAreasPerObjective": {
"t": "每个目标放弃前尝试区域数",
"d": "机器人经历多少个无果区域后彻底搁置该任务。"
},
"CoaBots.WorldBrain.QuestSuspendMs": {
"t": "任务短期搁置时长",
"d": "机器人暂时放弃某个卡住的任务后,将其搁置的时长。"
},
"CoaBots.WorldBrain.QuestSuspendMaxMs": {
"t": "任务长期搁置最长时间",
"d": "任务在反复失败后被搁置的最长封存时间。"
},
"CoaBots.WorldBrain.GatherDetours": {
"t": "路过顺手采集草药矿石",
"d": "具备采集技能的机器人在行进路线附近发现资源点时会顺道采集。"
},
"CoaBots.WorldBrain.SessionBreaks": {
"t": "像玩家一样休息发呆",
"d": "机器人在做任务之余会回城闲逛几分钟,模拟真实玩家的行为习惯。"
},
"CoaBots.WorldBrain.MountDistanceMin": {
"t": "骑乘最小距离",
"d": "旅途距离超过此值与最大值之间的随机距离时,机器人会召唤坐骑。"
},
"CoaBots.WorldBrain.MountDistanceMax": {
"t": "骑乘最大距离",
"d": "旅途距离超过此数值时,机器人必定会召唤坐骑。"
},
"CoaBots.WorldBrain.TaxiMinDistance": {
"t": "公共飞行路线起用距离",
"d": "超过此距离且已探索过航线的长途旅行将乘坐公共飞行管理员。"
},
"CoaBots.WorldBrain.TemporaryParties": {
"t": "临时组队做任务",
"d": "相同等级且在做同一个任务的机器人会临时组成队伍互相协助。"
},
"CoaBots.WorldBrain.PartyMaxSize": {
"t": "临时队伍最大人数",
"d": "临时任务小队允许容纳的最大成员数量。"
},
"CoaBots.WorldBrain.PartyRadius": {
"t": "组队判定范围",
"d": "机器人相距多近时会互相邀请临时组队。"
},
"CoaBots.WorldBrain.PartyMinMinutes": {
"t": "临时组队最短时长",
"d": "临时队伍的最短维持时间。"
},
"CoaBots.WorldBrain.PartyMaxMinutes": {
"t": "临时组队最长时长",
"d": "临时队伍的最长维持时间。"
},
"CoaBots.WorldBrain.HelpOthers": {
"t": "路过协助陷入苦战的玩家",
"d": "路过的同阵营机器人会主动协助处于危险中的玩家,且不抢夺掉落和经验。"
},
"CoaBots.WorldBrain.HelpRadius": {
"t": "求助援助范围",
"d": "机器人相距战斗多近时会加入战局协助。"
},
"CoaBots.WorldBrain.HelpHealthPct": {
"t": "提供援助生命值阈值",
"d": "当正在战斗的玩家生命值低于此百分比时机器人会介入援助。"
},
"CoaBots.WorldBrain.ResurrectOthers": {
"t": "复活阵亡玩家",
"d": "拥有复活法术的机器人会为附近的友方玩家尸体施放复活术。"
},
"CoaBots.WorldBrain.PlannerMinMs": {
"t": "决策规划最小间隔",
"d": "机器人规划下一次行动的最短间隔时间。"
},
"CoaBots.WorldBrain.PlannerMaxMs": {
"t": "决策规划最大间隔",
"d": "机器人规划下一次行动的最长间隔时间。"
},
"CoaBots.WorldBrain.ScanMinMs": {
"t": "扫描目标最小间隔",
"d": "在目标区域内扫描怪物与物体的最短时间间隔。"
},
"CoaBots.WorldBrain.ScanMaxMs": {
"t": "扫描目标最大间隔",
"d": "在目标区域内扫描怪物与物体的最长时间间隔。"
},
"CoaBots.WorldBrain.Weight.TravelPer100Yards": {
"t": "权重偏好:每100码路程惩罚",
"d": "机器人在评估下一步行动时代价权重的考量系数。仅在熟悉AI规划器时修改。"
},
"CoaBots.WorldBrain.Weight.CrowdPerBot": {
"t": "权重偏好:同区域拥挤度惩罚",
"d": "机器人在评估下一步行动时代价权重的考量系数。仅在熟悉AI规划器时修改。"
},
"CoaBots.WorldBrain.Weight.AreaOccupancy": {
"t": "权重偏好:区域占用惩罚",
"d": "机器人在评估下一步行动时代价权重的考量系数。仅在熟悉AI规划器时修改。"
},
"CoaBots.WorldBrain.Weight.Accept": {
"t": "权重偏好:接取任务偏好",
"d": "机器人在评估下一步行动时代价权重的考量系数。仅在熟悉AI规划器时修改。"
},
"CoaBots.WorldBrain.Weight.TurnIn": {
"t": "权重偏好:交付任务偏好",
"d": "机器人在评估下一步行动时代价权重的考量系数。仅在熟悉AI规划器时修改。"
},
"CoaBots.WorldBrain.Weight.Overlap": {
"t": "权重偏好:同路线任务重叠奖励",
"d": "机器人在评估下一步行动时代价权重的考量系数。仅在熟悉AI规划器时修改。"
},
"CoaBots.WorldBrain.Weight.TargetReserved": {
"t": "权重偏好:目标已被他人锁定惩罚",
"d": "机器人在评估下一步行动时代价权重的考量系数。仅在熟悉AI规划器时修改。"
},
"CoaBots.LfgFill.Enable": {
"t": "地下城查找器机器人补位",
"d": "当单人排随机地下城时,机器人会自动补齐缺少的坦克、治疗和输出角色。"
},
"CoaBots.AutoQueueDungeon.Enable": {
"t": "机器人自主排地下城",
"d": "实验性功能:空闲的坦克机器人会自主报名排地下城,并由上述补位机制补齐队伍。"
},
"CoaBots.BGFill.Enable": {
"t": "战场机器人自动补位",
"d": "当有玩家排战场时,双方阵营会自动填充机器人以便迅速开赛。"
},
"CoaBots.BGFill.TargetPlayersPerTeam": {
"t": "战场每队目标人数",
"d": "每支队伍自动补齐到的人数。0 表示补满该战场的标准人数。"
},
"CoaBots.Healer.CriticalHealPct": {
"t": "紧急强效治疗生命阈值",
"d": "当队友生命值低于此百分比时,治疗职业会切换至最强救急技能。"
},
"CoaBots.Combat.VerboseLog": {
"t": "详细战斗决策日志",
"d": "将战斗中的技能决策写入日志。内容非常庞大,建议仅在排查特定问题时开启。"
},
"Rate.XP.Kill": {
"t": "击杀怪物经验倍率",
"d": "击杀怪物所获得经验值的乘数倍率。默认为 1。"
},
"Rate.XP.Quest": {
"t": "完成任务经验倍率",
"d": "完成任务所获得经验值的乘数倍率。"
},
"Rate.XP.Quest.DF": {
"t": "日常与随机地下城任务经验倍率",
"d": "完成地下城查找器奖励及日常任务所获得经验值的乘数倍率。"
},
"Rate.XP.Explore": {
"t": "探索地图经验倍率",
"d": "发现新区域探索地图时获得经验值的乘数倍率。"
},
"Rate.Drop.Item.Normal": {
"t": "普通物品掉落率",
"d": "白色普通品质物品掉落几率的乘数倍率。"
},
"Rate.Drop.Money": {
"t": "金币掉落倍率",
"d": "怪物掉落金币数量的乘数倍率。"
},
"Rate.Honor": {
"t": "荣誉点数获取倍率",
"d": "通过PvP获得的荣誉点数乘数倍率。"
},
"Rate.Reputation.Gain": {
"t": "声望获取倍率",
"d": "所获阵营声望的乘数倍率。"
},
"Rate.Rest.InGame": {
"t": "在线双倍经验消耗速度",
"d": "游戏在线时消耗双倍休息充分经验的速度。"
},
"Rate.Creature.Normal.Damage": {
"t": "普通怪物伤害倍率",
"d": "普通怪物造成的伤害乘数。大幅改变游戏战斗难度。"
},
"Rate.Creature.Normal.HP": {
"t": "普通怪物生命值倍率",
"d": "普通怪物的生命值上限乘数。大幅改变游戏战斗难度。"
},
"PlayerLimit": {
"t": "最大同时在线玩家数",
"d": "服务器允许同时在线的最大玩家数量。设为 0 表示无限制。"
},
"GameType": {
"t": "服务器类型",
"d": "在服务器列表(Realm List)中显示的类型标识。"
},
"RealmZone": {
"t": "服务器区域语言分组",
"d": "向客户端展示的语言/地理区域代码。"
},
"PlayerSaveInterval": {
"t": "角色数据自动保存间隔",
"d": "在线玩家角色数据写入数据库的时间间隔。"
},
"CharactersPerAccount": {
"t": "每个账号最大角色数",
"d": "单个账号在所有服务器可创建的角色总数上限。"
},
"CharactersPerRealm": {
"t": "单个服务器最大角色数",
"d": "单个账号在此服务器上允许创建的角色数量上限。"
},
"StartPlayerLevel": {
"t": "新角色初始等级",
"d": "新创建的角色出生时的初始等级。"
},
"StartPlayerMoney": {
"t": "新角色初始金币",
"d": "新角色出生时背包携带的铜币数(10000 铜币 = 1 金币)。"
},
"MaxPlayerLevel": {
"t": "最高等级上限",
"d": "角色能够达到的最高等级。游戏客户端原生最高支持 80 级。"
},
"SkipCinematics": {
"t": "跳过开场动画",
"d": "新创建的角色是否跳过开场过场动画。"
},
"DurabilityLoss.OnDeath": {
"t": "死亡耐久度损失比例",
"d": "角色死亡时装备耐久度损失的百分比。"
},
"Death.SicknessLevel": {
"t": "最高复活虚弱等级",
"d": "高于此等级的角色在天使处复活会获得复活虚弱。设置为 -10 则彻底关闭。"
},
"LeaveGroupOnLogout.Enabled": {
"t": "下线自动退组",
"d": "玩家退出游戏注销登录时自动移出当前队伍。"
},
"GM.LoginState": {
"t": "GM登录默认状态",
"d": "游戏管理员登录时是否默认开启 GM 模式。"
},
"AllowTwoSide.Accounts": {
"t": "同账号双阵营创建",
"d": "允许同一个账号下同时创建联盟和部落角色。"
},
"AllowTwoSide.Interaction.Chat": {
"t": "跨阵营聊天",
"d": "允许联盟与部落玩家在公共频道互相交流发言。"
},
"AutoBroadcast.On": {
"t": "定时系统全服广播",
"d": "按固定时间间隔循环广播数据库中配置的系统公告信息。"
},
"AutoBroadcast.Timer": {
"t": "系统广播间隔时间",
"d": "两次自动广播消息之间的时间间隔。"
},
"Warden.Enabled": {
"t": "反作弊系统 (Warden)",
"d": "启用客户端反作弊检测机制。在局域网/单人私服上通常可保持关闭。"
},
"MapUpdateInterval": {
"t": "地图循环更新间隔",
"d": "世界服务器更新地图周期的间隔。越低越平滑但消耗更多CPU。"
},
"MapUpdate.Threads": {
"t": "地图处理CPU核心数",
"d": "用于处理世界地图更新的CPU核心线程数。多张地图活动时调高可大幅提升性能。世界服务器重启后生效。"
},
"MinWorldUpdateTime": {
"t": "最小世界更新时间",
"d": "世界循环之间的最短更新时间。调高可降低CPU占用率。"
},
"ThreadPool": {
"t": "后台工作线程数",
"d": "后台工作线程池大小。人口较多时增加此值有助于提高并发吞吐。"
},
"Network.Threads": {
"t": "网络IO线程数",
"d": "处理网络连接的线程数。小规模私服通常设置为 1 即可。"
},
"Ra.Enable": {
"t": "远程控制台 (RA)",
"d": "允许管理器和自动化脚本向服务器发送控制台指令。仅监听本地回环地址即可。"
},
"Ra.IP": {
"t": "远程控制台监听地址",
"d": "远程控制台绑定的IP地址。请保持 127.0.0.1 以防止来自外网的未授权访问。"
},
"Updates.EnableDatabases": {
"t": "启动时自动执行数据库升级",
"d": "允许服务器在启动时自行更改数据库。请保持 0:管理器会安全跟踪并执行数据库迁移。"
},
"Rate.Drop.Item.Uncommon": {
"t": "优秀(绿色)物品掉落率",
"d": "优秀品质(绿色装备)掉落频率的乘数倍率。"
},
"Rate.Drop.Item.Rare": {
"t": "精良(蓝色)物品掉落率",
"d": "精良品质(蓝色装备)掉落频率的乘数倍率。"
},
"Rate.Drop.Item.Epic": {
"t": "史诗(紫色)物品掉落率",
"d": "史诗品质(紫色装备)掉落频率的乘数倍率。"
},
"Rate.Drop.Item.Legendary": {
"t": "传说(橙色)物品掉落率",
"d": "传说品质(橙色装备)掉落频率的乘数倍率。"
},
"Rate.Talent": {
"t": "每级天赋点数倍率",
"d": "角色每升一级所获得天赋点数的乘数倍率。"
},
"Rate.Skill.Discovery": {
"t": "专业配方领悟几率",
"d": "制造物品时领悟新配方的几率乘数倍率。"
},
"Rate.RepairCost": {
"t": "装备修理费用倍率",
"d": "修理装备费用的乘数。设置为 0 则免费修理。"
},
"Rate.Auction.Cut": {
"t": "拍卖行手续费抽成比例",
"d": "拍卖行完成交易所扣除的手续费抽成乘数。设置为 0 则不抽成。"
},
"Rate.ArenaPoints": {
"t": "竞技场点数获取倍率",
"d": "所获竞技场点数的乘数倍率。"
},
"Rate.XP.Pet": {
"t": "猎人宠物经验倍率",
"d": "猎人宠物获得经验值的乘数倍率。"
},
"Instance.IgnoreLevel": {
"t": "无视地下城等级要求",
"d": "允许任何等级的角色进入地下城和团队副本。"
},
"Instance.IgnoreRaid": {
"t": "无团队队伍进入团本",
"d": "玩家无需身处团队队伍中即可进入团队副本。"
},
"Instance.ResetTimeHour": {
"t": "副本进度重置时间点",
"d": "地下城与团队副本进度重置的小时(0-23点)。"
},
"MaxPrimaryTradeSkill": {
"t": "角色主专业技能上限",
"d": "单个角色允许学习的主要专业(例如锻造、草药学)数量上限。"
},
"AlwaysMaxSkillForLevel": {
"t": "武器技能自动升满",
"d": "武器及其他熟练度技能自动保持在当前角色等级上限,无需反复练习。"
},
"ActivateWeather": {
"t": "天气系统",
"d": "开启或关闭降雨、降雪以及风暴等动态天气效果。"
},
"Group.Raid.LevelRestriction": {
"t": "团队副本邀请最低等级",
"d": "低于此等级的角色无法被邀请加入团队队伍。"
},
"AllowTwoSide.Interaction.Group": {
"t": "跨阵营组队",
"d": "允许联盟和部落玩家共同组成队伍。"
},
"AllowTwoSide.Interaction.Guild": {
"t": "跨阵营公会",
"d": "允许联盟和部落玩家加入同一个公会。"
},
"AllowTwoSide.Interaction.Auction": {
"t": "全阵营共享拍卖行",
"d": "联盟和部落玩家共享同一拍卖行市场。"
},
"Achievement.RealmFirstBlockBots": {
"t": "禁止机器人获取“服务器第一”成就",
"d": "随从(机器人)无法获得“服务器第一!”成就,绝不抢占真实玩家的第一名荣誉。需要 2026-10-02 或更新的服务器核心版本。"
}
},
"options": {
"GameType.0": "普通",
"GameType.1": "PvP",
"GameType.6": "角色扮演 (RP)",
"GameType.8": "角色扮演 + PvP (RP-PvP)",
"SkipCinematics.0": "全部播放",
"SkipCinematics.1": "仅跳过非首个角色",
"SkipCinematics.2": "全部跳过",
"GM.LoginState.0": "关闭",
"GM.LoginState.1": "开启",
"GM.LoginState.2": "保持上次状态"
},
"presets": {
"balanced": {
"t": "均衡模式",
"d": "推荐的日常设置:任务、地下城补位、战场补位均开启,日志安静。"
},
"solo-friendly": {
"t": "单人友好",
"d": "机器人会协助你并补齐你的队伍,世界人口较少且稳定。"
},
"living-world": {
"t": "生机世界",
"d": "更热闹的世界:更多机器人、休息漫步、采集资源并偶尔组队。"
},
"performance": {
"t": "性能优先",
"d": "更少的机器人以及更低的运算消耗——适合配置较低的电脑。"
},
"vanilla": {
"t": "标准倍率",
"d": "所有内容均保持标准速度 (1倍)。"
},
"relaxed": {
"t": "休闲惬意",
"d": "升级更快,掉落更多,适合轻松体验游戏 (2倍 / 3倍)。"
},
"fast": {
"t": "快速体验",
"d": "极快的成长进度,适合测试或短时间游玩 (5倍)。"
},
"defaults": {
"t": "推荐默认值",
"d": "所有设置恢复为默认值。"
}
}
}
+7
View File
@@ -50,6 +50,9 @@ export interface StatusView {
path_exists: boolean;
}
export type RealmMode = "coa" | "wildcard";
export interface RealmProfiles { active: RealmMode; wildcard_created: boolean; supported: boolean; recovery_pending: boolean }
export interface Human {
code: string;
title: string;
@@ -149,6 +152,7 @@ export interface SaveReport {
export type BackupKind = "quick" | "full" | "config" | "database";
export interface RecoveryPoint {
realm?: RealmMode;
schema: number;
id: string;
kind: BackupKind;
@@ -193,6 +197,7 @@ export interface ModuleView {
page: string | null;
/** not shown on the Modules page */
hidden: boolean;
compatibility?: "compatible" | "experimental" | "unsupported";
}
export interface ModuleSetting {
@@ -361,6 +366,8 @@ export interface ConsoleLine {
}
export const api = {
realmProfiles: (id: string) => invoke<RealmProfiles>("realm_profiles", { id }),
realmSelect: (id: string, mode: RealmMode, restart: boolean) => invoke<RealmProfiles>("realm_select", { id, mode, restart }),
defaultInstallDir: () => invoke<string>("default_install_dir"),
scan: (path: string) => invoke<ScanReport>("scan_server", { path }),
add: (path: string) => invoke<ServerSummary>("add_server", { path }),
+114
View File
@@ -0,0 +1,114 @@
import { useSyncExternalStore } from "react";
import { listen } from "@tauri-apps/api/event";
import { api, asUiError, type ClientPlan, type ClientStep, type UiError } from "@/lib/api";
import { checkClient } from "@/lib/clientUpdate";
/**
* Updating the game client from the main screen, without a window over everything: the "Update client" button turns into
* a progress bar (as in a game launcher). Only a choice that needs the owner's word (files they changed) is shown, in
* place, below the buttons. The first-time linking of a client keeps its dialog (ClientDialog).
*/
export type ClientJobPhase = "idle" | "scanning" | "choose" | "working" | "done" | "current" | "stopped" | "failed";
export interface ClientJob {
phase: ClientJobPhase;
step: ClientStep | null;
plan: ClientPlan | null;
error: UiError | null;
}
const IDLE: ClientJob = { phase: "idle", step: null, plan: null, error: null };
const jobs = new Map<string, ClientJob>();
const listeners = new Set<() => void>();
const cancelled = new Set<string>();
const get = (id: string) => jobs.get(id) ?? IDLE;
function set(id: string, next: Partial<ClientJob>) {
jobs.set(id, { ...get(id), ...next });
listeners.forEach((l) => l());
}
let unlisten: (() => void) | null = null;
async function followProgress(id: string) {
if (unlisten) return;
try {
unlisten = await listen<ClientStep>("client-progress", (e) => {
const phase = get(id).phase;
if (phase === "scanning" || phase === "working") set(id, { step: e.payload });
});
} catch {
/* no event bridge (a plain browser): the bar just stays at zero */
}
}
function fail(id: string, e: unknown) {
if (cancelled.has(id)) set(id, { phase: "stopped", step: null });
else set(id, { phase: "failed", step: null, error: asUiError(e) });
}
async function refresh(id: string) {
await checkClient(id);
}
/** Look at what differs from the published client; update at once when nothing needs a decision. */
export async function startClientUpdate(id: string): Promise<void> {
const now = get(id).phase;
if (now === "scanning" || now === "working") return;
cancelled.delete(id);
set(id, { phase: "scanning", step: null, plan: null, error: null });
void followProgress(id);
try {
const plan = await api.clientPlan(id);
if (plan.items.length === 0) {
set(id, { phase: "current", plan, step: null });
void refresh(id);
setTimeout(() => {
if (get(id).phase === "current") set(id, { phase: "idle" });
}, 5000);
return;
}
if (plan.items.some((i) => i.kind === "modified")) {
set(id, { phase: "choose", plan, step: null });
return;
}
await syncClient(id, true);
} catch (e) {
fail(id, e);
}
}
/** Download what is missing or changed; `keepModified` keeps the files the owner changed. */
export async function syncClient(id: string, keepModified: boolean): Promise<void> {
cancelled.delete(id);
set(id, { phase: "working", step: null, error: null });
void followProgress(id);
try {
await api.clientSync(id, keepModified);
set(id, { phase: "done", step: null });
void refresh(id);
setTimeout(() => {
if (get(id).phase === "done") set(id, { phase: "idle" });
}, 6000);
} catch (e) {
fail(id, e);
}
}
export function stopClientJob(id: string) {
cancelled.add(id);
void api.clientCancel().catch(() => undefined);
}
export function dismissClientJob(id: string) {
set(id, { phase: "idle", error: null, plan: null, step: null });
}
export function useClientJob(id: string): ClientJob {
return useSyncExternalStore(
(l) => {
listeners.add(l);
return () => listeners.delete(l);
},
() => get(id),
);
}
+1 -1
View File
@@ -60,4 +60,4 @@ export function issueUrl(title: string, body: string): string {
}
/** Links longer than this are not reliable in every browser; the full text is then copied to the clipboard instead. */
export const MAX_LINK = 6500;
export const MAX_LINK = 2000;
+6 -2
View File
@@ -33,7 +33,11 @@ export function BackupsPage({ serverId }: { serverId: string }) {
const human = useHuman();
const w = (iso: string) => when(iso, t, locale);
const trigger = (x: string) => (TRIGGER_KEYS.includes(x) ? t(`bk.trigger.${x}` as Key) : x);
const dbLabel = (x: string) => (DB_KEYS.includes(x) ? t(`bk.db.${x}` as Key) : x);
const dbLabel = (x: string) => {
const [realm, kind] = x.split("-");
if (kind && DB_KEYS.includes(kind)) return `${realm === "coa" ? "CoA" : "Wildcard"} · ${t(`bk.db.${kind}` as Key)}`;
return DB_KEYS.includes(x) ? t(`bk.db.${x}` as Key) : x;
};
const [points, setPoints] = useState<RecoveryPoint[] | null>(null);
const [busy, setBusy] = useState<string | null>(null);
const [step, setStep] = useState<string | null>(null);
@@ -174,7 +178,7 @@ export function BackupsPage({ serverId }: { serverId: string }) {
<div>
<p className="font-medium">{p.label && p.trigger === "manual" && p.label !== "e2e" ? p.label : trigger(p.trigger)}</p>
<p className="text-sm text-muted">
{w(p.created_at)} · {t(`bk.kind.${p.kind}` as Key)} · {size(p.components.reduce((a, c) => a + c.bytes, 0))}
{w(p.created_at)} · {p.realm === "wildcard" ? "Wildcard" : "CoA"} · {t(`bk.kind.${p.kind}` as Key)} · {size(p.components.reduce((a, c) => a + c.bytes, 0))}
</p>
</div>
<div className="flex shrink-0 gap-1">
+6 -4
View File
@@ -125,15 +125,17 @@ export function ModulesPage({ serverId, onChanged }: { serverId: string; onChang
{modules?.length === 0 && <Card className="p-6 text-center text-muted sm:col-span-2">{t("mod.empty")}</Card>}
{modules?.map((m, i) => (
<Fragment key={m.id}>
<Card className={cn("flex flex-col gap-4 p-5 transition-colors", !m.installed && "opacity-60", open === m.id && "border-gold/50")} aria-label={m.status === "soon" ? `${m.name}: ${t("mod.status.soon")}` : undefined}>
<Card className={cn("flex flex-col gap-4 p-5 transition-colors", (!m.installed || m.status === "soon") && "opacity-60", open === m.id && "border-gold/50")} aria-label={m.status === "soon" ? `${m.name}: ${t("mod.status.soon")}` : undefined}>
<div className="flex items-start gap-4">
<Tile icon={m.icon} off={!m.enabled || !m.installed} />
<Tile icon={m.icon} off={!m.enabled || !m.installed || m.status === "soon"} />
<div className="min-w-0 flex-1">
<div className="flex flex-wrap items-center gap-x-2 gap-y-1">
<h2 className="font-semibold leading-tight">{m.name}</h2>
<StatusBadge status={m.status} />
</div>
<p className="mt-1.5 line-clamp-2 text-sm text-muted">{m.description[locale] ?? m.description.en}</p>
{m.compatibility === "unsupported" && <p className="mt-2 text-xs text-warn">{t("realm.unsupported")}</p>}
{m.compatibility === "experimental" && <p className="mt-2 text-xs text-warn">{t("realm.experimental")}</p>}
</div>
{m.installed && m.switchable && (
<button
@@ -146,7 +148,7 @@ export function ModulesPage({ serverId, onChanged }: { serverId: string; onChang
<span className={cn("absolute top-0.5 h-5 w-5 rounded-full bg-white transition-all", m.enabled ? "left-[22px]" : "left-0.5")} />
</button>
)}
{m.installed && !m.switchable && <span className="mt-1.5 shrink-0 text-xs text-muted">{t("mod.alwaysOn")}</span>}
{m.installed && !m.switchable && m.status !== "soon" && m.compatibility !== "unsupported" && <span className="mt-1.5 shrink-0 text-xs text-muted">{t("mod.alwaysOn")}</span>}
{!m.installed && m.status !== "soon" && <span className="mt-1.5 shrink-0 text-xs text-muted">{t("mod.notHere")}</span>}
</div>
<div className="mt-auto flex items-center gap-2">
@@ -158,7 +160,7 @@ export function ModulesPage({ serverId, onChanged }: { serverId: string; onChang
>
<GithubMark className="h-4 w-4" />
</button>
{m.installed && (
{m.installed && m.status !== "soon" && m.compatibility !== "unsupported" && (
<Button size="sm" variant="ghost" aria-expanded={open === m.id} onClick={() => setOpen(open === m.id ? null : m.id)}>
<Settings2 className="h-3.5 w-3.5" aria-hidden /> {t("mod.settings")}
</Button>
+74 -7
View File
@@ -1,12 +1,14 @@
import { dismissClientJob, startClientUpdate, stopClientJob, syncClient, useClientJob } from "@/lib/clientJob";
import { useCallback, useEffect, useRef, useState } from "react";
import { Loader2 } from "lucide-react";
import { Loader2, X } from "lucide-react";
import { api, asUiError, type ClientInfo, type Human, type Performance, type Population, type ServerSummary, type ServiceStatus, type StatusView } from "@/lib/api";
import { cn, formatUptime } from "@/lib/utils";
import { cn, formatBytes, formatUptime } from "@/lib/utils";
import { useHuman, useT } from "@/i18n";
import { applyServerUpdate, useServerUpdate } from "@/lib/serverUpdate";
import { checkClient, useClientStatus } from "@/lib/clientUpdate";
import { ClientDialog, type ClientDialogMode } from "@/screens/ClientDialog";
import { RealmlistMenu } from "@/screens/RealmlistMenu";
import { RealmPicker } from "@/screens/RealmPicker";
import { Button } from "@/components/ui/button";
import { Card } from "@/components/ui/card";
@@ -62,11 +64,12 @@ function Row({ label, s }: { label: string; s: ServiceStatus }) {
);
}
export function Overview({ server, companions = true, onForget, onOpenUpdates }: { server: ServerSummary; /** the companions module is on */ companions?: boolean; onForget: () => Promise<void>; onOpenUpdates: () => void }) {
export function Overview({ server, companions = true, onForget, onOpenUpdates, onRealmChanged }: { server: ServerSummary; /** the companions module is on */ companions?: boolean; onForget: () => Promise<void>; onOpenUpdates: () => void; onRealmChanged: () => void }) {
const t = useT();
const human = useHuman();
const [status, setStatus] = useState<StatusView | null>(null);
const [action, setAction] = useState<Action>(null);
const [realmBusy, setRealmBusy] = useState(false);
const [failure, setFailure] = useState<Failure | null>(null);
const [showDetails, setShowDetails] = useState(false);
const [pop, setPop] = useState<Population | null>(null);
@@ -74,6 +77,10 @@ export function Overview({ server, companions = true, onForget, onOpenUpdates }:
const [dialog, setDialog] = useState<ClientDialogMode | null>(null);
const clientStatus = useClientStatus(server.id).status;
const [playing, setPlaying] = useState(false);
const job = useClientJob(server.id);
const jobBusy = job.phase === "scanning" || job.phase === "working";
const jobPct = job.step && job.step.total > 0 ? Math.min(100, Math.floor((job.step.done / job.step.total) * 100)) : 0;
const [keepMine, setKeepMine] = useState(true);
const [perf, setPerf] = useState<Performance | null>(null);
const upd = useServerUpdate(server.id);
const needsDecision = (upd.preview?.conflicts.length ?? 0) > 0;
@@ -91,6 +98,10 @@ export function Overview({ server, companions = true, onForget, onOpenUpdates }:
}, [server.id]);
const alive = useRef(true);
useEffect(() => {
if (job.phase === "done" || job.phase === "current") void api.clientInfo(server.id).then(setClient).catch(() => undefined);
}, [job.phase, server.id]);
const poll = useCallback(async () => {
try {
const s = await api.status(server.id);
@@ -188,10 +199,10 @@ export function Overview({ server, companions = true, onForget, onOpenUpdates }:
const all = [mysql, auth, world];
const running = all.every((s) => s.state === "running");
const anyUp = all.some((s) => s.state !== "stopped");
const transitioning = action !== null || status.busy;
const transitioning = action !== null || status.busy || realmBusy;
const conflict = all.find((s) => s.conflict)?.conflict ?? null;
const headline = transitioning
const headline = realmBusy ? t("realm.switching") : transitioning
? action === "stopping"
? t("status.stopping")
: t("status.starting")
@@ -206,6 +217,7 @@ export function Overview({ server, companions = true, onForget, onOpenUpdates }:
<div className="w-full max-w-4xl">
<h1 className="text-2xl font-semibold">{server.name}</h1>
<p className="selectable mt-0.5 text-xs text-muted">{server.path}</p>
<RealmPicker serverId={server.id} running={anyUp} disabled={transitioning || upd.applying} onBusy={setRealmBusy} onChanged={() => { onRealmChanged(); void poll(); }} />
<Card className="mt-6 p-7">
<div className="mb-1 text-xs font-medium uppercase tracking-[0.14em] text-muted">{t("overview.server")}</div>
@@ -279,8 +291,35 @@ export function Overview({ server, companions = true, onForget, onOpenUpdates }:
)}
<div className="ml-auto flex items-center gap-3">
{client && <RealmlistMenu serverId={server.id} />}
{client && clientStatus?.update_available ? (
<Button variant="primary" size="xl" disabled={playing} onClick={() => setDialog("update")} className="min-w-40">
{client && jobBusy ? (
<div
className="relative flex h-16 min-w-64 items-center overflow-hidden rounded-md border border-gold/50 bg-card-2"
role="progressbar"
aria-valuenow={jobPct}
aria-valuemin={0}
aria-valuemax={100}
aria-label={job.phase === "scanning" ? t("client.job.checking") : t("client.job.updating")}
>
<div className="absolute inset-y-0 left-0 bg-gold/35 transition-[width] duration-300" style={{ width: `${jobPct}%` }} />
<div className="relative z-10 flex min-w-0 flex-1 flex-col px-5 leading-tight">
<span className="text-sm font-semibold uppercase tracking-wide">{job.phase === "scanning" ? t("client.job.checking") : t("client.job.updating")}</span>
<span className="truncate text-xs text-muted">
{jobPct}%
{job.step && job.step.phase === "download" && job.step.bytes_per_sec > 0 ? ` · ${t("client.dl.speed", { speed: formatBytes(job.step.bytes_per_sec) })}` : ""}
</span>
</div>
<button
type="button"
onClick={() => stopClientJob(server.id)}
title={t("client.dl.cancel")}
aria-label={t("client.dl.cancel")}
className="relative z-10 flex h-full w-12 cursor-pointer items-center justify-center text-muted hover:text-ink"
>
<X className="h-4 w-4" aria-hidden />
</button>
</div>
) : client && (clientStatus?.update_available || job.phase === "choose") ? (
<Button variant="primary" size="xl" disabled={playing || job.phase === "choose"} onClick={() => void startClientUpdate(server.id)} className="min-w-40">
{t("btn.updateClient")}
</Button>
) : client ? (
@@ -298,6 +337,34 @@ export function Overview({ server, companions = true, onForget, onOpenUpdates }:
{anyUp && !running && !transitioning && (
<p className="mt-3 text-sm text-muted">{t("overview.partial")}</p>
)}
{job.phase === "choose" && job.plan && (
<div className="mt-4 rounded-md border border-warn/40 bg-warn/5 p-3 text-sm">
<p className="font-medium">{t("client.upd.modifiedTitle", { n: job.plan.items.filter((i) => i.kind === "modified").length })}</p>
<p className="mt-1 text-muted">{t("client.upd.modifiedText")}</p>
<label className="mt-3 flex cursor-pointer items-center gap-2">
<input type="checkbox" checked={keepMine} onChange={(e) => setKeepMine(e.target.checked)} className="h-4 w-4 accent-[#c9a24a]" />
<span>{t("client.upd.keep")}</span>
</label>
<div className="mt-3 flex gap-2">
<Button size="sm" variant="primary" onClick={() => void syncClient(server.id, keepMine)}>{t("client.upd.start")}</Button>
<Button size="sm" variant="ghost" onClick={() => dismissClientJob(server.id)}>{t("client.upd.later")}</Button>
</div>
</div>
)}
{job.phase === "done" && <p className="mt-3 text-sm text-ok" role="status">{t("client.upd.done")}</p>}
{job.phase === "current" && <p className="mt-3 text-sm text-ok" role="status">{t("client.upd.upToDate", { v: job.plan?.version ?? "" })}</p>}
{job.phase === "stopped" && (
<p className="mt-3 flex items-center gap-3 text-sm text-muted" role="status">
{t("client.dl.cancelled")}
<Button size="sm" variant="ghost" onClick={() => void startClientUpdate(server.id)}>{t("client.dl.resume")}</Button>
</p>
)}
{job.phase === "failed" && job.error && (
<p className="mt-3 flex flex-wrap items-center gap-3 text-sm text-bad" role="alert">
{job.error.human.code === "unknown" ? job.error.technical : human(job.error.human).message}
<Button size="sm" variant="ghost" onClick={() => void startClientUpdate(server.id)}>{t("client.dl.retry")}</Button>
</p>
)}
{upd.available && upd.preview && (
<div className="mt-4 rounded-md border border-gold/40 bg-gold/5 p-3 text-sm">
<p>{t("overview.updateAvail", { to: upd.preview.to_version, from: upd.preview.from_version ?? "?" })}</p>
+53
View File
@@ -0,0 +1,53 @@
import { useEffect, useState } from "react";
import { Layers, Loader2 } from "lucide-react";
import { api, asUiError, type RealmMode, type RealmProfiles } from "@/lib/api";
import { useT } from "@/i18n";
import { Button } from "@/components/ui/button";
import { Card } from "@/components/ui/card";
export function RealmPicker({ serverId, running, disabled, onChanged, onBusy }: {
serverId: string; running: boolean; disabled: boolean; onChanged: () => void; onBusy: (busy: boolean) => void;
}) {
const t = useT();
const [view, setView] = useState<RealmProfiles | null>(null);
const [selected, setSelected] = useState<RealmMode>("coa");
const [busy, setBusy] = useState(false);
const [error, setError] = useState<string | null>(null);
useEffect(() => {
let alive = true;
void api.realmProfiles(serverId).then(v => { if (alive) { setView(v); setSelected(v.active); } }).catch(e => { if (alive) setError(asUiError(e).technical); });
return () => { alive = false; };
}, [serverId]);
async function select() {
setBusy(true); onBusy(true); setError(null);
try { const next = await api.realmSelect(serverId, selected, running); setView(next); onChanged(); }
catch (e) {
setError(asUiError(e).technical);
// Selection may have committed even if the subsequent server restart failed.
try { setView(await api.realmProfiles(serverId)); onChanged(); } catch { /* keep the operation error */ }
}
finally { setBusy(false); onBusy(false); }
}
return <Card className="mt-5 p-5" aria-busy={busy}>
<div className="flex flex-wrap items-center gap-3">
<Layers className="h-5 w-5 text-gold" aria-hidden />
<label htmlFor="realm-profile" className="font-medium">{t("realm.profileLabel")}</label>
<select id="realm-profile" value={selected} disabled={!view || disabled || busy} onChange={e => setSelected(e.target.value as RealmMode)} className="min-w-52 rounded-md border border-line bg-card-2 px-3 py-2 text-ink">
<option value="coa">Conquest of Azeroth</option>
<option value="wildcard" disabled={!view?.supported && !view?.wildcard_created}>Wildcard · Darkmoon</option>
</select>
{view && (selected !== view.active || view.recovery_pending) && <Button size="sm" disabled={disabled || busy} onClick={() => void select()}>
{busy && <Loader2 className="h-4 w-4 animate-spin" aria-hidden />}
{busy ? t("realm.switching") : selected === "wildcard" && !view.wildcard_created ? t("realm.create") : running ? t("realm.restart") : t("realm.select")}
</Button>}
{view && <span className="ml-auto text-xs text-muted">{t("realm.active", { name: view.active === "coa" ? "CoA" : "Wildcard" })}</span>}
</div>
<p className="mt-3 text-sm text-muted">{t("realm.separate")}</p>
{selected === "wildcard" && <p className="mt-2 text-sm text-warn">{t("realm.modules")}</p>}
{view && !view.supported && <p className="mt-2 text-sm text-warn">{t("realm.update")}</p>}
{view?.recovery_pending && <p className="mt-2 text-sm text-warn">{t("realm.recovery")}</p>}
{error && <p className="mt-3 selectable text-sm text-bad" role="alert">{error}</p>}
</Card>;
}
+2 -2
View File
@@ -51,7 +51,7 @@ export function Shell(props: {
const reloadModules = useCallback(() => {
void api
.modulesList(props.activeId)
.then((list) => setHiddenPages(list.filter((m) => m.page && m.installed && m.switchable && !m.enabled).map((m) => m.page as string)))
.then((list) => setHiddenPages(list.filter((m) => m.page && (!m.installed || m.compatibility === "unsupported" || (m.switchable && !m.enabled))).map((m) => m.page as string)))
.catch(() => setHiddenPages([]));
}, [props.activeId]);
useEffect(() => {
@@ -122,7 +122,7 @@ export function Shell(props: {
<main className="h-full flex-1 overflow-y-auto px-10 py-8">
{page === "overview" ? (
<Overview key={server.id} server={server} companions={!hiddenPages.includes("bots")} onForget={() => props.onForget(server.id)} onOpenUpdates={() => setPage("settings")} />
<Overview key={server.id} server={server} companions={!hiddenPages.includes("bots")} onForget={() => props.onForget(server.id)} onOpenUpdates={() => setPage("settings")} onRealmChanged={reloadModules} />
) : page === "bots" || page === "server" ? (
<SettingsPage key={`${server.id}-${page}`} serverId={server.id} scope={page} title={t(current.label)} question={t(current.question)} />
) : page === "console" ? (
+2 -2
View File
@@ -22,7 +22,7 @@ const en = load("en");
let errors = 0;
console.log(`en: ${en.size} keys (source of truth)`);
for (const loc of ["ru", "de", "fr", "es"]) {
for (const loc of ["ru", "de", "fr", "es", "zh"]) {
const d = load(loc);
let missing = 0;
for (const [k, v] of d) {
@@ -41,7 +41,7 @@ for (const loc of ["ru", "de", "fr", "es"]) {
// Settings-schema overlays (src/i18n/schema/<locale>.json) must cover every setting, category, option and preset.
const root = join(dirname(fileURLToPath(import.meta.url)), "..");
const schemas = ["bots", "server"].map((sc) => ({ sc, d: JSON.parse(readFileSync(join(root, "schemas", `${sc}.json`), "utf8")), p: JSON.parse(readFileSync(join(root, "schemas", "presets", `${sc}.json`), "utf8")).presets }));
for (const loc of ["ru", "de", "fr", "es"]) {
for (const loc of ["ru", "de", "fr", "es", "zh"]) {
const o = JSON.parse(readFileSync(join(root, "src", "i18n", "schema", `${loc}.json`), "utf8"));
let miss = 0;
for (const { sc, d, p } of schemas) {
+4 -2
View File
@@ -3,7 +3,8 @@
param(
[string]$Source = 'C:\games\CoA-Repack',
[string]$Target = 'C:\games\coa-fixture',
[int]$PortBase = 13000
[int]$PortBase = 13000,
[string]$DatabaseArchive = ''
)
$ErrorActionPreference = 'Stop'
if ((Resolve-Path $Source).Path -eq $Target) { throw 'source and target are the same' }
@@ -27,7 +28,8 @@ foreach ($d in 'bin', 'lib', 'share') { Copy-Tree "mysql\$d" }
Copy-Item "$Source\RELEASE.json", "$Source\MANIFEST.json" $Target
# Pristine packaged database (never the live data directory).
& 'C:\Program Files\7-Zip\7z.exe' x "$Source\mysql\data.7z" "-o$Target\mysql" -y | Out-Null
if (-not $DatabaseArchive) { $DatabaseArchive = "$Source\mysql\data.7z" }
& 'C:\Program Files\7-Zip\7z.exe' x $DatabaseArchive "-o$Target\mysql" -y | Out-Null
if (-not (Test-Path "$Target\mysql\data\acore_characters")) { throw 'database extraction failed' }
New-Item -ItemType Junction -Path "$Target\Data" -Target "$Source\Data" | Out-Null
+1 -1
View File
@@ -7,6 +7,6 @@ export default defineConfig({
plugins: [react(), tailwindcss()],
resolve: { alias: { "@": fileURLToPath(new URL("./src", import.meta.url)) } },
clearScreen: false,
server: { port: 1420, strictPort: true },
server: { port: 1420, strictPort: true, watch: { ignored: ["**/target/**", "**/src-tauri/**"] } },
build: { target: "es2022", outDir: "dist" },
});