Compare commits

..
44 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
CorfireanandClaude Sonnet 5.5 53aa117ec2 fix(update): say 'up to date' when the version and files are unchanged instead of offering an update
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-02 21:32:43 +05:00
CorfireanandClaude Sonnet 5.5 cc5363b385 Release 0.4.0: modules page, one settings panel, collections, account delete, bot economy switches
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-02 20:41:25 +05:00
CorfireanandClaude Sonnet 5.5 209dbe37ac feat(ui): module settings open under their card's row; Other settings tab
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-02 17:07:39 +05:00
CorfireanandClaude Sonnet 5.5 89be57b4e4 feat(ui): one search, tabs and save bar on the Server page; no module legend
The collection switches and every other documented setting become tabs of the same
panel, are searched together with the curated settings and are saved by the same bar.
The Modules page drops the status legend; Playerbots is named SQUID's Playerbots.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-02 16:33:00 +05:00
CorfireanandClaude Sonnet 5.5 1f54fbf909 feat(modules): NPC Enchanter is a switchable early module
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-02 15:39:06 +05:00
ДмитрийandClaude Sonnet 5.5 31c08934ad Modules page: places held for Auction House Bot, NPC Enchanter and Playerbots with a Soon badge; module GitHub links from the catalog are allowed to open
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-02 15:07:25 +05:00
ДмитрийandClaude Sonnet 5.5 3b4cea7530 The companions are recognised by their .dist default file when no active config exists yet; the Bots settings page creates the active file from it
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-02 12:10:27 +05:00
ДмитрийandClaude Sonnet 5.5 b091061cc5 Appearances and collections card on the Server page; the compatibility part is no longer a card on the Modules page
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-02 11:36:42 +05:00
ДмитрийandClaude Sonnet 5.5 726b089f42 Modules page: square icon cards with status (early/beta/release), switch, GitHub and settings; companions, scaling, TBC and WotLK packs and client compatibility in the catalog; a module switched off hides its page. Accounts: delete an account with confirmation.
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-02 11:26:09 +05:00
ДмитрийandClaude Sonnet 5.5 14173d7d7e Server settings: Achievement.RealmFirstBlockBots (bots cannot take Realm First achievements)
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-02 06:21:51 +05:00
ДмитрийandClaude Sonnet 5.5 05397c4505 Import: when the chosen folder is the Core folder or an outer folder, offer the server's main folder; say clearly when it is a standalone AzerothCore server
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-02 05:31:28 +05:00
ДмитрийandClaude Sonnet 5.5 9444434734 Settings: full searchable list of every documented world-server setting (575), edited in place with a snapshot before each save
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-01 22:54:36 +05:00
ДмитрийandClaude Sonnet 5.5 8f2b585641 Server settings: 20 more curated settings (drop rates by quality, talents, repair cost, auction cut, instances, professions, cross-faction, weather) in five languages
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-01 22:50:06 +05:00
ДмитрийandClaude Sonnet 5.5 3281750104 Diagnostics: fold repeated config warnings, list config/log files, include the CoA switches
A server whose module configs lack a key logs the same warning on every tick, which filled the 512 KB log tails of a
bug report and hid the actual failure. Read 8 MB back, fold the repeats, then keep the last part.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-01 20:29:30 +05:00
ДмитрийandClaude Sonnet 5.5 d01e401f3c Layout fixes (fluid main card, password field), no emoji in reports, empty modules page; Release 0.3.1
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-01 16:30:12 +05:00
ДмитрийandClaude Sonnet 5.5 81aacdf5bb Realmlist switcher next to PLAY, and a Modules page
- Named realmlists (e.g. Solo, PTR): a drop-down by the PLAY button switches the game client by writing the chosen text into every
  locale's realmlist.wtf (the replaced file is saved first); add / edit / remove with a name and the realmlist text (or just an
  address). First use offers 'Solo' (127.0.0.1) and, if the client held another realmlist, 'Previous'.
- Modules page: bundled catalog (modules/catalog.json) of the optional modules built into the server; switch each on or off (its
  Enable setting), open its page on GitHub, edit its configuration with the module's own documentation. Nine modules to start with.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-01 16:10:45 +05:00
ДмитрийandClaude Sonnet 5.5 a79c26ed49 Report a problem: a tab that prepares a prefilled GitHub bug report
Form (summary, what happened, expected, steps) plus the Manager version, Windows version, install kind and server version filled in
automatically, a redacted diagnostics file to attach, and a button that opens GitHub's new-issue page with the standard template
(the full text goes to the clipboard when it is too long for a link). Nothing is sent from the Manager and no token is needed.
open_link accepts only this project's new-issue page for that.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-01 15:56:53 +05:00
ДмитрийandClaude Sonnet 5.5 a4c1080575 Tester suggestions: account management, install size and download volume, password show button, addon explanation
- Players page: list of the server's accounts with password change, access level (player/moderator/GM/administrator) and
  rename (a rename also sets a new password because the login verifier depends on the name; refused while logged in).
  Companion and console accounts are never listed.
- Install screen: size of the server from the signed package list (unpacked, download, peak) and the drive check uses it.
- Install progress shows downloaded / total volume and speed.
- Own show/hide button on password fields (the browser's one disappeared after leaving the field).
- Settings: one sentence on what the companion addon does.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-01 15:13:11 +05:00
ДмитрийandClaude Sonnet 5.5 2c0bb2bac3 Settings: a running server update survives leaving the tab
The update's busy flag, progress and result were local to the Settings card, so switching tabs and coming back showed 'Update now'
again while the update was still running (and the server rightly answered 'another action is still in progress'). They now live in the
shared server-update store: the card re-attaches to the running update with its progress, and shows how it ended.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-01 14:05:56 +05:00
ДмитрийandClaude Sonnet 5.5 645ffd8999 New servers and updated ones run the world on several threads: MapUpdate.Threads setting, one-time performance defaults, debug loggers lowered
- Server settings page gains 'CPU cores for the world' (MapUpdate.Threads), translated in all languages.
- On the first start of an installed server (not imports) the Manager sets it to half the logical processors (2..8) unless
  the owner already raised it, and lowers Logger.network / Logger.entities.player from debug to info; once per server.
- tools/sample_stacks.py: sampling profiler for a running worldserver (dbghelp + PDB), used to find what the world thread spends time on.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-01 13:14:41 +05:00
ДмитрийandClaude Sonnet 5.5 c8f6d61b98 Release 0.3.0
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-01 07:59:59 +05:00
ДмитрийandClaude Sonnet 5.5 2317d46bda Client updates never overwrite renderer wrappers or config files; test that nothing outside the manifest changes
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-01 07:56:40 +05:00
ДмитрийandClaude Sonnet 5.5 f1f2818525 Client setup dialog: drop the extra explanations, keep only the size
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-01 07:54:00 +05:00
ДмитрийandClaude Sonnet 5.5 615b3e938d Game client: download and update through the Manager
PLAY turns into UPDATE CLIENT when a tracked client is outdated; with no client linked
it offers choosing an existing folder or downloading from the community launcher servers
(resumable, hash-verified, free-space checked, progress and stop). Files the player changed
are kept on request or moved aside, never silently replaced. Existing clients can be adopted
from Settings. Fresh downloads get a realmlist for each installed locale.

Fixes zero-length files in the downloader (found by the live probe).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-01 07:52:58 +05:00
ДмитрийandClaude Sonnet 5.5 7d447b490f README: feature overview and screenshots
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-01 07:41:22 +05:00
ДмитрийandClaude Sonnet 5.5 0c376fdaf8 Main screen: server update check at start and every 5 minutes, UPDATE button instead of START when an update exists, progress, navigation dot; notes on client download
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-01 06:40:22 +05:00
122 changed files with 11692 additions and 219 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.2.0"
version = "0.6.0"
dependencies = [
"base64 0.22.1",
"chrono",
@@ -375,7 +519,7 @@ dependencies = [
[[package]]
name = "coa-release"
version = "0.2.0"
version = "0.6.0"
dependencies = [
"chrono",
"coa-core",
@@ -384,7 +528,7 @@ dependencies = [
[[package]]
name = "coa-server-manager"
version = "0.2.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.2.0"
version = "0.6.0"
edition = "2021"
license = "AGPL-3.0-only"
+1
View File
@@ -0,0 +1 @@
@AGENTS.md
+66 -18
View File
@@ -1,32 +1,80 @@
# CoA Server Manager
Windows desktop manager for local Conquest of Azeroth (AzerothCore) servers. Tauri 2 + Rust + React.
Design and audit: [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).
A Windows app that installs and runs your own **Conquest of Azeroth** server (AzerothCore) with a few clicks:
no console, no config files, no database tools. Tauri 2 + Rust + React.
![Overview](docs/screenshots/play.png)
## What it does
* **One-click install.** Downloads a signed, verified server package (resumable, checked file by file), sets up the
database and creates your first account. Or import a server you already have.
* **Start / Stop / PLAY.** One button for the whole server (database, auth, world) with live status, uptime and
players online. PLAY starts the game client with the right realmlist.
* **Game client.** Use the client you already have, or let the Manager download it (about 43 GB, resumable, every file
verified). A client the Manager looks after is checked for updates like the server: PLAY turns into **UPDATE CLIENT**,
and files you changed yourself are never replaced unless you say so.
* **Safe updates.** The Manager checks for a new server version on start and every five minutes; the main button turns
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
drop-down next to PLAY; the file that was replaced is saved first.
* **Accounts.** See everyone who can log in, change passwords and access levels, rename an account.
* **Modules.** A page for the server's optional modules (switch on/off, GitHub, settings); it fills up as modules are added.
* **Report a problem.** A form that prepares a ready bug report for GitHub with your versions filled in.
* **Settings without files.** Bots and Server pages with plain-language options and presets, a console to the world
server, player list with account tools.
* **Play with friends.** Checks whether your server is reachable, opens firewall rules, finds your router (UPnP),
supports LAN, direct and private-network (Tailscale) play, with step-by-step guides and a package to send to friends.
* **Updates to the Manager itself** download in the background and install when you close it. Your servers are never
stopped or changed by a Manager update.
* **Languages:** English, Russian, German, French, Spanish.
| Install | Ready |
|---------|-------|
| ![Installing](docs/screenshots/install.png) | ![Ready](docs/screenshots/ready.png) |
| Overview | Server updates |
|----------|----------------|
| ![Overview](docs/screenshots/overview.png) | ![Updates](docs/screenshots/updates.png) |
![Backups](docs/screenshots/backups.png)
## Install
Download the installer from the [Releases](https://github.com/Corfirean/coa-server-manager/releases) page
and run it. You need about 10 GB of free disk space for the server. The game client (about 43 GB) is separate: point the
Manager at the one you have, or let it download one for you.
## Status
| Phase | State |
|-------|-------|
| 0 Audit + architecture | done |
| 1 Foundation (fsx, registry, manifest, logging, error catalogue) | done |
| 2 Read-only import, process observation, Start/Stop via repack launcher, health diagnosis | done |
| 3 Config engine + Bots/Server settings UI + presets + snapshots | done |
| 4 Recovery points, DB dump/restore (staging + atomic swap), Backups UI | done |
| 5 Clean install: signed split packages, resumable verified download, staging + atomic commit, DB credential rotation, RA account creation | done |
| 6 Updates: tracked SQL migrations, update transaction (journal, conflicts, rollback), Settings > Server updates | done |
| 7 Companions: real population, hardware-aware sizes, RA spawn (install/update of the module rides on the update flow) | done |
| 8 Client: read-only detection, backed-up realmlist, isolated addon install, START & PLAY | done |
| Backlog: interface languages EN/RU/DE/FR/ES (see docs/ARCHITECTURE.md section 9) | planned |
| 9 Friends: exposure check, firewall rules, UPnP discovery, LAN/direct/private modes, friend package | done |
| 10 Polish: diagnostics, file verification, redacted diagnostic export | done; self-update installer, accessibility audit, i18n pending |
| `coa-server-build` repo: nightly build, edge/stable releases, fork sync | created; needs the COA_SIGNING_KEY / FORK_PUSH_TOKEN secrets |
Phases 0–10 of the plan in [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) are done: foundation, import, start/stop,
config engine, backups, clean install from signed packages, updates, companions, client launch, friends, polish.
Remaining work (translation review by native speakers, optional extras) is listed in section 9 of that document. Translation notes: [docs/TRANSLATIONS.md](docs/TRANSLATIONS.md).
## Develop
```
npm install
cargo test --workspace # core logic (scan, fsx, manifest, process, driver, health)
cargo test --workspace # core logic (scan, fsx, manifest, process, driver, health, updates, ...)
npx tsc --noEmit # type check
node tools/check-i18n.mjs # translation keys and placeholders
npx vite # UI in a browser uses a mock IPC (src/dev/mock.ts)
cargo build -p coa-server-manager # native app (debug build loads http://localhost:1420)
```
Layout: `crates/coa-core` (logic), `crates/coa-release` (package tools: pack, sign, verify), `src-tauri`
(command layer), `src` (UI).
Live checks against a real repack: `cargo run -p coa-core --example scan -- <folder>` (read-only).
Start/stop testing must use a disposable copy: `tools/make-fixture.ps1` builds `C:\games\coa-fixture`
on offset ports from the pristine packaged database. Never run start/stop against a server in use.
@@ -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.
+31
View File
@@ -0,0 +1,31 @@
//! Live check of the client download path against the community launcher's public server:
//! reads the manifest and downloads the few smallest files into a temp folder (never a real client).
//! Usage: cargo run -p coa-core --example client_probe (PROBE_SKIP=n skips the n smallest files)
use coa_core::clientdl::{self, Apply, Manifest};
use coa_core::download::{Cancel, HttpTransport};
fn main() {
let full = clientdl::fetch_latest().expect("manifest");
println!("version {} · {} files · {:.1} GB", full.version, full.files.len(), full.total_bytes() as f64 / 1e9);
let mut small = full.files.clone();
small.sort_by_key(|f| f.size);
let skip: usize = std::env::var("PROBE_SKIP").ok().and_then(|v| v.parse().ok()).unwrap_or(0);
let small: Vec<_> = small.into_iter().skip(skip).take(6).collect();
let manifest = Manifest { version: full.version.clone(), published_at: None, files: small };
let dir = std::env::temp_dir().join(format!("coa-client-probe-{}", std::process::id()));
std::fs::create_dir_all(&dir).unwrap();
let cancel = Cancel::default();
let plan = clientdl::plan(&dir, &manifest, &Default::default(), &cancel, &|_| {}).unwrap();
println!("plan: {} files, {} bytes", plan.items.len(), plan.download_bytes);
let transport = HttpTransport::new().unwrap();
clientdl::apply(
&Apply { client: &dir, manifest: &manifest, plan: &plan, keep_modified: false, transport: &transport, objects_url: clientdl::OBJECTS_URL, cancel: &cancel },
&|s| println!("{} {}/{} {}", s.phase, s.done, s.total, s.file.unwrap_or_default()),
)
.expect("apply");
let again = clientdl::plan(&dir, &manifest, &clientdl::load_state(&dir).unwrap(), &cancel, &|_| {}).unwrap();
println!("second plan: {} to do, {} up to date, version {:?}", again.items.len(), again.up_to_date_files, clientdl::local(&dir).version);
std::fs::remove_dir_all(&dir).unwrap();
}
+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(())
}
+146
View File
@@ -0,0 +1,146 @@
//! The accounts of the people who play on this server: listed from the login database, changed through the world
//! console (password, access level) or - for a rename - by changing the stored name and then letting the console set
//! a new password, because the login verifier is computed from the name and would no longer match.
//! The accounts the Manager and the companions use themselves are never listed.
use std::path::Path;
use serde::Serialize;
use crate::db::{Account, Db};
use crate::error::{Error, Result};
use crate::ra::{validate_account, Ra};
#[derive(Debug, Clone, Serialize, PartialEq, Eq)]
pub struct AccountInfo {
pub id: u32,
pub name: String,
/// 0 player, 1 moderator, 2 game master, 3 administrator.
pub access: u8,
pub online: bool,
pub last_login: Option<String>,
pub characters: u32,
}
const LIST_SQL: &str = "SELECT a.id, a.username, \
IFNULL((SELECT MAX(aa.gmlevel) FROM acore_auth.account_access aa WHERE aa.id = a.id), 0), \
a.online, IFNULL(a.last_login, ''), \
(SELECT COUNT(*) FROM acore_characters.characters c WHERE c.account = a.id) \
FROM acore_auth.account a \
WHERE a.username NOT LIKE 'COABOTHOST%' AND a.username <> 'COAMANAGER' ORDER BY a.id;";
/// Rows of tab-separated columns as the `mysql` client prints them.
pub fn parse_list(out: &str) -> Vec<AccountInfo> {
out.lines()
.filter_map(|line| {
let c: Vec<&str> = line.split('\t').collect();
if c.len() < 6 {
return None;
}
Some(AccountInfo {
id: c[0].trim().parse().ok()?,
name: c[1].trim().to_string(),
access: c[2].trim().parse().unwrap_or(0),
online: c[3].trim() != "0",
last_login: Some(c[4].trim().to_string()).filter(|s| !s.is_empty() && s != "NULL"),
characters: c[5].trim().parse().unwrap_or(0),
})
})
.collect()
}
pub fn list(root: &Path) -> Result<Vec<AccountInfo>> {
let db = Db::from_repack(root, Account::Admin)?;
Ok(parse_list(&db.query(LIST_SQL)?))
}
fn upper(name: &str) -> Result<String> {
validate_account(name, "placeholder")?;
Ok(name.to_ascii_uppercase())
}
/// Give the account a new name. Needs the world console (the new password is what makes the login work again) and an
/// account that is not logged in. The old name is put back if anything goes wrong.
pub fn rename(root: &Path, ra: &mut Ra, old: &str, new: &str, password: &str) -> Result<()> {
let (old, new) = (upper(old)?, upper(new)?);
validate_account(&new, password)?;
if old == new {
return Err(Error::Invalid("That is already the name of this account.".into()));
}
let db = Db::from_repack(root, Account::Admin)?;
let taken = db.query(&format!("SELECT COUNT(*) FROM acore_auth.account WHERE username = '{new}';"))?;
if taken.trim() != "0" {
return Err(Error::Invalid("That account name is already taken.".into()));
}
let changed = db.query(&format!("UPDATE acore_auth.account SET username = '{new}' WHERE username = '{old}' AND online = 0; SELECT ROW_COUNT();"))?;
if changed.trim() != "1" {
return Err(Error::Invalid("The account was not renamed: it does not exist or is logged in right now.".into()));
}
if let Err(e) = ra.set_account_password(&new, password) {
let _ = db.query(&format!("UPDATE acore_auth.account SET username = '{old}' WHERE username = '{new}';"));
return Err(e);
}
tracing::info!(%old, %new, "account renamed");
Ok(())
}
/// Accounts the Manager and the companions use themselves; they can never be deleted from here.
fn is_reserved(upper_name: &str) -> bool {
upper_name == "COAMANAGER" || upper_name.starts_with("COABOT")
}
/// Delete an account and, with it, all of its characters. Needs the world console. Refuses the Manager's and the
/// companions' own accounts, an account that is not there and one that is logged in right now.
pub fn delete(root: &Path, ra: &mut Ra, name: &str) -> Result<()> {
let name = upper(name)?;
if is_reserved(&name) {
return Err(Error::Invalid("This account belongs to the Manager or the companions and cannot be deleted.".into()));
}
let db = Db::from_repack(root, Account::Admin)?;
match db.query(&format!("SELECT online FROM acore_auth.account WHERE username = '{name}';"))?.trim() {
"" => return Err(Error::Invalid("That account does not exist.".into())),
"0" => {}
_ => return Err(Error::Invalid("The account is logged in right now; log it out first.".into())),
}
ra.delete_account(&name)?;
if db.query(&format!("SELECT COUNT(*) FROM acore_auth.account WHERE username = '{name}';"))?.trim() != "0" {
return Err(Error::Invalid("The account was not deleted.".into()));
}
tracing::info!(%name, "account deleted");
Ok(())
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn rows_from_the_client_become_accounts() {
let out = "2\tALICE\t3\t0\t2026-09-30 21:04:11\t4\n5\tBOB\t0\t1\t\t0\n7\tBROKEN\n";
let a = parse_list(out);
assert_eq!(a.len(), 2, "a short row is skipped");
assert_eq!(a[0], AccountInfo { id: 2, name: "ALICE".into(), access: 3, online: false, last_login: Some("2026-09-30 21:04:11".into()), characters: 4 });
assert!(a[1].online && a[1].last_login.is_none() && a[1].access == 0);
}
#[test]
fn the_internal_accounts_are_filtered_out_by_the_query() {
assert!(LIST_SQL.contains("COABOTHOST%") && LIST_SQL.contains("COAMANAGER"));
}
#[test]
fn the_managers_and_the_companions_accounts_are_never_deletable() {
for n in ["COAMANAGER", "COABOTHOST1", "COABOT12", "COABOTS"] {
assert!(is_reserved(n), "{n}");
}
for n in ["ALICE", "MYCOABOT", "BOT1"] {
assert!(!is_reserved(n), "{n}");
}
}
#[test]
fn names_are_validated_and_stored_in_capitals() {
assert_eq!(upper("Alice1").unwrap(), "ALICE1");
assert!(upper("a").is_err() && upper("x; DROP TABLE account").is_err() && upper("bad name").is_err());
}
}
+239
View File
@@ -0,0 +1,239 @@
//! Every setting of the world server's configuration, for people who want more than the curated list: the documented
//! settings come from `worldserver.conf.dist` (the file that ships with the server and explains each one), the current
//! values from the configuration the next start will use. Anything that holds a password, a port, an address, a folder or
//! the database connection is left out; the Manager owns those.
use std::collections::BTreeMap;
use std::fs;
use std::path::Path;
use serde::Serialize;
use crate::config::parser::ConfFile;
use crate::config::{take_snapshot, targets, Scope};
use crate::error::{Error, Result};
use crate::fsx;
#[derive(Debug, Serialize, PartialEq, Eq)]
pub struct Item {
pub key: String,
/// What the server uses now (the documented default when the file does not mention the setting).
pub value: String,
pub default: String,
pub doc: String,
/// The file sets it to something other than the documented default.
pub changed: bool,
}
/// Settings the Manager (or the launcher) owns.
fn hidden(key: &str) -> bool {
let k = key.to_ascii_lowercase();
k.contains("password")
|| k.contains("databaseinfo")
|| k.ends_with("port")
|| k.starts_with("ra.")
|| k.starts_with("logger.")
|| k.starts_with("appender.")
|| k.starts_with("updates.")
|| k.starts_with("logindatabase.")
|| k.starts_with("worlddatabase.")
|| k.starts_with("characterdatabase.")
|| ["bindip", "realmid", "datadir", "logsdir", "tempdir", "sourcedirectory", "mysqlexecutable", "cmakecommand", "builddirectory", "pidfile", "vmapdir", "mmapdir"].contains(&k.as_str())
}
fn doc_of(block: &[String]) -> String {
let mut parts: Vec<String> = Vec::new();
for l in block {
let body = l.trim_start_matches('#').trim();
if body.is_empty() {
continue;
}
// the lines that only name the settings the block describes
let named = l.starts_with("# ") && !l.starts_with("# ") && body.chars().all(|c| c.is_ascii_alphanumeric() || matches!(c, '.' | '_' | '-'));
if named {
continue;
}
parts.push(body.split_whitespace().collect::<Vec<_>>().join(" "));
}
let mut doc = parts.join(" ");
if doc.chars().count() > 900 {
doc = doc.chars().take(900).collect::<String>() + "…";
}
doc
}
/// The documented settings of a `.dist` file: (key, default, description), in file order.
fn parse_dist(text: &str) -> Vec<(String, String, String)> {
let mut out = Vec::new();
let mut block: Vec<String> = Vec::new();
let mut in_comment = false;
let mut doc = String::new();
for line in text.lines() {
let t = line.trim();
if t.starts_with('#') {
if !in_comment {
block.clear();
in_comment = true;
}
block.push(line.trim_end().to_string());
continue;
}
if in_comment {
doc = doc_of(&block);
in_comment = false;
}
if t.is_empty() || t.starts_with('[') {
continue;
}
if let Some((k, v)) = t.split_once('=') {
let k = k.trim();
if !k.is_empty() && k.chars().all(|c| c.is_ascii_alphanumeric() || matches!(c, '.' | '_' | '-')) {
out.push((k.to_string(), v.trim().to_string(), doc.clone()));
}
}
}
out
}
fn dist_path(root: &Path) -> std::path::PathBuf {
root.join("Core/configs/worldserver.conf.dist")
}
pub fn list(root: &Path) -> Result<Vec<Item>> {
let dist = fs::read_to_string(dist_path(root)).map_err(|_| Error::Invalid("The documented settings file (worldserver.conf.dist) was not found on this server.".into()))?;
let t = targets(root, Scope::Server)?;
let active = ConfFile::parse_bytes(&fs::read(&t.read)?)?;
Ok(parse_dist(&dist)
.into_iter()
.filter(|(k, _, _)| !hidden(k))
.map(|(key, default, doc)| {
let value = active.get(&key).map(|v| v.trim().to_string()).unwrap_or_else(|| default.clone());
let changed = value != default;
Item { key, value, default, doc, changed }
})
.collect())
}
/// Change settings that exist in the documented file. A value is one line of at most 500 characters. Returns the keys
/// that actually changed; the previous files are snapshotted first (and can be restored from Settings).
pub fn save(root: &Path, meta: &Path, changes: &BTreeMap<String, String>) -> Result<Vec<String>> {
let known: BTreeMap<String, String> = parse_dist(&fs::read_to_string(dist_path(root)).map_err(|_| Error::Invalid("worldserver.conf.dist was not found on this server.".into()))?)
.into_iter()
.map(|(k, d, _)| (k, d))
.collect();
let t = targets(root, Scope::Server)?;
let mut originals: Vec<(std::path::PathBuf, Vec<u8>)> = Vec::new();
let mut confs: Vec<ConfFile> = Vec::new();
for p in &t.writes {
let bytes = fs::read(p)?;
confs.push(ConfFile::parse_bytes(&bytes)?);
originals.push((p.clone(), bytes));
}
let mut changed = Vec::new();
for (key, value) in changes {
let value = value.trim();
if hidden(key) || !known.contains_key(key) {
return Err(Error::Invalid(format!("{key} is not a setting that can be changed here.")));
}
if value.is_empty() || value.len() > 500 || value.chars().any(char::is_control) {
return Err(Error::Invalid(format!("The value of {key} must be one line of text.")));
}
let same = confs.iter().all(|c| match c.get(key) {
Some(v) => v.trim() == value,
None => known[key] == value,
});
if !same {
changed.push((key.clone(), value.to_string()));
}
}
if changed.is_empty() {
return Ok(Vec::new());
}
for c in &mut confs {
for (k, v) in &changed {
c.set(k, v, &["Added by CoA Server Manager"]);
}
}
let texts: Vec<String> = confs.iter().map(ConfFile::to_text).collect();
for text in &texts {
let reread = ConfFile::parse(text);
for (k, v) in &changed {
if reread.get(k).map(str::trim) != Some(v.as_str()) {
return Err(Error::Invalid(format!("internal check failed for {k}")));
}
}
}
take_snapshot(meta, Scope::Server, &format!("before changing {} setting(s) in the full list", changed.len()), &originals)?;
let mut written = 0;
for (i, (path, _)) in originals.iter().enumerate() {
if let Err(e) = fsx::atomic_write(path, texts[i].as_bytes()) {
for (p, bytes) in originals.iter().take(written) {
let _ = fsx::atomic_write(p, bytes);
}
return Err(e);
}
written += 1;
}
Ok(changed.into_iter().map(|(k, _)| k).collect())
}
#[cfg(test)]
mod tests {
use super::*;
const DIST: &str = "[worldserver]\r\n\r\n###################\r\n# SECTION\r\n###################\r\n\r\n#\r\n# Rate.Drop.Item.Epic\r\n# Rate.Drop.Item.Rare\r\n# Description: Drop rates by quality.\r\n# Default: 1\r\n#\r\n\r\nRate.Drop.Item.Rare = 1\r\nRate.Drop.Item.Epic = 1\r\n\r\n#\r\n# LoginDatabaseInfo\r\n# Description: secret\r\n#\r\n\r\nLoginDatabaseInfo = \"127.0.0.1;3306;a;b;c\"\r\n\r\n#\r\n# Instance.ResetTimeHour\r\n# Description: Hour of the reset.\r\n# Important: Use 0-23.\r\n# Default: 4\r\n#\r\n\r\nInstance.ResetTimeHour = 4\r\n";
fn server(d: &Path) -> (std::path::PathBuf, std::path::PathBuf) {
let (root, meta) = (d.join("srv"), d.join("meta"));
fs::create_dir_all(root.join("Core/configs")).unwrap();
fs::create_dir_all(root.join("Settings")).unwrap();
fs::create_dir_all(&meta).unwrap();
fs::write(root.join("Core/configs/worldserver.conf.dist"), DIST).unwrap();
let conf = "[worldserver]\r\nRate.Drop.Item.Epic = 3\r\nLoginDatabaseInfo = \"x\"\r\n";
fs::write(root.join("Settings/worldserver.conf.template"), conf).unwrap();
fs::write(root.join("Core/configs/worldserver.conf"), conf).unwrap();
(root, meta)
}
#[test]
fn the_documentation_of_a_block_is_shared_by_its_settings_and_secrets_are_left_out() {
let d = tempfile::tempdir().unwrap();
let (root, _) = server(d.path());
let items = list(&root).unwrap();
let keys: Vec<&str> = items.iter().map(|i| i.key.as_str()).collect();
assert_eq!(keys, ["Rate.Drop.Item.Rare", "Rate.Drop.Item.Epic", "Instance.ResetTimeHour"], "the database connection is hidden");
assert_eq!(items[0].doc, "Description: Drop rates by quality. Default: 1");
assert_eq!(items[0].doc, items[1].doc);
assert_eq!(items[2].doc, "Description: Hour of the reset. Important: Use 0-23. Default: 4");
assert!(!items[0].changed && items[0].value == "1", "absent from the file: documented default");
assert!(items[1].changed && items[1].value == "3");
}
#[test]
fn only_documented_visible_settings_with_one_line_values_can_be_saved_and_both_files_change() {
let d = tempfile::tempdir().unwrap();
let (root, meta) = server(d.path());
let ok = BTreeMap::from([("Instance.ResetTimeHour".to_string(), "6".to_string())]);
assert_eq!(save(&root, &meta, &ok).unwrap(), ["Instance.ResetTimeHour"]);
for f in ["Settings/worldserver.conf.template", "Core/configs/worldserver.conf"] {
let t = fs::read_to_string(root.join(f)).unwrap();
assert!(t.contains("Instance.ResetTimeHour = 6") && t.contains("Rate.Drop.Item.Epic = 3"), "{f}: {t}");
}
assert!(save(&root, &meta, &ok).unwrap().is_empty(), "same value: nothing to do");
let same_as_default = BTreeMap::from([("Rate.Drop.Item.Rare".to_string(), "1".to_string())]);
assert!(save(&root, &meta, &same_as_default).unwrap().is_empty(), "the default is already in effect");
for bad in [("LoginDatabaseInfo", "\"evil\""), ("Nope.Key", "1"), ("Rate.Drop.Item.Rare", ""), ("Rate.Drop.Item.Rare", "1\n2")] {
assert!(save(&root, &meta, &BTreeMap::from([(bad.0.to_string(), bad.1.to_string())])).is_err(), "{bad:?}");
}
}
#[test]
fn what_belongs_to_the_manager_is_hidden() {
for k in ["LoginDatabaseInfo", "WorldServerPort", "BindIP", "Ra.Enable", "Ra.Password", "Logger.root", "Appender.Console", "DataDir", "Updates.EnableDatabases", "LoginDatabase.WorkerThreads", "InstanceServerPort"] {
assert!(hidden(k), "{k}");
}
for k in ["Rate.XP.Kill", "PlayerLimit", "SupportEnabled", "Instance.ResetTimeHour", "Warden.Enabled", "CharacterCreating.Disabled"] {
assert!(!hidden(k), "{k}");
}
}
}
+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)? {
+173 -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,
@@ -122,12 +184,40 @@ fn host_ok(h: &str) -> bool {
!h.is_empty() && h.len() <= 253 && h.chars().all(|c| c.is_ascii_alphanumeric() || matches!(c, '.' | '-' | ':')) && !h.starts_with('-')
}
/// Locales a client has game data for (`Data/<locale>/locale-<locale>.MPQ`), e.g. `enUS`.
fn installed_locales(client: &Path) -> Vec<String> {
let mut v: Vec<String> = fs::read_dir(client.join("Data"))
.map(|rd| {
rd.flatten()
.filter(|e| e.path().is_dir())
.filter_map(|e| e.file_name().into_string().ok())
.filter(|n| n.len() == 4 && n[..2].bytes().all(|b| b.is_ascii_lowercase()) && n[2..].bytes().all(|b| b.is_ascii_uppercase()))
.filter(|n| client.join("Data").join(n).join(format!("locale-{n}.MPQ")).is_file())
.collect()
})
.unwrap_or_default();
v.sort();
v
}
/// Point every locale's realmlist at `host`. Each changed file is copied to the backup folder first.
/// A freshly downloaded client has no realmlist yet; one is created for each installed locale.
pub fn set_realmlist(client: &Path, meta: &Path, host: &str) -> Result<Vec<String>> {
if !host_ok(host) {
return Err(Error::Invalid("That address is not valid.".into()));
}
let mut changed = Vec::new();
if realmlist_files(client).is_empty() {
for loc in installed_locales(client) {
let file = client.join("Data").join(&loc).join("realmlist.wtf");
fsx::atomic_write(&file, format!("set realmlist {host}
").as_bytes())?;
changed.push(file.to_string_lossy().into_owned());
}
if !changed.is_empty() {
return Ok(changed);
}
}
let stamp = chrono::Utc::now().format("%Y%m%d-%H%M%S").to_string();
for file in realmlist_files(client) {
let old = fs::read(&file)?;
@@ -161,6 +251,32 @@ pub fn set_realmlist(client: &Path, meta: &Path, host: &str) -> Result<Vec<Strin
Ok(changed)
}
/// Replace the text of every locale's realmlist with `content` (a named realmlist chosen by the player). Each changed file
/// is saved to the backup folder first; files that already hold the same lines are left alone. A client without one gets a
/// file for each installed locale. Returns the files that changed.
pub fn write_realmlist(client: &Path, meta: &Path, content: &str) -> Result<Vec<String>> {
let compact = |t: &str| t.lines().map(|l| l.trim().to_ascii_lowercase()).filter(|l| !l.is_empty()).collect::<Vec<_>>().join("\n");
let mut files = realmlist_files(client);
if files.is_empty() {
files = installed_locales(client).into_iter().map(|loc| client.join("Data").join(loc).join("realmlist.wtf")).collect();
}
let stamp = chrono::Utc::now().format("%Y%m%d-%H%M%S").to_string();
let mut changed = Vec::new();
for file in files {
let old = fs::read(&file).ok();
if let Some(old) = &old {
if compact(&String::from_utf8_lossy(old)) == compact(content) {
continue;
}
let locale = file.parent().and_then(|p| p.file_name()).map(|n| n.to_string_lossy().into_owned()).unwrap_or_default();
fsx::atomic_write(&backup_dir(meta).join(format!("realmlist-{locale}-{stamp}.wtf")), old)?;
}
fsx::atomic_write(&file, content.as_bytes())?;
changed.push(file.to_string_lossy().into_owned());
}
Ok(changed)
}
/// Copy the addon into the client. If a different version is there, that one folder is backed up first;
/// files in it that the package does not contain are left alone.
pub fn install_addon(client: &Path, meta: &Path, source: &Path) -> Result<()> {
@@ -199,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();
@@ -261,6 +416,22 @@ mod tests {
assert!(set_realmlist(&c, &meta, "bad host; rm -rf").is_err());
}
#[test]
fn a_fresh_client_gets_a_realmlist_for_each_installed_locale() {
let d = tempfile::tempdir().unwrap();
let c = d.path().join("fresh");
fs::create_dir_all(c.join("Data/enUS")).unwrap();
fs::create_dir_all(c.join("Data/Content")).unwrap();
fs::write(c.join("Data/enUS/locale-enUS.MPQ"), b"x").unwrap();
fs::write(c.join("Ascension.exe"), b"exe").unwrap();
let changed = set_realmlist(&c, &d.path().join("meta"), "127.0.0.1").unwrap();
assert_eq!(changed.len(), 1);
assert_eq!(fs::read_to_string(c.join("Data/enUS/realmlist.wtf")).unwrap(), "set realmlist 127.0.0.1
");
assert!(!c.join("Data/Content/realmlist.wtf").exists());
assert_eq!(detect(&c, None).unwrap().realmlists[0].host.as_deref(), Some("127.0.0.1"));
}
#[test]
fn addon_install_touches_only_its_own_folder_and_backs_up_a_different_version() {
let d = tempfile::tempdir().unwrap();
+630
View File
@@ -0,0 +1,630 @@
//! Download and update of the game client from the community launcher's public manifest.
//!
//! The manifest lists every file with its size and SHA-256; each file is fetched by hash and verified before it is
//! moved into place (`download::fetch_with`, resumable). The Manager keeps a small state file inside the client
//! folder (`.coa-manager/client-state.json`) so that later checks are cheap and so that files the player changed
//! are recognised: they are never overwritten without being asked, and a replaced file is moved aside, not deleted.
//! WTF, Cache, other addons, logs and `realmlist.wtf` are not part of what the Manager synchronises.
use std::collections::{BTreeMap, HashMap};
use std::fs::{self, File};
use std::io::Read;
use std::path::{Path, PathBuf};
use std::time::{Instant, UNIX_EPOCH};
use serde::{Deserialize, Serialize};
use sha2::{Digest, Sha256};
use crate::download::{self, Cancel, HttpTransport, Job, Transport};
use crate::error::{Error, Result};
use crate::fsx;
pub const MANIFEST_URL: &str = "https://launcher-api.coa-development.org/downloads/client/latest.json";
pub const OBJECTS_URL: &str = "https://launcher-api.coa-development.org/downloads/client/objects";
const STATE_DIR: &str = ".coa-manager";
const MAX_MANIFEST_BYTES: u64 = 16 * 1024 * 1024;
const MAX_FILE_BYTES: u64 = 16 * 1024 * 1024 * 1024;
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ManifestFile {
pub path: String,
pub size: u64,
pub sha256: String,
}
#[derive(Debug, Clone, Serialize)]
pub struct Manifest {
pub version: String,
pub published_at: Option<String>,
pub files: Vec<ManifestFile>,
}
impl Manifest {
pub fn total_bytes(&self) -> u64 {
self.files.iter().map(|f| f.size).sum()
}
}
#[derive(Deserialize)]
struct RawManifest {
schema: u32,
version: String,
#[serde(rename = "publishedAt")]
published_at: Option<String>,
files: Vec<ManifestFile>,
}
/// Things the Manager never writes, even if a manifest lists them: logs, the realmlist, the player's own settings,
/// caches and the companion addon (those have their own safe paths).
fn is_excluded(path: &str) -> bool {
let p = path.replace('\\', "/").to_ascii_lowercase();
p.ends_with(".log")
|| p.rsplit('/').next() == Some("realmlist.wtf")
|| p.starts_with("wtf/")
|| p.starts_with("cache/")
|| p.starts_with("errors/")
|| p.starts_with("logs/")
|| p.starts_with(".coa-manager/")
|| p.starts_with("interface/addons/coabotui/")
}
/// Files players customise: graphics wrappers and their configuration. If one exists and differs from the published
/// file it is left exactly as it is, whatever the "keep my files" choice; it is only created when missing.
fn is_player_owned(path: &str) -> bool {
let name = path.rsplit('/').next().unwrap_or(path).to_ascii_lowercase();
matches!(name.as_str(), "d3d8.dll" | "d3d9.dll" | "d3d10core.dll" | "d3d11.dll" | "dxgi.dll" | "dxvk.conf")
|| matches!(name.rsplit('.').next(), Some("ini" | "conf" | "cfg" | "wtf"))
}
pub fn parse_manifest(text: &str) -> Result<Manifest> {
let raw: RawManifest = serde_json::from_str(text).map_err(|e| Error::Invalid(format!("The client list could not be read: {e}")))?;
if raw.schema != 1 {
return Err(Error::Invalid(format!("The client list uses a newer format ({}); update the Manager.", raw.schema)));
}
if raw.version.trim().is_empty() || raw.version.len() > 64 {
return Err(Error::Invalid("The client list has no version.".into()));
}
let root = Path::new("client-root");
let mut files = Vec::with_capacity(raw.files.len());
for f in raw.files {
fsx::safe_join(root, &f.path)?;
let hash_ok = f.sha256.len() == 64 && f.sha256.bytes().all(|b| b.is_ascii_hexdigit());
if !hash_ok || f.size > MAX_FILE_BYTES {
return Err(Error::Invalid(format!("The client list has a bad entry for {}.", f.path)));
}
if is_excluded(&f.path) {
continue;
}
files.push(ManifestFile { path: f.path.replace('\\', "/"), size: f.size, sha256: f.sha256.to_ascii_lowercase() });
}
if files.is_empty() {
return Err(Error::Invalid("The client list is empty.".into()));
}
Ok(Manifest { version: raw.version, published_at: raw.published_at, files })
}
pub fn fetch_manifest(transport: &dyn Transport, url: &str) -> Result<Manifest> {
let mut reply = transport.get(url, 0).map_err(|e| Error::Invalid(format!("Could not reach the client download server: {e}")))?;
if reply.status != 200 {
return Err(Error::Invalid(format!("The client download server answered {}.", reply.status)));
}
let mut text = String::new();
reply.body.by_ref().take(MAX_MANIFEST_BYTES).read_to_string(&mut text).map_err(|e| Error::Invalid(format!("Could not read the client list: {e}")))?;
parse_manifest(&text)
}
pub fn fetch_latest() -> Result<Manifest> {
download::check_url(MANIFEST_URL)?;
fetch_manifest(&HttpTransport::with_total_timeout(30)?, MANIFEST_URL)
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Entry {
pub size: u64,
pub mtime: u64,
pub sha256: String,
/// The player chose to keep this file although the manifest has a different one (this is the manifest hash
/// they were asked about; a newer manifest asks again).
#[serde(default)]
pub kept_against: Option<String>,
}
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct State {
/// The manifest version this folder was brought to; None while a download is unfinished.
pub version: Option<String>,
pub files: BTreeMap<String, Entry>,
}
fn state_path(client: &Path) -> PathBuf {
client.join(STATE_DIR).join("client-state.json")
}
pub fn load_state(client: &Path) -> Option<State> {
fsx::read_json(&state_path(client)).ok()
}
fn save_state(client: &Path, state: &State) -> Result<()> {
fsx::atomic_write_json(&state_path(client), state)
}
#[derive(Debug, Clone, Serialize)]
pub struct Local {
/// The Manager downloaded or adopted this folder (a state file exists).
pub managed: bool,
pub version: Option<String>,
}
pub fn local(client: &Path) -> Local {
let s = load_state(client);
Local { managed: s.is_some(), version: s.and_then(|s| s.version) }
}
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize)]
#[serde(rename_all = "snake_case")]
pub enum Kind {
/// Not in the folder.
Missing,
/// Still as the Manager left it; the manifest has a newer file.
Changed,
/// Different from the manifest and not as the Manager left it (changed by the player or by something else).
Modified,
}
#[derive(Debug, Clone, Serialize)]
pub struct Item {
pub path: String,
pub size: u64,
pub kind: Kind,
#[serde(skip)]
sha256: String,
}
#[derive(Debug, Clone, Serialize)]
pub struct Plan {
pub version: String,
pub items: Vec<Item>,
pub download_bytes: u64,
pub total_files: usize,
pub up_to_date_files: usize,
pub kept_files: usize,
#[serde(skip)]
confirmed: BTreeMap<String, Entry>,
}
impl Plan {
pub fn modified(&self) -> Vec<&Item> {
self.items.iter().filter(|i| i.kind == Kind::Modified).collect()
}
}
#[derive(Debug, Clone, Serialize)]
pub struct Step {
/// "scan" while comparing files, "download" while fetching, "finish" at the end.
pub phase: &'static str,
pub done: u64,
pub total: u64,
pub bytes_per_sec: u64,
pub file: Option<String>,
}
fn cancelled() -> Error {
Error::Invalid("Download cancelled.".into())
}
fn mtime_secs(m: &fs::Metadata) -> u64 {
m.modified().ok().and_then(|t| t.duration_since(UNIX_EPOCH).ok()).map(|d| d.as_secs()).unwrap_or(0)
}
fn hash_file(path: &Path, cancel: &Cancel, on_bytes: &mut dyn FnMut(u64)) -> Result<String> {
let mut f = File::open(path)?;
let mut hasher = Sha256::new();
let mut buf = vec![0u8; 1 << 20];
loop {
if cancel.is_set() {
return Err(cancelled());
}
let n = f.read(&mut buf)?;
if n == 0 {
return Ok(hex::encode(hasher.finalize()));
}
hasher.update(&buf[..n]);
on_bytes(n as u64);
}
}
/// Compare the folder with the manifest. Files are hashed only when their size or modification time no longer
/// matches what the state file recorded, so a routine check of a managed folder is quick.
pub fn plan(client: &Path, m: &Manifest, state: &State, cancel: &Cancel, on_step: &dyn Fn(Step)) -> Result<Plan> {
let total = m.total_bytes();
let mut done = 0u64;
let mut items = Vec::new();
let mut confirmed = BTreeMap::new();
let (mut up_to_date, mut kept) = (0usize, 0usize);
for f in &m.files {
if cancel.is_set() {
return Err(cancelled());
}
on_step(Step { phase: "scan", done, total, bytes_per_sec: 0, file: Some(f.path.clone()) });
let path = fsx::safe_join(client, &f.path)?;
let meta = match fs::metadata(&path) {
Ok(meta) if meta.is_file() => meta,
_ => {
items.push(Item { path: f.path.clone(), size: f.size, kind: Kind::Missing, sha256: f.sha256.clone() });
done += f.size;
continue;
}
};
let (size, mtime) = (meta.len(), mtime_secs(&meta));
let entry = state.files.get(&f.path);
let trusted = entry.filter(|e| e.size == size && e.mtime == mtime);
let local: Option<String> = if let Some(e) = trusted {
Some(e.sha256.clone())
} else if size == f.size || entry.map(|e| e.size == size).unwrap_or(false) {
let base = done;
let mut seen = 0u64;
let h = hash_file(&path, cancel, &mut |n| {
seen += n;
on_step(Step { phase: "scan", done: base + seen.min(f.size), total, bytes_per_sec: 0, file: Some(f.path.clone()) });
})?;
Some(h)
} else {
None
};
done += f.size;
if is_player_owned(&f.path) && local.as_deref() != Some(f.sha256.as_str()) {
let sha = match local {
Some(h) => h,
None => hash_file(&path, cancel, &mut |_| {})?,
};
kept += 1;
confirmed.insert(f.path.clone(), Entry { size, mtime, sha256: sha, kept_against: Some(f.sha256.clone()) });
continue;
}
if local.as_deref() == Some(f.sha256.as_str()) {
up_to_date += 1;
confirmed.insert(f.path.clone(), Entry { size, mtime, sha256: f.sha256.clone(), kept_against: None });
continue;
}
let as_left = entry.filter(|e| local.as_deref() == Some(e.sha256.as_str()));
match as_left {
Some(e) if e.kept_against.as_deref() == Some(f.sha256.as_str()) => {
kept += 1;
confirmed.insert(f.path.clone(), Entry { size, mtime, sha256: e.sha256.clone(), kept_against: e.kept_against.clone() });
}
Some(e) if e.kept_against.is_none() => {
items.push(Item { path: f.path.clone(), size: f.size, kind: Kind::Changed, sha256: f.sha256.clone() });
}
_ => items.push(Item { path: f.path.clone(), size: f.size, kind: Kind::Modified, sha256: f.sha256.clone() }),
}
}
on_step(Step { phase: "scan", done: total, total, bytes_per_sec: 0, file: None });
let download_bytes = items.iter().map(|i| i.size).sum();
Ok(Plan { version: m.version.clone(), items, download_bytes, total_files: m.files.len(), up_to_date_files: up_to_date, kept_files: kept, confirmed })
}
pub struct Apply<'a> {
pub client: &'a Path,
pub manifest: &'a Manifest,
pub plan: &'a Plan,
/// Leave files the player changed alone (they are remembered, and asked about again only when the manifest changes).
pub keep_modified: bool,
pub transport: &'a dyn Transport,
pub objects_url: &'a str,
pub cancel: &'a Cancel,
}
fn blocked(path: &str, e: std::io::Error) -> Error {
Error::Invalid(format!("Could not replace {path}: {e}. Close the game and anything else using the client, then try again."))
}
/// Download what the plan lists. Progress is saved after every file, so an interrupted run resumes where it stopped.
pub fn apply(a: &Apply, on_step: &dyn Fn(Step)) -> Result<()> {
let mut state = State { version: None, files: a.plan.confirmed.clone() };
save_state(a.client, &state)?;
let mut todo = Vec::new();
for item in &a.plan.items {
if item.kind == Kind::Modified && a.keep_modified {
let path = fsx::safe_join(a.client, &item.path)?;
let meta = fs::metadata(&path)?;
let sha = hash_file(&path, a.cancel, &mut |_| {})?;
state.files.insert(item.path.clone(), Entry { size: meta.len(), mtime: mtime_secs(&meta), sha256: sha, kept_against: Some(item.sha256.clone()) });
} else {
todo.push(item);
}
}
let total: u64 = todo.iter().map(|i| i.size).sum();
fsx::require_space(a.client, total)?;
let staging = a.client.join(STATE_DIR).join("staging");
let replaced = a.client.join(STATE_DIR).join("replaced").join(chrono::Utc::now().format("%Y%m%d-%H%M%S").to_string());
let mut done = 0u64;
let mut placed: HashMap<&str, PathBuf> = HashMap::new();
for item in todo {
if a.cancel.is_set() {
save_state(a.client, &state)?;
return Err(cancelled());
}
let target = fsx::safe_join(a.client, &item.path)?;
let started = Instant::now();
let staged = staging.join(&item.sha256);
let copy_from = placed.get(item.sha256.as_str()).cloned();
if copy_from.is_none() {
let job = Job { url: format!("{}/{}", a.objects_url, item.sha256), dest: staged.clone(), sha256: item.sha256.clone(), size: item.size };
let base = done;
let result = download::fetch_with(a.transport, &job, a.cancel, &|p| {
on_step(Step { phase: "download", done: base + p.downloaded, total, bytes_per_sec: p.bytes_per_sec, file: Some(item.path.clone()) });
});
if let Err(e) = result {
let _ = save_state(a.client, &state);
return Err(e);
}
}
if let Some(parent) = target.parent() {
fs::create_dir_all(parent)?;
}
if target.exists() {
if item.kind == Kind::Modified {
let keep = fsx::safe_join(&replaced, &item.path)?;
if let Some(parent) = keep.parent() {
fs::create_dir_all(parent)?;
}
fs::rename(&target, &keep).map_err(|e| blocked(&item.path, e))?;
} else {
fs::remove_file(&target).map_err(|e| blocked(&item.path, e))?;
}
}
match copy_from {
Some(src) => {
fs::copy(&src, &target).map_err(|e| blocked(&item.path, e))?;
}
None => fs::rename(&staged, &target).map_err(|e| blocked(&item.path, e))?,
}
placed.insert(&item.sha256, target.clone());
let meta = fs::metadata(&target)?;
state.files.insert(item.path.clone(), Entry { size: meta.len(), mtime: mtime_secs(&meta), sha256: item.sha256.clone(), kept_against: None });
save_state(a.client, &state)?;
done += item.size;
let secs = started.elapsed().as_secs_f64().max(0.001);
on_step(Step { phase: "download", done, total, bytes_per_sec: (item.size as f64 / secs) as u64, file: Some(item.path.clone()) });
}
state.version = Some(a.manifest.version.clone());
save_state(a.client, &state)?;
let _ = fs::remove_dir_all(&staging);
on_step(Step { phase: "finish", done: total, total, bytes_per_sec: 0, file: None });
Ok(())
}
#[cfg(test)]
mod tests {
use super::*;
use crate::download::Reply;
use std::io::Cursor;
use std::sync::atomic::{AtomicUsize, Ordering};
use std::sync::Mutex;
/// Serves objects by hash; remembers what was requested and can fail after N objects.
struct Server {
objects: Mutex<HashMap<String, Vec<u8>>>,
requested: Mutex<Vec<String>>,
cancel_after: Option<(AtomicUsize, Cancel)>,
}
impl Server {
fn new(files: &[(&str, &[u8])]) -> Self {
let s = Server { objects: Default::default(), requested: Default::default(), cancel_after: None };
for (_, body) in files {
s.objects.lock().unwrap().insert(fsx::sha256_bytes(body), body.to_vec());
}
s
}
}
impl Transport for Server {
fn get(&self, url: &str, from: u64) -> std::result::Result<Reply, String> {
let sha = url.rsplit('/').next().unwrap().to_string();
self.requested.lock().unwrap().push(sha.clone());
if let Some((left, cancel)) = &self.cancel_after {
if left.fetch_sub(1, Ordering::SeqCst) == 1 {
cancel.cancel();
}
}
let body = self.objects.lock().unwrap().get(&sha).cloned().ok_or("404")?;
let (status, start) = if from > 0 { (206, from as usize) } else { (200, 0) };
let cr = (from > 0).then(|| format!("bytes {from}-{}/{}", body.len() - 1, body.len()));
Ok(Reply { status, content_range: cr, body: Box::new(Cursor::new(body[start..].to_vec())) })
}
}
fn manifest(version: &str, files: &[(&str, &[u8])]) -> Manifest {
Manifest {
version: version.into(),
published_at: None,
files: files.iter().map(|(p, b)| ManifestFile { path: p.to_string(), size: b.len() as u64, sha256: fsx::sha256_bytes(b) }).collect(),
}
}
const V1: [(&str, &[u8]); 4] = [("Wow.exe", b"exe-1"), ("Data/common.MPQ", b"common-mpq-data"), ("Data/patch-A.MPQ", b"patch-a-1"), ("Data/enUS/locale.MPQ", b"locale")];
fn sync(dir: &Path, m: &Manifest, server: &Server, keep: bool) -> Result<Plan> {
let state = load_state(dir).unwrap_or_default();
let cancel = Cancel::default();
let p = plan(dir, m, &state, &cancel, &|_| {})?;
apply(&Apply { client: dir, manifest: m, plan: &p, keep_modified: keep, transport: server, objects_url: "https://x.invalid/objects", cancel: &cancel }, &|_| {})?;
Ok(p)
}
#[test]
fn manifest_rejects_traversal_and_bad_entries_and_skips_personal_files() {
let ok = r#"{"schema":1,"version":"v1","files":[
{"path":"Wow.exe","size":3,"sha256":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"},
{"path":"Data/enUS/realmlist.wtf","size":3,"sha256":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"},
{"path":"WTF/Config.wtf","size":3,"sha256":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"},
{"path":"Interface/AddOns/CoABotUI/x.lua","size":3,"sha256":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"},
{"path":"MemoryBridge.log","size":3,"sha256":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}]}"#;
let m = parse_manifest(ok).unwrap();
assert_eq!(m.files.iter().map(|f| f.path.as_str()).collect::<Vec<_>>(), ["Wow.exe"]);
for bad in [
r#"{"schema":1,"version":"v","files":[{"path":"../evil.dll","size":1,"sha256":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}]}"#,
r#"{"schema":1,"version":"v","files":[{"path":"C:/evil.dll","size":1,"sha256":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}]}"#,
r#"{"schema":1,"version":"v","files":[{"path":"a.dll","size":1,"sha256":"short"}]}"#,
r#"{"schema":2,"version":"v","files":[]}"#,
r#"{"schema":1,"version":"v","files":[]}"#,
] {
assert!(parse_manifest(bad).is_err(), "{bad}");
}
}
#[test]
fn fresh_download_installs_every_file_verified_and_leaves_nothing_behind() {
let d = tempfile::tempdir().unwrap();
let (m, s) = (manifest("v1", &V1), Server::new(&V1));
let p = sync(d.path(), &m, &s, false).unwrap();
assert_eq!(p.items.len(), 4);
for (path, body) in V1 {
assert_eq!(fs::read(d.path().join(path)).unwrap(), body);
}
let st = load_state(d.path()).unwrap();
assert_eq!(st.version.as_deref(), Some("v1"));
assert_eq!(st.files.len(), 4);
assert!(!d.path().join(".coa-manager/staging").exists());
assert!(local(d.path()).managed);
}
#[test]
fn an_update_downloads_only_what_changed_and_a_second_check_is_empty() {
let d = tempfile::tempdir().unwrap();
sync(d.path(), &manifest("v1", &V1), &Server::new(&V1), false).unwrap();
let mut v2 = V1.to_vec();
v2[2] = ("Data/patch-A.MPQ", b"patch-a-2-longer");
v2.push(("Data/new.MPQ", b"brand new"));
let (m2, s2) = (manifest("v2", &v2), Server::new(&v2));
let p = sync(d.path(), &m2, &s2, false).unwrap();
let kinds: Vec<_> = p.items.iter().map(|i| (i.path.as_str(), i.kind)).collect();
assert_eq!(kinds, [("Data/patch-A.MPQ", Kind::Changed), ("Data/new.MPQ", Kind::Missing)]);
assert_eq!(s2.requested.lock().unwrap().len(), 2, "unchanged files were not downloaded again");
assert_eq!(fs::read(d.path().join("Data/patch-A.MPQ")).unwrap(), b"patch-a-2-longer");
assert!(!d.path().join(".coa-manager/replaced").exists(), "a file the Manager itself wrote needs no backup");
let again = sync(d.path(), &m2, &s2, false).unwrap();
assert!(again.items.is_empty() && again.up_to_date_files == 5);
assert_eq!(load_state(d.path()).unwrap().version.as_deref(), Some("v2"));
}
#[test]
fn a_file_the_player_changed_is_asked_about_kept_when_told_to_and_saved_when_replaced() {
let d = tempfile::tempdir().unwrap();
sync(d.path(), &manifest("v1", &V1), &Server::new(&V1), false).unwrap();
fs::write(d.path().join("Wow.exe"), b"my patched exe").unwrap();
let mut v2 = V1.to_vec();
v2[0] = ("Wow.exe", b"exe-2");
let (m2, s2) = (manifest("v2", &v2), Server::new(&v2));
let p = sync(d.path(), &m2, &s2, true).unwrap();
assert_eq!(p.modified().len(), 1);
assert_eq!(fs::read(d.path().join("Wow.exe")).unwrap(), b"my patched exe", "kept");
assert!(s2.requested.lock().unwrap().is_empty(), "nothing needed downloading");
let quiet = sync(d.path(), &m2, &s2, true).unwrap();
assert!(quiet.items.is_empty() && quiet.kept_files == 1, "the decision is remembered");
let mut v3 = V1.to_vec();
v3[0] = ("Wow.exe", b"exe-3");
let (m3, s3) = (manifest("v3", &v3), Server::new(&v3));
let again = sync(d.path(), &m3, &s3, false).unwrap();
assert_eq!(again.modified().len(), 1, "a newer client asks again");
assert_eq!(fs::read(d.path().join("Wow.exe")).unwrap(), b"exe-3");
let saved = fs::read_dir(d.path().join(".coa-manager/replaced")).unwrap().next().unwrap().unwrap().path();
assert_eq!(fs::read(saved.join("Wow.exe")).unwrap(), b"my patched exe", "the player's version was moved aside, not lost");
}
#[test]
fn renderer_files_configs_and_everything_not_in_the_manifest_survive_an_update_untouched() {
let d = tempfile::tempdir().unwrap();
let v1: Vec<(&str, &[u8])> = vec![("Wow.exe", b"exe-1"), ("d3d9.dll", b"official d3d9"), ("dxvk.conf", b"official conf"), ("Data/common.MPQ", b"common-1")];
sync(d.path(), &manifest("v1", &v1), &Server::new(&v1), false).unwrap();
// the player's own setup: custom renderer + configs, addons, WTF, realmlist, extra archives, backups
let mine: Vec<(&str, &[u8])> = vec![
("d3d9.dll", b"my renderer"),
("dxvk.conf", b"my conf"),
("ModernWoWRenderer.ini", b"cfg"),
("GraphicsEffects.ini.bak", b"bak"),
("Data/enUS/realmlist.wtf", b"set realmlist 127.0.0.1
"),
("Data/patch-5.MPQ", b"extra archive"),
("Interface/AddOns/ElvUI/ElvUI.toc", b"## Title: Elv"),
("WTF/Account/x/SavedVariables.lua", b"vars"),
("Cache/x.wdb", b"cache"),
];
for (p, b) in &mine {
let path = d.path().join(p);
fs::create_dir_all(path.parent().unwrap()).unwrap();
fs::write(path, b).unwrap();
}
let before: BTreeMap<String, String> = mine.iter().map(|(p, b)| (p.to_string(), fsx::sha256_bytes(b))).collect();
let v2: Vec<(&str, &[u8])> = vec![("Wow.exe", b"exe-2"), ("d3d9.dll", b"official d3d9 v2"), ("dxvk.conf", b"official conf v2"), ("Data/common.MPQ", b"common-2")];
let (m2, s2) = (manifest("v2", &v2), Server::new(&v2));
for keep in [false, true] {
sync(d.path(), &m2, &s2, keep).unwrap();
for (p, h) in &before {
assert_eq!(&fsx::sha256_file(&d.path().join(p)).unwrap(), h, "{p} must not change (keep_modified={keep})");
}
assert_eq!(fs::read(d.path().join("Wow.exe")).unwrap(), b"exe-2");
assert_eq!(fs::read(d.path().join("Data/common.MPQ")).unwrap(), b"common-2");
}
assert!(!d.path().join(".coa-manager/replaced").exists(), "nothing of the player's was displaced");
}
#[test]
fn an_existing_client_without_state_is_compared_by_content() {
let d = tempfile::tempdir().unwrap();
for (p, b) in V1 {
let path = d.path().join(p);
fs::create_dir_all(path.parent().unwrap()).unwrap();
fs::write(path, b).unwrap();
}
fs::write(d.path().join("Data/patch-A.MPQ"), b"patch-a-X").unwrap(); // same size, different content
fs::remove_file(d.path().join("Data/enUS/locale.MPQ")).unwrap();
fs::create_dir_all(d.path().join("WTF")).unwrap();
fs::write(d.path().join("WTF/Config.wtf"), b"mine").unwrap();
let m = manifest("v1", &V1);
let p = plan(d.path(), &m, &State::default(), &Cancel::default(), &|_| {}).unwrap();
let kinds: Vec<_> = p.items.iter().map(|i| (i.path.as_str(), i.kind)).collect();
assert_eq!(kinds, [("Data/patch-A.MPQ", Kind::Modified), ("Data/enUS/locale.MPQ", Kind::Missing)]);
assert_eq!(p.up_to_date_files, 2);
assert_eq!(fs::read(d.path().join("WTF/Config.wtf")).unwrap(), b"mine");
}
#[test]
fn cancel_keeps_finished_files_and_the_next_run_only_fetches_the_rest() {
let d = tempfile::tempdir().unwrap();
let m = manifest("v1", &V1);
let mut s = Server::new(&V1);
let cancel = Cancel::default();
s.cancel_after = Some((AtomicUsize::new(3), cancel.clone()));
let state = State::default();
let p = plan(d.path(), &m, &state, &cancel, &|_| {}).unwrap();
let r = apply(&Apply { client: d.path(), manifest: &m, plan: &p, keep_modified: false, transport: &s, objects_url: "https://x.invalid/o", cancel: &cancel }, &|_| {});
assert!(r.is_err());
let st = load_state(d.path()).unwrap();
assert!(st.version.is_none() && !st.files.is_empty() && st.files.len() < 4, "unfinished but remembered: {}", st.files.len());
assert!(local(d.path()).managed && local(d.path()).version.is_none());
let s2 = Server::new(&V1);
sync(d.path(), &m, &s2, false).unwrap();
assert_eq!(s2.requested.lock().unwrap().len(), 4 - st.files.len(), "only the missing files were requested");
assert_eq!(load_state(d.path()).unwrap().version.as_deref(), Some("v1"));
}
#[test]
fn a_wrong_object_never_reaches_the_client_folder() {
let d = tempfile::tempdir().unwrap();
let m = manifest("v1", &V1);
let s = Server::new(&V1);
// the server returns different bytes under the right hash
let sha = fsx::sha256_bytes(b"exe-1");
s.objects.lock().unwrap().insert(sha, b"EVIL!".to_vec());
assert!(sync(d.path(), &m, &s, false).is_err());
assert!(!d.path().join("Wow.exe").exists());
assert!(load_state(d.path()).unwrap().version.is_none());
}
}
+172 -7
View File
@@ -67,7 +67,12 @@ pub fn targets(root: &Path, scope: Scope) -> Result<Targets> {
Scope::Bots => {
let conf = root.join("Core/configs/modules/mod_coa_playerbots.conf");
if !conf.is_file() {
return Err(Error::Invalid("CoA Companions (bots) are not installed on this server.".into()));
// The server ships the documented defaults as `.dist` and uses them until an active file exists: make it.
let dist = root.join("Core/configs/modules/mod_coa_playerbots.conf.dist");
if !dist.is_file() {
return Err(Error::Invalid("CoA Companions (bots) are not installed on this server.".into()));
}
fsx::atomic_write(&conf, &fs::read(&dist)?)?;
}
Ok(Targets { read: conf.clone(), writes: vec![conf], generated: None })
}
@@ -126,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) };
@@ -150,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);
@@ -323,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());
@@ -355,8 +387,70 @@ pub fn list_snapshots(meta_dir: &Path) -> Vec<SnapshotInfo> {
out
}
/// How many threads the world should use to update maps on this computer: half the logical processors, between 2 and 8.
/// Maps (continents, dungeons, battlegrounds) are updated in parallel, one thread per map, so more threads than the
/// number of maps in use bring nothing.
pub fn recommended_map_threads() -> u32 {
let cores = std::thread::available_parallelism().map(|n| n.get() as u32).unwrap_or(4);
(cores / 2).clamp(2, 8)
}
const PERFORMANCE_MARKER: &str = "performance-defaults-v1.done";
/// Once per server: switch the world to updating maps on several threads (`MapUpdate.Threads`), which the stock
/// configuration leaves at 1. A value the owner already raised is respected, and because this runs a single time
/// (a marker file in the Manager's folder for the server) a later choice to go back to 1 is never overridden.
/// Returns the new thread count when something was written.
pub fn ensure_performance_defaults(root: &Path, meta_dir: &Path) -> Result<Option<u32>> {
let marker = meta_dir.join(PERFORMANCE_MARKER);
if marker.exists() {
return Ok(None);
}
let view = load(root, Scope::Server)?;
let current = view.settings.iter().find(|s| s.meta.key == "MapUpdate.Threads");
let already = current.map(|s| s.present && s.value.as_i64().unwrap_or(1) > 1).unwrap_or(false);
let threads = recommended_map_threads();
let written = if already {
None
} else {
let changes = BTreeMap::from([("MapUpdate.Threads".to_string(), Value::from(threads))]);
save(root, meta_dir, Scope::Server, &changes)?;
Some(threads)
};
let quieted = quiet_debug_loggers(root)?;
fsx::atomic_write(&marker, b"MapUpdate.Threads and logging levels set by the Manager\n")?;
tracing::info!(?written, ?quieted, "performance defaults applied");
Ok(written)
}
/// Loggers some configurations leave at debug level: `network` writes a line for every packet sent and
/// `entities.player` one for every item check. With companions that is thousands of lines a second, each a disk write.
/// They are put back to info level (the next level up); anything else in the file is untouched.
fn quiet_debug_loggers(root: &Path) -> Result<Vec<String>> {
let mut changed = Vec::new();
for path in targets(root, Scope::Server)?.writes {
let mut conf = ConfFile::parse_bytes(&fs::read(&path)?)?;
let mut touched = false;
for key in ["Logger.network", "Logger.entities.player"] {
let Some(value) = conf.get(key).map(|v| v.trim().to_string()) else { continue };
if let Some(rest) = value.strip_prefix("5,") {
conf.set(key, &format!("4,{rest}"), &["Lowered from debug by CoA Server Manager: it wrote a line for every packet and item check"]);
touched = true;
if !changed.contains(&key.to_string()) {
changed.push(key.to_string());
}
}
}
if touched {
fsx::atomic_write(&path, conf.to_text().as_bytes())?;
}
}
Ok(changed)
}
/// 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)?;
@@ -508,6 +602,38 @@ mod tests {
pairs.iter().map(|(k, v)| (k.to_string(), v.clone())).collect()
}
#[test]
fn the_world_gets_several_map_threads_once_and_an_owner_choice_is_never_overridden() {
let (_d, root, meta) = fixture();
let wanted = recommended_map_threads();
assert!((2..=8).contains(&wanted));
for p in ["Settings/worldserver.conf.template", "Core/configs/worldserver.conf"] {
let mut t = fs::read_to_string(root.join(p)).unwrap();
t.push_str("Logger.network=5,Server\r\nLogger.entities.player=5,Server\r\nLogger.module=4,Console Server\r\n");
fs::write(root.join(p), t).unwrap();
}
assert_eq!(ensure_performance_defaults(&root, &meta).unwrap(), Some(wanted));
for p in ["Settings/worldserver.conf.template", "Core/configs/worldserver.conf"] {
let t = fs::read_to_string(root.join(p)).unwrap();
assert!(t.contains(&format!("MapUpdate.Threads = {wanted}")), "{p}: {t}");
assert!(t.contains("Unknown.Custom = \"keep me\""), "other settings untouched");
assert!(t.contains("Logger.network=4,Server") && t.contains("Logger.entities.player=4,Server"), "{p}: {t}");
assert!(t.contains("Logger.module=4,Console Server"), "info level loggers are left alone");
}
// the owner goes back to one thread: it stays that way
save(&root, &meta, Scope::Server, &set(&[("MapUpdate.Threads", json!(1))])).unwrap();
assert_eq!(ensure_performance_defaults(&root, &meta).unwrap(), None);
assert!(fs::read_to_string(root.join("Core/configs/worldserver.conf")).unwrap().contains("MapUpdate.Threads = 1"));
}
#[test]
fn an_already_raised_value_is_respected_on_the_first_run() {
let (_d, root, meta) = fixture();
save(&root, &meta, Scope::Server, &set(&[("MapUpdate.Threads", json!(6))])).unwrap();
assert_eq!(ensure_performance_defaults(&root, &meta).unwrap(), None);
assert!(fs::read_to_string(root.join("Core/configs/worldserver.conf")).unwrap().contains("MapUpdate.Threads = 6"));
}
#[test]
fn missing_module_configs_are_created_from_their_dist_and_existing_ones_are_kept() {
let (_d, root, _m) = fixture();
@@ -532,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] {
@@ -618,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();
@@ -660,9 +819,15 @@ Logger.x=6,Console Server
}
#[test]
fn bots_scope_requires_the_module_config() {
fn bots_scope_requires_the_module_config_or_its_default_file() {
let (_d, root, _m) = fixture();
fs::remove_file(root.join("Core/configs/modules/mod_coa_playerbots.conf")).unwrap();
assert!(load(&root, Scope::Bots).is_err());
let modules = root.join("Core/configs/modules");
let conf = modules.join("mod_coa_playerbots.conf");
let text = fs::read(&conf).unwrap();
fs::remove_file(&conf).unwrap();
assert!(load(&root, Scope::Bots).is_err(), "neither file: not installed");
fs::write(modules.join("mod_coa_playerbots.conf.dist"), &text).unwrap();
assert!(load(&root, Scope::Bots).is_ok(), "only the default file: it is made");
assert!(conf.is_file());
}
}
+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;");
}
}
+66 -2
View File
@@ -143,6 +143,31 @@ fn tail(path: &Path, max: u64) -> Vec<u8> {
b
}
/// Keep the first line of each repeated "Missing property X" warning and report how often it came.
pub fn squash_repeated_config_warnings(text: &str) -> String {
let mut counts: Vec<(String, usize)> = Vec::new();
let mut out: Vec<&str> = Vec::new();
for line in text.lines() {
let key = line.strip_prefix("> Config: Missing property ").and_then(|r| r.split_whitespace().next());
match key {
Some(k) => match counts.iter_mut().find(|(n, _)| n == k) {
Some((_, c)) => *c += 1,
None => {
counts.push((k.to_string(), 1));
out.push(line);
}
},
None => out.push(line),
}
}
let mut s = out.join("\n");
for (k, c) in counts.iter().filter(|(_, c)| *c > 1) {
s.push_str(&format!("
[Manager: \"Missing property {k}\" was logged {c} times in this excerpt]"));
}
s
}
/// Remove things that must never leave the machine from log text.
pub fn redact(text: &str) -> String {
let mut out = Vec::new();
@@ -177,9 +202,33 @@ pub fn export_package(root: &Path, meta_dir: &Path, manager_log: &Path, meta: &I
});
add("summary.json", serde_json::to_string_pretty(&summary)?.as_bytes())?;
for (name, path) in [("manager.log", manager_log.to_path_buf()), ("manager-install.log", meta_dir.join("logs/manager.log")), ("Server.log.tail", root.join("Core/Logs/Server.log")), ("Errors.log.tail", root.join("Core/Logs/Errors.log")), ("Auth.log.tail", root.join("Core/Logs/Auth.log")), ("world-console.log.tail", root.join("Core/Logs/world-console.log")), ("mysql-error.log.tail", root.join("mysql/logs/mysql-error.log"))] {
let bytes = tail(&path, 512 * 1024);
// A module that reads a missing setting on every tick fills a log with one warning, thousands of times; read far
// enough back to see past that, fold the repeats, then keep the last part.
let bytes = tail(&path, 8 * 1024 * 1024);
if !bytes.is_empty() {
add(name, redact(&String::from_utf8_lossy(&bytes)).as_bytes())?;
let text = squash_repeated_config_warnings(&String::from_utf8_lossy(&bytes));
let keep = text.len().saturating_sub(512 * 1024);
let start = (keep..text.len()).find(|i| text.is_char_boundary(*i)).unwrap_or(text.len());
add(name, redact(&text[start..]).as_bytes())?;
}
}
// Which files the server's own configuration folders hold, and the two CoA switches that decide whether the game
// client can talk to the world server at all.
let mut present = String::new();
for dir in ["Core/configs", "Core/configs/modules", "Core/Logs"] {
if let Ok(rd) = fs::read_dir(root.join(dir)) {
let mut names: Vec<String> = rd.flatten().filter(|e| e.path().is_file()).map(|e| format!("{dir}/{} ({} bytes)", e.file_name().to_string_lossy(), e.metadata().map(|m| m.len()).unwrap_or(0))).collect();
names.sort();
present.push_str(&names.join("\n"));
present.push('\n');
}
}
add("files.txt", present.as_bytes())?;
if let Ok(b) = fs::read(root.join("Core/configs/modules/coa.conf")) {
if let Ok(c) = ConfFile::parse_bytes(&b) {
let wanted = ["CoA.Enable", "CoA.AllowRemoteClients", "CoA.MapClass10ToWarrior"];
let lines: Vec<String> = c.entries().filter(|(k, _)| wanted.contains(k)).map(|(k, v)| format!("{k} = {v}")).collect();
add("coa.conf.txt", lines.join("\n").as_bytes())?;
}
}
// Which settings exist, never their values.
@@ -210,6 +259,21 @@ mod tests {
use super::*;
use crate::registry::{InstallKind, InstallMeta};
#[test]
fn repeated_config_warnings_are_folded() {
let t = "start
> Config: Missing property A.B in config file x or module config, add y
> Config: Missing property A.B in config file x
real error
> Config: Missing property C.D in config file x
> Config: Missing property A.B in config file x";
let out = squash_repeated_config_warnings(t);
assert_eq!(out.matches("Missing property A.B in config file").count(), 1);
assert!(out.contains("real error") && out.contains("C.D"));
assert!(out.contains("\"Missing property A.B\" was logged 3 times"));
assert!(!out.contains("C.D\" was logged"));
}
#[test]
fn redaction_removes_lines_that_could_carry_secrets() {
let t = redact("normal line\nLoginDatabaseInfo = \"127.0.0.1;3307;acore;PASS;db\"\nRa.Password=abc\nother");
@@ -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,
})
}
+26 -1
View File
@@ -35,7 +35,7 @@ impl Cancel {
pub fn cancel(&self) {
self.0.store(true, Ordering::SeqCst);
}
fn is_set(&self) -> bool {
pub fn is_set(&self) -> bool {
self.0.load(Ordering::SeqCst)
}
}
@@ -70,6 +70,17 @@ pub trait Transport {
pub struct HttpTransport(reqwest::blocking::Client);
impl HttpTransport {
/// For small documents (manifests): gives up when the server stalls instead of waiting forever.
pub fn with_total_timeout(secs: u64) -> Result<Self> {
reqwest::blocking::Client::builder()
.connect_timeout(Duration::from_secs(15))
.timeout(Duration::from_secs(secs))
.redirect(reqwest::redirect::Policy::limited(5))
.build()
.map(HttpTransport)
.map_err(|e| Error::Invalid(e.to_string()))
}
pub fn new() -> Result<Self> {
reqwest::blocking::Client::builder()
.connect_timeout(Duration::from_secs(15))
@@ -130,6 +141,10 @@ fn attempt(client: &dyn Transport, job: &Job, part: &Path, cancel: &Cancel, on_p
have = 0;
}
if have == job.size {
if !part.exists() {
// an empty file: nothing to request
File::create(part)?;
}
return finish(job, part, hasher);
}
@@ -378,6 +393,16 @@ mod tests {
assert!(part_path(&j.dest).exists(), "partial data is kept for the next try");
}
#[test]
fn an_empty_file_needs_no_request_and_is_still_created() {
let dir = tempfile::tempdir().unwrap();
let j = job(dir.path(), b"");
let m = Mock::new(Vec::new(), 0, true);
fetch_with(&m, &j, &Cancel::default(), &|_| {}).unwrap();
assert_eq!(fs::read(&j.dest).unwrap(), Vec::<u8>::new());
assert_eq!(m.calls.load(Ordering::SeqCst), 0);
}
#[test]
fn only_https_or_loopback_http_is_allowed() {
assert!(check_url("https://github.com/x").is_ok());
+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[..]
+93 -5
View File
@@ -101,19 +101,24 @@ pub struct ScanReport {
pub database_schemas: Vec<String>,
pub client: Option<ClientInfo>,
pub notes: Vec<String>,
/// When the chosen folder is not a server but a repack's main folder is right next to it (its parent, or a folder
/// inside it): the folder the person most likely meant.
pub suggested_path: Option<String>,
/// "not-repack": a server was found but it is not laid out like the CoA Repack the Manager works with.
pub hint: Option<&'static str>,
/// Always false: a scan never modifies anything.
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;
@@ -187,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)
@@ -199,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();
@@ -224,7 +232,10 @@ pub fn scan(root: &Path) -> Result<ScanReport> {
.collect();
database_schemas.sort();
let bot_conf = modules_dir.join("mod_coa_playerbots.conf");
// A fresh repack ships `mod_coa_playerbots.conf.dist` and only writes the active file when someone changes it.
let bot_active = modules_dir.join("mod_coa_playerbots.conf");
let bot_dist = modules_dir.join("mod_coa_playerbots.conf.dist");
let bot_conf = if bot_active.is_file() { bot_active } else { bot_dist };
let bot_config_keys = count_bot_keys(&bot_conf);
let banner_revision = banner_revision_in_log(&root.join("Core/Logs/Server.log"));
@@ -294,6 +305,16 @@ pub fn scan(root: &Path) -> Result<ScanReport> {
notes.push("This looks like a game client folder, not a server folder.".into());
}
let (suggested_path, hint) = if classification == Classification::Incompatible && !looks_like_client {
match find_repack_nearby(&root) {
Some(p) => (Some(p.to_string_lossy().into_owned()), None),
None if root.join("worldserver.exe").is_file() || has_exes => (None, Some("not-repack")),
None => (None, None),
}
} else {
(None, None)
};
Ok(ScanReport {
path: root.to_string_lossy().into_owned(),
classification,
@@ -308,10 +329,34 @@ pub fn scan(root: &Path) -> Result<ScanReport> {
database_schemas,
client,
notes,
suggested_path,
hint,
modifies_files: false,
})
}
fn is_repack_root(p: &Path) -> bool {
p.join("Core/worldserver.exe").is_file() && p.join("Scripts/manage.py").is_file()
}
/// People often pick the `Core` folder (it holds worldserver.exe) or the folder an archive was unpacked into, with the real
/// server one level inside. Look at the parent, then at the folders inside (two levels), for the repack's main folder.
fn find_repack_nearby(root: &Path) -> Option<PathBuf> {
if let Some(parent) = root.parent() {
if is_repack_root(parent) {
return Some(parent.to_path_buf());
}
}
let subdirs = |dir: &Path| -> Vec<PathBuf> {
fs::read_dir(dir).map(|rd| rd.flatten().map(|e| e.path()).filter(|p| p.is_dir()).take(200).collect()).unwrap_or_default()
};
let first = subdirs(root);
if let Some(p) = first.iter().find(|p| is_repack_root(p)) {
return Some(p.clone());
}
first.iter().flat_map(|d| subdirs(d)).find(|p| is_repack_root(p))
}
/// Paths of the executables used by an installation, if present.
pub fn executables(root: &Path) -> (PathBuf, PathBuf, PathBuf) {
(root.join("Core/worldserver.exe"), root.join("Core/authserver.exe"), root.join("mysql/bin/mysqld.exe"))
@@ -405,6 +450,49 @@ mod tests {
assert_eq!(scan(&root).unwrap().classification, Classification::UnknownCustom);
}
#[test]
fn the_core_folder_or_an_outer_folder_points_at_the_real_server_folder() {
let dir = tempfile::tempdir().unwrap();
let repack = dir.path().join("CoA-Repack");
testkit::fake_repack(&repack);
let core = scan(&repack.join("Core")).unwrap();
assert_eq!(core.classification, Classification::Incompatible);
assert!(Path::new(core.suggested_path.as_deref().unwrap()).ends_with("CoA-Repack"));
let outer = tempfile::tempdir().unwrap();
testkit::fake_repack(&outer.path().join("unpacked").join("CoA-Repack"));
let r = scan(outer.path()).unwrap();
assert_eq!(r.classification, Classification::Incompatible);
assert!(Path::new(r.suggested_path.as_deref().unwrap()).ends_with("CoA-Repack"), "found two levels down");
let healthy = scan(&repack).unwrap();
assert!(healthy.suggested_path.is_none() && healthy.hint.is_none());
}
#[test]
fn a_plain_azerothcore_folder_is_told_apart_from_a_wrong_folder() {
let dir = tempfile::tempdir().unwrap();
let plain = dir.path().join("acore");
fs::create_dir_all(&plain).unwrap();
fs::write(plain.join("worldserver.exe"), b"w").unwrap();
let r = scan(&plain).unwrap();
assert_eq!(r.classification, Classification::Incompatible);
assert!(r.suggested_path.is_none());
assert_eq!(r.hint, Some("not-repack"));
}
#[test]
fn the_companions_are_found_by_their_documented_default_file_when_no_active_one_exists() {
let dir = tempfile::tempdir().unwrap();
let root = dir.path().join("repack");
testkit::fake_repack(&root);
let modules = root.join("Core/configs/modules");
fs::rename(modules.join("mod_coa_playerbots.conf"), modules.join("mod_coa_playerbots.conf.dist")).unwrap();
let r = scan(&root).unwrap();
assert!(r.items.iter().any(|i| i.key == "companions" && i.status == Status::Found), "found through the .dist");
assert_eq!(r.bot_config_keys, 2);
}
#[test]
fn missing_folder_is_an_error_not_a_verdict() {
assert!(scan(Path::new("C:/definitely/not/here")).is_err());
+7
View File
@@ -1,11 +1,14 @@
pub mod accounts;
pub mod backup;
pub mod cleanbase;
pub mod companions;
pub mod client;
pub mod clientdl;
pub mod config;
pub mod console;
pub mod db;
pub mod diag;
pub mod docker;
pub mod download;
pub mod driver;
pub mod error;
@@ -24,6 +27,10 @@ pub mod migrations;
pub mod net;
pub mod package;
pub mod ra;
pub mod allsettings;
pub mod modules;
pub mod realmlist;
pub mod realms;
pub mod registry;
pub mod release;
pub mod update;
+411
View File
@@ -0,0 +1,411 @@
//! Optional server modules. They are compiled into the server; what the owner decides is whether each one is on and how it is
//! configured, which lives in `Core/configs/modules/<module>.conf` (the documented defaults are in the `.dist` beside it).
//! The list of known modules is a bundled catalog, so a module is added to the Manager by adding a few lines to it.
use std::collections::BTreeMap;
use std::fs;
use std::path::{Path, PathBuf};
use serde::{Deserialize, Serialize};
use crate::config::parser::ConfFile;
use crate::error::{Error, Result};
use crate::fsx;
static CATALOG: &str = include_str!("../../../modules/catalog.json");
#[derive(Debug, Clone, Deserialize)]
pub struct Entry {
pub id: String,
pub name: String,
/// language code -> text; "en" is always there.
pub description: BTreeMap<String, String>,
pub repo: String,
/// File in `Core/configs/modules` that holds this module's settings.
pub conf: String,
/// The name an older server build gave that file (used when `conf` is not there).
#[serde(default)]
pub alt_conf: Option<String>,
/// The setting that switches the whole module on or off (1 / 0). Empty for a part that cannot be switched off.
#[serde(default)]
pub enable_key: String,
/// Can be turned on and off here. A part the game client needs to talk to the server is only configured.
#[serde(default = "yes")]
pub switchable: bool,
/// What the module is when its setting is not in the file: a server from before the setting existed runs it.
#[serde(default = "yes")]
pub default_on: bool,
/// How far along it is: `early` (experimental, may change or break), `beta` (works, still being tested) or
/// `release` (stable); `soon` is a place held for a module that is planned but not part of any build yet.
#[serde(default = "release")]
pub status: String,
/// Which icon the page draws (a name the page knows).
#[serde(default)]
pub icon: String,
/// A page of the Manager that only makes sense while the module is on (it is hidden while it is off).
#[serde(default)]
pub page: Option<String>,
/// Not shown on the Modules page; its settings are offered elsewhere (a server setting card).
#[serde(default)]
pub hidden: bool,
}
fn yes() -> bool {
true
}
fn release() -> String {
"release".into()
}
#[derive(Deserialize)]
struct Catalog {
modules: Vec<Entry>,
}
pub fn catalog() -> Vec<Entry> {
serde_json::from_str::<Catalog>(CATALOG).map(|c| c.modules).unwrap_or_default()
}
fn entry_in(cat: &[Entry], id: &str) -> Result<Entry> {
cat.iter().find(|e| e.id == id).cloned().ok_or_else(|| Error::Invalid("That module is not known to the Manager.".into()))
}
fn dir(root: &Path) -> PathBuf {
root.join("Core/configs/modules")
}
fn read(path: &Path) -> Option<ConfFile> {
fs::read(path).ok().and_then(|b| ConfFile::parse_bytes(&b).ok())
}
fn truthy(v: &str) -> bool {
matches!(v.trim().trim_matches('"').to_ascii_lowercase().as_str(), "1" | "true" | "yes" | "on")
}
#[derive(Debug, Serialize)]
pub struct ModuleView {
pub id: String,
pub name: String,
pub description: BTreeMap<String, String>,
pub repo: String,
/// The module's configuration is present on this server (otherwise it is not part of this server build).
pub installed: bool,
pub enabled: bool,
pub switchable: bool,
pub status: String,
pub icon: String,
pub page: Option<String>,
pub hidden: bool,
pub compatibility: String,
}
pub fn list(root: &Path) -> Vec<ModuleView> {
list_in(&catalog(), root)
}
/// The configuration file name this server uses for the module: the current one, or the name an older build gave it.
fn conf_name(root: &Path, e: &Entry) -> String {
let there = |n: &str| dir(root).join(n).is_file() || dir(root).join(format!("{n}.dist")).is_file();
if there(&e.conf) {
return e.conf.clone();
}
match &e.alt_conf {
Some(alt) if there(alt) => alt.clone(),
_ => e.conf.clone(),
}
}
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| {
let name = conf_name(root, &e);
let conf = dir(root).join(&name);
let dist = dir(root).join(format!("{name}.dist"));
let installed = conf.is_file() || dist.is_file();
// 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: enabled && !blocked,
switchable: e.switchable && !blocked,
status: e.status,
icon: e.icon,
page: e.page,
hidden: e.hidden,
}
})
.collect()
}
/// The active file, created from its `.dist` when it does not exist yet.
fn active_file(root: &Path, e: &Entry) -> Result<PathBuf> {
let name = conf_name(root, e);
let conf = dir(root).join(&name);
if !conf.is_file() {
let dist = dir(root).join(format!("{name}.dist"));
if !dist.is_file() {
return Err(Error::Invalid("This module is not part of this server.".into()));
}
fsx::atomic_write(&conf, &fs::read(&dist)?)?;
}
Ok(conf)
}
fn backup(meta: &Path, conf: &Path) -> Result<()> {
let name = conf.file_name().map(|n| n.to_string_lossy().into_owned()).unwrap_or_default();
let to = meta.join("backups").join("modules").join(format!("{name}-{}", chrono::Utc::now().format("%Y%m%d-%H%M%S")));
fsx::atomic_write(&to, &fs::read(conf)?)
}
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)
}
fn set_enabled_in(cat: &[Entry], root: &Path, meta: &Path, id: &str, on: bool) -> Result<()> {
let e = entry_in(cat, id)?;
if !e.switchable || e.enable_key.is_empty() {
return Err(Error::Invalid("This part cannot be switched off.".into()));
}
let conf = active_file(root, &e)?;
let mut file = ConfFile::parse_bytes(&fs::read(&conf)?)?;
if file.get(&e.enable_key).map(truthy).unwrap_or(e.default_on) == on && file.get(&e.enable_key).is_some() {
return Ok(());
}
backup(meta, &conf)?;
file.set(&e.enable_key, if on { "1" } else { "0" }, &["Changed by CoA Server Manager"]);
fsx::atomic_write(&conf, file.to_text().as_bytes())?;
tracing::info!(module = id, on, "module switched");
Ok(())
}
#[derive(Debug, Serialize, PartialEq, Eq)]
pub struct Setting {
pub key: String,
pub value: String,
pub default: Option<String>,
/// The documentation the module ships above the setting.
pub doc: String,
}
/// Every active setting of the module with its current value, its documented default and its description.
pub fn settings(root: &Path, id: &str) -> Result<Vec<Setting>> {
settings_in(&catalog(), root, id)
}
fn settings_in(cat: &[Entry], root: &Path, id: &str) -> Result<Vec<Setting>> {
let e = entry_in(cat, id)?;
let name = conf_name(root, &e);
let conf = dir(root).join(&name);
let dist = read(&dir(root).join(format!("{name}.dist")));
let active = read(&conf).or_else(|| dist.clone()).ok_or_else(|| Error::Invalid("This module is not part of this server.".into()))?;
Ok(active
.entries()
.map(|(k, v)| Setting {
key: k.to_string(),
value: v.to_string(),
default: dist.as_ref().and_then(|d| d.get(k)).map(str::to_string),
doc: dist.as_ref().map(|d| d.doc_for(k)).filter(|d| !d.is_empty()).unwrap_or_else(|| active.doc_for(k)).join(" "),
})
.collect())
}
/// 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)
}
fn save_settings_in(cat: &[Entry], root: &Path, meta: &Path, id: &str, changes: &BTreeMap<String, String>) -> Result<Vec<String>> {
let e = entry_in(cat, id)?;
let conf = active_file(root, &e)?;
let mut file = ConfFile::parse_bytes(&fs::read(&conf)?)?;
let mut changed = Vec::new();
for (key, value) in changes {
let value = value.trim();
if file.get(key).is_none() {
return Err(Error::Invalid(format!("{key} is not a setting of this module.")));
}
if value.is_empty() || value.len() > 500 || value.chars().any(char::is_control) {
return Err(Error::Invalid(format!("The value of {key} must be one line of text.")));
}
if file.get(key).map(str::trim) != Some(value) {
changed.push((key.clone(), value.to_string()));
}
}
if changed.is_empty() {
return Ok(Vec::new());
}
backup(meta, &conf)?;
for (k, v) in &changed {
file.set(k, v, &[]);
}
fsx::atomic_write(&conf, file.to_text().as_bytes())?;
Ok(changed.into_iter().map(|(k, _)| k).collect())
}
#[cfg(test)]
mod tests {
use super::*;
fn test_catalog() -> Vec<Entry> {
let one = |id: &str, name: &str, conf: &str, key: &str| Entry {
id: id.into(),
name: name.into(),
description: ["en", "ru", "de", "fr", "es"].iter().map(|l| (l.to_string(), format!("{name} ({l})"))).collect(),
repo: format!("https://github.com/Corfirean/example/{id}"),
conf: conf.into(),
alt_conf: None,
enable_key: key.into(),
switchable: true,
default_on: true,
status: "beta".into(),
icon: String::new(),
page: None,
hidden: false,
};
vec![one("war-games", "War Games", "war_games.conf", "WarGames.Enable"), one("spellbook", "Spellbook", "spellbook.conf", "Spellbook.Enable")]
}
fn server(d: &Path) -> (PathBuf, PathBuf) {
let (root, meta) = (d.join("srv"), d.join("meta"));
let m = dir(&root);
fs::create_dir_all(&m).unwrap();
fs::create_dir_all(&meta).unwrap();
fs::write(m.join("war_games.conf.dist"), "# Turns War Games on.\r\n# Second line.\r\nWarGames.Enable = 1\r\n\r\n# How long a challenge stays open.\r\nWarGames.ChallengeSeconds = 60\r\n").unwrap();
(root, meta)
}
#[test]
fn the_bundled_catalog_is_valid() {
let c = catalog();
// it may be empty (modules are added to it one by one); whatever is in it must be complete
for e in &c {
assert!(e.description.contains_key("en") && e.description.len() == 5, "{} has all five descriptions", e.id);
assert!(e.repo.starts_with("https://github.com/") && e.conf.ends_with(".conf"), "{}", e.id);
assert!(!e.switchable || e.enable_key.ends_with(".Enable"), "{} needs the setting that switches it", e.id);
assert!(["soon", "early", "beta", "release"].contains(&e.status.as_str()), "{} has an unknown status", e.id);
assert!(e.status != "soon" || !e.switchable, "{} is only announced, so it cannot be switched", e.id);
}
let mut ids: Vec<_> = c.iter().map(|e| e.id.as_str()).collect();
ids.sort();
ids.dedup();
assert_eq!(ids.len(), c.len(), "ids are unique");
}
#[test]
fn a_module_is_listed_as_installed_with_its_documented_default_until_a_file_exists() {
let d = tempfile::tempdir().unwrap();
let (root, _) = server(d.path());
let wg = list_in(&test_catalog(), &root).into_iter().find(|m| m.id == "war-games").unwrap();
assert!(wg.installed && wg.enabled, "the .dist says 1");
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();
let (root, meta) = server(d.path());
set_enabled_in(&test_catalog(), &root, &meta, "war-games", false).unwrap();
let conf = fs::read_to_string(dir(&root).join("war_games.conf")).unwrap();
assert!(conf.contains("WarGames.Enable = 0") && conf.contains("WarGames.ChallengeSeconds = 60"), "{conf}");
assert!(!list_in(&test_catalog(), &root).into_iter().find(|m| m.id == "war-games").unwrap().enabled);
set_enabled_in(&test_catalog(), &root, &meta, "war-games", false).unwrap();
assert_eq!(fs::read_dir(meta.join("backups/modules")).unwrap().count(), 1, "no change, no backup");
set_enabled_in(&test_catalog(), &root, &meta, "war-games", true).unwrap();
assert!(fs::read_to_string(dir(&root).join("war_games.conf")).unwrap().contains("WarGames.Enable = 1"));
assert!(set_enabled_in(&test_catalog(), &root, &meta, "spellbook", true).is_err(), "not part of this server");
assert!(set_enabled_in(&test_catalog(), &root, &meta, "nonsense", true).is_err());
}
#[test]
fn settings_show_the_documentation_and_only_known_keys_with_one_line_values_can_be_saved() {
let d = tempfile::tempdir().unwrap();
let (root, meta) = server(d.path());
let s = settings_in(&test_catalog(), &root, "war-games").unwrap();
assert_eq!(s.len(), 2);
assert_eq!(s[1], Setting { key: "WarGames.ChallengeSeconds".into(), value: "60".into(), default: Some("60".into()), doc: "How long a challenge stays open.".into() });
assert_eq!(s[0].doc, "Turns War Games on. Second line.");
let ok = BTreeMap::from([("WarGames.ChallengeSeconds".to_string(), "90".to_string())]);
assert_eq!(save_settings_in(&test_catalog(), &root, &meta, "war-games", &ok).unwrap(), ["WarGames.ChallengeSeconds"]);
assert!(settings_in(&test_catalog(), &root, "war-games").unwrap()[1].value == "90");
assert!(save_settings_in(&test_catalog(), &root, &meta, "war-games", &ok).unwrap().is_empty(), "same value: nothing to do");
for bad in [("Other.Key", "1"), ("WarGames.ChallengeSeconds", ""), ("WarGames.ChallengeSeconds", "1\nInjected = 1")] {
let c = BTreeMap::from([(bad.0.to_string(), bad.1.to_string())]);
assert!(save_settings_in(&test_catalog(), &root, &meta, "war-games", &c).is_err(), "{bad:?}");
}
assert!(!fs::read_to_string(dir(&root).join("war_games.conf")).unwrap().contains("Injected"));
}
#[test]
fn an_older_file_name_is_used_when_the_current_one_is_missing_and_a_part_that_cannot_be_switched_stays_on() {
let d = tempfile::tempdir().unwrap();
let (root, meta) = server(d.path());
fs::write(dir(&root).join("old_name.conf"), "CoA.Enable = 0\r\nCoA.UnlockAllVanity = 1\r\n").unwrap();
let compat = Entry {
id: "compat".into(),
name: "Compat".into(),
description: ["en", "ru", "de", "fr", "es"].iter().map(|l| (l.to_string(), "x".to_string())).collect(),
repo: "https://github.com/Corfirean/x".into(),
conf: "coa.conf".into(),
alt_conf: Some("old_name.conf".into()),
enable_key: String::new(),
switchable: false,
default_on: true,
status: "release".into(),
icon: String::new(),
page: None,
hidden: false,
};
let cat = vec![compat];
let v = list_in(&cat, &root).remove(0);
assert!(v.installed && v.enabled && !v.switchable, "found under the old name, never reported as off");
assert_eq!(settings_in(&cat, &root, "compat").unwrap().len(), 2);
let change = BTreeMap::from([("CoA.UnlockAllVanity".to_string(), "0".to_string())]);
assert_eq!(save_settings_in(&cat, &root, &meta, "compat", &change).unwrap(), ["CoA.UnlockAllVanity"]);
assert!(fs::read_to_string(dir(&root).join("old_name.conf")).unwrap().contains("CoA.UnlockAllVanity = 0"));
assert!(set_enabled_in(&cat, &root, &meta, "compat", false).is_err(), "cannot be switched off");
}
#[test]
fn a_module_whose_setting_is_not_in_the_file_counts_as_on_and_can_be_switched_off() {
let d = tempfile::tempdir().unwrap();
let (root, meta) = server(d.path());
fs::write(dir(&root).join("war_games.conf"), "WarGames.ChallengeSeconds = 60\r\n").unwrap();
let cat = test_catalog();
assert!(list_in(&cat, &root).into_iter().find(|m| m.id == "war-games").unwrap().enabled, "a missing key means the default (on)");
set_enabled_in(&cat, &root, &meta, "war-games", false).unwrap();
assert!(fs::read_to_string(dir(&root).join("war_games.conf")).unwrap().contains("WarGames.Enable = 0"));
assert!(!list_in(&cat, &root).into_iter().find(|m| m.id == "war-games").unwrap().enabled);
}
}
+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();
+32 -4
View File
@@ -53,20 +53,48 @@ pub fn fetch_manifest(source: &Source, trusted_key: &str) -> Result<(Manifest, V
/// Make every archive part available in a verified folder: a local source is used in place, a remote one is
/// downloaded (resumable) into `download_dir`. `report(fraction 0..1, speed_text)`.
/// 1536 -> "1.5 KB", 6.3e9 -> "5.9 GB" (binary units, as drive sizes are shown).
pub fn human_bytes(n: u64) -> String {
let units = ["B", "KB", "MB", "GB", "TB"];
let mut v = n as f64;
let mut i = 0;
while v >= 1024.0 && i < units.len() - 1 {
v /= 1024.0;
i += 1;
}
if i == 0 || v >= 100.0 { format!("{} {}", v.round() as u64, units[i]) } else { format!("{v:.1} {}", units[i]) }
}
pub fn fetch_parts(source: &Source, manifest: &Manifest, download_dir: &Path, cancel: &Cancel, report: &dyn Fn(f64, Option<String>)) -> Result<PathBuf> {
let archive = manifest.archive.as_ref().ok_or_else(|| Error::InvalidManifest("manifest has no archive".into()))?;
match source {
Source::Dir(d) => Ok(d.clone()),
Source::Url(base) => {
let total = archive.parts.len();
for (i, part) in archive.parts.iter().enumerate() {
let all: u64 = archive.parts.iter().map(|p| p.size).sum::<u64>().max(1);
let mut before = 0u64;
for part in archive.parts.iter() {
let job = Job { url: format!("{}/{}", base.trim_end_matches('/'), part.name), dest: download_dir.join(&part.name), sha256: part.sha256.clone(), size: part.size };
download::fetch(&job, cancel, &|p: Progress| {
let frac = (i as f64 + p.downloaded as f64 / p.total.max(1) as f64) / total as f64;
report(frac, Some(format!("{:.1} MB/s", p.bytes_per_sec as f64 / 1e6)));
let done = before + p.downloaded.min(part.size);
// language-neutral so the screen can show it as it is: "3.1 GB / 5.9 GB · 40.6 MB/s"
report(done as f64 / all as f64, Some(format!("{} / {} \u{b7} {:.1} MB/s", human_bytes(done), human_bytes(all), p.bytes_per_sec as f64 / 1e6)));
})?;
before += part.size;
}
Ok(download_dir.to_path_buf())
}
}
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn sizes_are_shown_in_binary_units() {
assert_eq!(human_bytes(0), "0 B");
assert_eq!(human_bytes(1536), "1.5 KB");
assert_eq!(human_bytes(6 * (1 << 30)), "6.0 GB");
assert_eq!(human_bytes(150 * (1 << 20)), "150 MB");
}
}
+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 {
+64
View File
@@ -138,6 +138,30 @@ impl Ra {
Ok(out.lines().last().unwrap_or("").to_string())
}
/// Set a new password for an existing account.
pub fn set_account_password(&mut self, name: &str, password: &str) -> Result<()> {
validate_account(name, password)?;
let out = self.command(&format!("account set password {name} {password} {password}"))?;
account_reply(&out, "The password was not changed")
}
/// Access level of an account on all realms: 0 player, 1 moderator, 2 game master, 3 administrator.
pub fn set_account_access(&mut self, name: &str, level: u8) -> Result<()> {
validate_account(name, "placeholder")?;
if level > 3 {
return Err(Error::Invalid("The access level must be 0 to 3.".into()));
}
let out = self.command(&format!("account set gmlevel {name} {level} -1"))?;
account_reply(&out, "The access level was not changed")
}
/// Delete an account together with its characters (the console's `account delete`).
pub fn delete_account(&mut self, name: &str) -> Result<()> {
validate_account(name, "placeholder")?;
let out = self.command(&format!("account delete {name}"))?;
account_reply(&out, "The account was not deleted")
}
/// Give `name` administrator rights on all realms (GM level 3).
pub fn make_administrator(&mut self, name: &str) -> Result<()> {
validate_account(name, "placeholder")?;
@@ -150,6 +174,16 @@ impl Ra {
}
}
/// The console reports a failed account command in words; anything else (including silence) counts as done.
fn account_reply(out: &str, what: &str) -> Result<()> {
let l = out.to_lowercase();
let failed = ["does not exist", "not exist", "not found", "do not match", "don't match", "usage", "unknown", "incorrect", "error"];
if failed.iter().any(|m| l.contains(m)) {
return Err(Error::Invalid(format!("{what}: {}", out.lines().last().unwrap_or("").trim())));
}
Ok(())
}
/// The console answers an unknown sub-command with the list of the ones it knows.
fn is_unsupported_command(out: &str) -> bool {
let l = out.to_lowercase();
@@ -287,6 +321,36 @@ AC>";
assert_eq!(h.join().unwrap(), ["local", "secretra", "account create Player1 hunter22"]);
}
#[test]
fn changes_a_password_with_the_expected_command() {
let _lock = serial();
let (port, h) = fake_ra("The password was changed");
let mut ra = Ra::connect_to(port, "u", "p").unwrap();
ra.set_account_password("Player1", "newpass9").unwrap();
drop(ra);
assert_eq!(h.join().unwrap()[2], "account set password Player1 newpass9 newpass9");
}
#[test]
fn changes_an_access_level_with_the_expected_command() {
let _lock = serial();
let (port, h) = fake_ra("You have changed security level of Player1 to 2.");
let mut ra = Ra::connect_to(port, "u", "p").unwrap();
ra.set_account_access("Player1", 2).unwrap();
assert!(ra.set_account_access("Player1", 4).is_err(), "only 0 to 3");
drop(ra);
assert_eq!(h.join().unwrap()[2], "account set gmlevel Player1 2 -1");
}
#[test]
fn a_failed_account_command_is_reported_and_bad_names_never_reach_the_console() {
let _lock = serial();
let (port, _h) = fake_ra("Account not found.");
let mut ra = Ra::connect_to(port, "u", "p").unwrap();
assert!(ra.set_account_password("x", "newpass9").is_err(), "the name is validated before anything is sent");
assert!(ra.set_account_password("Nobody", "newpass9").unwrap_err().to_string().contains("not found"));
}
#[test]
fn spawn_bots_sends_only_a_bounded_number() {
let _lock = serial();
+235
View File
@@ -0,0 +1,235 @@
//! Named realmlists for the game client ("Solo" for your own server, "PTR" for the shared one, ...). Choosing one writes its
//! text into the client's `Data/<locale>/realmlist.wtf` files; the file that was there is saved first. The profiles live
//! in the Manager's folder for the server, never in the client.
use std::fs;
use std::path::Path;
use serde::{Deserialize, Serialize};
use crate::client;
use crate::error::{Error, Result};
use crate::fsx;
const FILE: &str = "realmlists.json";
const MAX_PROFILES: usize = 24;
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct Profile {
pub id: String,
pub name: String,
/// The text of `realmlist.wtf` (normalised: `set <name> <value>` lines).
pub data: String,
}
#[derive(Debug, Default, Serialize, Deserialize)]
struct Store {
profiles: Vec<Profile>,
}
#[derive(Debug, Serialize)]
pub struct View {
pub profiles: Vec<Profile>,
/// The profile whose text every realmlist file of the client currently holds.
pub active: Option<String>,
}
fn compact(text: &str) -> String {
text.lines().map(|l| l.trim().to_ascii_lowercase()).filter(|l| !l.is_empty()).collect::<Vec<_>>().join("\n")
}
/// Accept either the whole file text or just an address ("play.example.com", "192.168.0.5:3724"), and make sure that
/// what is written into the client is nothing but `set <name> <value>` lines.
pub fn normalize(data: &str) -> Result<String> {
let bad = |m: &str| Err(Error::Invalid(m.into()));
let text = data.trim();
if text.is_empty() {
return bad("Enter the realmlist text or an address.");
}
if text.len() > 2000 {
return bad("That text is too long for a realmlist.");
}
let lines: Vec<String> = if !text.contains(char::is_whitespace) {
vec![format!("set realmlist {text}")]
} else {
text.lines().map(|l| l.trim().to_string()).filter(|l| !l.is_empty()).collect()
};
for line in &lines {
let mut parts = line.splitn(3, char::is_whitespace);
let (set, key, value) = (parts.next().unwrap_or(""), parts.next().unwrap_or(""), parts.next().unwrap_or("").trim());
if !set.eq_ignore_ascii_case("set") || key.is_empty() || value.is_empty() || !key.chars().all(|c| c.is_ascii_alphanumeric() || c == '_') {
return bad("Each line must look like: set realmlist 127.0.0.1");
}
if !value.chars().all(|c| c.is_ascii_graphic() || c == ' ') {
return bad("The realmlist may only use plain letters, digits and punctuation.");
}
if key.eq_ignore_ascii_case("realmlist") && !value.trim_matches('"').chars().all(|c| c.is_ascii_alphanumeric() || matches!(c, '.' | '-' | ':' | '_')) {
return bad("That address is not valid.");
}
}
Ok(lines.join("\r\n") + "\r\n")
}
fn slug(name: &str) -> String {
let s: String = name.to_ascii_lowercase().chars().map(|c| if c.is_ascii_alphanumeric() { c } else { '-' }).collect();
let s = s.trim_matches('-').to_string();
if s.is_empty() { "realm".into() } else { s }
}
fn load(meta: &Path, client_dir: Option<&Path>) -> Store {
let mut store: Store = fsx::read_json(&meta.join(FILE)).unwrap_or_default();
if store.profiles.is_empty() {
// First use: "Solo" for this computer, and what the client held before so that it can be switched back to.
store.profiles.push(Profile { id: "solo".into(), name: "Solo".into(), data: "set realmlist 127.0.0.1\r\n".into() });
if let Some(files) = client_dir.map(client::realmlist_files) {
if let Some(text) = files.iter().find_map(|f| fs::read_to_string(f).ok()) {
if let Ok(data) = normalize(&text) {
if compact(&data) != compact(&store.profiles[0].data) {
store.profiles.push(Profile { id: "previous".into(), name: "Previous".into(), data });
}
}
}
}
let _ = fsx::atomic_write_json(&meta.join(FILE), &store);
}
store
}
fn save_store(meta: &Path, store: &Store) -> Result<()> {
fsx::atomic_write_json(&meta.join(FILE), store)
}
pub fn view(meta: &Path, client_dir: Option<&Path>) -> View {
let store = load(meta, client_dir);
let active = client_dir.and_then(|c| {
let files = client::realmlist_files(c);
let texts: Vec<String> = files.iter().filter_map(|f| fs::read_to_string(f).ok()).map(|t| compact(&t)).collect();
let first = texts.first()?;
if texts.iter().any(|t| t != first) {
return None;
}
store.profiles.iter().find(|p| compact(&p.data) == *first).map(|p| p.id.clone())
});
View { profiles: store.profiles, active }
}
/// Add a profile (`id` None) or change one. Names are 1-32 characters and unique regardless of capitals.
pub fn save_profile(meta: &Path, client_dir: Option<&Path>, id: Option<&str>, name: &str, data: &str) -> Result<Profile> {
let name = name.trim();
if name.is_empty() || name.chars().count() > 32 || name.chars().any(char::is_control) {
return Err(Error::Invalid("The name must be 1 to 32 characters.".into()));
}
let data = normalize(data)?;
let mut store = load(meta, client_dir);
if store.profiles.iter().any(|p| p.name.eq_ignore_ascii_case(name) && Some(p.id.as_str()) != id) {
return Err(Error::Invalid("A realmlist with that name already exists.".into()));
}
let profile = match id {
Some(id) => {
let p = store.profiles.iter_mut().find(|p| p.id == id).ok_or_else(|| Error::Invalid("That realmlist does not exist.".into()))?;
p.name = name.to_string();
p.data = data;
p.clone()
}
None => {
if store.profiles.len() >= MAX_PROFILES {
return Err(Error::Invalid("There are too many realmlists; remove one first.".into()));
}
let mut new_id = slug(name);
while store.profiles.iter().any(|p| p.id == new_id) {
new_id.push('-');
}
let p = Profile { id: new_id, name: name.to_string(), data };
store.profiles.push(p.clone());
p
}
};
save_store(meta, &store)?;
Ok(profile)
}
pub fn delete_profile(meta: &Path, client_dir: Option<&Path>, id: &str) -> Result<()> {
let mut store = load(meta, client_dir);
if store.profiles.len() <= 1 {
return Err(Error::Invalid("The last realmlist cannot be removed.".into()));
}
store.profiles.retain(|p| p.id != id);
save_store(meta, &store)
}
/// Write the profile into the client; returns the files that changed (each was saved to the backup folder first).
pub fn activate(meta: &Path, client_dir: &Path, id: &str) -> Result<Vec<String>> {
let store = load(meta, Some(client_dir));
let profile = store.profiles.iter().find(|p| p.id == id).ok_or_else(|| Error::Invalid("That realmlist does not exist.".into()))?;
client::write_realmlist(client_dir, meta, &profile.data)
}
#[cfg(test)]
mod tests {
use super::*;
fn fake_client(d: &Path, host: &str) -> std::path::PathBuf {
let c = d.join("wow");
for loc in ["enUS", "ruRU"] {
fs::create_dir_all(c.join("Data").join(loc)).unwrap();
fs::write(c.join("Data").join(loc).join("realmlist.wtf"), format!("set realmlist {host}\r\nset patchlist x.example\r\n")).unwrap();
}
fs::write(c.join("Ascension.exe"), b"exe").unwrap();
c
}
#[test]
fn an_address_or_whole_lines_are_accepted_and_anything_else_is_not() {
assert_eq!(normalize("play.example.com").unwrap(), "set realmlist play.example.com\r\n");
assert_eq!(normalize("SET realmlist 192.168.0.5:3724\nset patchlist x.example\n").unwrap(), "SET realmlist 192.168.0.5:3724\r\nset patchlist x.example\r\n");
for bad in ["", " ", "rm -rf /", "set realmlist bad host;calc", "set realmlist", "x\ny", "set realmlist a\"b", &"a".repeat(2100)] {
assert!(normalize(bad).is_err(), "{bad:?}");
}
}
#[test]
fn the_first_use_offers_solo_and_what_the_client_had_and_the_active_one_is_recognised() {
let d = tempfile::tempdir().unwrap();
let (c, meta) = (fake_client(d.path(), "ptr.example.org"), d.path().join("meta"));
fs::create_dir_all(&meta).unwrap();
let v = view(&meta, Some(&c));
assert_eq!(v.profiles.iter().map(|p| p.name.as_str()).collect::<Vec<_>>(), ["Solo", "Previous"]);
assert_eq!(v.active.as_deref(), Some("previous"), "the files hold exactly what was captured");
assert!(activate(&meta, &c, "previous").unwrap().is_empty(), "already what the files hold");
assert_eq!(fs::read_to_string(c.join("Data/enUS/realmlist.wtf")).unwrap(), "set realmlist ptr.example.org\r\nset patchlist x.example\r\n");
}
#[test]
fn switching_writes_every_locale_saves_the_old_file_and_changes_nothing_else() {
let d = tempfile::tempdir().unwrap();
let (c, meta) = (fake_client(d.path(), "ptr.example.org"), d.path().join("meta"));
fs::create_dir_all(&meta).unwrap();
fs::write(c.join("WTF.txt"), b"mine").unwrap();
let ptr = save_profile(&meta, Some(&c), None, "PTR", "ptr.example.org").unwrap();
let changed = activate(&meta, &c, "solo").unwrap();
assert_eq!(changed.len(), 2);
for loc in ["enUS", "ruRU"] {
assert_eq!(fs::read_to_string(c.join("Data").join(loc).join("realmlist.wtf")).unwrap(), "set realmlist 127.0.0.1\r\n");
}
assert_eq!(view(&meta, Some(&c)).active.as_deref(), Some("solo"));
assert_eq!(fs::read_dir(meta.join("backups/client")).unwrap().count(), 2, "each replaced file was saved");
activate(&meta, &c, &ptr.id).unwrap();
assert_eq!(view(&meta, Some(&c)).active.as_deref(), Some(ptr.id.as_str()));
assert_eq!(fs::read(c.join("WTF.txt")).unwrap(), b"mine");
}
#[test]
fn names_are_unique_profiles_can_be_edited_and_the_last_one_stays() {
let d = tempfile::tempdir().unwrap();
let meta = d.path().join("meta");
fs::create_dir_all(&meta).unwrap();
let a = save_profile(&meta, None, None, "PTR", "ptr.example.org").unwrap();
assert!(save_profile(&meta, None, None, "ptr", "other.example.org").is_err(), "names are unique regardless of capitals");
let edited = save_profile(&meta, None, Some(&a.id), "PTR 2", "ptr2.example.org").unwrap();
assert_eq!((edited.id.as_str(), edited.data.as_str()), (a.id.as_str(), "set realmlist ptr2.example.org\r\n"));
assert!(save_profile(&meta, None, None, "", "x.example.org").is_err());
delete_profile(&meta, None, &a.id).unwrap();
assert!(delete_profile(&meta, None, "solo").is_err(), "one profile must remain");
assert_eq!(view(&meta, None).profiles.len(), 1);
}
}
+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 && {
+55 -3
View File
@@ -277,9 +277,10 @@ Advanced override, snapshot first.
### D9. Client integration
The client is a separate object. Manager only: detect (`Wow.exe`/`Ascension.exe` + `Data\`), read/write
`realmlist.wtf` after backing it up, and copy `Interface\AddOns\CoABotUI` (backing that one directory up only if
its files differ from the manifest). No touching of `WTF`, `Cache`, other AddOns, or the exe.
The client is a separate object. By default the Manager only detects it (`Wow.exe`/`Ascension.exe` + `Data\`), reads/writes
`realmlist.wtf` after backing it up, and copies `Interface\AddOns\CoABotUI` (backing that one directory up only if
its files differ from the manifest). No touching of `WTF`, `Cache`, other AddOns, or the exe. Downloading or updating
a client is opt-in and described in section 9 (game client download); an existing client is never changed without asking.
*Reference machine note:* `C:\games\Ascension` is a heavily modified Ascension client (custom `d3d9.dll`,
renderer files, many `.bak`s) — client detection must be strictly read-only + additive.
@@ -336,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
@@ -517,3 +549,23 @@ The reference install classifies as **Healthy (customised)**: repack shape, bina
hour, world thread stalled); (2) no active `coa.conf` (`CoA.Enable = 1`) because packages contain only `*.conf.dist`.
Fixed: `clean-base` restores quiet templates, `assemble-tree` ships `coa.conf.dist`, and the Manager creates missing
module `.conf` files from their `.dist` on install and before each start of a Manager-installed server.
* **Game client download and update through the Manager** (built 2026-10-01, `coa-core::clientdl`). The community PTR launcher
("Conquest of AzerothCore" Electron app) reads its client from
`https://launcher-api.coa-development.org/downloads/client/latest.json` (`{schema, version, publishedAt, files:[{path,size,sha256}]}`;
~200 files, 43 GiB: `Ascension.exe`, DLLs and ~40 big `Data/*.MPQ`) and fetches each file as the content-addressed object
`.../downloads/client/objects/<sha256>`. The Manager uses the same endpoints with its own resumable, hash-verified downloader:
* **State** lives in the client folder (`.coa-manager/client-state.json`: manifest version, per file size/mtime/sha256). A
routine check (every 5 minutes, like the server) is one small manifest request compared with the recorded version; no game file is read.
* **Plan, then apply** (like server updates): files are compared by size and mtime against the state, and hashed only when those
no longer match. Each file is `Missing`, `Changed` (still as the Manager left it) or `Modified` (the player changed it, e.g. a
custom `d3d9.dll` or a patched exe). Modified files are kept on request (and remembered: asked again only when the published file
changes) or replaced after being moved to `.coa-manager/replaced/<time>/`. Objects are staged in `.coa-manager/staging/<sha>` and
moved into place only after the hash matches; state is saved after every file, so cancel, crash or reboot resume where they stopped.
* **Never touched:** `WTF`, `Cache`, `Errors`, `Logs`, `*.log`, `realmlist.wtf`, `Interface/AddOns/CoABotUI` (those have their own paths).
* **UI:** PLAY becomes **UPDATE CLIENT** when a tracked client is outdated (with "Play without updating"); with no client linked it
becomes **Set up game client** (choose an existing folder, or download into `<chosen folder>/CoA Client` with a free-space check).
An existing client that is not tracked can be adopted from Settings > Game client ("Keep this client up to date").
A fresh download gets `realmlist.wtf` for each installed locale (the manifest has none) and the companion addon.
* **Open points:** ask the launcher maintainers before putting heavy load on their API; DBCs live inside the MPQ patch archives
(extracting them would need an MPQ reader), so the server's `Data\dbc` still comes from our `base` package for now.
+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: 58 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 23 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 47 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 61 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 19 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 83 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 86 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 57 KiB

+138
View File
@@ -0,0 +1,138 @@
{
"schema": 1,
"modules": [
{
"id": "companions",
"name": "CoA Companions",
"description": {
"en": "Companion bots for groups, dungeons and your guild.",
"ru": "Боты-компаньоны для групп, подземелий и гильдии.",
"de": "Begleiter-Bots für Gruppen, Dungeons und deine Gilde.",
"fr": "Des bots compagnons pour les groupes, les donjons et votre guilde.",
"es": "Bots acompañantes para grupos, mazmorras y tu hermandad."
},
"repo": "https://github.com/Corfirean/mod-coa-playerbots",
"conf": "mod_coa_playerbots.conf",
"enable_key": "CoaBots.Enable",
"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": "Подстраивает подземелья и рейды под вашу группу, есть соло-режимы.",
"de": "Passt Dungeons und Schlachtzüge an deine Gruppe an, mit Solo-Modi.",
"fr": "Adapte donjons et raids à votre groupe, avec des modes solo.",
"es": "Adapta mazmorras y bandas a tu grupo, con modos en solitario."
},
"repo": "https://github.com/Corfirean/mod-coa-content-scaling",
"conf": "mod-coa-content-scaling.conf",
"enable_key": "CoAContentScaling.Enable",
"status": "early",
"icon": "scaling"
},
{
"id": "tbc-content",
"name": "TBC Content",
"description": {
"en": "Outland dungeons and raids, scaled to your level range.",
"ru": "Подземелья и рейды Запределья, подогнанные под ваши уровни.",
"de": "Dungeons und Schlachtzüge der Scherbenwelt, an deine Stufen angepasst.",
"fr": "Donjons et raids de l'Outreterre, adaptés à vos niveaux.",
"es": "Mazmorras y bandas de Terrallende, adaptadas a tus niveles."
},
"repo": "https://github.com/Corfirean/mod-coa-content-scaling/tree/main/content-packs/mod-coa-tbc-content",
"conf": "mod-coa-tbc-content.conf",
"enable_key": "CoATBC.Enable",
"status": "early",
"icon": "tbc"
},
{
"id": "wotlk-content",
"name": "WotLK Content",
"description": {
"en": "Northrend dungeons and raids, scaled to your level range.",
"ru": "Подземелья и рейды Нордскола, подогнанные под ваши уровни.",
"de": "Dungeons und Schlachtzüge Nordends, an deine Stufen angepasst.",
"fr": "Donjons et raids du Norfendre, adaptés à vos niveaux.",
"es": "Mazmorras y bandas de Rasganorte, adaptadas a tus niveles."
},
"repo": "https://github.com/Corfirean/mod-coa-content-scaling/tree/main/content-packs/mod-coa-wotlk-content",
"conf": "mod-coa-wotlk-content.conf",
"enable_key": "CoAWotLK.Enable",
"status": "early",
"icon": "wotlk"
},
{
"id": "ah-bot",
"name": "Auction House Bot",
"description": {
"en": "Fills the auction house with realistic, adjustable listings.",
"ru": "Наполняет аукцион реалистичными настраиваемыми лотами.",
"de": "Füllt das Auktionshaus mit realistischen, einstellbaren Angeboten.",
"fr": "Remplit l'hôtel des ventes d'annonces réalistes et réglables.",
"es": "Llena la casa de subastas con ofertas realistas y ajustables."
},
"repo": "https://github.com/NathanHandley/mod-ah-bot-plus",
"conf": "mod_ahbot.conf",
"switchable": false,
"status": "soon",
"icon": "gavel"
},
{
"id": "npc-enchanter",
"name": "NPC Enchanter",
"description": {
"en": "An NPC that enchants your gear for you.",
"ru": "НПС, который зачаровывает ваше снаряжение.",
"de": "Ein NPC, der deine Ausrüstung für dich verzaubert.",
"fr": "Un PNJ qui enchante votre équipement pour vous.",
"es": "Un PNJ que encanta tu equipo por ti."
},
"repo": "https://github.com/azerothcore/mod-npc-enchanter",
"conf": "npc_enchanter.conf",
"switchable": true,
"status": "early",
"icon": "sparkles",
"enable_key": "Enchanter.Enable",
"default_on": true
},
{
"id": "playerbots",
"name": "SQUID's Playerbots",
"description": {
"en": "An alternative bot system with random bots and full AI.",
"ru": "Альтернативная система ботов со случайными ботами и полным ИИ.",
"de": "Ein alternatives Bot-System mit Zufalls-Bots und voller KI.",
"fr": "Un système de bots alternatif avec bots aléatoires et IA complète.",
"es": "Un sistema de bots alternativo con bots aleatorios e IA completa."
},
"repo": "https://github.com/Zyth45/mod-playerbots",
"conf": "playerbots.conf",
"switchable": false,
"status": "soon",
"icon": "swords"
},
{
"id": "client-compat",
"name": "Client compatibility",
"description": {
"en": "Client-server link and appearance unlocks.",
"ru": "Связь клиента с сервером и разблокировка внешних видов.",
"de": "Verbindung Client–Server und Aussehen-Freischaltungen.",
"fr": "Lien client-serveur et déblocage des apparences.",
"es": "Enlace cliente-servidor y desbloqueo de apariencias."
},
"repo": "https://github.com/Corfirean/azerothcore-wotlk-coa",
"conf": "coa.conf",
"alt_conf": "mod_ascension_compat.conf",
"switchable": false,
"status": "release",
"icon": "plug",
"hidden": true
}
]
}
+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.2.0",
"version": "0.6.0",
"license": "AGPL-3.0-only",
"type": "module",
"scripts": {
+280
View File
@@ -489,6 +489,19 @@
"max": 1000,
"unit": "ms"
},
{
"key": "MapUpdate.Threads",
"type": "int",
"category": "performance",
"title": "CPU cores for the world",
"description": "How many processor cores the world uses to update maps. Companions spread over several maps run much faster with more than one. Takes effect when the world server restarts.",
"default": 4,
"advanced": false,
"restartRequired": "world",
"dangerous": false,
"min": 1,
"max": 16
},
{
"key": "MinWorldUpdateTime",
"type": "int",
@@ -563,6 +576,273 @@
"dangerous": true,
"min": 0,
"max": 7
},
{
"key": "Rate.Drop.Item.Uncommon",
"type": "float",
"category": "rates",
"title": "Uncommon item drop rate",
"description": "Multiplier for how often uncommon (green) items drop.",
"default": 1,
"advanced": false,
"restartRequired": "world",
"dangerous": false,
"min": 0,
"max": 20,
"unit": "x"
},
{
"key": "Rate.Drop.Item.Rare",
"type": "float",
"category": "rates",
"title": "Rare item drop rate",
"description": "Multiplier for how often rare (blue) items drop.",
"default": 1,
"advanced": false,
"restartRequired": "world",
"dangerous": false,
"min": 0,
"max": 20,
"unit": "x"
},
{
"key": "Rate.Drop.Item.Epic",
"type": "float",
"category": "rates",
"title": "Epic item drop rate",
"description": "Multiplier for how often epic (purple) items drop.",
"default": 1,
"advanced": false,
"restartRequired": "world",
"dangerous": false,
"min": 0,
"max": 20,
"unit": "x"
},
{
"key": "Rate.Drop.Item.Legendary",
"type": "float",
"category": "rates",
"title": "Legendary item drop rate",
"description": "Multiplier for how often legendary (orange) items drop.",
"default": 1,
"advanced": false,
"restartRequired": "world",
"dangerous": false,
"min": 0,
"max": 20,
"unit": "x"
},
{
"key": "Rate.Talent",
"type": "float",
"category": "rates",
"title": "Talent points",
"description": "Multiplier for the talent points a character earns per level.",
"default": 1,
"advanced": true,
"restartRequired": "world",
"dangerous": false,
"min": 0,
"max": 10,
"unit": "x"
},
{
"key": "Rate.Skill.Discovery",
"type": "float",
"category": "rates",
"title": "Recipe discovery chance",
"description": "Multiplier for the chance to discover a new recipe while crafting.",
"default": 1,
"advanced": true,
"restartRequired": "world",
"dangerous": false,
"min": 0,
"max": 20,
"unit": "x"
},
{
"key": "Rate.RepairCost",
"type": "float",
"category": "rates",
"title": "Repair cost",
"description": "Multiplier for what repairing equipment costs. 0 makes repairs free.",
"default": 1,
"advanced": false,
"restartRequired": "world",
"dangerous": false,
"min": 0,
"max": 10,
"unit": "x"
},
{
"key": "Rate.Auction.Cut",
"type": "float",
"category": "rates",
"title": "Auction house cut",
"description": "Multiplier for the share of a sale the auction house keeps. 0 means no cut.",
"default": 1,
"advanced": true,
"restartRequired": "world",
"dangerous": false,
"min": 0,
"max": 10,
"unit": "x"
},
{
"key": "Rate.ArenaPoints",
"type": "float",
"category": "rates",
"title": "Arena points gain",
"description": "Multiplier for arena points earned.",
"default": 1,
"advanced": true,
"restartRequired": "world",
"dangerous": false,
"min": 0,
"max": 20,
"unit": "x"
},
{
"key": "Rate.XP.Pet",
"type": "float",
"category": "rates",
"title": "Pet experience",
"description": "Multiplier for the experience hunters' pets gain.",
"default": 1,
"advanced": true,
"restartRequired": "world",
"dangerous": false,
"min": 0,
"max": 20,
"unit": "x"
},
{
"key": "Instance.IgnoreLevel",
"type": "bool",
"category": "gameplay",
"title": "Ignore dungeon level requirements",
"description": "Characters of any level can enter dungeons and raids.",
"default": false,
"advanced": false,
"restartRequired": "world",
"dangerous": false
},
{
"key": "Instance.IgnoreRaid",
"type": "bool",
"category": "gameplay",
"title": "Enter raids without a raid group",
"description": "Players can enter raid instances without being in a raid group.",
"default": false,
"advanced": false,
"restartRequired": "world",
"dangerous": false
},
{
"key": "Instance.ResetTimeHour",
"type": "int",
"category": "gameplay",
"title": "Dungeon reset hour",
"description": "Hour of the day (0-23) when dungeon and raid lockouts reset.",
"default": 4,
"advanced": true,
"restartRequired": "world",
"dangerous": false,
"min": 0,
"max": 23
},
{
"key": "MaxPrimaryTradeSkill",
"type": "int",
"category": "gameplay",
"title": "Primary professions per character",
"description": "How many primary professions (such as Blacksmithing or Herbalism) a character may learn.",
"default": 2,
"advanced": false,
"restartRequired": "world",
"dangerous": false,
"min": 0,
"max": 11
},
{
"key": "AlwaysMaxSkillForLevel",
"type": "bool",
"category": "gameplay",
"title": "Skills always at maximum for level",
"description": "Weapon and other skills are always at their maximum for the character's level, no training needed.",
"default": false,
"advanced": false,
"restartRequired": "world",
"dangerous": false
},
{
"key": "ActivateWeather",
"type": "bool",
"category": "gameplay",
"title": "Weather",
"description": "Turns rain, snow and storms on or off.",
"default": true,
"advanced": false,
"restartRequired": "world",
"dangerous": false
},
{
"key": "Group.Raid.LevelRestriction",
"type": "int",
"category": "gameplay",
"title": "Minimum level to invite to a raid",
"description": "Characters below this level cannot be invited to a raid group.",
"default": 10,
"advanced": true,
"restartRequired": "world",
"dangerous": false,
"min": 1,
"max": 80
},
{
"key": "AllowTwoSide.Interaction.Group",
"type": "bool",
"category": "accounts",
"title": "Cross-faction groups",
"description": "Alliance and Horde players can form groups together.",
"default": false,
"advanced": false,
"restartRequired": "world",
"dangerous": false
},
{
"key": "AllowTwoSide.Interaction.Guild",
"type": "bool",
"category": "accounts",
"title": "Cross-faction guilds",
"description": "Alliance and Horde players can join the same guild.",
"default": false,
"advanced": false,
"restartRequired": "world",
"dangerous": false
},
{
"key": "AllowTwoSide.Interaction.Auction",
"type": "bool",
"category": "accounts",
"title": "Shared auction house",
"description": "Alliance and Horde players can use the same auction house.",
"default": false,
"advanced": false,
"restartRequired": "world",
"dangerous": false
},
{
"key": "Achievement.RealmFirstBlockBots",
"type": "bool",
"category": "gameplay",
"title": "Bots cannot take 'Realm First!'",
"description": "Companions (bots) cannot earn 'Realm First!' achievements, so they never take a server first away from real players. Needs a server build from 2026-10-02 or later.",
"default": true,
"advanced": false,
"restartRequired": "world",
"dangerous": false
}
]
}
+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" }
+515 -12
View File
@@ -28,6 +28,8 @@ struct AppState {
busy: Mutex<HashSet<String>>,
/// Cancel handle of the installation currently running, if any.
install_cancel: Mutex<Option<Cancel>>,
/// Cancel handle of the game-client check or download currently running, if any.
client_cancel: Mutex<Option<Cancel>>,
}
/// Where official server packages are published (created by the release pipeline, Phase 6).
@@ -68,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
@@ -187,26 +202,35 @@ 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)?;
if meta.kind == coa_core::registry::InstallKind::New {
coa_core::config::ensure_performance_defaults(&root, &dir)?;
}
Ok::<(), Error>(())
})
.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);
@@ -270,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)
@@ -380,9 +405,30 @@ async fn restore_backup_database(state: State<'_, AppState>, id: String, backup_
}
#[tauri::command]
fn install_preflight(state: State<'_, AppState>, dest: String) -> Preflight {
// The real size is checked again once the signed manifest is known; assume a typical install here.
install::preflight(std::path::Path::new(&dest), 6 * 1024 * 1024 * 1024, &state.registry)
fn install_preflight(state: State<'_, AppState>, dest: String, needed: Option<u64>) -> Preflight {
// `needed` is the real size from the signed package list when the screen already has it; the real size is checked
// again at install time either way.
install::preflight(std::path::Path::new(&dest), needed.unwrap_or(6 * 1024 * 1024 * 1024), &state.registry)
}
#[derive(Serialize)]
struct InstallRequirements {
/// What is downloaded.
download_bytes: u64,
/// What the unpacked server takes on the drive (the downloaded parts are removed afterwards).
unpacked_bytes: u64,
version: String,
}
/// How big the server is, read from the package's signed list before anything is downloaded.
#[tauri::command]
async fn install_requirements(package: Option<String>) -> std::result::Result<InstallRequirements, UiError> {
blocking(move || {
let (m, _) = coa_core::pkgsource::fetch_manifest(&package_source(package), coa_core::signing::EMBEDDED_PUBLIC_KEY)?;
let archive = m.archive.ok_or_else(|| Error::InvalidManifest("no archive".into()))?;
Ok(InstallRequirements { download_bytes: archive.parts.iter().map(|p| p.size).sum(), unpacked_bytes: archive.unpacked_size, version: m.version })
})
.await
}
#[tauri::command]
@@ -433,6 +479,178 @@ async fn create_account(state: State<'_, AppState>, id: String, username: String
.await
}
#[tauri::command]
async fn realmlist_profiles(state: State<'_, AppState>, id: String) -> std::result::Result<coa_core::realmlist::View, UiError> {
let root = path_of(&state, &id)?;
blocking(move || {
let (dir, _) = install_meta(&root)?;
Ok(coa_core::realmlist::view(&dir, linked_client(&root)?.as_deref()))
})
.await
}
#[tauri::command]
async fn realmlist_save(state: State<'_, AppState>, id: String, profile_id: Option<String>, name: String, data: String) -> std::result::Result<coa_core::realmlist::Profile, UiError> {
let root = path_of(&state, &id)?;
blocking(move || {
let (dir, _) = install_meta(&root)?;
coa_core::realmlist::save_profile(&dir, linked_client(&root)?.as_deref(), profile_id.as_deref(), &name, &data)
})
.await
}
#[tauri::command]
async fn realmlist_delete(state: State<'_, AppState>, id: String, profile_id: String) -> std::result::Result<(), UiError> {
let root = path_of(&state, &id)?;
blocking(move || {
let (dir, _) = install_meta(&root)?;
coa_core::realmlist::delete_profile(&dir, linked_client(&root)?.as_deref(), &profile_id)
})
.await
}
/// Write the chosen realmlist into the linked game client.
#[tauri::command]
async fn realmlist_activate(state: State<'_, AppState>, id: String, profile_id: String) -> std::result::Result<Vec<String>, UiError> {
let root = path_of(&state, &id)?;
blocking(move || {
let (dir, _) = install_meta(&root)?;
let client = linked_client(&root)?.ok_or_else(|| Error::Invalid("No game client is set up for this server yet.".into()))?;
let changed = coa_core::realmlist::activate(&dir, &client, &profile_id)?;
tracing::info!(profile = %profile_id, files = changed.len(), "realmlist switched");
Ok(changed)
})
.await
}
#[tauri::command]
async fn modules_list(state: State<'_, AppState>, id: String) -> std::result::Result<Vec<coa_core::modules::ModuleView>, UiError> {
let root = path_of(&state, &id)?;
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)
})
.await
}
#[tauri::command]
async fn module_settings(state: State<'_, AppState>, id: String, module: String) -> std::result::Result<Vec<coa_core::modules::Setting>, UiError> {
let root = path_of(&state, &id)?;
blocking(move || coa_core::modules::settings(&root, &module)).await
}
#[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)
})
.await
}
#[tauri::command]
async fn all_settings(state: State<'_, AppState>, id: String) -> std::result::Result<Vec<coa_core::allsettings::Item>, UiError> {
let root = path_of(&state, &id)?;
blocking(move || coa_core::allsettings::list(&root)).await
}
#[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)
})
.await
}
#[tauri::command]
async fn list_accounts(state: State<'_, AppState>, id: String) -> std::result::Result<Vec<coa_core::accounts::AccountInfo>, UiError> {
let root = path_of(&state, &id)?;
blocking(move || coa_core::accounts::list(&root)).await
}
#[tauri::command]
async fn account_set_password(state: State<'_, AppState>, id: String, name: String, password: String) -> std::result::Result<(), UiError> {
let root = path_of(&state, &id)?;
blocking(move || {
Ra::connect(&root)?.set_account_password(&name, &password)?;
tracing::info!(%name, "account password changed");
Ok(())
})
.await
}
#[tauri::command]
async fn account_set_access(state: State<'_, AppState>, id: String, name: String, level: u8) -> std::result::Result<(), UiError> {
let root = path_of(&state, &id)?;
blocking(move || {
Ra::connect(&root)?.set_account_access(&name, level)?;
tracing::info!(%name, level, "account access level changed");
Ok(())
})
.await
}
#[tauri::command]
async fn account_rename(state: State<'_, AppState>, id: String, name: String, new_name: String, password: String) -> std::result::Result<(), UiError> {
let root = path_of(&state, &id)?;
blocking(move || {
let mut ra = Ra::connect(&root)?;
coa_core::accounts::rename(&root, &mut ra, &name, &new_name, &password)
})
.await
}
#[tauri::command]
async fn account_delete(state: State<'_, AppState>, id: String, name: String) -> std::result::Result<(), UiError> {
let root = path_of(&state, &id)?;
blocking(move || {
let mut ra = Ra::connect(&root)?;
coa_core::accounts::delete(&root, &mut ra, &name)
})
.await
}
fn install_meta(root: &std::path::Path) -> Result<(PathBuf, InstallMeta)> {
let dir = meta_dir(root)?;
let (_, meta) = MetaDir::open(&dir)?;
@@ -726,23 +944,207 @@ fn client_install_addon(state: State<'_, AppState>, id: String) -> std::result::
Ok(coa_core::client::install_addon(&client.unwrap(), &dir, &source)?)
}
#[derive(Serialize)]
struct ClientStatus {
/// A usable client folder is linked to this server.
linked: bool,
/// The Manager keeps this folder up to date (it downloaded it or was asked to adopt it).
managed: bool,
installed_version: Option<String>,
latest_version: Option<String>,
latest_bytes: Option<u64>,
/// A managed client is older than the published one (or its download never finished).
update_available: bool,
}
fn linked_client(root: &std::path::Path) -> Result<Option<PathBuf>> {
let (_, meta) = install_meta(root)?;
Ok(meta.client_path.map(PathBuf::from).filter(|p| coa_core::client::detect(p, None).is_some()))
}
/// Cheap: one small manifest request and the local state file; no game file is read.
#[tauri::command]
async fn client_status(state: State<'_, AppState>, id: String) -> std::result::Result<ClientStatus, UiError> {
let root = path_of(&state, &id)?;
blocking(move || {
let client = linked_client(&root)?;
let latest = coa_core::clientdl::fetch_latest().ok();
let local = client.as_deref().map(coa_core::clientdl::local);
let managed = local.as_ref().map(|l| l.managed).unwrap_or(false);
let installed = local.and_then(|l| l.version);
let update_available = managed && latest.as_ref().map(|l| installed.as_deref() != Some(l.version.as_str())).unwrap_or(false);
Ok(ClientStatus {
linked: client.is_some(),
managed,
installed_version: installed,
latest_bytes: latest.as_ref().map(|l| l.total_bytes()),
latest_version: latest.map(|l| l.version),
update_available,
})
})
.await
}
#[derive(Serialize)]
struct ClientDownloadCheck {
needed_bytes: u64,
free_bytes: u64,
version: String,
/// Where the client would go.
dest: String,
}
const CLIENT_FOLDER: &str = "CoA Client";
#[tauri::command]
async fn client_download_check(parent: String) -> std::result::Result<ClientDownloadCheck, UiError> {
blocking(move || {
let latest = coa_core::clientdl::fetch_latest()?;
let dest = PathBuf::from(&parent).join(CLIENT_FOLDER);
Ok(ClientDownloadCheck {
needed_bytes: latest.total_bytes(),
free_bytes: coa_core::fsx::free_space(std::path::Path::new(&parent))?,
version: latest.version,
dest: dest.to_string_lossy().into_owned(),
})
})
.await
}
/// Compare the linked client with the published one. Hashes files only where the recorded state cannot vouch for them.
#[tauri::command]
async fn client_plan(app: AppHandle, state: State<'_, AppState>, id: String) -> std::result::Result<coa_core::clientdl::Plan, UiError> {
let root = path_of(&state, &id)?;
let cancel = begin_client_job(&state)?;
let result = blocking(move || {
let client = linked_client(&root)?.ok_or_else(|| Error::Invalid("No game client is set up for this server yet.".into()))?;
let manifest = coa_core::clientdl::fetch_latest()?;
let current = coa_core::clientdl::load_state(&client).unwrap_or_default();
coa_core::clientdl::plan(&client, &manifest, &current, &cancel, &|s| {
let _ = app.emit("client-progress", s);
})
})
.await;
end_client_job(&state);
result
}
/// Bring the linked client to the published version. `keep_modified` leaves files the player changed alone.
#[tauri::command]
async fn client_sync(app: AppHandle, state: State<'_, AppState>, id: String, keep_modified: bool) -> std::result::Result<(), UiError> {
let root = path_of(&state, &id)?;
let cancel = begin_client_job(&state)?;
let result = blocking(move || {
let client = linked_client(&root)?.ok_or_else(|| Error::Invalid("No game client is set up for this server yet.".into()))?;
run_client_sync(&app, &client, keep_modified, &cancel)
})
.await;
end_client_job(&state);
result
}
fn run_client_sync(app: &AppHandle, client: &std::path::Path, keep_modified: bool, cancel: &Cancel) -> Result<()> {
let emit = |s: coa_core::clientdl::Step| {
let _ = app.emit("client-progress", s);
};
let manifest = coa_core::clientdl::fetch_latest()?;
let current = coa_core::clientdl::load_state(client).unwrap_or_default();
let plan = coa_core::clientdl::plan(client, &manifest, &current, cancel, &emit)?;
coa_core::download::check_url(coa_core::clientdl::OBJECTS_URL)?;
let transport = coa_core::download::HttpTransport::new()?;
coa_core::clientdl::apply(
&coa_core::clientdl::Apply { client, manifest: &manifest, plan: &plan, keep_modified, transport: &transport, objects_url: coa_core::clientdl::OBJECTS_URL, cancel },
&emit,
)?;
tracing::info!(version = %manifest.version, downloaded = plan.items.len(), "client brought up to date");
Ok(())
}
/// Download the whole client into `<parent>/CoA Client`, then link it to this server.
#[tauri::command]
async fn client_download(app: AppHandle, state: State<'_, AppState>, id: String, parent: String) -> std::result::Result<coa_core::client::ClientInfo, UiError> {
let root = path_of(&state, &id)?;
let cancel = begin_client_job(&state)?;
let result = blocking(move || {
let (dir, mut meta) = install_meta(&root)?;
let parent = PathBuf::from(&parent);
if !parent.is_dir() {
return Err(Error::Invalid("Choose an existing folder to put the game client in.".into()));
}
let dest = parent.join(CLIENT_FOLDER);
let resuming = coa_core::clientdl::load_state(&dest).is_some();
let non_empty = std::fs::read_dir(&dest).map(|mut r| r.next().is_some()).unwrap_or(false);
if non_empty && !resuming {
return Err(Error::Invalid(format!("{} already exists and is not an unfinished download. Choose another folder.", dest.display())));
}
std::fs::create_dir_all(&dest)?;
run_client_sync(&app, &dest, false, &cancel)?;
let source = coa_core::client::addon_source(&root);
let info = coa_core::client::detect(&dest, source.as_deref()).ok_or_else(|| Error::Invalid("The downloaded client looks incomplete.".into()))?;
meta.client_path = Some(info.path.clone());
coa_core::fsx::atomic_write_json(&dir.join("install.json"), &meta)?;
// a fresh client has no realmlist; this server is on this computer
coa_core::client::set_realmlist(&dest, &dir, "127.0.0.1")?;
if let Some(src) = source {
coa_core::client::install_addon(&dest, &dir, &src)?;
}
Ok(coa_core::client::detect(&dest, coa_core::client::addon_source(&root).as_deref()).unwrap_or(info))
})
.await;
end_client_job(&state);
result
}
#[tauri::command]
fn client_cancel(state: State<'_, AppState>) {
if let Ok(c) = state.client_cancel.lock() {
if let Some(c) = c.as_ref() {
c.cancel();
}
}
}
fn begin_client_job(state: &AppState) -> std::result::Result<Cancel, UiError> {
let mut slot = state.client_cancel.lock().map_err(|_| Error::Invalid("state poisoned".into()))?;
if slot.is_some() {
return Err(Error::Invalid("The game client is already being checked or downloaded.".into()).into());
}
let cancel = Cancel::default();
*slot = Some(cancel.clone());
Ok(cancel)
}
fn end_client_job(state: &AppState) {
if let Ok(mut c) = state.client_cancel.lock() {
*c = None;
}
}
/// Start the server if needed, wait until it is ready, then launch the game client.
#[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() })
})
@@ -767,15 +1169,64 @@ struct FriendsStatus {
/// Manager to launch an arbitrary address.
#[tauri::command]
fn open_link(url: String) -> std::result::Result<(), UiError> {
const ALLOWED: &[&str] = &["https://tailscale.com/", "https://login.tailscale.com/", "https://portforward.com/"];
if !ALLOWED.iter().any(|p| url.starts_with(p)) || !url.chars().all(|c| c.is_ascii_alphanumeric() || "/:._-?=#%".contains(c)) {
const ALLOWED: &[&str] = &["https://tailscale.com/", "https://login.tailscale.com/", "https://portforward.com/", "https://github.com/Corfirean/"];
// A prefilled "new issue" page of this project: the address must be exactly that page, and its query may carry
// `&` between the (percent-encoded) title and text.
const NEW_ISSUE: &str = "https://github.com/Corfirean/coa-server-manager/issues/new";
let issue = url == NEW_ISSUE || url.starts_with(&format!("{NEW_ISSUE}?"));
let chars_ok = url.chars().all(|c| c.is_ascii_alphanumeric() || "/:._-?=#%".contains(c) || (issue && c == '&'));
// the GitHub page of a module that is in the bundled catalog (some are not ours)
let catalog = coa_core::modules::catalog().iter().any(|e| e.repo == url);
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(())
}
#[derive(Serialize)]
struct ReportContext {
manager_version: String,
windows: String,
/// "new" for a server the Manager installed, "imported" for one that was added.
install_kind: String,
server_version: Option<String>,
}
/// "Windows 11 (build 26200)" from `ver`; empty if it cannot be read.
fn windows_version() -> String {
let mut cmd = std::process::Command::new("cmd.exe");
cmd.args(["/C", "ver"]);
#[cfg(windows)]
{
use std::os::windows::process::CommandExt;
cmd.creation_flags(0x0800_0000);
}
let out = cmd.output().map(|o| String::from_utf8_lossy(&o.stdout).into_owned()).unwrap_or_default();
let build: Option<u32> = out.split("Version").nth(1).and_then(|v| v.trim().trim_end_matches(']').split('.').nth(2)).and_then(|b| b.trim().parse().ok());
match build {
Some(b) if b >= 22000 => format!("Windows 11 (build {b})"),
Some(b) => format!("Windows 10 (build {b})"),
None => String::new(),
}
}
/// What the problem report fills in on its own. Nothing here identifies the person or the machine.
#[tauri::command]
async fn report_context(state: State<'_, AppState>, id: String) -> std::result::Result<ReportContext, UiError> {
let root = path_of(&state, &id)?;
blocking(move || {
let (_, meta) = install_meta(&root)?;
Ok(ReportContext {
manager_version: coa_core::MANAGER_VERSION.to_string(),
windows: windows_version(),
install_kind: if meta.kind == coa_core::registry::InstallKind::New { "new".into() } else { "imported".into() },
server_version: meta.core.version.clone(),
})
})
.await
}
#[tauri::command]
async fn friends_status(state: State<'_, AppState>, id: String) -> std::result::Result<FriendsStatus, UiError> {
let root = path_of(&state, &id)?;
@@ -969,7 +1420,7 @@ pub fn run() {
.plugin(tauri_plugin_dialog::init())
.plugin(tauri_plugin_updater::Builder::new().build())
.plugin(tauri_plugin_process::init())
.manage(AppState { registry: Registry::at(dir.join("installs.json")), busy: Mutex::new(HashSet::new()), install_cancel: Mutex::new(None) })
.manage(AppState { registry: Registry::at(dir.join("installs.json")), busy: Mutex::new(HashSet::new()), install_cancel: Mutex::new(None), client_cancel: Mutex::new(None) })
.invoke_handler(tauri::generate_handler![
default_install_dir,
scan_server,
@@ -992,6 +1443,25 @@ pub fn run() {
restore_backup_configs,
restore_backup_database,
install_preflight,
install_requirements,
report_context,
list_accounts,
realmlist_profiles,
realmlist_save,
realmlist_delete,
realmlist_activate,
modules_list,
realm_profiles,
realm_select,
module_set_enabled,
module_settings,
module_save_settings,
all_settings,
all_settings_save,
account_set_password,
account_set_access,
account_rename,
account_delete,
install_new,
cancel_install,
create_account,
@@ -1012,6 +1482,12 @@ pub fn run() {
set_client,
client_realmlist,
client_install_addon,
client_status,
client_download_check,
client_plan,
client_sync,
client_download,
client_cancel,
play,
friends_status,
friends_check_internet,
@@ -1027,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.2.0",
"version": "0.6.0",
"identifier": "com.coa.servermanager",
"build": {
"beforeDevCommand": "npm run dev",
+1 -1
View File
@@ -3,7 +3,7 @@ import * as React from "react";
import { cn } from "@/lib/utils";
const buttonVariants = cva(
"inline-flex items-center justify-center gap-2 rounded-md font-medium transition-colors disabled:pointer-events-none disabled:opacity-45 cursor-pointer",
"inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md font-medium transition-colors disabled:pointer-events-none disabled:opacity-45 cursor-pointer",
{
variants: {
variant: {
+31
View File
@@ -0,0 +1,31 @@
import * as React from "react";
import { Eye, EyeOff } from "lucide-react";
import { cn } from "@/lib/utils";
import { useT } from "@/i18n";
/**
* A password field with its own show/hide button. The browser's built-in one only exists while the field is focused and
* comes back only after the field is emptied, so people could not look at a password they had already typed.
*/
export const PasswordInput = React.forwardRef<HTMLInputElement, Omit<React.InputHTMLAttributes<HTMLInputElement>, "type">>(
({ className, ...props }, ref) => {
const t = useT();
const [shown, setShown] = React.useState(false);
return (
<div className="relative block w-fit">
<input ref={ref} type={shown ? "text" : "password"} className={cn(className, "pr-11 [&::-ms-reveal]:hidden")} {...props} />
<button
type="button"
onClick={() => setShown((v) => !v)}
aria-label={shown ? t("pw.hide") : t("pw.show")}
aria-pressed={shown}
title={shown ? t("pw.hide") : t("pw.show")}
className="absolute inset-y-0 right-0 flex w-10 cursor-pointer items-center justify-center text-muted hover:text-ink"
>
{shown ? <EyeOff className="h-4 w-4" aria-hidden /> : <Eye className="h-4 w-4" aria-hidden />}
</button>
</div>
);
},
);
PasswordInput.displayName = "PasswordInput";
+56 -4
View File
@@ -6,8 +6,10 @@ import serverPresets from "../../schemas/presets/server.json";
export {};
(() => {
let added = false, running = false;
const report = {path:"C:\games\CoA-Repack",classification:"healthy",items:[
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:[
{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"},
@@ -16,25 +18,75 @@ 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}))};}
if(cmd==="companion_sizes") return {hardware:{cores:16,ram_gb:31,free_ram_gb:12},sizes:[{id:"small",title:"Small",bots:50,warning:null},{id:"medium",title:"Medium",bots:250,warning:null},{id:"large",title:"Large",bots:500,warning:"500 companions may need more CPU and memory than this computer has (8 cores, 16 GB)."}]};
if(cmd==="add_companions"){const base=(window as any).__bots??85;(window as any).__target=base+args.count;return {spawned:"queued",created:null,baseline:base};}
if(cmd==="check_update") return {from_version:(window as any).__updated?"0.261001.8":"0.260930.5",to_version:"0.261001.8",items:[],conflicts:[],migrations:5,download_bytes:6000000};
if(cmd==="apply_update"){const w=window as any;for(let i=1;i<=8;i++){await new Promise((r: any)=>setTimeout(r,700));(w.__handlers?.["update-progress"]??[]).forEach((h: any)=>h({event:"update-progress",id:1,payload:{step:i<4?"Downloading the update":i<7?"Applying the update":"Finishing",percent:i*12}}));}(window as any).__updated=true;return {txn:{state:"committed",to_version:"0.261001.8"},migrations:null};}
if(cmd==="get_population"){if(!running) return null;let b=(window as any).__bots??85;const t=(window as any).__target??0;if(t>b){b=Math.min(t,b+25);(window as any).__bots=b;}return {online_total:b,bots_online:Math.max(0,b-7),players_online:0,bots_total:b};}
if(cmd==="get_performance") return running?{mean_ms:14,median_ms:15,p95_ms:24,p99_ms:30,max_ms:61,ticks_per_sec:71.4}:null;
if(cmd==="run_diagnostics") return {problems:2,checks:[{id:"files",title:"Server files",level:"ok",detail:"All expected server parts were found."},{id:"world",title:"World server",level:"warn",detail:"Not running."},{id:"disk",title:"Free disk space",level:"warn",detail:"Only 3 GB free; backups and updates need room."},{id:"exposure",title:"Private services",level:"ok",detail:"Database and server console are not reachable from the network."}]};
if(cmd==="plugin:event|listen") return 1;
if(cmd.startsWith("client_")){
const w=window as any;
const emit=(payload: any)=>(w.__handlers?.["client-progress"]??[]).forEach((h: any)=>h({event:"client-progress",id:1,payload}));
const sleep=(ms: number)=>new Promise((r: any)=>setTimeout(r,ms));
const total=46404000000;
const run=async(phase: string,n: number,speed: number)=>{for(let i=1;i<=n;i++){if(w.__stop){w.__stop=false;throw {human:{code:"unknown",title:"",message:"",actions:[]},technical:"Download cancelled."};}emit({phase,done:Math.round(total*i/n),total,bytes_per_sec:speed,file:phase==="scan"?"Data/patch-"+i+".MPQ":"Data/patch-O.MPQ"});await sleep(120);}};
if(cmd==="client_status"){const c=w.__client??"none";return {linked:c!=="none",managed:c==="old"||c==="new",installed_version:c==="old"?"2026-09-20-01":c==="new"?"2026-09-29-01":null,latest_version:"2026-09-29-01",latest_bytes:total,update_available:c==="old"};}
if(cmd==="client_download_check") return {needed_bytes:total,free_bytes:args.parent.startsWith("C")?210e9:20e9,version:"2026-09-29-01",dest:args.parent+"\\CoA Client"};
if(cmd==="client_plan"){await run("scan",12,0);return {version:"2026-09-29-01",items:[{path:"Data/patch-O.MPQ",size:2814983707,kind:"changed"},{path:"Data/patch-WB1.MPQ",size:2001890268,kind:"missing"},...(w.__modified?[{path:"d3d9.dll",size:4284430,kind:"modified"},{path:"Ascension.exe",size:7694848,kind:"modified"}]:[])],download_bytes:4829000000,total_files:200,up_to_date_files:196,kept_files:0};}
if(cmd==="client_sync"){await run("download",25,41e6);w.__client="new";return null;}
if(cmd==="client_download"){await run("scan",4,0);await run("download",40,41e6);w.__client="new";return {path:args.parent+"\\CoA Client",executable:"Ascension.exe",realmlists:[{path:"x",host:"127.0.0.1"}],addon:{installed:true,version:"1",up_to_date:true},other_addons:0};}
if(cmd==="client_cancel"){w.__stop=true;return null;}
}
if(cmd==="realmlist_profiles"){const w=window as any;w.__rl=w.__rl??{profiles:[{id:"solo",name:"Solo",data:"set realmlist 127.0.0.1\r\n"},{id:"ptr",name:"PTR",data:"set realmlist ptr.example.org\r\n"}],active:"solo"};return w.__rl;}
if(cmd==="realmlist_activate"){(window as any).__rl.active=args.profileId;return [];}
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}].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||{});
if(cmd==="module_settings" && args.module==="client-compat") return [{key:"CoA.UnlockLocalAppearanceCatalog",value:"1",default:"1",doc:""},{key:"CoA.UnlockAllVanity",value:"1",default:"1",doc:""},{key:"CoA.AutoCollectAppearances",value:"0",default:"1",doc:""},{key:"CoA.LearnOwnedCompanions",value:"1",default:"1",doc:""},{key:"CoA.MaxRidingFromStart",value:"1",default:"1",doc:""}];
if(cmd==="module_settings"){
const S:Record<string,{key:string;value:string;default:string;doc:string}[]>={
"npc-enchanter":[{key:"Enchanter.Enable",value:"1",default:"1",doc:"Enable the module."},{key:"Enchanter.Announce",value:"0",default:"0",doc:"Announce the module when the player logs in."},{key:"Enchanter.CostCopper",value:"0",default:"0",doc:"What one enchantment costs, in copper (10000 = 1 gold). 0 = free."},{key:"Enchanter.MessageTimer",value:"60000",default:"60000",doc:"How often the NPC emotes, in milliseconds."}],
"companions":[{key:"CoaBots.Enable",value:"1",default:"1",doc:"Master switch of the companion bots."},{key:"CoaBots.MaxPerPlayer",value:"4",default:"4",doc:"How many bots one player can have at a time."}],
"content-scaling":[{key:"CoAContentScaling.Enable",value:"1",default:"1",doc:"Scale dungeons and raids to the group."}],
"tbc-content":[{key:"CoATBC.Enable",value:"1",default:"1",doc:"Outland dungeons and raids."}],
"wotlk-content":[{key:"CoAWotLK.Enable",value:"1",default:"1",doc:"Northrend dungeons and raids."}],
};
return S[args.module]??[];
}
if(cmd==="module_save_settings") return Object.keys(args.changes);
if(cmd==="report_context") return {manager_version:"0.3.1",windows:"Windows 11 (build 26200)",install_kind:"new",server_version:"0.261001.10"};
if(cmd==="open_link"){(window as any).__lastLink=args.url;return null;}
if(cmd==="export_diagnostics") return "C:\\Users\\you\\Desktop\\CoA-Diagnostics-20261001-140000.zip";
if(cmd==="install_preflight") return {ok:true,problems:[],free_bytes:210*2**30};
if(cmd==="install_requirements") return {download_bytes:Math.round(5.9*2**30),unpacked_bytes:Math.round(11.4*2**30),version:"0.2.0"};
if(cmd==="list_accounts"){const w=window as any;w.__acc=w.__acc??[{id:2,name:"ALICE",access:3,online:true,last_login:"2026-10-01 12:04:11",characters:4},{id:5,name:"BOB",access:0,online:false,last_login:null,characters:0},{id:6,name:"CAROL",access:2,online:false,last_login:"2026-09-30 21:40:02",characters:2}];return w.__acc;}
if(cmd==="account_set_access"){const a=(window as any).__acc.find((x: any)=>x.name===args.name);if(a)a.access=args.level;return null;}
if(cmd==="account_set_password") return null;
if(cmd==="account_rename"){const a=(window as any).__acc.find((x: any)=>x.name===args.name);if(a)a.name=String(args.newName).toUpperCase();return null;}
if(cmd==="client_info"){const c=(window as any).__client??"none";return c==="none"?null:{path:"C:\\games\\CoA Client",executable:"Ascension.exe",realmlists:[{path:"x",host:"127.0.0.1"}],addon:{installed:true,version:"1",up_to_date:true},other_addons:2};}
if(cmd==="set_client"){(window as any).__client="foreign";return {path:args.path,executable:"Ascension.exe",realmlists:[],addon:{installed:false,version:null,up_to_date:null},other_addons:0};}
if(cmd==="plugin:event|listen"){const w=window as any;(w.__handlers??={})[args.event]=[...(w.__handlers[args.event]??[]),args.handler];return 1;}
if(cmd==="plugin:event|unlisten") return null;
throw new Error("unmocked "+cmd);
}
+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);
+220 -1
View File
@@ -113,7 +113,7 @@ const de: Partial<Record<keyof typeof en, string>> = {
"import.custom.title": "Angepasster Server erkannt",
"import.custom.text": "Dieser Build wird nicht erkannt. Einige Update- und Installationsfunktionen sind deaktiviert.",
"import.incompatible.title": "Das ist kein Serverordner",
"import.incompatible.text": "Wähle den Ordner, der Core, Data und mysql (oder deine worldserver.exe) enthält.",
"import.incompatible.text": "Wähle den Hauptordner des Servers: den, der die Ordner Core, Data, mysql, Scripts und Settings enthält (nicht den Ordner Core selbst).",
"import.techDetails": "Technische Details anzeigen",
"import.detected": "Erkannt",
"import.notInstalled": "Nicht installiert",
@@ -568,6 +568,225 @@ const de: Partial<Record<keyof typeof en, string>> = {
"comp.despawnCount": "Wie viele abmelden",
"comp.despawnHint": "Entlastet sofort: Jeder Bot online kostet Serverzeit. Sie bleiben gespeichert und kommen beim nächsten Start zurück, wenn die automatische Anmeldung an ist.",
"comp.despawnSomeDone": "{n} Begleiter abgemeldet. Sie bleiben gespeichert.",
// Server update button
"btn.update": "AKTUALISIEREN",
"btn.updating": "WIRD AKTUALISIERT …",
"btn.updateTo": "Auf {v} aktualisieren",
"overview.updateAvail": "Ein Server-Update ist verfügbar: {to} (du hast {from}).",
"overview.updateConflicts": "Einige Dateien wurden von dir geändert. Entscheide in den Einstellungen, was damit geschehen soll.",
"overview.openUpdates": "Updates öffnen",
"overview.updatingNote": "Update läuft: Der Server wird gestoppt, gesichert, aktualisiert und zur Prüfung erneut gestartet.",
"nav.updateDot": "Update verfügbar",
// Game client download and update
"btn.close": "Schließen",
"btn.setupClient": "Spielclient einrichten",
"btn.updateClient": "CLIENT AKTUALISIEREN",
"client.setup.title": "Spielclient einrichten",
"client.setup.intro": "Zum Spielen brauchst du den Spielclient. Nutze einen vorhandenen oder lass ihn vom Manager herunterladen.",
"client.setup.have": "Ich habe bereits einen Client",
"client.setup.download": "Client herunterladen",
"client.setup.downloadHint": "Etwa 43 GB",
"client.dl.pickParent": "Wähle, wohin der Spielclient soll",
"client.dl.confirmText": "Version {v}, {size}. Er wird in diesem Ordner gespeichert:",
"client.dl.free": "Freier Platz auf diesem Laufwerk: {free}.",
"client.dl.notEnough": "Nicht genug freier Platz: {need} nötig, {free} verfügbar. Wähle ein anderes Laufwerk.",
"client.dl.otherFolder": "Anderer Ordner …",
"client.dl.start": "Herunterladen",
"client.dl.back": "Zurück",
"client.dl.retry": "Erneut versuchen",
"client.dl.resume": "Fortsetzen",
"client.dl.cancel": "Anhalten",
"client.dl.cancelled": "Angehalten. Alles bereits Heruntergeladene bleibt erhalten; du kannst jederzeit fortsetzen.",
"client.dl.scanning": "Dateien werden verglichen …",
"client.dl.downloading": "Wird heruntergeladen",
"client.dl.progress": "{done} von {total}",
"client.dl.speed": "{speed}/s",
"client.dl.done": "Der Spielclient ist bereit",
"client.dl.doneText": "Er ist mit diesem Server verknüpft. Du kannst auf PLAY drücken.",
"client.upd.title": "Client-Update",
"client.upd.available": "Ein neuerer Spielclient ist verfügbar: {v}.",
"client.upd.summary": "{n} Datei(en) zum Herunterladen, insgesamt {size}.",
"client.upd.upToDate": "Dein Client entspricht bereits Version {v}.",
"client.upd.modifiedTitle": "{n} Datei(en) hast du geändert",
"client.upd.modifiedText": "Zum Beispiel eine gepatchte Programmdatei. Behalte sie oder ersetze sie durch die offiziellen Versionen; deine werden dann im Ordner .coa-manager des Clients gesichert. Grafik-Wrapper (d3d9.dll und ähnliche) und Konfigurationsdateien bleiben immer unverändert.",
"client.upd.keep": "Von mir geänderte Dateien behalten",
"client.upd.more": "… und {n} weitere",
"client.upd.start": "Client aktualisieren",
"client.upd.later": "Jetzt nicht",
"client.upd.playAnyway": "Ohne Update spielen",
"client.upd.done": "Der Spielclient ist aktuell",
"client.upd.doneText": "Der Manager sagt dir Bescheid, wenn eine neuere Version erscheint.",
"client.track.title": "Client aktuell halten",
"client.track.text": "Der Manager vergleicht deinen Client einmal mit dem offiziellen und prüft danach auf neue Versionen, wie beim Server. Von dir geänderte Dateien werden nur ersetzt, wenn du es willst.",
"client.track.start": "Aktuell halten",
"client.track.startUpdate": "Aktualisieren und aktuell halten",
"client.track.button": "Diesen Client aktuell halten …",
"client.version": "Client-Version",
"client.versionUntracked": "vom Manager nicht verfolgt",
"client.versionUnfinished": "Download nicht abgeschlossen",
"client.downloadInstead": "Client herunterladen …",
// Accounts panel, password toggle, install size, addon explanation
"pw.show": "Passwort anzeigen",
"pw.hide": "Passwort verbergen",
"install.size": "Der Server belegt etwa {size} auf dem Laufwerk. Der Download ist {download} groß; während der Installation werden etwa {peak} benötigt.",
"client.addonWhat": "Ein Panel im Spiel (über eine Minimap-Schaltfläche) zur Steuerung deiner Begleiter: Gruppe auffüllen, Rollen und Formationen festlegen, Befehle wie Angriff, Pull oder Position halten geben und ihre Ausrüstung und Aufgaben ansehen. Ohne ihn funktioniert das Spiel; die Begleiter folgen dann nur ihrer eigenen KI.",
"acc.title": "Konten",
"acc.text": "Alle, die sich auf diesem Server anmelden können. Für Änderungen an Passwort und Zugriff muss der Server laufen.",
"acc.refresh": "Liste aktualisieren",
"acc.unavailable": "Die Liste ist gerade nicht verfügbar. Starte den Server und versuche es erneut.",
"acc.empty": "Noch keine Konten. Erstelle oben das erste.",
"acc.col.name": "Konto",
"acc.col.chars": "Charaktere",
"acc.col.access": "Zugriff",
"acc.col.last": "Letzte Anmeldung",
"acc.online": "online",
"acc.never": "nie",
"acc.level.0": "Spieler",
"acc.level.1": "Moderator",
"acc.level.2": "Spielleiter",
"acc.level.3": "Administrator",
"acc.changePassword": "Passwort ändern",
"acc.rename": "Umbenennen",
"acc.needsRunning": "Starte den Server, um Konten zu ändern.",
"acc.changeFor": "Neues Passwort für {name}",
"acc.renameFor": "{name} umbenennen",
"acc.newName": "Neuer Kontoname",
"acc.newPassword": "Neues Passwort",
"acc.nameRule": "3–17 Buchstaben oder Ziffern.",
"acc.passRule": "6–16 Zeichen, keine Leerzeichen oder Anführungszeichen.",
"acc.renameNote": "Ein neues Passwort ist nötig, weil das Anmeldepasswort vom Kontonamen abhängt. Der Spieler meldet sich mit dem neuen Namen und diesem Passwort an. Das Konto darf nicht angemeldet sein.",
"acc.save": "Speichern",
"acc.passwordChanged": "Das Passwort von {name} wurde geändert.",
"acc.renamed": "{name} heißt jetzt {new}.",
"acc.accessChanged": "{name} ist jetzt: {level}.",
// Problem report (GitHub issue)
"nav.report": "Problem melden",
"q.report": "Etwas funktioniert nicht?",
"rep.title": "Problem melden",
"rep.intro": "Beschreibe, was schiefgelaufen ist. Der Manager bereitet daraus einen Fehlerbericht für GitHub vor und öffnet ihn im Browser; dort prüfst du ihn, fügst Screenshots hinzu und sendest ihn ab. Du brauchst ein kostenloses GitHub-Konto. Aus diesem Fenster wird nichts gesendet.",
"rep.autoTitle": "Wird automatisch ausgefüllt",
"rep.manager": "Manager-Version",
"rep.windows": "Windows-Version",
"rep.kind": "Server",
"rep.kindNew": "Neu installiert",
"rep.kindImported": "Importierter Server",
"rep.server": "Server-Version",
"rep.summary": "Kurze Zusammenfassung",
"rep.summaryHint": "Zum Beispiel: Ladebildschirm hängt nach dem Erstellen eines Charakters",
"rep.what": "Was ist passiert?",
"rep.whatHint": "Beschreibe das Problem.",
"rep.expected": "Was hast du erwartet?",
"rep.expectedHint": "Beschreibe das erwartete Verhalten.",
"rep.steps": "Schritte zum Nachstellen",
"rep.attachTitle": "Logs und Screenshots",
"rep.attachText": "Erstelle eine Diagnosedatei (Einstellungen und Logs ohne Passwörter und Adressen) und ziehe sie zusammen mit Screenshots oder Videos auf die GitHub-Seite, sobald sie offen ist.",
"rep.makeFile": "Diagnosedatei erstellen",
"rep.fileSaved": "Gespeichert unter {path}. Ziehe diese Datei in das GitHub-Issue.",
"rep.privacy": "Bitte entferne Passwörter, Tokens, private IP-Angaben und andere sensible Daten, bevor du Logs veröffentlichst.",
"rep.open": "Bericht auf GitHub öffnen",
"rep.copy": "Text kopieren",
"rep.preview": "Text ansehen",
"rep.needFields": "Fülle zuerst die Zusammenfassung und „Was ist passiert?“ aus.",
"rep.githubNote": "Der Bericht ist auf Englisch gehalten, damit die Entwickler ihn lesen können; deine eigenen Worte bleiben so, wie du sie geschrieben hast.",
"rep.opened": "GitHub wurde im Browser geöffnet. Prüfe den Text, hänge Dateien an und klicke auf „Submit new issue“.",
"rep.openedLong": "Der Bericht ist für einen Link zu lang und wurde deshalb in die Zwischenablage kopiert. GitHub ist geöffnet: Füge ihn (Strg+V) in die Beschreibung ein, hänge Dateien an und klicke auf „Submit new issue“.",
"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 …",
"realm.addTitle": "Neue Realmlist",
"realm.editTitle": "Realmlist ändern",
"realm.name": "Name",
"realm.nameHint": "Zum Beispiel Solo oder PTR",
"realm.data": "Realmlist-Text",
"realm.dataHint": "Was in die realmlist.wtf geschrieben wird, zum Beispiel: set realmlist play.example.com. Du kannst auch nur die Adresse eingeben. Beim Auswählen wird die Realmlist in deinen Spielclient geschrieben; die vorherige Datei wird zuvor gesichert.",
"realm.switched": "Das Spiel verwendet jetzt „{name}“.",
"realm.edit": "{name} ändern",
"realm.delete": "{name} entfernen",
"realm.confirmDelete": "Realmlist „{name}“ entfernen? Der Spielclient behält die aktuelle Datei.",
"nav.modules": "Module",
"q.modules": "Welche Zusatzfunktionen hat der Server?",
"mod.title": "Module",
"mod.intro": "Zusatzfunktionen, die im Server eingebaut sind. Schalte die gewünschten ein oder aus, öffne ihre GitHub-Seite oder ändere ihre Einstellungen.",
"mod.restart": "Änderungen werden nach einem Neustart des Weltservers wirksam.",
"mod.switch": "{name} ein- oder ausschalten",
"mod.notHere": "Nicht Teil dieses Servers",
"mod.github": "GitHub",
"mod.settings": "Einstellungen",
"mod.default": "Zurück zum Standard ({v})",
"mod.saved": "Gespeichert ({n} geändert).",
// Modules page: nothing yet
"mod.empty": "Hier ist noch nichts. Optionale Module erscheinen auf dieser Seite, sobald sie hinzugefügt werden.",
// Settings page: the full searchable list
"all.title": "Alle Servereinstellungen",
"all.intro": "Alle weiteren dokumentierten Einstellungen des Weltservers mit Erklärung. Was auf den anderen Reitern steht, wird hier nicht wiederholt, die Suche oben findet aber alles. Ändere nur, was du verstehst: Ein falscher Wert kann den Server beschädigen. Die bisherige Konfiguration wird vorher gesichert und kann wiederhergestellt werden.",
"all.search": "Nach Name oder Beschreibung suchen…",
"all.onlyChanged": "Nur geänderte",
"all.count": "{shown} von {total} werden angezeigt. Suche, um die Liste einzugrenzen.",
"all.none": "Keine Einstellungen gefunden.",
"all.changed": "geändert",
"all.useDefault": "Standardwert verwenden ({v})",
"all.save": "{n} Änderung(en) speichern",
"all.saved": "Gespeichert. Starte den Server neu, um die Änderungen zu übernehmen.",
"import.suggest.title": "Meintest du diesen Ordner?",
"import.suggest.text": "Der gewählte Ordner gehört zu einem Server. Der Hauptordner des Servers ist:",
"import.suggest.use": "Diesen Ordner verwenden",
"import.notRepack": "Das sieht nach einem eigenständigen AzerothCore-Server aus. Der Manager arbeitet mit dem Aufbau des CoA Repack (ein Ordner mit Core, mysql, Scripts und Settings). Nutze stattdessen „Neuen Server installieren“ oder binde ein CoA Repack ein.",
"acc.delete": "Löschen",
"acc.deleteFor": "Konto {name} löschen?",
"acc.deleteWarn": "Das Konto und alle seine Charaktere ({n}) werden endgültig gelöscht. Das lässt sich nicht rückgängig machen; erstelle zuerst eine Sicherung, falls du sie noch brauchst.",
"acc.deleteConfirm": "Zur Bestätigung {name} eingeben",
"acc.deleteButton": "Konto löschen",
"acc.deleted": "Das Konto {name} wurde gelöscht.",
"mod.status.early": "Früh",
"mod.status.beta": "Beta",
"mod.status.release": "Release",
"mod.hint.early": "Experimentell: kann sich ändern oder kaputtgehen.",
"mod.hint.beta": "Funktioniert, wird noch getestet.",
"mod.hint.release": "Stabil.",
"mod.legend": "Modulstatus",
"mod.alwaysOn": "Immer an",
"mod.settingsOf": "{name}: Einstellungen",
"col.title": "Aussehen und Sammlungen",
"col.intro": "Schalter für die Sammlungen und Erleichterungen des Spielclients. Sie gelten nach dem Neustart des Weltservers.",
"col.appearances": "Alle Aussehen freischalten (Transmog)",
"col.appearances.text": "Alle Aussehen stehen von Anfang an im Schrank bereit.",
"col.vanity": "Die ganze Vanity-Sammlung freischalten",
"col.vanity.text": "Jedes Vanity-Objekt gehört jedem Konto.",
"col.auto": "Aussehen automatisch sammeln",
"col.auto.text": "Erhaltene Gegenstände werden der Sammlung hinzugefügt.",
"col.companions": "Besitz an Reittieren und Begleitern lehren",
"col.companions.text": "Deine Reittiere und Begleiter werden dauerhaft gelernt.",
"col.riding": "Maximales Reiten ab dem ersten Login",
"col.riding.text": "Alle Reitstufen und Kaltwetterflug, schon auf Stufe 1.",
"mod.status.soon": "Bald",
"mod.hint.soon": "Geplant: noch nicht verfügbar.",
"set.tab.collections": "Sammlungen",
"set.tab.all": "Weitere",
"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;
+222 -1
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",
@@ -113,7 +127,7 @@ const en = {
"import.custom.title": "Custom server detected",
"import.custom.text": "This build is not recognised. Some update and install features will be disabled.",
"import.incompatible.title": "This is not a server folder",
"import.incompatible.text": "Choose the folder that contains Core, Data and mysql (or your worldserver.exe).",
"import.incompatible.text": "Choose the main server folder: the one that contains the folders Core, Data, mysql, Scripts and Settings (not the Core folder itself).",
"import.techDetails": "Show technical details",
"import.detected": "Detected",
"import.notInstalled": "Not installed",
@@ -568,6 +582,213 @@ const en = {
"comp.despawnCount": "How many to log out",
"comp.despawnHint": "Eases the load right away: every online bot costs server time. They stay saved and return at the next start if automatic login is on.",
"comp.despawnSomeDone": "{n} companions logged out. They stay saved.",
// Server update button
"btn.update": "UPDATE",
"btn.updating": "UPDATING…",
"btn.updateTo": "Update to {v}",
"overview.updateAvail": "A server update is available: {to} (you have {from}).",
"overview.updateConflicts": "Some files were changed by you. Choose what to do with them in Settings.",
"overview.openUpdates": "Open updates",
"overview.updatingNote": "Updating: the server is stopped, backed up, updated and started again to check that it works.",
"nav.updateDot": "Update available",
// Game client download and update
"btn.close": "Close",
"btn.setupClient": "Set up game client",
"btn.updateClient": "UPDATE CLIENT",
"client.setup.title": "Set up the game client",
"client.setup.intro": "To play you need the game client. Use one you already have, or let the Manager download it.",
"client.setup.have": "I already have a client",
"client.setup.download": "Download the client",
"client.setup.downloadHint": "About 43 GB",
"client.dl.pickParent": "Choose where to put the game client",
"client.dl.confirmText": "Version {v}, {size}. It will be saved in this folder:",
"client.dl.free": "Free space on that drive: {free}.",
"client.dl.notEnough": "Not enough free space: {need} needed, {free} available. Choose another drive.",
"client.dl.otherFolder": "Other folder…",
"client.dl.start": "Download",
"client.dl.back": "Back",
"client.dl.retry": "Try again",
"client.dl.resume": "Continue",
"client.dl.cancel": "Stop",
"client.dl.cancelled": "Stopped. Everything already downloaded is kept; continue whenever you like.",
"client.dl.scanning": "Comparing files…",
"client.dl.downloading": "Downloading",
"client.dl.progress": "{done} of {total}",
"client.dl.speed": "{speed}/s",
"client.dl.done": "The game client is ready",
"client.dl.doneText": "It is linked to this server. You can press PLAY.",
"client.upd.title": "Client update",
"client.upd.available": "A newer game client is available: {v}.",
"client.upd.summary": "{n} file(s) to download, {size} in total.",
"client.upd.upToDate": "Your client already matches version {v}.",
"client.upd.modifiedTitle": "{n} file(s) were changed by you",
"client.upd.modifiedText": "For example a patched executable. Keep them, or replace them with the official versions; yours are then saved in the client’s .coa-manager folder. Graphics wrappers (d3d9.dll and the like) and config files are always left as they are.",
"client.upd.keep": "Keep the files I changed",
"client.upd.more": "… and {n} more",
"client.upd.start": "Update client",
"client.upd.later": "Not now",
"client.upd.playAnyway": "Play without updating",
"client.upd.done": "The game client is up to date",
"client.upd.doneText": "The Manager will tell you when a newer one is published.",
"client.track.title": "Keep the client up to date",
"client.track.text": "The Manager compares your client with the official one once, then checks for new versions like it does for the server. Files you changed are never replaced unless you say so.",
"client.track.start": "Keep up to date",
"client.track.startUpdate": "Update and keep up to date",
"client.track.button": "Keep this client up to date…",
"client.version": "Client version",
"client.versionUntracked": "not tracked by the Manager",
"client.versionUnfinished": "download not finished",
"client.downloadInstead": "Download a client…",
// Accounts panel, password toggle, install size, addon explanation
"pw.show": "Show password",
"pw.hide": "Hide password",
"install.size": "The server will take about {size} on the drive. The download is {download}; while it installs about {peak} is needed.",
"client.addonWhat": "A panel inside the game (opened from a minimap button) for commanding your companions: fill your group, set roles and formations, give orders such as attack, pull or hold, and see their gear and tasks. The game works without it; companions then simply follow their own AI.",
"acc.title": "Accounts",
"acc.text": "Everyone who can log in to this server. Password and access changes need the server to be running.",
"acc.refresh": "Refresh the list",
"acc.unavailable": "The list is not available right now. Start the server and try again.",
"acc.empty": "No accounts yet. Create the first one above.",
"acc.col.name": "Account",
"acc.col.chars": "Characters",
"acc.col.access": "Access",
"acc.col.last": "Last login",
"acc.online": "online",
"acc.never": "never",
"acc.level.0": "Player",
"acc.level.1": "Moderator",
"acc.level.2": "Game master",
"acc.level.3": "Administrator",
"acc.changePassword": "Change password",
"acc.rename": "Rename",
"acc.needsRunning": "Start the server to change accounts.",
"acc.changeFor": "New password for {name}",
"acc.renameFor": "Rename {name}",
"acc.newName": "New account name",
"acc.newPassword": "New password",
"acc.nameRule": "3–17 letters or digits.",
"acc.passRule": "6–16 characters, no spaces or quotes.",
"acc.renameNote": "A new password is needed because the login password depends on the account name. The player logs in with the new name and this password. The account must not be logged in.",
"acc.save": "Save",
"acc.passwordChanged": "The password of {name} was changed.",
"acc.renamed": "{name} is now called {new}.",
"acc.accessChanged": "{name} is now: {level}.",
// Problem report (GitHub issue)
"nav.report": "Report a problem",
"q.report": "Something not working?",
"rep.title": "Report a problem",
"rep.intro": "Describe what went wrong. The Manager prepares a bug report for GitHub from this and opens it in your browser; you read it, add screenshots and press Submit there. You need a free GitHub account. Nothing is sent from this window.",
"rep.autoTitle": "Filled in automatically",
"rep.manager": "Manager version",
"rep.windows": "Windows version",
"rep.kind": "Server",
"rep.kindNew": "Fresh install",
"rep.kindImported": "Imported server",
"rep.server": "Server version",
"rep.summary": "Short summary",
"rep.summaryHint": "For example: stuck on the loading screen after creating a character",
"rep.what": "What happened?",
"rep.whatHint": "Describe the problem.",
"rep.expected": "What did you expect to happen?",
"rep.expectedHint": "Describe the expected behaviour.",
"rep.steps": "Steps to reproduce",
"rep.attachTitle": "Logs and screenshots",
"rep.attachText": "Create a diagnostics file (settings and logs with passwords and addresses removed) and drag it, together with any screenshot or video, into the GitHub page once it is open.",
"rep.makeFile": "Create the diagnostics file",
"rep.fileSaved": "Saved to {path}. Drag this file into the GitHub issue.",
"rep.privacy": "Please remove passwords, tokens, private IP information or other sensitive data before posting logs.",
"rep.open": "Open the report on GitHub",
"rep.copy": "Copy the text",
"rep.preview": "Preview the text",
"rep.needFields": "Fill in the summary and what happened first.",
"rep.githubNote": "The report is written in English so the developers can read it; your own words stay as you typed them.",
"rep.opened": "GitHub was opened in your browser. Check the text, attach files and press Submit new issue.",
"rep.openedLong": "The report is too long for a link, so it was copied to the clipboard. GitHub is open: paste it (Ctrl+V) into the description, attach files and press Submit new issue.",
"rep.copied": "Copied to the clipboard.",
// Realmlist switcher and modules page
"realm.label": "Realm",
"realm.other": "Other",
"realm.add": "Add a realmlist…",
"realm.addTitle": "New realmlist",
"realm.editTitle": "Change the realmlist",
"realm.name": "Name",
"realm.nameHint": "For example Solo or PTR",
"realm.data": "Realmlist text",
"realm.dataHint": "What goes into realmlist.wtf, for example: set realmlist play.example.com. You can also type just the address. Choosing a realmlist writes it into your game client; the previous file is saved first.",
"realm.switched": "The game now uses “{name}”.",
"realm.edit": "Change {name}",
"realm.delete": "Remove {name}",
"realm.confirmDelete": "Remove the realmlist “{name}”? The game client keeps whatever file it has now.",
"nav.modules": "Modules",
"q.modules": "What extra features does the server have?",
"mod.title": "Modules",
"mod.intro": "Extra features built into the server. Switch the ones you want on or off, open their GitHub page, or change their settings.",
"mod.restart": "Changes apply after the world server restarts.",
"mod.switch": "Turn {name} on or off",
"mod.notHere": "Not part of this server",
"mod.github": "GitHub",
"mod.settings": "Settings",
"mod.default": "Back to the default ({v})",
"mod.saved": "Saved ({n} changed).",
// Modules page: nothing yet
"mod.empty": "There is nothing here yet. Optional modules will appear on this page as they are added.",
// Settings page: the full searchable list
"all.title": "All server settings",
"all.intro": "All other documented settings of the world server, with their explanations. The ones shown on the other tabs are not repeated here, but the search above finds everything. Change only what you understand: a wrong value can break the server. The previous configuration is saved first and can be restored.",
"all.search": "Search by name or description…",
"all.onlyChanged": "Only changed",
"all.count": "Showing {shown} of {total}. Search to narrow it down.",
"all.none": "No settings match.",
"all.changed": "changed",
"all.useDefault": "Use the default ({v})",
"all.save": "Save {n} change(s)",
"all.saved": "Saved. Restart the server to apply the changes.",
"import.suggest.title": "Did you mean this folder?",
"import.suggest.text": "The folder you chose belongs to a server. The server's main folder is:",
"import.suggest.use": "Use this folder",
"import.notRepack": "This looks like a standalone AzerothCore server. The Manager works with the CoA Repack layout (a folder that contains Core, mysql, Scripts and Settings). Use \"Install a new server\" instead, or import a CoA Repack.",
"acc.delete": "Delete",
"acc.deleteFor": "Delete the account {name}?",
"acc.deleteWarn": "This permanently deletes the account and all of its characters ({n}). It cannot be undone; make a backup first if you might need them.",
"acc.deleteConfirm": "Type {name} to confirm",
"acc.deleteButton": "Delete the account",
"acc.deleted": "The account {name} was deleted.",
"mod.status.early": "Early",
"mod.status.beta": "Beta",
"mod.status.release": "Release",
"mod.hint.early": "Experimental: may change or break.",
"mod.hint.beta": "Works, still being tested.",
"mod.hint.release": "Stable.",
"mod.legend": "Module status",
"mod.alwaysOn": "Always on",
"mod.settingsOf": "{name}: settings",
"col.title": "Appearances and collections",
"col.intro": "Switches for the collections and conveniences of the game client. They apply after the world server restarts.",
"col.appearances": "Unlock every appearance (transmog)",
"col.appearances.text": "All appearances are available in the wardrobe from the start.",
"col.vanity": "Unlock the whole vanity collection",
"col.vanity.text": "Every vanity entry is owned by every account.",
"col.auto": "Collect appearances automatically",
"col.auto.text": "Items a character obtains are added to the collection.",
"col.companions": "Teach owned mounts and companions",
"col.companions.text": "Mounts and companions you own are learned for good.",
"col.riding": "Maximum riding from the first login",
"col.riding.text": "All riding ranks and Cold Weather Flying, even at level 1.",
"mod.status.soon": "Soon",
"mod.hint.soon": "Planned: not available yet.",
"set.tab.collections": "Collections",
"set.tab.all": "Other settings",
"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;
+220 -1
View File
@@ -113,7 +113,7 @@ const es: Partial<Record<keyof typeof en, string>> = {
"import.custom.title": "Servidor personalizado detectado",
"import.custom.text": "Esta versión no se reconoce. Algunas funciones de actualización e instalación estarán desactivadas.",
"import.incompatible.title": "Esta no es una carpeta de servidor",
"import.incompatible.text": "Elige la carpeta que contiene Core, Data y mysql (o tu worldserver.exe).",
"import.incompatible.text": "Elige la carpeta principal del servidor: la que contiene las carpetas Core, Data, mysql, Scripts y Settings (no la carpeta Core en sí).",
"import.techDetails": "Mostrar detalles técnicos",
"import.detected": "Detectado",
"import.notInstalled": "No instalado",
@@ -568,6 +568,225 @@ const es: Partial<Record<keyof typeof en, string>> = {
"comp.despawnCount": "Cuántos desconectar",
"comp.despawnHint": "Alivia la carga al instante: cada bot conectado cuesta tiempo de servidor. Quedan guardados y vuelven en el próximo inicio si el inicio de sesión automático está activado.",
"comp.despawnSomeDone": "{n} compañeros desconectados. Quedan guardados.",
// Server update button
"btn.update": "ACTUALIZAR",
"btn.updating": "ACTUALIZANDO…",
"btn.updateTo": "Actualizar a {v}",
"overview.updateAvail": "Hay una actualización del servidor: {to} (tienes {from}).",
"overview.updateConflicts": "Algunos archivos los cambiaste tú. Decide en Ajustes qué hacer con ellos.",
"overview.openUpdates": "Abrir actualizaciones",
"overview.updatingNote": "Actualizando: el servidor se detiene, se respalda, se actualiza y se inicia de nuevo para comprobar que funciona.",
"nav.updateDot": "Actualización disponible",
// Game client download and update
"btn.close": "Cerrar",
"btn.setupClient": "Configurar el cliente del juego",
"btn.updateClient": "ACTUALIZAR CLIENTE",
"client.setup.title": "Configurar el cliente del juego",
"client.setup.intro": "Para jugar necesitas el cliente del juego. Usa uno que ya tengas o deja que el Manager lo descargue.",
"client.setup.have": "Ya tengo un cliente",
"client.setup.download": "Descargar el cliente",
"client.setup.downloadHint": "Unos 43 GB",
"client.dl.pickParent": "Elige dónde guardar el cliente del juego",
"client.dl.confirmText": "Versión {v}, {size}. Se guardará en esta carpeta:",
"client.dl.free": "Espacio libre en esa unidad: {free}.",
"client.dl.notEnough": "No hay espacio suficiente: se necesitan {need} y hay {free}. Elige otra unidad.",
"client.dl.otherFolder": "Otra carpeta…",
"client.dl.start": "Descargar",
"client.dl.back": "Atrás",
"client.dl.retry": "Reintentar",
"client.dl.resume": "Continuar",
"client.dl.cancel": "Detener",
"client.dl.cancelled": "Detenido. Todo lo ya descargado se conserva; puedes continuar cuando quieras.",
"client.dl.scanning": "Comparando archivos…",
"client.dl.downloading": "Descargando",
"client.dl.progress": "{done} de {total}",
"client.dl.speed": "{speed}/s",
"client.dl.done": "El cliente del juego está listo",
"client.dl.doneText": "Está vinculado a este servidor. Puedes pulsar PLAY.",
"client.upd.title": "Actualización del cliente",
"client.upd.available": "Hay un cliente del juego más reciente: {v}.",
"client.upd.summary": "{n} archivo(s) por descargar, {size} en total.",
"client.upd.upToDate": "Tu cliente ya coincide con la versión {v}.",
"client.upd.modifiedTitle": "{n} archivo(s) cambiado(s) por ti",
"client.upd.modifiedText": "Por ejemplo un ejecutable modificado. Consérvalos o reemplázalos por las versiones oficiales; los tuyos se guardan entonces en la carpeta .coa-manager del cliente. Los wrappers gráficos (d3d9.dll y similares) y los archivos de configuración se dejan siempre como están.",
"client.upd.keep": "Conservar los archivos que cambié",
"client.upd.more": "… y {n} más",
"client.upd.start": "Actualizar cliente",
"client.upd.later": "Ahora no",
"client.upd.playAnyway": "Jugar sin actualizar",
"client.upd.done": "El cliente del juego está actualizado",
"client.upd.doneText": "El Manager te avisará cuando se publique una más reciente.",
"client.track.title": "Mantener el cliente actualizado",
"client.track.text": "El Manager compara una vez tu cliente con el oficial y luego busca versiones nuevas como hace con el servidor. Los archivos que cambiaste solo se reemplazan si tú lo decides.",
"client.track.start": "Mantener actualizado",
"client.track.startUpdate": "Actualizar y mantener actualizado",
"client.track.button": "Mantener este cliente actualizado…",
"client.version": "Versión del cliente",
"client.versionUntracked": "el Manager no la sigue",
"client.versionUnfinished": "descarga sin terminar",
"client.downloadInstead": "Descargar un cliente…",
// Accounts panel, password toggle, install size, addon explanation
"pw.show": "Mostrar contraseña",
"pw.hide": "Ocultar contraseña",
"install.size": "El servidor ocupará unos {size} en la unidad. La descarga es de {download}; durante la instalación se necesitan unos {peak}.",
"client.addonWhat": "Un panel dentro del juego (se abre desde un botón del minimapa) para dirigir a tus compañeros: completar el grupo, definir roles y formaciones, dar órdenes como atacar, iniciar combate o mantener posición, y ver su equipo y tareas. El juego funciona sin él; los compañeros simplemente siguen su propia IA.",
"acc.title": "Cuentas",
"acc.text": "Todas las personas que pueden entrar en este servidor. Para cambiar contraseñas y accesos el servidor debe estar en marcha.",
"acc.refresh": "Actualizar la lista",
"acc.unavailable": "La lista no está disponible ahora. Inicia el servidor e inténtalo de nuevo.",
"acc.empty": "Aún no hay cuentas. Crea la primera arriba.",
"acc.col.name": "Cuenta",
"acc.col.chars": "Personajes",
"acc.col.access": "Acceso",
"acc.col.last": "Último acceso",
"acc.online": "en línea",
"acc.never": "nunca",
"acc.level.0": "Jugador",
"acc.level.1": "Moderador",
"acc.level.2": "Maestro del juego",
"acc.level.3": "Administrador",
"acc.changePassword": "Cambiar contraseña",
"acc.rename": "Renombrar",
"acc.needsRunning": "Inicia el servidor para cambiar las cuentas.",
"acc.changeFor": "Nueva contraseña para {name}",
"acc.renameFor": "Renombrar {name}",
"acc.newName": "Nuevo nombre de cuenta",
"acc.newPassword": "Nueva contraseña",
"acc.nameRule": "De 3 a 17 letras o dígitos.",
"acc.passRule": "De 6 a 16 caracteres, sin espacios ni comillas.",
"acc.renameNote": "Hace falta una contraseña nueva porque la contraseña de acceso depende del nombre de la cuenta. El jugador entra con el nuevo nombre y esta contraseña. La cuenta no debe estar conectada.",
"acc.save": "Guardar",
"acc.passwordChanged": "Se cambió la contraseña de {name}.",
"acc.renamed": "{name} ahora se llama {new}.",
"acc.accessChanged": "{name} ahora es: {level}.",
// Problem report (GitHub issue)
"nav.report": "Informar de un problema",
"q.report": "¿Algo no funciona?",
"rep.title": "Informar de un problema",
"rep.intro": "Describe qué salió mal. El Manager prepara con ello un informe de error para GitHub y lo abre en tu navegador; allí lo revisas, añades capturas y lo envías. Necesitas una cuenta gratuita de GitHub. Desde esta ventana no se envía nada.",
"rep.autoTitle": "Se rellena automáticamente",
"rep.manager": "Versión del Manager",
"rep.windows": "Versión de Windows",
"rep.kind": "Servidor",
"rep.kindNew": "Instalación nueva",
"rep.kindImported": "Servidor importado",
"rep.server": "Versión del servidor",
"rep.summary": "Resumen breve",
"rep.summaryHint": "Por ejemplo: pantalla de carga atascada tras crear un personaje",
"rep.what": "¿Qué pasó?",
"rep.whatHint": "Describe el problema.",
"rep.expected": "¿Qué esperabas que pasara?",
"rep.expectedHint": "Describe el comportamiento esperado.",
"rep.steps": "Pasos para reproducirlo",
"rep.attachTitle": "Registros y capturas",
"rep.attachText": "Crea un archivo de diagnóstico (ajustes y registros sin contraseñas ni direcciones) y arrástralo, junto con capturas o vídeos, a la página de GitHub cuando se abra.",
"rep.makeFile": "Crear el archivo de diagnóstico",
"rep.fileSaved": "Guardado en {path}. Arrastra este archivo al issue de GitHub.",
"rep.privacy": "Elimina contraseñas, tokens, información de IP privada y otros datos sensibles antes de publicar registros.",
"rep.open": "Abrir el informe en GitHub",
"rep.copy": "Copiar el texto",
"rep.preview": "Ver el texto",
"rep.needFields": "Rellena primero el resumen y «¿Qué pasó?».",
"rep.githubNote": "El informe está en inglés para que los desarrolladores puedan leerlo; tus propias palabras se quedan como las escribiste.",
"rep.opened": "GitHub se abrió en tu navegador. Revisa el texto, adjunta archivos y pulsa «Submit new issue».",
"rep.openedLong": "El informe es demasiado largo para un enlace, así que se copió al portapapeles. GitHub está abierto: pégalo (Ctrl+V) en la descripción, adjunta archivos y pulsa «Submit new issue».",
"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…",
"realm.addTitle": "Nueva realmlist",
"realm.editTitle": "Cambiar la realmlist",
"realm.name": "Nombre",
"realm.nameHint": "Por ejemplo Solo o PTR",
"realm.data": "Texto de la realmlist",
"realm.dataHint": "Lo que se escribe en realmlist.wtf, por ejemplo: set realmlist play.example.com. También puedes escribir solo la dirección. Al elegir una realmlist se escribe en tu cliente; el archivo anterior se guarda antes.",
"realm.switched": "El juego ahora usa «{name}».",
"realm.edit": "Cambiar {name}",
"realm.delete": "Eliminar {name}",
"realm.confirmDelete": "¿Eliminar la realmlist «{name}»? El cliente conserva el archivo actual.",
"nav.modules": "Módulos",
"q.modules": "¿Qué funciones adicionales tiene el servidor?",
"mod.title": "Módulos",
"mod.intro": "Funciones adicionales integradas en el servidor. Activa o desactiva las que quieras, abre su página de GitHub o cambia sus ajustes.",
"mod.restart": "Los cambios se aplican al reiniciar el servidor del mundo.",
"mod.switch": "Activar o desactivar {name}",
"mod.notHere": "No forma parte de este servidor",
"mod.github": "GitHub",
"mod.settings": "Ajustes",
"mod.default": "Volver al valor por defecto ({v})",
"mod.saved": "Guardado ({n} cambiado(s)).",
// Modules page: nothing yet
"mod.empty": "Aquí todavía no hay nada. Los módulos opcionales aparecerán en esta página a medida que se añadan.",
// Settings page: the full searchable list
"all.title": "Todos los ajustes del servidor",
"all.intro": "Todos los demás ajustes documentados del servidor del mundo, con su explicación. Los de las otras pestañas no se repiten aquí, pero la búsqueda de arriba lo encuentra todo. Cambia solo lo que entiendas: un valor incorrecto puede romper el servidor. La configuración anterior se guarda antes y se puede restaurar.",
"all.search": "Buscar por nombre o descripción…",
"all.onlyChanged": "Solo los cambiados",
"all.count": "Mostrando {shown} de {total}. Usa la búsqueda para acotar.",
"all.none": "Ningún ajuste coincide.",
"all.changed": "cambiado",
"all.useDefault": "Usar el valor predeterminado ({v})",
"all.save": "Guardar {n} cambio(s)",
"all.saved": "Guardado. Reinicia el servidor para aplicar los cambios.",
"import.suggest.title": "¿Quisiste decir esta carpeta?",
"import.suggest.text": "La carpeta elegida pertenece a un servidor. La carpeta principal del servidor es:",
"import.suggest.use": "Usar esta carpeta",
"import.notRepack": "Parece un servidor AzerothCore independiente. El Manager funciona con la estructura del CoA Repack (una carpeta que contiene Core, mysql, Scripts y Settings). Usa «Instalar un servidor nuevo» o importa un CoA Repack.",
"acc.delete": "Eliminar",
"acc.deleteFor": "¿Eliminar la cuenta {name}?",
"acc.deleteWarn": "La cuenta y todos sus personajes ({n}) se eliminarán de forma permanente. No se puede deshacer; haz antes una copia de seguridad si pudieras necesitarlos.",
"acc.deleteConfirm": "Escribe {name} para confirmar",
"acc.deleteButton": "Eliminar la cuenta",
"acc.deleted": "La cuenta {name} se eliminó.",
"mod.status.early": "Temprano",
"mod.status.beta": "Beta",
"mod.status.release": "Estable",
"mod.hint.early": "Experimental: puede cambiar o fallar.",
"mod.hint.beta": "Funciona, aún en pruebas.",
"mod.hint.release": "Estable.",
"mod.legend": "Estado del módulo",
"mod.alwaysOn": "Siempre activo",
"mod.settingsOf": "{name}: ajustes",
"col.title": "Apariencias y colecciones",
"col.intro": "Ajustes de las colecciones y comodidades del cliente del juego. Se aplican al reiniciar el servidor del mundo.",
"col.appearances": "Desbloquear todas las apariencias (transfiguración)",
"col.appearances.text": "Todas las apariencias están disponibles desde el principio.",
"col.vanity": "Desbloquear toda la colección Vanity",
"col.vanity.text": "Cada objeto Vanity pertenece a cada cuenta.",
"col.auto": "Recoger apariencias automáticamente",
"col.auto.text": "Los objetos que obtiene un personaje se añaden a la colección.",
"col.companions": "Enseñar monturas y mascotas que posees",
"col.companions.text": "Tus monturas y mascotas se aprenden para siempre.",
"col.riding": "Equitación máxima desde el primer inicio",
"col.riding.text": "Todos los rangos de equitación y vuelo en clima frío, desde el nivel 1.",
"mod.status.soon": "Pronto",
"mod.hint.soon": "Previsto: aún no disponible.",
"set.tab.collections": "Colecciones",
"set.tab.all": "Otros",
"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;
+220 -1
View File
@@ -113,7 +113,7 @@ const fr: Partial<Record<keyof typeof en, string>> = {
"import.custom.title": "Serveur personnalisé détecté",
"import.custom.text": "Cette version n’est pas reconnue. Certaines fonctions de mise à jour et d’installation seront désactivées.",
"import.incompatible.title": "Ce n’est pas un dossier de serveur",
"import.incompatible.text": "Choisissez le dossier qui contient Core, Data et mysql (ou votre worldserver.exe).",
"import.incompatible.text": "Choisissez le dossier principal du serveur : celui qui contient les dossiers Core, Data, mysql, Scripts et Settings (et non le dossier Core lui-même).",
"import.techDetails": "Afficher les détails techniques",
"import.detected": "Détecté",
"import.notInstalled": "Non installé",
@@ -568,6 +568,225 @@ const fr: Partial<Record<keyof typeof en, string>> = {
"comp.despawnCount": "Combien déconnecter",
"comp.despawnHint": "Allège aussitôt la charge : chaque bot en ligne coûte du temps serveur. Ils restent enregistrés et reviennent au prochain démarrage si la connexion automatique est activée.",
"comp.despawnSomeDone": "{n} compagnons déconnectés. Ils restent enregistrés.",
// Server update button
"btn.update": "METTRE À JOUR",
"btn.updating": "MISE À JOUR…",
"btn.updateTo": "Mettre à jour vers {v}",
"overview.updateAvail": "Une mise à jour du serveur est disponible : {to} (vous avez {from}).",
"overview.updateConflicts": "Certains fichiers ont été modifiés par vous. Choisissez dans les Paramètres ce qu’il faut en faire.",
"overview.openUpdates": "Ouvrir les mises à jour",
"overview.updatingNote": "Mise à jour : le serveur est arrêté, sauvegardé, mis à jour puis relancé pour vérifier qu’il fonctionne.",
"nav.updateDot": "Mise à jour disponible",
// Game client download and update
"btn.close": "Fermer",
"btn.setupClient": "Configurer le client du jeu",
"btn.updateClient": "METTRE À JOUR LE CLIENT",
"client.setup.title": "Configurer le client du jeu",
"client.setup.intro": "Pour jouer, il faut le client du jeu. Utilisez-en un existant ou laissez le Manager le télécharger.",
"client.setup.have": "J’ai déjà un client",
"client.setup.download": "Télécharger le client",
"client.setup.downloadHint": "Environ 43 Go",
"client.dl.pickParent": "Choisissez où placer le client du jeu",
"client.dl.confirmText": "Version {v}, {size}. Il sera enregistré dans ce dossier :",
"client.dl.free": "Espace libre sur ce disque : {free}.",
"client.dl.notEnough": "Espace libre insuffisant : {need} nécessaires, {free} disponibles. Choisissez un autre disque.",
"client.dl.otherFolder": "Autre dossier…",
"client.dl.start": "Télécharger",
"client.dl.back": "Retour",
"client.dl.retry": "Réessayer",
"client.dl.resume": "Continuer",
"client.dl.cancel": "Arrêter",
"client.dl.cancelled": "Arrêté. Tout ce qui est déjà téléchargé est conservé ; vous pouvez reprendre à tout moment.",
"client.dl.scanning": "Comparaison des fichiers…",
"client.dl.downloading": "Téléchargement",
"client.dl.progress": "{done} sur {total}",
"client.dl.speed": "{speed}/s",
"client.dl.done": "Le client du jeu est prêt",
"client.dl.doneText": "Il est lié à ce serveur. Vous pouvez appuyer sur PLAY.",
"client.upd.title": "Mise à jour du client",
"client.upd.available": "Un client de jeu plus récent est disponible : {v}.",
"client.upd.summary": "{n} fichier(s) à télécharger, {size} au total.",
"client.upd.upToDate": "Votre client correspond déjà à la version {v}.",
"client.upd.modifiedTitle": "{n} fichier(s) modifié(s) par vous",
"client.upd.modifiedText": "Par exemple un exécutable modifié. Conservez-les ou remplacez-les par les versions officielles ; les vôtres sont alors sauvegardées dans le dossier .coa-manager du client. Les wrappers graphiques (d3d9.dll et similaires) et les fichiers de configuration restent toujours tels quels.",
"client.upd.keep": "Conserver les fichiers que j’ai modifiés",
"client.upd.more": "… et {n} de plus",
"client.upd.start": "Mettre à jour le client",
"client.upd.later": "Pas maintenant",
"client.upd.playAnyway": "Jouer sans mettre à jour",
"client.upd.done": "Le client du jeu est à jour",
"client.upd.doneText": "Le Manager vous préviendra quand une version plus récente sera publiée.",
"client.track.title": "Garder le client à jour",
"client.track.text": "Le Manager compare une fois votre client avec l’officiel, puis cherche les nouvelles versions comme pour le serveur. Les fichiers que vous avez modifiés ne sont remplacés que si vous le décidez.",
"client.track.start": "Garder à jour",
"client.track.startUpdate": "Mettre à jour et garder à jour",
"client.track.button": "Garder ce client à jour…",
"client.version": "Version du client",
"client.versionUntracked": "non suivi par le Manager",
"client.versionUnfinished": "téléchargement inachevé",
"client.downloadInstead": "Télécharger un client…",
// Accounts panel, password toggle, install size, addon explanation
"pw.show": "Afficher le mot de passe",
"pw.hide": "Masquer le mot de passe",
"install.size": "Le serveur occupera environ {size} sur le disque. Le téléchargement fait {download} ; pendant l’installation, environ {peak} sont nécessaires.",
"client.addonWhat": "Un panneau dans le jeu (ouvert depuis un bouton de la minicarte) pour commander vos compagnons : compléter le groupe, définir rôles et formations, donner des ordres (attaquer, engager, tenir la position) et voir leur équipement et leurs tâches. Le jeu fonctionne sans lui ; les compagnons suivent alors simplement leur propre IA.",
"acc.title": "Comptes",
"acc.text": "Toutes les personnes qui peuvent se connecter à ce serveur. Changer un mot de passe ou un accès nécessite que le serveur soit lancé.",
"acc.refresh": "Actualiser la liste",
"acc.unavailable": "La liste n’est pas disponible pour le moment. Lancez le serveur et réessayez.",
"acc.empty": "Aucun compte pour l’instant. Créez le premier ci-dessus.",
"acc.col.name": "Compte",
"acc.col.chars": "Personnages",
"acc.col.access": "Accès",
"acc.col.last": "Dernière connexion",
"acc.online": "en ligne",
"acc.never": "jamais",
"acc.level.0": "Joueur",
"acc.level.1": "Modérateur",
"acc.level.2": "Maître de jeu",
"acc.level.3": "Administrateur",
"acc.changePassword": "Changer le mot de passe",
"acc.rename": "Renommer",
"acc.needsRunning": "Lancez le serveur pour modifier les comptes.",
"acc.changeFor": "Nouveau mot de passe pour {name}",
"acc.renameFor": "Renommer {name}",
"acc.newName": "Nouveau nom de compte",
"acc.newPassword": "Nouveau mot de passe",
"acc.nameRule": "3 à 17 lettres ou chiffres.",
"acc.passRule": "6 à 16 caractères, sans espaces ni guillemets.",
"acc.renameNote": "Un nouveau mot de passe est nécessaire car le mot de passe de connexion dépend du nom du compte. Le joueur se connecte avec le nouveau nom et ce mot de passe. Le compte ne doit pas être connecté.",
"acc.save": "Enregistrer",
"acc.passwordChanged": "Le mot de passe de {name} a été modifié.",
"acc.renamed": "{name} s’appelle maintenant {new}.",
"acc.accessChanged": "{name} est maintenant : {level}.",
// Problem report (GitHub issue)
"nav.report": "Signaler un problème",
"q.report": "Quelque chose ne marche pas ?",
"rep.title": "Signaler un problème",
"rep.intro": "Décrivez ce qui s’est mal passé. Le Manager en prépare un rapport de bug pour GitHub et l’ouvre dans votre navigateur ; vous le relisez, ajoutez des captures d’écran et l’envoyez là-bas. Un compte GitHub gratuit est nécessaire. Rien n’est envoyé depuis cette fenêtre.",
"rep.autoTitle": "Rempli automatiquement",
"rep.manager": "Version du Manager",
"rep.windows": "Version de Windows",
"rep.kind": "Serveur",
"rep.kindNew": "Nouvelle installation",
"rep.kindImported": "Serveur importé",
"rep.server": "Version du serveur",
"rep.summary": "Résumé court",
"rep.summaryHint": "Par exemple : écran de chargement bloqué après la création d’un personnage",
"rep.what": "Que s’est-il passé ?",
"rep.whatHint": "Décrivez le problème.",
"rep.expected": "Qu’attendiez-vous ?",
"rep.expectedHint": "Décrivez le comportement attendu.",
"rep.steps": "Étapes pour reproduire",
"rep.attachTitle": "Journaux et captures d’écran",
"rep.attachText": "Créez un fichier de diagnostic (réglages et journaux sans mots de passe ni adresses) et glissez-le, avec vos captures ou vidéos, sur la page GitHub une fois ouverte.",
"rep.makeFile": "Créer le fichier de diagnostic",
"rep.fileSaved": "Enregistré dans {path}. Glissez ce fichier dans l’issue GitHub.",
"rep.privacy": "Veuillez retirer les mots de passe, jetons, adresses IP privées et autres données sensibles avant de publier des journaux.",
"rep.open": "Ouvrir le rapport sur GitHub",
"rep.copy": "Copier le texte",
"rep.preview": "Aperçu du texte",
"rep.needFields": "Remplissez d’abord le résumé et « Que s’est-il passé ? ».",
"rep.githubNote": "Le rapport est rédigé en anglais pour que les développeurs puissent le lire ; vos propres mots restent tels que vous les avez écrits.",
"rep.opened": "GitHub s’est ouvert dans votre navigateur. Vérifiez le texte, joignez les fichiers et appuyez sur « Submit new issue ».",
"rep.openedLong": "Le rapport est trop long pour un lien : il a été copié dans le presse-papiers. GitHub est ouvert : collez-le (Ctrl+V) dans la description, joignez les fichiers et appuyez sur « Submit new issue ».",
"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…",
"realm.addTitle": "Nouvelle realmlist",
"realm.editTitle": "Modifier la realmlist",
"realm.name": "Nom",
"realm.nameHint": "Par exemple Solo ou PTR",
"realm.data": "Texte de la realmlist",
"realm.dataHint": "Ce qui sera écrit dans realmlist.wtf, par exemple : set realmlist play.example.com. Vous pouvez aussi saisir seulement l’adresse. Choisir une realmlist l’écrit dans votre client ; l’ancien fichier est d’abord sauvegardé.",
"realm.switched": "Le jeu utilise maintenant « {name} ».",
"realm.edit": "Modifier {name}",
"realm.delete": "Supprimer {name}",
"realm.confirmDelete": "Supprimer la realmlist « {name} » ? Le client garde le fichier actuel.",
"nav.modules": "Modules",
"q.modules": "Quelles fonctions supplémentaires le serveur propose-t-il ?",
"mod.title": "Modules",
"mod.intro": "Fonctions supplémentaires intégrées au serveur. Activez ou désactivez celles que vous voulez, ouvrez leur page GitHub ou modifiez leurs réglages.",
"mod.restart": "Les changements s’appliquent après le redémarrage du serveur de monde.",
"mod.switch": "Activer ou désactiver {name}",
"mod.notHere": "Ne fait pas partie de ce serveur",
"mod.github": "GitHub",
"mod.settings": "Réglages",
"mod.default": "Revenir à la valeur par défaut ({v})",
"mod.saved": "Enregistré ({n} modifié(s)).",
// Modules page: nothing yet
"mod.empty": "Il n’y a encore rien ici. Les modules optionnels apparaîtront sur cette page au fur et à mesure de leur ajout.",
// Settings page: the full searchable list
"all.title": "Tous les réglages du serveur",
"all.intro": "Tous les autres réglages documentés du serveur de monde, avec leur explication. Ceux des autres onglets ne sont pas répétés ici, mais la recherche ci-dessus trouve tout. Ne modifiez que ce que vous comprenez : une mauvaise valeur peut casser le serveur. La configuration précédente est sauvegardée d'abord et peut être restaurée.",
"all.search": "Rechercher par nom ou description…",
"all.onlyChanged": "Seulement les modifiés",
"all.count": "{shown} sur {total} affichés. Utilisez la recherche pour affiner.",
"all.none": "Aucun réglage ne correspond.",
"all.changed": "modifié",
"all.useDefault": "Utiliser la valeur par défaut ({v})",
"all.save": "Enregistrer {n} modification(s)",
"all.saved": "Enregistré. Redémarrez le serveur pour appliquer les changements.",
"import.suggest.title": "Vouliez-vous ce dossier ?",
"import.suggest.text": "Le dossier choisi fait partie d'un serveur. Le dossier principal du serveur est :",
"import.suggest.use": "Utiliser ce dossier",
"import.notRepack": "Cela ressemble à un serveur AzerothCore autonome. Le Manager fonctionne avec la structure du CoA Repack (un dossier contenant Core, mysql, Scripts et Settings). Utilisez plutôt « Installer un nouveau serveur » ou importez un CoA Repack.",
"acc.delete": "Supprimer",
"acc.deleteFor": "Supprimer le compte {name} ?",
"acc.deleteWarn": "Le compte et tous ses personnages ({n}) seront supprimés définitivement. C'est irréversible ; faites d'abord une sauvegarde si vous pouvez en avoir besoin.",
"acc.deleteConfirm": "Saisissez {name} pour confirmer",
"acc.deleteButton": "Supprimer le compte",
"acc.deleted": "Le compte {name} a été supprimé.",
"mod.status.early": "Précoce",
"mod.status.beta": "Bêta",
"mod.status.release": "Stable",
"mod.hint.early": "Expérimental : peut changer ou casser.",
"mod.hint.beta": "Fonctionne, encore en test.",
"mod.hint.release": "Stable.",
"mod.legend": "Statut du module",
"mod.alwaysOn": "Toujours actif",
"mod.settingsOf": "{name} : réglages",
"col.title": "Apparences et collections",
"col.intro": "Réglages des collections et facilités du client de jeu. Ils s'appliquent après le redémarrage du serveur de monde.",
"col.appearances": "Débloquer toutes les apparences (transmo)",
"col.appearances.text": "Toutes les apparences sont disponibles dès le départ.",
"col.vanity": "Débloquer toute la collection Vanity",
"col.vanity.text": "Chaque objet Vanity appartient à chaque compte.",
"col.auto": "Collecter les apparences automatiquement",
"col.auto.text": "Les objets obtenus sont ajoutés à la collection.",
"col.companions": "Apprendre les montures et compagnons possédés",
"col.companions.text": "Vos montures et compagnons sont appris définitivement.",
"col.riding": "Monte maximale dès la première connexion",
"col.riding.text": "Tous les rangs de monte et le vol par temps froid, dès le niveau 1.",
"mod.status.soon": "Bientôt",
"mod.hint.soon": "Prévu : pas encore disponible.",
"set.tab.collections": "Collections",
"set.tab.all": "Autres",
"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;
+220 -1
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": "Сервер",
@@ -113,7 +125,7 @@ const ru: Partial<Record<keyof typeof en, string>> = {
"import.custom.title": "Найден нестандартный сервер",
"import.custom.text": "Эта сборка не распознана. Часть функций обновления и установки будет отключена.",
"import.incompatible.title": "Это не папка сервера",
"import.incompatible.text": "Выберите папку, в которой лежат Core, Data и mysql (или ваш worldserver.exe).",
"import.incompatible.text": "Выберите главную папку сервера: ту, где лежат папки Core, Data, mysql, Scripts и Settings (а не саму папку Core).",
"import.techDetails": "Показать технические подробности",
"import.detected": "Найдено",
"import.notInstalled": "Не установлено",
@@ -568,6 +580,213 @@ const ru: Partial<Record<keyof typeof en, string>> = {
"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 ГБ",
"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": "Он привязан к этому серверу. Можно нажимать PLAY.",
"client.upd.title": "Обновление клиента",
"client.upd.available": "Доступна новая версия клиента игры: {v}.",
"client.upd.summary": "Файлов к загрузке: {n}, всего {size}.",
"client.upd.upToDate": "Ваш клиент уже соответствует версии {v}.",
"client.upd.modifiedTitle": "Файлов, изменённых вами: {n}",
"client.upd.modifiedText": "Например, изменённый exe. Оставьте их или замените официальными версиями; ваши тогда сохранятся в папке .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": "Панель внутри игры (открывается кнопкой у миникарты) для управления компаньонами: набрать группу, назначить роли и построения, отдавать приказы (атаковать, начать бой, держать позицию), смотреть их снаряжение и задания. Без аддона игра работает: компаньоны просто действуют по своему ИИ.",
"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": "Модератор",
"acc.level.2": "Гейм-мастер",
"acc.level.3": "Администратор",
"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 и откроет его в браузере; вы прочитаете его, добавите скриншоты и нажмёте «Submit» уже там. Нужен бесплатный аккаунт 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": "Создайте файл диагностики (настройки и логи без паролей и адресов) и перетащите его вместе со скриншотами или видео на страницу GitHub, когда она откроется.",
"rep.makeFile": "Создать файл диагностики",
"rep.fileSaved": "Сохранено: {path}. Перетащите этот файл в issue на GitHub.",
"rep.privacy": "Перед публикацией логов удалите пароли, токены, частные IP-адреса и другие личные данные.",
"rep.open": "Открыть отчёт на GitHub",
"rep.copy": "Копировать текст",
"rep.preview": "Показать текст отчёта",
"rep.needFields": "Сначала заполните краткое описание и «Что произошло?».",
"rep.githubNote": "Шаблон отчёта на английском, чтобы его мог прочитать разработчик; ваши формулировки остаются как вы их написали.",
"rep.opened": "GitHub открыт в браузере. Проверьте текст, прикрепите файлы и нажмите «Submit new issue».",
"rep.openedLong": "Отчёт слишком длинный для ссылки, поэтому он скопирован в буфер обмена. GitHub открыт: вставьте текст (Ctrl+V) в описание, прикрепите файлы и нажмите «Submit new issue».",
"rep.copied": "Скопировано в буфер обмена.",
// Realmlist switcher and modules page
"realm.label": "Реалм",
"realm.other": "Другой",
"realm.add": "Добавить реалмлист…",
"realm.addTitle": "Новый реалмлист",
"realm.editTitle": "Изменить реалмлист",
"realm.name": "Название",
"realm.nameHint": "Например: Solo или PTR",
"realm.data": "Текст реалмлиста",
"realm.dataHint": "То, что попадёт в realmlist.wtf, например: set realmlist play.example.com. Можно ввести и просто адрес. Выбор реалмлиста записывает его в ваш игровой клиент; прежний файл сначала сохраняется.",
"realm.switched": "Игра теперь использует «{name}».",
"realm.edit": "Изменить {name}",
"realm.delete": "Удалить {name}",
"realm.confirmDelete": "Удалить реалмлист «{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": "Обновление клиента",
};
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;
+89 -1
View File
@@ -462,6 +462,94 @@
"Updates.EnableDatabases": {
"t": "Automatische Datenbank-Updates",
"d": "Erlaubt dem Server, seine Datenbanken beim Start selbst zu ändern. Lass es auf 0: Der Manager wendet Datenbank-Updates sicher an und verfolgt sie."
},
"MapUpdate.Threads": {
"t": "CPU-Kerne für die Welt",
"d": "Wie viele Prozessorkerne die Welt zum Aktualisieren der Karten nutzt. Begleiter, die sich über mehrere Karten verteilen, laufen mit mehr als einem Kern deutlich schneller. Wird nach einem Neustart des Weltservers wirksam."
},
"Rate.Drop.Item.Uncommon": {
"t": "Droprate für ungewöhnliche Gegenstände",
"d": "Multiplikator dafür, wie oft ungewöhnliche (grüne) Gegenstände fallen."
},
"Rate.Drop.Item.Rare": {
"t": "Droprate für seltene Gegenstände",
"d": "Multiplikator dafür, wie oft seltene (blaue) Gegenstände fallen."
},
"Rate.Drop.Item.Epic": {
"t": "Droprate für epische Gegenstände",
"d": "Multiplikator dafür, wie oft epische (lila) Gegenstände fallen."
},
"Rate.Drop.Item.Legendary": {
"t": "Droprate für legendäre Gegenstände",
"d": "Multiplikator dafür, wie oft legendäre (orange) Gegenstände fallen."
},
"Rate.Talent": {
"t": "Talentpunkte",
"d": "Multiplikator für die Talentpunkte, die ein Charakter pro Stufe erhält."
},
"Rate.Skill.Discovery": {
"t": "Chance auf Rezeptentdeckung",
"d": "Multiplikator für die Chance, beim Herstellen ein neues Rezept zu entdecken."
},
"Rate.RepairCost": {
"t": "Reparaturkosten",
"d": "Multiplikator für die Kosten der Ausrüstungsreparatur. 0 macht Reparaturen kostenlos."
},
"Rate.Auction.Cut": {
"t": "Auktionshaus-Gebühr",
"d": "Multiplikator für den Anteil eines Verkaufs, den das Auktionshaus behält. 0 bedeutet keine Gebühr."
},
"Rate.ArenaPoints": {
"t": "Arenapunkte",
"d": "Multiplikator für erhaltene Arenapunkte."
},
"Rate.XP.Pet": {
"t": "Begleiter-Erfahrung",
"d": "Multiplikator für die Erfahrung, die Begleiter von Jägern erhalten."
},
"Instance.IgnoreLevel": {
"t": "Stufenanforderungen für Dungeons ignorieren",
"d": "Charaktere jeder Stufe können Dungeons und Schlachtzüge betreten."
},
"Instance.IgnoreRaid": {
"t": "Schlachtzüge ohne Schlachtzugsgruppe betreten",
"d": "Spieler können Schlachtzugsinstanzen betreten, ohne in einer Schlachtzugsgruppe zu sein."
},
"Instance.ResetTimeHour": {
"t": "Dungeon-Reset-Stunde",
"d": "Uhrzeit (0–23), zu der Dungeon- und Schlachtzugssperren zurückgesetzt werden."
},
"MaxPrimaryTradeSkill": {
"t": "Hauptberufe pro Charakter",
"d": "Wie viele Hauptberufe (z. B. Schmiedekunst oder Kräuterkunde) ein Charakter erlernen darf."
},
"AlwaysMaxSkillForLevel": {
"t": "Fertigkeiten immer auf Maximum der Stufe",
"d": "Waffen- und andere Fertigkeiten sind immer auf dem Maximum der Charakterstufe, Training ist nicht nötig."
},
"ActivateWeather": {
"t": "Wetter",
"d": "Schaltet Regen, Schnee und Stürme ein oder aus."
},
"Group.Raid.LevelRestriction": {
"t": "Mindeststufe zum Einladen in einen Schlachtzug",
"d": "Charaktere unter dieser Stufe können nicht in eine Schlachtzugsgruppe eingeladen werden."
},
"AllowTwoSide.Interaction.Group": {
"t": "Gruppen über Fraktionen hinweg",
"d": "Spieler der Allianz und der Horde können gemeinsam Gruppen bilden."
},
"AllowTwoSide.Interaction.Guild": {
"t": "Gilden über Fraktionen hinweg",
"d": "Spieler der Allianz und der Horde können derselben Gilde beitreten."
},
"AllowTwoSide.Interaction.Auction": {
"t": "Gemeinsames Auktionshaus",
"d": "Spieler der Allianz und der Horde nutzen dasselbe Auktionshaus."
},
"Achievement.RealmFirstBlockBots": {
"t": "Bots erhalten kein „Server-Erster“",
"d": "Begleiter (Bots) können keine „Server-Erster“-Erfolge erringen und nehmen sie echten Spielern daher nie weg. Benötigt einen Server-Build vom 02.10.2026 oder neuer."
}
},
"options": {
@@ -510,4 +598,4 @@
"d": "Alle Einstellungen kehren zu ihren Standardwerten zurück."
}
}
}
}
+89 -1
View File
@@ -462,6 +462,94 @@
"Updates.EnableDatabases": {
"t": "Actualizaciones automáticas de bases de datos",
"d": "Permite que el servidor cambie él mismo sus bases de datos al arrancar. Déjalo en 0: el Manager aplica y registra las actualizaciones de bases de datos de forma segura."
},
"MapUpdate.Threads": {
"t": "Núcleos de CPU para el mundo",
"d": "Cuántos núcleos del procesador usa el mundo para actualizar los mapas. Los compañeros repartidos por varios mapas van mucho más rápido con más de un núcleo. Se aplica al reiniciar el servidor del mundo."
},
"Rate.Drop.Item.Uncommon": {
"t": "Probabilidad de botín de objetos poco comunes",
"d": "Multiplicador de la frecuencia con que caen objetos poco comunes (verdes)."
},
"Rate.Drop.Item.Rare": {
"t": "Probabilidad de botín de objetos raros",
"d": "Multiplicador de la frecuencia con que caen objetos raros (azules)."
},
"Rate.Drop.Item.Epic": {
"t": "Probabilidad de botín de objetos épicos",
"d": "Multiplicador de la frecuencia con que caen objetos épicos (morados)."
},
"Rate.Drop.Item.Legendary": {
"t": "Probabilidad de botín de objetos legendarios",
"d": "Multiplicador de la frecuencia con que caen objetos legendarios (naranjas)."
},
"Rate.Talent": {
"t": "Puntos de talento",
"d": "Multiplicador de los puntos de talento que gana un personaje por nivel."
},
"Rate.Skill.Discovery": {
"t": "Probabilidad de descubrir recetas",
"d": "Multiplicador de la probabilidad de descubrir una receta nueva al fabricar."
},
"Rate.RepairCost": {
"t": "Coste de reparación",
"d": "Multiplicador del coste de reparar el equipo. 0 hace las reparaciones gratuitas."
},
"Rate.Auction.Cut": {
"t": "Comisión de la casa de subastas",
"d": "Multiplicador de la parte de una venta que se queda la casa de subastas. 0 significa sin comisión."
},
"Rate.ArenaPoints": {
"t": "Puntos de arena",
"d": "Multiplicador de los puntos de arena obtenidos."
},
"Rate.XP.Pet": {
"t": "Experiencia de mascotas",
"d": "Multiplicador de la experiencia que ganan las mascotas de los cazadores."
},
"Instance.IgnoreLevel": {
"t": "Ignorar el nivel requerido de las mazmorras",
"d": "Personajes de cualquier nivel pueden entrar en mazmorras y bandas."
},
"Instance.IgnoreRaid": {
"t": "Entrar en bandas sin grupo de banda",
"d": "Los jugadores pueden entrar en instancias de banda sin estar en un grupo de banda."
},
"Instance.ResetTimeHour": {
"t": "Hora de reinicio de mazmorras",
"d": "Hora del día (0-23) a la que se reinician los bloqueos de mazmorras y bandas."
},
"MaxPrimaryTradeSkill": {
"t": "Profesiones principales por personaje",
"d": "Cuántas profesiones principales (como herrería o herboristería) puede aprender un personaje."
},
"AlwaysMaxSkillForLevel": {
"t": "Habilidades siempre al máximo del nivel",
"d": "Las habilidades de armas y otras están siempre al máximo para el nivel del personaje, sin entrenar."
},
"ActivateWeather": {
"t": "Clima",
"d": "Activa o desactiva la lluvia, la nieve y las tormentas."
},
"Group.Raid.LevelRestriction": {
"t": "Nivel mínimo para invitar a una banda",
"d": "Los personajes por debajo de este nivel no pueden ser invitados a un grupo de banda."
},
"AllowTwoSide.Interaction.Group": {
"t": "Grupos entre facciones",
"d": "Jugadores de la Alianza y de la Horda pueden formar grupos juntos."
},
"AllowTwoSide.Interaction.Guild": {
"t": "Hermandades entre facciones",
"d": "Jugadores de la Alianza y de la Horda pueden unirse a la misma hermandad."
},
"AllowTwoSide.Interaction.Auction": {
"t": "Casa de subastas compartida",
"d": "Jugadores de la Alianza y de la Horda usan la misma casa de subastas."
},
"Achievement.RealmFirstBlockBots": {
"t": "Los bots no logran «Primero del reino»",
"d": "Los acompañantes (bots) no pueden conseguir los logros «Primero del reino», así que nunca se los quitan a los jugadores reales. Requiere una versión del servidor del 2 de octubre de 2026 o posterior."
}
},
"options": {
@@ -510,4 +598,4 @@
"d": "Todos los ajustes vuelven a su valor predeterminado."
}
}
}
}
+89 -1
View File
@@ -462,6 +462,94 @@
"Updates.EnableDatabases": {
"t": "Mises à jour automatiques des bases de données",
"d": "Permet au serveur de modifier lui-même ses bases de données au démarrage. Gardez 0 : le Manager applique et suit les mises à jour de base de données en toute sécurité."
},
"MapUpdate.Threads": {
"t": "Cœurs du processeur pour le monde",
"d": "Nombre de cœurs du processeur utilisés par le monde pour mettre à jour les cartes. Les compagnons répartis sur plusieurs cartes vont nettement plus vite avec plus d’un cœur. Pris en compte au redémarrage du serveur de monde."
},
"Rate.Drop.Item.Uncommon": {
"t": "Taux de butin des objets inhabituels",
"d": "Multiplicateur de la fréquence de butin des objets inhabituels (verts)."
},
"Rate.Drop.Item.Rare": {
"t": "Taux de butin des objets rares",
"d": "Multiplicateur de la fréquence de butin des objets rares (bleus)."
},
"Rate.Drop.Item.Epic": {
"t": "Taux de butin des objets épiques",
"d": "Multiplicateur de la fréquence de butin des objets épiques (violets)."
},
"Rate.Drop.Item.Legendary": {
"t": "Taux de butin des objets légendaires",
"d": "Multiplicateur de la fréquence de butin des objets légendaires (orange)."
},
"Rate.Talent": {
"t": "Points de talent",
"d": "Multiplicateur des points de talent gagnés par niveau."
},
"Rate.Skill.Discovery": {
"t": "Chance de découvrir des recettes",
"d": "Multiplicateur de la chance de découvrir une nouvelle recette en fabriquant."
},
"Rate.RepairCost": {
"t": "Coût des réparations",
"d": "Multiplicateur du coût de réparation de l'équipement. 0 rend les réparations gratuites."
},
"Rate.Auction.Cut": {
"t": "Commission de l'hôtel des ventes",
"d": "Multiplicateur de la part d'une vente que garde l'hôtel des ventes. 0 signifie aucune commission."
},
"Rate.ArenaPoints": {
"t": "Points d'arène",
"d": "Multiplicateur des points d'arène gagnés."
},
"Rate.XP.Pet": {
"t": "Expérience des familiers",
"d": "Multiplicateur de l'expérience gagnée par les familiers des chasseurs."
},
"Instance.IgnoreLevel": {
"t": "Ignorer les niveaux requis des donjons",
"d": "Les personnages de tout niveau peuvent entrer dans les donjons et les raids."
},
"Instance.IgnoreRaid": {
"t": "Entrer dans les raids sans groupe de raid",
"d": "Les joueurs peuvent entrer dans les instances de raid sans être dans un groupe de raid."
},
"Instance.ResetTimeHour": {
"t": "Heure de réinitialisation des donjons",
"d": "Heure de la journée (0-23) à laquelle les verrouillages de donjons et de raids sont réinitialisés."
},
"MaxPrimaryTradeSkill": {
"t": "Métiers principaux par personnage",
"d": "Nombre de métiers principaux (comme la forge ou l'herboristerie) qu'un personnage peut apprendre."
},
"AlwaysMaxSkillForLevel": {
"t": "Compétences toujours au maximum du niveau",
"d": "Les compétences d'armes et autres sont toujours au maximum du niveau du personnage, sans entraînement."
},
"ActivateWeather": {
"t": "Météo",
"d": "Active ou désactive la pluie, la neige et les tempêtes."
},
"Group.Raid.LevelRestriction": {
"t": "Niveau minimum pour inviter dans un raid",
"d": "Les personnages en dessous de ce niveau ne peuvent pas être invités dans un groupe de raid."
},
"AllowTwoSide.Interaction.Group": {
"t": "Groupes entre factions",
"d": "Les joueurs de l'Alliance et de la Horde peuvent former des groupes ensemble."
},
"AllowTwoSide.Interaction.Guild": {
"t": "Guildes entre factions",
"d": "Les joueurs de l'Alliance et de la Horde peuvent rejoindre la même guilde."
},
"AllowTwoSide.Interaction.Auction": {
"t": "Hôtel des ventes commun",
"d": "Les joueurs de l'Alliance et de la Horde utilisent le même hôtel des ventes."
},
"Achievement.RealmFirstBlockBots": {
"t": "Les bots n'obtiennent pas les « Premier du royaume »",
"d": "Les compagnons (bots) ne peuvent pas obtenir les hauts faits « Premier du royaume » et ne les prennent donc jamais aux vrais joueurs. Nécessite une version du serveur du 2 octobre 2026 ou plus récente."
}
},
"options": {
@@ -510,4 +598,4 @@
"d": "Tous les paramètres reviennent à leur valeur par défaut."
}
}
}
}
+89 -1
View File
@@ -462,6 +462,94 @@
"Updates.EnableDatabases": {
"t": "Автоматические обновления баз данных",
"d": "Позволяет серверу самому менять свои базы данных при запуске. Оставьте 0: менеджер безопасно применяет и учитывает обновления баз данных."
},
"MapUpdate.Threads": {
"t": "Ядра процессора для мира",
"d": "Сколько ядер процессора мир использует для обновления карт. Компаньоны, разбросанные по нескольким картам, работают заметно быстрее при значении больше одного. Применяется после перезапуска игрового сервера."
},
"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": "Спутники (боты) не могут получать достижения «Первый на сервере», поэтому никогда не отнимают их у настоящих игроков. Нужна сборка сервера от 2 октября 2026 или новее."
}
},
"options": {
@@ -510,4 +598,4 @@
"d": "Все настройки возвращаются к значениям по умолчанию."
}
}
}
}
+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": "所有设置恢复为默认值。"
}
}
}
+131 -1
View File
@@ -26,6 +26,9 @@ export interface ScanReport {
bot_config_keys: number;
client: { path: string; executable: string } | null;
notes: string[];
/** the repack's main folder when the chosen folder is part of it */
suggested_path?: string | null;
hint?: "not-repack" | null;
modifies_files: boolean;
}
@@ -47,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;
@@ -146,6 +152,7 @@ export interface SaveReport {
export type BackupKind = "quick" | "full" | "config" | "database";
export interface RecoveryPoint {
realm?: RealmMode;
schema: number;
id: string;
kind: BackupKind;
@@ -167,6 +174,71 @@ export interface Preflight {
free_bytes: number;
}
export interface RealmProfile {
id: string;
name: string;
data: string;
}
export interface ModuleView {
id: string;
name: string;
description: Record<string, string>;
repo: string;
/** the module is part of this server build (its configuration exists) */
installed: boolean;
enabled: boolean;
/** can be turned on and off (a part the game client needs is only configured) */
switchable: boolean;
/** soon (planned, not available yet), early (experimental), beta (still being tested) or release (stable) */
status: "soon" | "early" | "beta" | "release";
icon: string;
/** a page of the Manager that is hidden while the module is off */
page: string | null;
/** not shown on the Modules page */
hidden: boolean;
compatibility?: "compatible" | "experimental" | "unsupported";
}
export interface ModuleSetting {
key: string;
value: string;
default: string | null;
doc: string;
}
export interface AllSetting {
key: string;
value: string;
default: string;
doc: string;
/** the configuration sets it to something other than the documented default */
changed: boolean;
}
export interface ReportContext {
manager_version: string;
windows: string;
install_kind: "new" | "imported";
server_version: string | null;
}
export interface InstallRequirements {
download_bytes: number;
unpacked_bytes: number;
version: string;
}
export interface AccountInfo {
id: number;
name: string;
/** 0 player, 1 moderator, 2 game master, 3 administrator */
access: number;
online: boolean;
last_login: string | null;
characters: number;
}
export interface InstallStep {
step: string;
percent: number;
@@ -226,6 +298,39 @@ export interface ClientInfo {
other_addons: number;
}
export interface ClientStatus {
linked: boolean;
managed: boolean;
installed_version: string | null;
latest_version: string | null;
latest_bytes: number | null;
update_available: boolean;
}
export interface ClientPlan {
version: string;
items: { path: string; size: number; kind: "missing" | "changed" | "modified" }[];
download_bytes: number;
total_files: number;
up_to_date_files: number;
kept_files: number;
}
export interface ClientStep {
phase: "scan" | "download" | "finish";
done: number;
total: number;
bytes_per_sec: number;
file: string | null;
}
export interface ClientDownloadCheck {
needed_bytes: number;
free_bytes: number;
version: string;
dest: string;
}
export type FriendsMode = "local" | "lan" | "direct" | "private";
export interface FriendsStatus {
@@ -261,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 }),
@@ -278,7 +385,24 @@ export const api = {
deleteBackup: (id: string, backupId: string) => invoke<void>("delete_backup", { id, backupId }),
restoreConfigs: (id: string, backupId: string) => invoke<RecoveryPoint>("restore_backup_configs", { id, backupId }),
restoreDatabase: (id: string, backupId: string, database: string) => invoke<DbRestore>("restore_backup_database", { id, backupId, database }),
installPreflight: (dest: string) => invoke<Preflight>("install_preflight", { dest }),
installPreflight: (dest: string, needed?: number) => invoke<Preflight>("install_preflight", { dest, needed: needed ?? null }),
installRequirements: (pkg?: string) => invoke<InstallRequirements>("install_requirements", { package: pkg ?? null }),
realmlistProfiles: (id: string) => invoke<{ profiles: RealmProfile[]; active: string | null }>("realmlist_profiles", { id }),
realmlistSave: (id: string, profileId: string | null, name: string, data: string) => invoke<RealmProfile>("realmlist_save", { id, profileId, name, data }),
realmlistDelete: (id: string, profileId: string) => invoke<void>("realmlist_delete", { id, profileId }),
realmlistActivate: (id: string, profileId: string) => invoke<string[]>("realmlist_activate", { id, profileId }),
modulesList: (id: string) => invoke<ModuleView[]>("modules_list", { id }),
moduleSetEnabled: (id: string, module: string, enabled: boolean) => invoke<void>("module_set_enabled", { id, module, enabled }),
moduleSettings: (id: string, module: string) => invoke<ModuleSetting[]>("module_settings", { id, module }),
moduleSaveSettings: (id: string, module: string, changes: Record<string, string>) => invoke<string[]>("module_save_settings", { id, module, changes }),
allSettings: (id: string) => invoke<AllSetting[]>("all_settings", { id }),
allSettingsSave: (id: string, changes: Record<string, string>) => invoke<string[]>("all_settings_save", { id, changes }),
reportContext: (id: string) => invoke<ReportContext>("report_context", { id }),
listAccounts: (id: string) => invoke<AccountInfo[]>("list_accounts", { id }),
accountSetPassword: (id: string, name: string, password: string) => invoke<void>("account_set_password", { id, name, password }),
accountSetAccess: (id: string, name: string, level: number) => invoke<void>("account_set_access", { id, name, level }),
accountRename: (id: string, name: string, newName: string, password: string) => invoke<void>("account_rename", { id, name, newName, password }),
accountDelete: (id: string, name: string) => invoke<void>("account_delete", { id, name }),
installNew: (dest: string, pkg?: string) => invoke<ServerSummary>("install_new", { dest, package: pkg ?? null }),
cancelInstall: () => invoke<void>("cancel_install"),
createAccount: (id: string, username: string, password: string, administrator: boolean) =>
@@ -301,6 +425,12 @@ export const api = {
setClient: (id: string, path: string) => invoke<ClientInfo>("set_client", { id, path }),
setRealmlist: (id: string, host: string) => invoke<string[]>("client_realmlist", { id, host }),
installAddon: (id: string) => invoke<void>("client_install_addon", { id }),
clientStatus: (id: string) => invoke<ClientStatus>("client_status", { id }),
clientDownloadCheck: (parent: string) => invoke<ClientDownloadCheck>("client_download_check", { parent }),
clientPlan: (id: string) => invoke<ClientPlan>("client_plan", { id }),
clientSync: (id: string, keepModified: boolean) => invoke<void>("client_sync", { id, keepModified }),
clientDownload: (id: string, parent: string) => invoke<ClientInfo>("client_download", { id, parent }),
clientCancel: () => invoke<void>("client_cancel"),
play: (id: string) => invoke<DriverOutcome>("play", { id }),
friendsStatus: (id: string) => invoke<FriendsStatus>("friends_status", { id }),
friendsCheckInternet: () => invoke<InternetCheck>("friends_check_internet"),
+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),
);
}
+51
View File
@@ -0,0 +1,51 @@
import { useSyncExternalStore } from "react";
import { api, type ClientStatus } from "@/lib/api";
/**
* Game client status for the main screen: which client is linked and, for a client the Manager keeps up to date,
* whether a newer one has been published. Checked at start and every five minutes (one small request; no game file is read).
*/
interface State {
status: ClientStatus | null;
checking: boolean;
}
const EMPTY: State = { status: null, checking: false };
const states = new Map<string, State>();
const listeners = new Set<() => void>();
const CHECK_EVERY_MS = 5 * 60 * 1000;
const get = (id: string) => states.get(id) ?? EMPTY;
function set(id: string, next: Partial<State>) {
states.set(id, { ...get(id), ...next });
listeners.forEach((l) => l());
}
export async function checkClient(id: string): Promise<void> {
if (get(id).checking) return;
set(id, { checking: true });
try {
set(id, { status: await api.clientStatus(id) });
} catch {
// offline: keep what we knew
} finally {
set(id, { checking: false });
}
}
/** Check now and then every five minutes. Returns the function that stops it. */
export function startClientPolling(id: string): () => void {
void checkClient(id);
const t = setInterval(() => void checkClient(id), CHECK_EVERY_MS);
return () => clearInterval(t);
}
export function useClientStatus(id: string): State {
return useSyncExternalStore(
(l) => {
listeners.add(l);
return () => listeners.delete(l);
},
() => get(id),
);
}
+63
View File
@@ -0,0 +1,63 @@
/** The text of a problem report, always in English so whoever reads it on GitHub can follow it; the person's own words go in as typed. */
export interface ReportInput {
managerVersion: string;
windows: string;
installKind: "new" | "imported";
serverVersion: string | null;
what: string;
expected: string;
steps: string;
/** a diagnostics file was created for this report */
diagnostics: boolean;
}
export const NEW_ISSUE_URL = "https://github.com/Corfirean/coa-server-manager/issues/new";
const PRIVACY = "> Please remove passwords, tokens, private IP information or other sensitive data before posting logs.";
export function reportBody(r: ReportInput): string {
const text = (s: string, fallback: string) => (s.trim() ? s.trim() : fallback);
return [
"## Bug Report",
"",
`**Manager version:** ${r.managerVersion || "unknown"} `,
`**Windows version:** ${r.windows || "unknown"} `,
`**Fresh install or imported server:** ${r.installKind === "new" ? "Fresh install" : "Imported server"} `,
...(r.serverVersion ? [`**Server version:** ${r.serverVersion} `] : []),
"",
"**What happened?** ",
text(r.what, "Describe the problem."),
"",
"**What did you expect to happen?** ",
text(r.expected, "Describe the expected behaviour."),
"",
"**Steps to reproduce:** ",
text(r.steps, "1.\n2.\n3."),
"",
"**Screenshot / video:** ",
"Attach it if possible.",
"",
"**Logs:** ",
r.diagnostics ? "The diagnostics file from the Manager is attached below (it has passwords and addresses removed)." : "Attach relevant Manager/server logs if available.",
"",
PRIVACY,
"",
].join("\n");
}
/** Percent-encode everything that is not a plain letter, digit or one of . _ - so the link carries nothing the browser could misread. */
export function encodeQuery(s: string): string {
return Array.from(new TextEncoder().encode(s))
.map((b) => {
const c = String.fromCharCode(b);
return /[A-Za-z0-9._-]/.test(c) ? c : "%" + b.toString(16).toUpperCase().padStart(2, "0");
})
.join("");
}
/** A link that opens GitHub's "new issue" page with the title and text filled in. */
export function issueUrl(title: string, body: string): string {
return `${NEW_ISSUE_URL}?labels=bug&title=${encodeQuery(title)}&body=${encodeQuery(body)}`;
}
/** Links longer than this are not reliable in every browser; the full text is then copied to the clipboard instead. */
export const MAX_LINK = 2000;
+100
View File
@@ -0,0 +1,100 @@
import { useSyncExternalStore } from "react";
import { listen } from "@tauri-apps/api/event";
import { api, asUiError, type UiError, type UpdatePreview, type UpdateTxn } from "@/lib/api";
/**
* Server update status for the main screen and the navigation: checked when the app starts and every five minutes,
* and applied from the main button when nothing needs a decision (files the owner changed are decided in Settings).
*/
export interface ServerUpdateState {
preview: UpdatePreview | null;
available: boolean;
checking: boolean;
applying: boolean;
step: string | null;
percent: number;
error: string | null;
/** The full error of the last update attempt, for the Settings card. */
uiError: UiError | null;
/** How the last update ended; kept here so the Settings card can show it after the user left and came back. */
result: { committed: string } | { pending: UpdateTxn } | null;
}
const EMPTY: ServerUpdateState = { preview: null, available: false, checking: false, applying: false, step: null, percent: 0, error: null, uiError: null, result: null };
const states = new Map<string, ServerUpdateState>();
const listeners = new Set<() => void>();
export const CHECK_EVERY_MS = 5 * 60 * 1000;
const get = (id: string) => states.get(id) ?? EMPTY;
function set(id: string, next: Partial<ServerUpdateState>) {
states.set(id, { ...get(id), ...next });
listeners.forEach((l) => l());
}
export async function checkServerUpdate(id: string): Promise<void> {
const cur = get(id);
if (cur.applying || cur.checking) return;
set(id, { checking: true });
try {
const p = await api.checkUpdate(id);
set(id, { preview: p, available: p.to_version !== (p.from_version ?? ""), error: null });
} catch (e) {
// offline or no package published: keep what we knew and stay quiet
set(id, { error: asUiError(e).human.code });
} finally {
set(id, { checking: false });
}
}
/** Check now and then every five minutes. Returns the function that stops it. */
export function startServerUpdatePolling(id: string): () => void {
void checkServerUpdate(id);
const t = setInterval(() => void checkServerUpdate(id), CHECK_EVERY_MS);
return () => clearInterval(t);
}
export function clearServerUpdateResult(id: string) {
set(id, { result: null, uiError: null });
}
/**
* Apply an update. Without options this is the main-screen button: the pending update, only when no file needs a
* decision. With options (the Settings card) the owner has already chosen what to do with each changed file and may
* point at another package source. The state lives here, not in a screen, so leaving the Settings tab and coming back
* shows the update still running (and its progress) instead of an "Update now" button the server would refuse.
*/
export async function applyServerUpdate(id: string, opts?: { choices: Record<string, "keep" | "replace">; source?: string }): Promise<boolean> {
const p = get(id).preview;
if (get(id).applying) return false;
if (!opts && (!p || p.conflicts.length > 0)) return false;
set(id, { applying: true, step: null, percent: 0, error: null, uiError: null, result: null });
let un: (() => void) | undefined;
try {
un = await listen<{ step: string; percent: number }>("update-progress", (e) => set(id, { step: e.payload.step, percent: e.payload.percent }));
} catch {
/* progress is optional */
}
try {
const out = await api.applyUpdate(id, opts?.choices ?? {}, opts?.source);
set(id, { result: out.txn.state === "committed" ? { committed: out.txn.to_version ?? "" } : { pending: out.txn } });
return true;
} catch (e) {
const ui = asUiError(e);
set(id, { error: ui.human.code, uiError: ui });
return false;
} finally {
un?.();
set(id, { applying: false });
void checkServerUpdate(id);
}
}
export function useServerUpdate(id: string): ServerUpdateState {
return useSyncExternalStore(
(l) => {
listeners.add(l);
return () => listeners.delete(l);
},
() => get(id),
);
}
+12
View File
@@ -5,6 +5,18 @@ export function cn(...inputs: ClassValue[]) {
return twMerge(clsx(inputs));
}
/** 1536 -> "1.5 KB"; 43.2e9 -> "40.2 GB" (binary units, as drive sizes are shown). */
export function formatBytes(n: number): string {
const units = ["B", "KB", "MB", "GB", "TB"];
let v = Math.max(0, n);
let i = 0;
while (v >= 1024 && i < units.length - 1) {
v /= 1024;
i++;
}
return `${i === 0 || v >= 100 ? Math.round(v) : v.toFixed(1)} ${units[i]}`;
}
export function formatUptime(secs: number | null | undefined): string {
if (secs == null) return "—";
const d = Math.floor(secs / 86400);
+200
View File
@@ -0,0 +1,200 @@
import { useCallback, useEffect, useState } from "react";
import { Loader2, RefreshCw } from "lucide-react";
import { api, asUiError, type AccountInfo, type UiError } from "@/lib/api";
import { Button } from "@/components/ui/button";
import { Card } from "@/components/ui/card";
import { PasswordInput } from "@/components/ui/password-input";
import { useHuman, useT, type Key } from "@/i18n";
const LEVELS = [0, 1, 2, 3] as const;
const inputClass = "w-64 rounded-md border border-line bg-bg px-3 py-2 text-sm outline-none focus:border-gold";
type Editor = { name: string; mode: "password" | "rename" | "delete"; characters?: number };
/** Everyone who can log in to the server, with the changes an owner usually needs: password, access level, name. */
export function AccountsCard({ serverId, online, reloadKey }: { serverId: string; online: boolean | null; reloadKey: number }) {
const t = useT();
const human = useHuman();
const [accounts, setAccounts] = useState<AccountInfo[] | null>(null);
const [listError, setListError] = useState(false);
const [editor, setEditor] = useState<Editor | null>(null);
const [newName, setNewName] = useState("");
const [confirmName, setConfirmName] = useState("");
const [password, setPassword] = useState("");
const [busy, setBusy] = useState<string | null>(null);
const [error, setError] = useState<UiError | null>(null);
const [note, setNote] = useState<string | null>(null);
const load = useCallback(async () => {
try {
setAccounts(await api.listAccounts(serverId));
setListError(false);
} catch {
setAccounts(null);
setListError(true);
}
}, [serverId]);
useEffect(() => {
void load();
}, [load, reloadKey, online]);
async function run(label: string, fn: () => Promise<void>, ok: string) {
setBusy(label);
setError(null);
setNote(null);
try {
await fn();
setNote(ok);
setEditor(null);
setPassword("");
setNewName("");
setConfirmName("");
await load();
} catch (e) {
setError(asUiError(e));
} finally {
setBusy(null);
}
}
const passOk = password.length >= 6 && password.length <= 16 && /^[\x21-\x7e]+$/.test(password) && !/["']/.test(password);
const nameOk = /^[A-Za-z0-9]{3,17}$/.test(newName);
return (
<Card className="mt-6 p-6">
<div className="flex items-start justify-between gap-3">
<div>
<h2 className="font-semibold">{t("acc.title")}</h2>
<p className="mt-1 text-sm text-muted">{t("acc.text")}</p>
</div>
<Button size="sm" variant="ghost" onClick={() => void load()} aria-label={t("acc.refresh")} title={t("acc.refresh")}>
<RefreshCw className="h-4 w-4" aria-hidden />
</Button>
</div>
{listError && <p className="mt-4 text-sm text-warn">{t("acc.unavailable")}</p>}
{accounts && accounts.length === 0 && <p className="mt-4 text-sm text-muted">{t("acc.empty")}</p>}
{accounts && accounts.length > 0 && (
<div className="mt-4 overflow-x-auto">
<table className="w-full text-left text-sm">
<thead className="text-xs text-muted">
<tr>
<th className="py-2 pr-3 font-normal">{t("acc.col.name")}</th>
<th className="py-2 pr-3 font-normal">{t("acc.col.chars")}</th>
<th className="py-2 pr-3 font-normal">{t("acc.col.access")}</th>
<th className="py-2 pr-3 font-normal">{t("acc.col.last")}</th>
<th className="py-2 font-normal" />
</tr>
</thead>
<tbody className="divide-y divide-line">
{accounts.map((a) => (
<tr key={a.id}>
<td className="py-2 pr-3 font-medium">
{a.name}
{a.online && <span className="ml-2 text-xs text-ok">{t("acc.online")}</span>}
</td>
<td className="py-2 pr-3">{a.characters}</td>
<td className="py-2 pr-3">
<select
aria-label={t("acc.col.access")}
className="rounded-md border border-line bg-bg px-2 py-1 text-sm"
value={a.access}
disabled={!online || busy !== null}
onChange={(e) =>
void run(
`access:${a.name}`,
() => api.accountSetAccess(serverId, a.name, Number(e.target.value)),
t("acc.accessChanged", { name: a.name, level: t(`acc.level.${e.target.value}` as Key) }),
)
}
>
{LEVELS.map((l) => (
<option key={l} value={l}>{t(`acc.level.${l}` as Key)}</option>
))}
</select>
</td>
<td className="py-2 pr-3 text-muted">{a.last_login ?? t("acc.never")}</td>
<td className="py-2 text-right whitespace-nowrap">
<Button size="sm" variant="ghost" disabled={!online || busy !== null} onClick={() => { setEditor({ name: a.name, mode: "password" }); setError(null); setNote(null); }}>
{t("acc.changePassword")}
</Button>
<Button size="sm" variant="ghost" disabled={!online || busy !== null || a.online} onClick={() => { setEditor({ name: a.name, mode: "rename" }); setError(null); setNote(null); }}>
{t("acc.rename")}
</Button>
<Button size="sm" variant="ghost" className="text-bad hover:text-bad" disabled={!online || busy !== null || a.online} onClick={() => { setEditor({ name: a.name, mode: "delete", characters: a.characters }); setConfirmName(""); setError(null); setNote(null); }}>
{t("acc.delete")}
</Button>
</td>
</tr>
))}
</tbody>
</table>
</div>
)}
{online === false && accounts && accounts.length > 0 && <p className="mt-3 text-xs text-muted">{t("acc.needsRunning")}</p>}
{editor && editor.mode === "delete" && (
<div className="mt-4 rounded-md border border-bad/40 bg-bad/5 p-4" role="alertdialog" aria-label={t("acc.deleteFor", { name: editor.name })}>
<p className="font-medium text-bad">{t("acc.deleteFor", { name: editor.name })}</p>
<p className="mt-2 text-sm">{t("acc.deleteWarn", { n: editor.characters ?? 0 })}</p>
<div className="mt-3">
<label htmlFor="acc-confirm" className="text-sm text-muted">{t("acc.deleteConfirm", { name: editor.name })}</label>
<input id="acc-confirm" className={inputClass + " mt-1 block"} value={confirmName} onChange={(e) => setConfirmName(e.target.value)} autoComplete="off" />
</div>
<div className="mt-4 flex gap-2">
<Button
variant="primary"
size="sm"
className="bg-bad text-white hover:bg-bad/90"
disabled={busy !== null || confirmName.trim().toUpperCase() !== editor.name.toUpperCase()}
onClick={() => void run("delete", () => api.accountDelete(serverId, editor.name), t("acc.deleted", { name: editor.name }))}
>
{busy === "delete" && <Loader2 className="h-4 w-4 animate-spin" aria-hidden />}
{t("acc.deleteButton")}
</Button>
<Button size="sm" variant="ghost" onClick={() => { setEditor(null); setConfirmName(""); }}>{t("common.cancel")}</Button>
</div>
</div>
)}
{editor && editor.mode !== "delete" && (
<div className="mt-4 rounded-md border border-line bg-black/20 p-4">
<p className="font-medium">{editor.mode === "password" ? t("acc.changeFor", { name: editor.name }) : t("acc.renameFor", { name: editor.name })}</p>
{editor.mode === "rename" && (
<div className="mt-3">
<label htmlFor="acc-newname" className="text-sm text-muted">{t("acc.newName")}</label>
<input id="acc-newname" className={inputClass + " mt-1 block"} value={newName} onChange={(e) => setNewName(e.target.value)} autoComplete="off" />
<p className="mt-1 text-xs text-muted">{t("acc.nameRule")}</p>
</div>
)}
<div className="mt-3">
<label htmlFor="acc-newpass" className="text-sm text-muted">{t("acc.newPassword")}</label>
<PasswordInput id="acc-newpass" className={inputClass + " mt-1 block"} value={password} onChange={(e) => setPassword(e.target.value)} autoComplete="new-password" />
<p className="mt-1 text-xs text-muted">{t("acc.passRule")}</p>
</div>
{editor.mode === "rename" && <p className="mt-3 text-xs text-muted">{t("acc.renameNote")}</p>}
<div className="mt-4 flex gap-2">
<Button
variant="primary"
size="sm"
disabled={busy !== null || !passOk || (editor.mode === "rename" && !nameOk)}
onClick={() =>
editor.mode === "password"
? void run("password", () => api.accountSetPassword(serverId, editor.name, password), t("acc.passwordChanged", { name: editor.name }))
: void run("rename", () => api.accountRename(serverId, editor.name, newName, password), t("acc.renamed", { name: editor.name, new: newName.toUpperCase() }))
}
>
{busy && <Loader2 className="h-4 w-4 animate-spin" aria-hidden />}
{t("acc.save")}
</Button>
<Button size="sm" variant="ghost" onClick={() => { setEditor(null); setPassword(""); setNewName(""); }}>{t("common.cancel")}</Button>
</div>
</div>
)}
{note && <p className="mt-3 text-sm text-ok" role="status">{note}</p>}
{error && <p className="mt-3 text-sm text-bad" role="alert">{error.human.code === "unknown" ? error.technical : human(error.human).message}</p>}
</Card>
);
}
+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">
Loaded 100 of 122 files, more files were not shown because too many files have changed in this diff. Show more