mirror of
https://github.com/Corfirean/coa-server-manager.git
synced 2026-11-19 03:25:56 +00:00
Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
b9e663079e | ||
|
|
d7693b0878 | ||
|
|
1f64da3ae0 | ||
|
|
1aec8e5394 | ||
|
|
326a4fe3d3 | ||
|
|
f9839ba369 | ||
|
|
e951eb134b | ||
|
|
6cbf007d72 | ||
|
|
07e9bc497d | ||
|
|
e4edb7cbdd | ||
|
|
ca2514c790 | ||
|
|
69c9938aba | ||
|
|
2fd42f2acd | ||
|
|
05630ec9eb | ||
|
|
d64fdb51be | ||
|
|
260d10b729 | ||
|
|
20657df203 | ||
|
|
f08ae1c76b | ||
|
|
4fc133c35e | ||
|
|
de38e60444 | ||
|
|
3c26004e04 | ||
|
|
d1534ebc92 | ||
|
|
20d4c3351e | ||
|
|
8a313b83b8 | ||
|
|
7eea72c415 | ||
|
|
e8ffa6efe3 | ||
|
|
baeecd2ddf | ||
|
|
d352731280 | ||
|
|
a0545286ee | ||
|
|
6f8ed793a7 | ||
|
|
b3c88ce2a6 | ||
|
|
d71c5635e3 | ||
|
|
755761d0de | ||
|
|
550e475962 | ||
|
|
2e6fcceb05 | ||
|
|
abcc816581 | ||
|
|
8353b791fb | ||
|
|
b81227b0ea | ||
|
|
a9fb982ab0 | ||
|
|
a822bfc99b | ||
|
|
1211de5a77 | ||
|
|
ee36692db7 | ||
|
|
ee43522019 | ||
|
|
b4dc30b84a | ||
|
|
73a6cca753 | ||
|
|
705bee7d56 | ||
|
|
5aa9b32283 | ||
|
|
711f378ae8 | ||
|
|
c29d56e2b3 | ||
|
|
d63e85bb18 | ||
|
|
c513649beb | ||
|
|
d2e6fef188 | ||
|
|
2224afd2ea | ||
|
|
3a5558f388 | ||
|
|
173248efbe | ||
|
|
5697a1d36e | ||
|
|
bc62ae206f | ||
|
|
076fba185c | ||
|
|
23cbb108ad | ||
|
|
1a1976d9ad | ||
|
|
dc3fcab7e1 | ||
|
|
ba5816e3ae | ||
|
|
56faaa3a2a | ||
|
|
35084dbce8 | ||
|
|
7e7216979a | ||
|
|
7c0c4cda1f | ||
|
|
642da8fdc1 | ||
|
|
30d2f56997 | ||
|
|
4d1a6e0b21 | ||
|
|
bda38b9f26 | ||
|
|
c004b90c54 | ||
|
|
d44e00f9ad | ||
|
|
dad10d8a5d | ||
|
|
b33821e7eb | ||
|
|
1288a84da2 | ||
|
|
e7b76137d1 | ||
|
|
7bb0ea9472 | ||
|
|
1dab6154c7 | ||
|
|
06a6302732 | ||
|
|
65631450ff | ||
|
|
2d9c6a65bb | ||
|
|
ce83f04d9d | ||
|
|
81f031b30f | ||
|
|
ee3ca2c517 | ||
|
|
50e858dcd5 | ||
|
|
8bbf16ed4f | ||
|
|
324e9810cc | ||
|
|
a8ab201d7d | ||
|
|
733d73ef76 | ||
|
|
5525325160 | ||
|
|
1aade1dcf9 | ||
|
|
787549237f | ||
|
|
088cd05e4f | ||
|
|
dc97095bd6 | ||
|
|
c6d8e5554d | ||
|
|
0900a4a143 | ||
|
|
eeb102e260 | ||
|
|
ea376a66d3 | ||
|
|
88747c8da1 | ||
|
|
8e1eb825df | ||
|
|
4fcf0dde3f | ||
|
|
e4791fc45c | ||
|
|
f55a9fb42b | ||
|
|
8ad06fd78a | ||
|
|
af82963f35 | ||
|
|
321ac597ce | ||
|
|
925a81f4f2 | ||
|
|
df1901ea90 | ||
|
|
569d5fffc4 | ||
|
|
7888dbc763 | ||
|
|
f0e8a8c12f | ||
|
|
af5a9717d4 | ||
|
|
bf2fffcffa | ||
|
|
4a99dd3a6a | ||
|
|
306003b698 | ||
|
|
d9be2b9d82 | ||
|
|
81b040ef02 | ||
|
|
5fdee1d658 | ||
|
|
4e1f548012 | ||
|
|
b3ee94071d | ||
|
|
76dc7452de | ||
|
|
02e3a9e4e6 | ||
|
|
8addc97bc5 | ||
|
|
57807b9769 | ||
|
|
7e29a9f2ec | ||
|
|
af9f148889 | ||
|
|
92385cf569 | ||
|
|
b00e732c7f | ||
|
|
594bdee594 | ||
|
|
d4408a0e92 | ||
|
|
b61a186470 | ||
|
|
9e9778af74 | ||
|
|
d5f1e9cc83 | ||
|
|
aa25e9c721 | ||
|
|
1fd3a5482e | ||
|
|
8801c6f308 | ||
|
|
341f2f0230 | ||
|
|
a48717340b | ||
|
|
351ace1c56 | ||
|
|
ba143e1ccd | ||
|
|
5343020bed | ||
|
|
55b0087455 | ||
|
|
9d135765cd | ||
|
|
58a99f0a6d | ||
|
|
d9c10c4564 |
No files matched your search
@@ -25,4 +25,5 @@ jobs:
|
|||||||
- run: npm ci
|
- run: npm ci
|
||||||
- run: node tools/check-i18n.mjs
|
- run: node tools/check-i18n.mjs
|
||||||
- run: npm run build
|
- run: npm run build
|
||||||
|
- run: node --experimental-strip-types --test tools/*.test.mjs
|
||||||
- run: cargo test --workspace --locked
|
- run: cargo test --workspace --locked
|
||||||
@@ -69,8 +69,11 @@ jobs:
|
|||||||
with:
|
with:
|
||||||
node-version: 22
|
node-version: 22
|
||||||
- run: npm ci
|
- run: npm ci
|
||||||
|
# tauri::generate_context! needs ../dist; without a warm target cache the tests do not compile without it.
|
||||||
|
- run: npm run build
|
||||||
- name: Tests
|
- name: Tests
|
||||||
run: cargo test --workspace -- --test-threads=1
|
run: cargo test --workspace --locked -- --test-threads=1
|
||||||
|
- run: node --experimental-strip-types --test tools/*.test.mjs
|
||||||
- name: Build and sign (publish only when requested)
|
- name: Build and sign (publish only when requested)
|
||||||
id: tauri
|
id: tauri
|
||||||
uses: tauri-apps/tauri-action@v0
|
uses: tauri-apps/tauri-action@v0
|
||||||
|
|||||||
@@ -0,0 +1,72 @@
|
|||||||
|
name: sign-local-installer
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [release/20261108-manager]
|
||||||
|
workflow_dispatch:
|
||||||
|
inputs:
|
||||||
|
build_run_id:
|
||||||
|
description: Successful manager-local run in coa-server-build
|
||||||
|
required: true
|
||||||
|
permissions:
|
||||||
|
contents: read
|
||||||
|
actions: read
|
||||||
|
jobs:
|
||||||
|
sign:
|
||||||
|
if: github.event_name == 'workflow_dispatch'
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v7
|
||||||
|
- uses: actions/setup-node@v4
|
||||||
|
with:
|
||||||
|
node-version: 22
|
||||||
|
- name: Verify local build provenance
|
||||||
|
env:
|
||||||
|
GH_TOKEN: ${{ github.token }}
|
||||||
|
BUILD_RUN: ${{ inputs.build_run_id }}
|
||||||
|
run: |
|
||||||
|
python3 - <<'PY'
|
||||||
|
import json, os, subprocess
|
||||||
|
run = os.environ['BUILD_RUN']
|
||||||
|
if not run.isdigit():
|
||||||
|
raise RuntimeError('Invalid build run')
|
||||||
|
data = json.loads(subprocess.check_output(['gh', 'api', f'repos/Corfirean/coa-server-build/actions/runs/{run}']))
|
||||||
|
if data['conclusion'] != 'success' or data['path'] != '.github/workflows/manager-local.yml':
|
||||||
|
raise RuntimeError('Not a successful local Manager build')
|
||||||
|
subprocess.run(['gh', 'run', 'download', run, '-R', 'Corfirean/coa-server-build', '-n', 'unsigned-manager-windows', '-D', '_prepared-manager'], check=True)
|
||||||
|
from pathlib import Path
|
||||||
|
import hashlib
|
||||||
|
root = Path('_prepared-manager')
|
||||||
|
meta = json.loads((root / 'prepared-source.json').read_text())
|
||||||
|
version = json.loads(Path('package.json').read_text())['version']
|
||||||
|
name = meta['installer']
|
||||||
|
if Path(name).name != name or meta['source'] != os.environ['GITHUB_SHA'] or meta['version'] != version or str(meta['run']) != run:
|
||||||
|
raise RuntimeError('Installer identity differs')
|
||||||
|
if hashlib.sha256((root / name).read_bytes()).hexdigest() != meta['sha256']:
|
||||||
|
raise RuntimeError('Installer hash differs')
|
||||||
|
PY
|
||||||
|
- run: npm ci
|
||||||
|
- name: Sign exact locally compiled bytes
|
||||||
|
env:
|
||||||
|
TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}
|
||||||
|
TAURI_SIGNING_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}
|
||||||
|
run: |
|
||||||
|
node --input-type=module <<'JS'
|
||||||
|
import { readFileSync, writeFileSync } from 'node:fs';
|
||||||
|
import { execFileSync } from 'node:child_process';
|
||||||
|
import { createHash } from 'node:crypto';
|
||||||
|
const root = '_prepared-manager/';
|
||||||
|
const meta = JSON.parse(readFileSync(root + 'prepared-source.json'));
|
||||||
|
execFileSync('node_modules/.bin/tauri', ['signer', 'sign', '--app-version', meta.version, root + meta.installer], {stdio: 'inherit'});
|
||||||
|
if (createHash('sha256').update(readFileSync(root + meta.installer)).digest('hex') !== meta.sha256) throw new Error('Signed bytes changed');
|
||||||
|
const signature = readFileSync(root + meta.installer + '.sig', 'utf8').trim();
|
||||||
|
const url = `https://github.com/Corfirean/coa-server-manager/releases/download/v${meta.version}/${encodeURIComponent(meta.installer)}`;
|
||||||
|
writeFileSync(root + 'latest.json', JSON.stringify({version: meta.version, notes: 'See the release notes.', pub_date: new Date().toISOString(), platforms: {'windows-x86_64': {signature, url}}}, null, 2) + '\n');
|
||||||
|
meta.signingRun = process.env.GITHUB_RUN_ID;
|
||||||
|
writeFileSync(root + 'prepared-source.json', JSON.stringify(meta, null, 2) + '\n');
|
||||||
|
JS
|
||||||
|
- uses: actions/upload-artifact@v4
|
||||||
|
with:
|
||||||
|
name: prepared-manager-windows
|
||||||
|
path: _prepared-manager/*
|
||||||
|
retention-days: 14
|
||||||
|
if-no-files-found: error
|
||||||
@@ -35,6 +35,16 @@ Every published Manager version, including a clearly marked Pre-release, belongs
|
|||||||
CHANGELOG.md and changelog/history.json. Its GitHub release notes use the same reviewed record.
|
CHANGELOG.md and changelog/history.json. Its GitHub release notes use the same reviewed record.
|
||||||
Promotion updates that entry without duplicating it; Manager and server histories remain separate.
|
Promotion updates that entry without duplicating it; Manager and server histories remain separate.
|
||||||
|
|
||||||
|
Translated release notes are a required preparation step before freezing a new Manager source. Follow the
|
||||||
|
runbook's "Mandatory translated release notes during preparation" checklist: translate every new reviewed
|
||||||
|
Manager/server note into Russian, German, French, Spanish and Simplified Chinese in
|
||||||
|
`src/data/latest-note-translations.json`, keyed by exact canonical English text. Preserve existing translations
|
||||||
|
and released fragments. Refresh the bundled server-history snapshot from a pinned canonical commit and record
|
||||||
|
its provenance. Run `node --test tools/release-history.test.mjs`, `node tools/check-i18n.mjs` and `npm run build`;
|
||||||
|
verify each new record, all six viewer languages, English fallback and offline use. Save source/version and checks
|
||||||
|
in the handoff. Translations ship with Manager: a server-only release must record the carrying Manager version or
|
||||||
|
pending translation delivery, without forcing another Manager release or changing already signed installers.
|
||||||
|
|
||||||
Before preparing or publishing a Manager/server release, read the maintained
|
Before preparing or publishing a Manager/server release, read the maintained
|
||||||
[release runbook](https://github.com/Corfirean/coa-server-build/blob/main/docs/server-release.md)
|
[release runbook](https://github.com/Corfirean/coa-server-build/blob/main/docs/server-release.md)
|
||||||
and [build agent instructions](https://github.com/Corfirean/coa-server-build/blob/main/AGENTS.md).
|
and [build agent instructions](https://github.com/Corfirean/coa-server-build/blob/main/AGENTS.md).
|
||||||
|
|||||||
+178
@@ -8,6 +8,184 @@ Published releases and previews. Pre-release entries do not change the stable up
|
|||||||
|
|
||||||
Dates follow GitHub publication (UTC); legacy records retain their archived dates. Newest releases first.
|
Dates follow GitHub publication (UTC); legacy records retain their archived dates. Newest releases first.
|
||||||
|
|
||||||
|
## 0.9.14 — 2026-11-16
|
||||||
|
|
||||||
|
- Install community addons from the Manager.
|
||||||
|
- Old item and creature data is cleared before every Play.
|
||||||
|
- Turning the custom races client patch on or off takes seconds again.
|
||||||
|
- The database moves to a free port when Windows reserves or another program takes 3307.
|
||||||
|
- Your own MySQL settings survive restarts and updates.
|
||||||
|
- Disabled custom races stay disabled after a server update that adds races.
|
||||||
|
- Rename your realms in the Manager.
|
||||||
|
- The account for a friend's server is in the login box at every Play.
|
||||||
|
- Restart the world every day at a chosen time.
|
||||||
|
- Switches for the Custom Races V2 subclasses, Hero Races and the /dev menu.
|
||||||
|
- Companion bots on Wildcard and Warcraft Reborn.
|
||||||
|
- The Custom Races card tells which characters stay out while races are off.
|
||||||
|
|
||||||
|
[Release](https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.14) · [Source changes](https://github.com/Corfirean/coa-server-manager/compare/v0.9.13...v0.9.14)
|
||||||
|
|
||||||
|
## 0.9.13 — 2026-11-15
|
||||||
|
|
||||||
|
- The custom races client is updated to Custom Races V2.
|
||||||
|
|
||||||
|
[Release](https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.13) · [Source changes](https://github.com/Corfirean/coa-server-manager/compare/v0.9.12...v0.9.13)
|
||||||
|
|
||||||
|
## 0.9.12 — 2026-11-14
|
||||||
|
|
||||||
|
- Settings for how much help bots get in dungeons and raids.
|
||||||
|
|
||||||
|
[Release](https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.12) · [Source changes](https://github.com/Corfirean/coa-server-manager/compare/v0.9.10...v0.9.12)
|
||||||
|
|
||||||
|
## 0.9.10 — 2026-11-08
|
||||||
|
|
||||||
|
- Custom Races patch installation recovers from interrupted downloads.
|
||||||
|
|
||||||
|
[Release](https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.10) · [Source changes](https://github.com/Corfirean/coa-server-manager/compare/v0.9.9...v0.9.10)
|
||||||
|
|
||||||
|
## 0.9.9 — 2026-11-04
|
||||||
|
|
||||||
|
- Update and recovery checks use the temporary login port even with a Windows override.
|
||||||
|
|
||||||
|
[Release](https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.9) · [Source changes](https://github.com/Corfirean/coa-server-manager/compare/v0.9.8...v0.9.9)
|
||||||
|
|
||||||
|
## 0.9.8 — 2026-11-01
|
||||||
|
|
||||||
|
- Dungeon Clear can be enabled when SQUID bots are active.
|
||||||
|
- Diagnostic exports include launcher stages and lock owner records.
|
||||||
|
- Choose normal logs, errors only or no server logs in maintenance settings.
|
||||||
|
- Update checks temporarily suspend bot population and restore your configuration.
|
||||||
|
- Update validation keeps MySQL running between compatible checks.
|
||||||
|
|
||||||
|
[Release](https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.8) · [Source changes](https://github.com/Corfirean/coa-server-manager/compare/v0.9.7...v0.9.8)
|
||||||
|
|
||||||
|
## 0.9.7 — 2026-10-30
|
||||||
|
|
||||||
|
- Show available update notes even when release history is cached.
|
||||||
|
|
||||||
|
[Release](https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.7) · [Source changes](https://github.com/Corfirean/coa-server-manager/compare/v0.9.5...v0.9.7)
|
||||||
|
|
||||||
|
## 0.9.5 — 2026-10-30
|
||||||
|
|
||||||
|
- Account creation verifies a lost console reply against the requested login.
|
||||||
|
- Abandoned game relay tunnels close their local connection immediately.
|
||||||
|
- Keep disabled graphics components disabled during client updates.
|
||||||
|
- Force-stop an unresponsive world after a failed normal shutdown.
|
||||||
|
- Crash history includes reports from every world and Windows text files.
|
||||||
|
- Show the online bot count for Playerbots on the overview.
|
||||||
|
- Disable public server browsing in Settings.
|
||||||
|
- Keep deliberate stops and update shutdowns from triggering crash restart.
|
||||||
|
- Server startup waits for a responsive console before reporting success.
|
||||||
|
- Restore the existing Manager window when launching it again.
|
||||||
|
|
||||||
|
[Release](https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.5) · [Source changes](https://github.com/Corfirean/coa-server-manager/compare/v0.9.4...v0.9.5)
|
||||||
|
|
||||||
|
## 0.9.4 — 2026-10-29
|
||||||
|
|
||||||
|
**Portable Characters are experimental and may contain bugs.**
|
||||||
|
|
||||||
|
- Settings group updates, startup and maintenance with translated release history.
|
||||||
|
- Update and launch without updating share a divided button.
|
||||||
|
- Maximizing the window keeps text and controls at a comfortable size.
|
||||||
|
|
||||||
|
[Release](https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.4) · [Source changes](https://github.com/Corfirean/coa-server-manager/compare/v0.9.3...v0.9.4)
|
||||||
|
|
||||||
|
## 0.9.3 — 2026-10-29
|
||||||
|
|
||||||
|
**Portable Characters are experimental and may contain bugs.**
|
||||||
|
|
||||||
|
- Slow server startup no longer triggers an early update rollback.
|
||||||
|
|
||||||
|
[Release](https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.3) · [Source changes](https://github.com/Corfirean/coa-server-manager/compare/v0.9.2...v0.9.3)
|
||||||
|
|
||||||
|
## 0.9.2 — 2026-10-28
|
||||||
|
|
||||||
|
**Portable Characters are experimental and may contain bugs.**
|
||||||
|
|
||||||
|
- New server installation waits for slower database startup.
|
||||||
|
- Find and edit CoA options in the existing server settings.
|
||||||
|
- Simultaneous update checks share results or wait their turn.
|
||||||
|
- Recovery can stop an unfinished world startup after restoring an older launcher.
|
||||||
|
|
||||||
|
[Release](https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.2) · [Source changes](https://github.com/Corfirean/coa-server-manager/compare/v0.9.1...v0.9.2)
|
||||||
|
|
||||||
|
## 0.9.1 — 2026-10-28
|
||||||
|
|
||||||
|
**Portable Characters are experimental and may contain bugs.**
|
||||||
|
|
||||||
|
- Existing unsupported character records no longer block unrelated server updates.
|
||||||
|
|
||||||
|
[Release](https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.1) · [Source changes](https://github.com/Corfirean/coa-server-manager/compare/v0.9.0...v0.9.1)
|
||||||
|
|
||||||
|
## 0.9.0 — 2026-10-28
|
||||||
|
|
||||||
|
**Portable Characters are experimental and may contain bugs.**
|
||||||
|
|
||||||
|
- Choose Parallel or Global level scaling in module settings.
|
||||||
|
- Report Content Scaling problems directly to its repository.
|
||||||
|
- Send custom race problem reports directly to their maintainer.
|
||||||
|
- Internet sharing restores the LAN address after server restarts.
|
||||||
|
- Configure custom race availability for new characters.
|
||||||
|
- Public listing offers every realm that starts together, not just the main one.
|
||||||
|
- Public listing is a short list of realms with a window for the details.
|
||||||
|
- Configure profession and defense skill gains in server settings.
|
||||||
|
- Starting a server sets the character classes of the realm chosen on Overview.
|
||||||
|
- Start Wildcard and Warcraft Reborn together with Conquest of Azeroth.
|
||||||
|
- Control portable characters and keep Manager running in the system tray.
|
||||||
|
|
||||||
|
[Release](https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.0) · [Source changes](https://github.com/Corfirean/coa-server-manager/compare/v0.8.2...v0.9.0)
|
||||||
|
|
||||||
|
## 0.8.2 — 2026-10-27
|
||||||
|
|
||||||
|
**Portable Characters are experimental and may contain bugs.**
|
||||||
|
|
||||||
|
- Installs the verified CoA Custom 1.9.2 client patches and quest safety addon, while recognizing existing 1.9.1 installations.
|
||||||
|
- Server updates preserve the order of database migrations introduced during merges, preventing older snapshots from overwriting newer progression.
|
||||||
|
|
||||||
|
[Release](https://github.com/Corfirean/coa-server-manager/releases/tag/v0.8.2) · [Source changes](https://github.com/Corfirean/coa-server-manager/compare/v0.8.1...v0.8.2)
|
||||||
|
|
||||||
|
## 0.8.1 — 2026-10-25
|
||||||
|
|
||||||
|
**Portable Characters are experimental and may contain bugs.**
|
||||||
|
|
||||||
|
- Install the matching CoA Custom 1.9.1 client files.
|
||||||
|
|
||||||
|
[Release](https://github.com/Corfirean/coa-server-manager/releases/tag/v0.8.1) · [Source changes](https://github.com/Corfirean/coa-server-manager/compare/v0.8.0...v0.8.1)
|
||||||
|
|
||||||
|
## 0.8.0 — 2026-10-24
|
||||||
|
|
||||||
|
**Portable Characters are experimental and may contain bugs.**
|
||||||
|
|
||||||
|
- Server owners can allow portable characters per realm.
|
||||||
|
- Allowing portable characters also prepares the server for portable sessions.
|
||||||
|
- Managers stay compatible with the public connection service.
|
||||||
|
- Relay connections recover and use the ports of the installed server.
|
||||||
|
- Portable progress resumes after reconnecting or restarting the Manager.
|
||||||
|
- Older copies on another host may require maintenance before returning.
|
||||||
|
|
||||||
|
[Release](https://github.com/Corfirean/coa-server-manager/releases/tag/v0.8.0) · [Source changes](https://github.com/Corfirean/coa-server-manager/compare/v0.7.3...v0.8.0)
|
||||||
|
|
||||||
|
## 0.7.3 — 2026-10-23
|
||||||
|
|
||||||
|
**Portable Characters are experimental and may contain bugs.**
|
||||||
|
|
||||||
|
- Portable characters open again after using an experimental Manager.
|
||||||
|
|
||||||
|
[Release](https://github.com/Corfirean/coa-server-manager/releases/tag/v0.7.3) · [Source changes](https://github.com/Corfirean/coa-server-manager/compare/v0.7.2...v0.7.3)
|
||||||
|
|
||||||
|
## 0.7.2 — 2026-10-23
|
||||||
|
|
||||||
|
- Advanced settings cover creature melee damage, spell damage and health by rank.
|
||||||
|
- Internet sharing accepts existing port forwards to the same server.
|
||||||
|
- The Auction House Bot card has a single switch.
|
||||||
|
- More character and server browser controls now use your selected language.
|
||||||
|
- Online player counts correctly separate random bots from players.
|
||||||
|
- Custom races work with shared addon folders on another drive.
|
||||||
|
- Configure the day and night cycle from the module settings.
|
||||||
|
- A stalled database inspection no longer blocks server maintenance indefinitely.
|
||||||
|
|
||||||
|
[Release](https://github.com/Corfirean/coa-server-manager/releases/tag/v0.7.2) · [Source changes](https://github.com/Corfirean/coa-server-manager/compare/v0.7.1...v0.7.2)
|
||||||
|
|
||||||
## 0.7.1 — 2026-10-22
|
## 0.7.1 — 2026-10-22
|
||||||
|
|
||||||
Close the game, then open Modules → Custom Races → Repair Client Patch to update existing patches, or Install Client Patch for a new installation. Updating the Manager does not automatically replace game files or update your server.
|
Close the game, then open Modules → Custom Races → Repair Client Patch to update existing patches, or Install Client Patch for a new installation. Updating the Manager does not automatically replace game files or update your server.
|
||||||
|
|||||||
Generated
+31
-3
@@ -586,7 +586,7 @@ dependencies = [
|
|||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "coa-core"
|
name = "coa-core"
|
||||||
version = "0.7.3"
|
version = "0.9.14"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"base64 0.22.1",
|
"base64 0.22.1",
|
||||||
"chrono",
|
"chrono",
|
||||||
@@ -606,6 +606,7 @@ dependencies = [
|
|||||||
"serde_json",
|
"serde_json",
|
||||||
"sha1",
|
"sha1",
|
||||||
"sha2",
|
"sha2",
|
||||||
|
"socket2",
|
||||||
"tar",
|
"tar",
|
||||||
"tempfile",
|
"tempfile",
|
||||||
"thiserror 2.0.21",
|
"thiserror 2.0.21",
|
||||||
@@ -618,6 +619,15 @@ dependencies = [
|
|||||||
"zstd",
|
"zstd",
|
||||||
]
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "coa-launcher"
|
||||||
|
version = "0.9.14"
|
||||||
|
dependencies = [
|
||||||
|
"coa-core",
|
||||||
|
"serde_json",
|
||||||
|
"windows-sys 0.60.2",
|
||||||
|
]
|
||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "coa-registry-proto"
|
name = "coa-registry-proto"
|
||||||
version = "0.1.0"
|
version = "0.1.0"
|
||||||
@@ -634,7 +644,7 @@ dependencies = [
|
|||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "coa-release"
|
name = "coa-release"
|
||||||
version = "0.7.3"
|
version = "0.9.14"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"chrono",
|
"chrono",
|
||||||
"coa-core",
|
"coa-core",
|
||||||
@@ -643,7 +653,7 @@ dependencies = [
|
|||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "coa-server-manager"
|
name = "coa-server-manager"
|
||||||
version = "0.7.3"
|
version = "0.9.14"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"coa-control-proto",
|
"coa-control-proto",
|
||||||
"coa-core",
|
"coa-core",
|
||||||
@@ -655,8 +665,10 @@ dependencies = [
|
|||||||
"tauri-plugin-dialog",
|
"tauri-plugin-dialog",
|
||||||
"tauri-plugin-opener",
|
"tauri-plugin-opener",
|
||||||
"tauri-plugin-process",
|
"tauri-plugin-process",
|
||||||
|
"tauri-plugin-single-instance",
|
||||||
"tauri-plugin-updater",
|
"tauri-plugin-updater",
|
||||||
"tracing",
|
"tracing",
|
||||||
|
"uuid",
|
||||||
]
|
]
|
||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
@@ -4606,6 +4618,22 @@ dependencies = [
|
|||||||
"tauri-plugin",
|
"tauri-plugin",
|
||||||
]
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "tauri-plugin-single-instance"
|
||||||
|
version = "2.5.5"
|
||||||
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||||
|
checksum = "726b6da0dd5bd1344f84f4108a622c07d01923baacb5c803a605189672c5352f"
|
||||||
|
dependencies = [
|
||||||
|
"serde",
|
||||||
|
"serde_json",
|
||||||
|
"tauri",
|
||||||
|
"thiserror 2.0.21",
|
||||||
|
"tokio",
|
||||||
|
"tracing",
|
||||||
|
"windows-sys 0.61.2",
|
||||||
|
"zbus",
|
||||||
|
]
|
||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "tauri-plugin-updater"
|
name = "tauri-plugin-updater"
|
||||||
version = "2.13.1"
|
version = "2.13.1"
|
||||||
|
|||||||
+2
-2
@@ -1,10 +1,10 @@
|
|||||||
[workspace]
|
[workspace]
|
||||||
resolver = "2"
|
resolver = "2"
|
||||||
members = ["crates/coa-core", "crates/coa-release", "crates/coa-registry-proto", "crates/coa-control-proto", "src-tauri"]
|
members = ["crates/coa-core", "crates/coa-launcher", "crates/coa-release", "crates/coa-registry-proto", "crates/coa-control-proto", "src-tauri"]
|
||||||
exclude = ["services/coa-registry", "services/coa-registry-e2e", "services/coa-coordinator", "services/coa-relay"]
|
exclude = ["services/coa-registry", "services/coa-registry-e2e", "services/coa-coordinator", "services/coa-relay"]
|
||||||
|
|
||||||
[workspace.package]
|
[workspace.package]
|
||||||
version = "0.7.3"
|
version = "0.9.14"
|
||||||
edition = "2021"
|
edition = "2021"
|
||||||
license = "AGPL-3.0-only"
|
license = "AGPL-3.0-only"
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,228 @@
|
|||||||
|
# Per-race availability audit
|
||||||
|
|
||||||
|
Date: 2026-10-27. This is an internal implementation audit, not a supported-feature guide.
|
||||||
|
|
||||||
|
## Frozen sources
|
||||||
|
|
||||||
|
Separate `feat/per-race-toggles` branches and checkouts:
|
||||||
|
|
||||||
|
| Component | Checkout | Fetched base |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| Manager | `C:/games/source/per-race-manager` | `origin/master`, `925a81f` |
|
||||||
|
| Core | `C:/games/source/per-race-core` | `origin/coa-bots`, `1c658cab46d5057a8972cebd84c840aa6fbc4a91` |
|
||||||
|
| CoA Companions | `C:/games/source/per-race-companions` | `origin/master`, `6a289fc2230ce9425924ca86dee02d0bb8d3d344` |
|
||||||
|
| Build | `C:/games/source/per-race-build` | `origin/main`, `89795b6` |
|
||||||
|
|
||||||
|
The build runbook explicitly selects `Corfirean/azerothcore-wotlk-coa:coa-bots`, not its `main`.
|
||||||
|
The old `C:/games/source/server/azerothcore-wotlk-coa` checkout instead tracks jealous-sound upstream
|
||||||
|
and has local modifications. It must not be used as the feature's release base.
|
||||||
|
The primary Manager and Companions checkouts also contain unrelated work and remain untouched.
|
||||||
|
|
||||||
|
SQUID is a separate repository, `Zyth45/mod-playerbots`, not `Corfirean/mod-coa-playerbots`.
|
||||||
|
Existing research checkout: `C:/games/source/squid-playerbots`. Its current local branch is
|
||||||
|
`fix/custom-races-existing-bots`, one commit ahead of `origin/coa`. Build policy selects the highest
|
||||||
|
stable numeric tag, so that local branch must not silently become the shipped dependency.
|
||||||
|
|
||||||
|
## Manager integration points
|
||||||
|
|
||||||
|
- `crates/coa-core/src/custom_races.rs`: package version `1.9.2`, release URLs, MPQ/root/addon lists,
|
||||||
|
hash manifests, client status, install, enable/disable and uninstall.
|
||||||
|
- `PatchTransaction`, `SavedFile`, `recover_patch_transaction`: shared client-relative journal in
|
||||||
|
`.coa-races-transaction/journal.json`, saved files and `committed` marker. Uncommitted changes roll back.
|
||||||
|
Paths use `fsx::safe_join`; file moves handle cross-volume addon locations.
|
||||||
|
- `patch_lock`: exclusive OS file lock on `.coa-races.lock`. The empty file's existence is normal and
|
||||||
|
does not prove another operation is active. Do not delete it as a stale-lock workaround.
|
||||||
|
- Client mutations reject `client::is_running`; reuse this gate and lock for availability changes.
|
||||||
|
- `patch_files`, `matches_patch`, `preserve_original`: ownership and preservation depend on manifests
|
||||||
|
and hashes, not just a filename. Availability overlay ownership needs its own verified record.
|
||||||
|
- `modules/catalog.json`: `custom-races` uses `coa_custom_races.conf` and `CoACustomRaces.Enable`.
|
||||||
|
Companions use `mod_coa_playerbots.conf` / `CoaBots.Enable`; SQUID uses
|
||||||
|
`playerbots.conf` / `AiPlayerbot.Enabled`.
|
||||||
|
- `crates/coa-core/src/modules.rs`: `toggle`, `settings_in`, `save_settings_in` write current module
|
||||||
|
configuration. Bot switches enforce stopped servers and the existing control lock.
|
||||||
|
- `src/screens/ModulesPage.tsx`: Custom Races card, master toggle, install/progress/status UI.
|
||||||
|
- `src/lib/api.ts` and `src-tauri/src/lib.rs`: existing `custom_races_status`,
|
||||||
|
`custom_races_install`, `custom_races_uninstall`, `custom_races_toggle_client` commands.
|
||||||
|
There is no per-race command or verified availability status yet.
|
||||||
|
- `src-tauri/src/lib.rs::play`: local launch reads `realms::state`, calls `client::sync_realm`, then
|
||||||
|
launches. Remote launch has a separate realmlist override path; it cannot infer a remote race policy.
|
||||||
|
- `crates/coa-core/src/realms.rs`: modes CoA, Wildcard and Warcraft Reborn; current configs are captured
|
||||||
|
under `Settings/realm-profiles/<mode>.json`. Use this mechanism rather than a parallel realm store.
|
||||||
|
Existing bot restrictions for non-CoA modes must remain effective.
|
||||||
|
- `crates/coa-core/src/clientdl.rs::apply`: manifest-based client updates, `keep_modified`, staging,
|
||||||
|
preservation of replaced files. No availability-overlay invalidation or rebuild exists today.
|
||||||
|
|
||||||
|
### Confirmed reconciliation risk
|
||||||
|
|
||||||
|
`custom_races.rs::sync_bot_races_config` writes a replacement `AiPlayerbot.ExcludedBotRaces` value:
|
||||||
|
recommended full exclusions or experimental `65,72,77,80,81`. It does not preserve arbitrary user
|
||||||
|
exclusions. `modules.rs` calls it from the master switch and BotsEnable saving; some callers discard
|
||||||
|
errors. Per-race integration cannot rely on this overwrite behavior.
|
||||||
|
|
||||||
|
`playerbots_conf_paths` can also copy a `.dist` file when no active config exists; it is not a purely
|
||||||
|
read-only discovery API. Status inspection should avoid adding more implicit writes.
|
||||||
|
|
||||||
|
## Core gates and bypasses
|
||||||
|
|
||||||
|
- `modules/mod-coa-custom-races/src/mod_coa_custom_races.cpp`: `WorldScript` loads the master switch;
|
||||||
|
`AccountScript::CanAccountCreateCharacter` accepts stock IDs 1–8, 10, 11 or an enabled master switch.
|
||||||
|
No disabled-ID list is implemented. Stock ID 9 is deliberately not included.
|
||||||
|
- `modules/mod-coa-custom-races/conf/coa_custom_races.conf.dist`: Enable and BotsEnable exist;
|
||||||
|
DisabledRaceIds does not.
|
||||||
|
- `src/server/game/Handlers/CharacterHandler.cpp`: normal character creation invokes
|
||||||
|
`sScriptMgr->CanAccountCreateCharacter` inside its finalization callback and rejects with
|
||||||
|
`CHAR_CREATE_DISABLED`. A packet from an unpatched client reaches that gate too.
|
||||||
|
- `src/server/game/Scripting/ScriptDefines/AccountScript.cpp`: hook aggregation must be preserved.
|
||||||
|
- `src/server/game/DataStores/DBCStores.cpp::LoadDBCStores`: chooses `DataDir/dbc_races/<file>` if
|
||||||
|
the master switch is enabled and that file exists, otherwise `DataDir/dbc/<file>`.
|
||||||
|
Per-race creation policy must not remove DBC rows or change login data.
|
||||||
|
- `.agents/docs/systems/ascension-character-creation.md`: native client compatibility depends on
|
||||||
|
`CharBaseInfo.dbc`; race button indices are not RaceIDs. Existing race/class checks must stay intact.
|
||||||
|
|
||||||
|
## Both bot systems
|
||||||
|
|
||||||
|
### CoA Companions
|
||||||
|
|
||||||
|
`module/src/BotSpawnRandom.cpp::GetValidBotRaces` reads the global and bot custom-race switches,
|
||||||
|
`CoaBots.CustomRaces.Enable`, and both AiPlayerbot/CoaBots exclusion lists. It checks DBC presence.
|
||||||
|
Its experimental defaults apply only when the combined exclusion set is empty: adding an owner list
|
||||||
|
to that set would silently remove those defaults. Keep those policies independent.
|
||||||
|
|
||||||
|
`CreateBotClone`, `CreateOneRandomBot`, and leveled spawning clone SQL character data directly;
|
||||||
|
they bypass the account creation hook. Enforce new-character policy at the common clone creation
|
||||||
|
entry as well as random selection. Preserve existing bots and faction selection via
|
||||||
|
`Player::TeamIdForRace`.
|
||||||
|
|
||||||
|
Additional confirmed callers: `module/src/BotBattlegroundFill.cpp::QueueBotForSide` and
|
||||||
|
`module/src/BotLfgFill.cpp` call `CreateOneRandomBot` after trying to reuse an existing bot.
|
||||||
|
The existing-bot reuse path must remain separate from creation restrictions.
|
||||||
|
|
||||||
|
`tools/offline_bot_factory.py` is another direct-SQL creation path. Its main loop chooses a
|
||||||
|
template by class and faction, then copies `template.race` into the new character overrides.
|
||||||
|
It currently does not read the custom-race creation policy. Reject or filter prohibited
|
||||||
|
templates before generating new accounts, GUIDs or SQL; do not rewrite their races.
|
||||||
|
|
||||||
|
### SQUID Playerbots
|
||||||
|
|
||||||
|
`src/PlayerbotAIConfig.cpp` loads `AiPlayerbot.ExcludedBotRaces` and adds
|
||||||
|
`AiPlayerbot.CrashingBotRaces`; it reads BotsEnable. `src/CoaBotRacePolicy.h` implements
|
||||||
|
`IsCoaBotRaceAllowed`. `src/Bot/Factory/RandomPlayerbotFactory.cpp::CreateRandomBot` applies
|
||||||
|
that policy before faction and race/class selection.
|
||||||
|
|
||||||
|
The same predicate also appears in `src/Bot/RandomPlayerbotMgr.cpp` and
|
||||||
|
`src/Bot/PlayerbotMgr.cpp`, including existing-character admission. Do not append owner creation
|
||||||
|
restrictions globally to this shared exclusion vector: that would also affect existing bots.
|
||||||
|
The predicate currently does not itself require `CoACustomRaces.Enable`.
|
||||||
|
`RandomPlayerbotFactory.cpp` calls `Player::Create` directly without the account hook.
|
||||||
|
Use a creation-only check in this factory, leaving existing-character admission unchanged.
|
||||||
|
|
||||||
|
## Portable Characters
|
||||||
|
|
||||||
|
Manager import code is under `crates/coa-core/src/portable/realm/`.
|
||||||
|
`import.rs` validates identity namespaces and race/class start data (`UnknownRaceClass`).
|
||||||
|
Availability policy must not become an import rejection or an identity rewrite. The inspected
|
||||||
|
creation hook is in the normal packet handler, not this importer. In the core,
|
||||||
|
`src/server/coa/CoAPortableImport.cpp` checks `GetPlayerInfo(model.Race, model.Class)` and writes
|
||||||
|
`model.Race` to the imported character and character cache. It does not invoke the account
|
||||||
|
creation hook. Preserve this separation. Live compatibility is still untested.
|
||||||
|
|
||||||
|
## Client experiment, actual observations
|
||||||
|
|
||||||
|
The owner updated `C:/games/Ascension` from 1.9.1 to 1.9.2 during this audit; its manifest now says
|
||||||
|
`# CoA Custom 1.9.2`. A separate physical client copy is being prepared under
|
||||||
|
`C:/games/source/per-race-evidence/client`; game assets are outside Git. The copy completed:
|
||||||
|
25646 files copied, zero failures. The separate server file copy also completed, but has not
|
||||||
|
been configured or started. No database service has been started for this task.
|
||||||
|
|
||||||
|
Read-only MPQ membership probing found ChrRaces in patch-ZZZF, ZZZE, ZZZC, ZZZ, ZZW, ZZV, ZZU,
|
||||||
|
ZZS, T, M and several locale archives. CharacterCreate.lua has multiple owners too.
|
||||||
|
The old `mpqprobe.py` precedence model explicitly admits an inference for Ascension multi-letter
|
||||||
|
archives. Therefore `patch-ZZZF.MPQ` is a candidate source, not runtime-confirmed effective data.
|
||||||
|
`patch-ZZZZ.MPQ` exists already; no overlay filename has been qualified.
|
||||||
|
|
||||||
|
Extracted from `patch-ZZZF.MPQ`:
|
||||||
|
|
||||||
|
- WDBC, 95 records, 69 fields, record size 276, string block 2428, total bytes 28668.
|
||||||
|
- SHA-256 `b78635b08bf0bd63d2898fce97c1fb162c8a9c41632703172eefa88bae79061f`.
|
||||||
|
- Actual rows: Sethrak 82, Gnoll 83, Saberon 97. Their Flags are 12.
|
||||||
|
- String block starts with `Hu`, not NUL; imposing an initial empty-string invariant incorrectly
|
||||||
|
rejects this real table. String boundaries and referenced offsets still need validation.
|
||||||
|
- Sethrak experiment changes only Flags 12 → 13. All other bytes compare equal.
|
||||||
|
- One generated MPQ was read back through StormLib; its DBC equals the expected patched bytes.
|
||||||
|
- The installed `pympq` Python extension crashed during interpreter finalization. The experimental
|
||||||
|
tool instead uses the installed Unicode StormLib DLL directly. It is not a runtime dependency
|
||||||
|
proposal for Manager or its users.
|
||||||
|
|
||||||
|
`tools/race_availability_poc.py` requires an explicit source archive and creates output only in a new
|
||||||
|
directory. It does not select an archive order, install an overlay or assert in-game success.
|
||||||
|
`tools/test_race_availability_poc.py` uses synthetic bytes only.
|
||||||
|
|
||||||
|
### Background verification after interactive testing was deferred
|
||||||
|
|
||||||
|
The owner requested no screen capture/input and no client/server/MySQL launches while other bot
|
||||||
|
tests run. These restrictions remain active. The owner reported that the copied client launches;
|
||||||
|
this does not confirm creation behavior or effective DBC loading.
|
||||||
|
|
||||||
|
- 17 DBC/fingerprint tests and 8 synthetic MPQ integration tests pass (25 total, none skipped).
|
||||||
|
- Native tests use the explicitly selected existing Unicode StormLib DLL, with no new install.
|
||||||
|
- Output is built and verified in a temporary directory before publishing the offline result folder.
|
||||||
|
Failures leave no published result; this is not the future client transaction implementation.
|
||||||
|
- One and fifty disabled races both produce one MPQ. StormLib adds an internal `(listfile)`;
|
||||||
|
the sole game payload is `DBFilesClient/ChrRaces.dbc`.
|
||||||
|
- Every referenced localized race-name offset is bounds-checked; invalid UTF-8 is rejected.
|
||||||
|
- The experimental fingerprint includes original DBC SHA-256, normalized IDs, algorithm version
|
||||||
|
and explicitly recorded profile. A profile label does not prove client compatibility.
|
||||||
|
- The real three-race offline experiment is in
|
||||||
|
`C:/games/source/per-race-evidence/multiple-races-offline/report.json`.
|
||||||
|
Source MPQ SHA-256: `40eac695cfcafb598b8376f3b9a61ecc037e4d445b87279cfe387a91edad32c3`.
|
||||||
|
Generated DBC SHA-256: `243fb36837b76ebd6943da574cc095be548b4530be7f06487debea6703db10d3`.
|
||||||
|
|
||||||
|
The first copy launch showed a missing-critical-files message and subsequently crashed on exit.
|
||||||
|
The crash report identifies `AMDXN32.DLL` in the AMD graphics driver at the fault address; this
|
||||||
|
does not establish the root cause. EXE, Extensions, dinput8, d3d9, dxgi, EsteriaAppearance and
|
||||||
|
patch-ZZZF hashes matched the primary client during comparison. The experimental overlay was
|
||||||
|
not installed. No graphics-driver or client-runtime changes were made to work around the crash.
|
||||||
|
|
||||||
|
## Reference implementations and update preservation
|
||||||
|
|
||||||
|
Inspected read-only reference clones:
|
||||||
|
|
||||||
|
- `aspollon/AFK-Realm` at `ea9c5bf691c98cace8cc03c06183c161022946de`.
|
||||||
|
- `aspollon/mod-custom-races` at `5a8f2ff8a0d494ffadf64e677a438aa7f5a6671b`.
|
||||||
|
|
||||||
|
`mod-custom-races/afk-realm.json` declares client patch generation and GlueXML Lua insertion.
|
||||||
|
`client/CustomRaces.lua` extends and lays out buttons, using race names/files and configured IDs.
|
||||||
|
This is a reference, not evidence of compatibility with the current CoA/Esteria UI or a reason
|
||||||
|
to replace CSM's prebuilt-server distribution.
|
||||||
|
|
||||||
|
`crates/coa-core/src/config/merge.rs` performs additive `.dist` merging: missing keys are added,
|
||||||
|
existing user values and unknown keys are retained. A new DisabledRaceIds key should use this
|
||||||
|
path. Existing realm snapshots already capture module `.conf` files. Neither mechanism currently
|
||||||
|
coordinates an availability overlay with client update/repair; that remains implementation work.
|
||||||
|
|
||||||
|
## Open gates
|
||||||
|
|
||||||
|
Update after the owner found the existing Hide Races panel: see
|
||||||
|
[existing-filter research](docs/PER_RACE_EXISTING_FILTER_RESEARCH.md). The inspected Lua already
|
||||||
|
supports personal name/index-based hiding, but it is not a realm-scoped RaceID policy. Nine
|
||||||
|
offline Lua 5.1 probes confirmed key behavior and limitations. Reusing its layout/UI is now a
|
||||||
|
candidate to investigate before choosing a production DBC implementation. This is not evidence
|
||||||
|
that the DBC approach failed, and it does not qualify client support.
|
||||||
|
|
||||||
|
The owner subsequently confirmed the GlueXML probe: restricted races disappeared from selection
|
||||||
|
and were grey, unchecked and disabled in Hide Races. The production client integration should
|
||||||
|
reuse this filter; changing DBC flags is no longer the selected implementation path.
|
||||||
|
|
||||||
|
Server controls, strict catalog-bound configuration, the core creation hook and both bot factory
|
||||||
|
guards are implemented and have passed offline checks and native builds. Existing-bot admission
|
||||||
|
and user/crashing exclusions remain separate from the new creation policy.
|
||||||
|
|
||||||
|
Remaining gates:
|
||||||
|
1. Integrate automatic client reconciliation, ownership and recovery with realm settings.
|
||||||
|
2. Qualify client update/repair and shared-client PLAY behavior.
|
||||||
|
3. Verify live creation rejection/re-enable, existing-character login, imports and both bot systems
|
||||||
|
when the owner's database test environment becomes available.
|
||||||
|
|
||||||
|
Status: **PARTIAL** — server implementation and builds pass; live server acceptance and production
|
||||||
|
client synchronization remain pending. See docs/PER_RACE_TOGGLES_TESTS.md for exact scope.
|
||||||
|
No existing character data, production service, release channel, or primary client archive was changed.
|
||||||
+7247
File diff suppressed because it is too large.
Load diff
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: added
|
||||||
|
audience: admins
|
||||||
|
title: Choose Parallel or Global level scaling in module settings
|
||||||
|
---
|
||||||
|
Content Scaling progression can now be set to Parallel (Classic over 1 to the level cap, TBC and WotLK over 45 to the cap) or Global (all expansions over 1 to the cap) without editing the config file by hand.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: added
|
||||||
|
audience: admins
|
||||||
|
title: Server owners can allow portable characters per realm
|
||||||
|
---
|
||||||
|
Portable admission is off until enabled by the realm owner. Export and import requests enforce the saved choice.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Allowing portable characters also prepares the server for portable sessions
|
||||||
|
---
|
||||||
|
Stop the server before enabling access for the first time. The Manager enables portable sessions in the effective module configuration and preserves the required database setting across restarts. Existing configuration is backed up.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Managers stay compatible with the public connection service
|
||||||
|
---
|
||||||
|
Coordinator authentication no longer changes when portable messages change. The publishing card shows game relay status separately.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Relay connections recover and use the ports of the installed server
|
||||||
|
---
|
||||||
|
Dropped or unresponsive relay links reconnect automatically. Abandoned game connections close, and tunnels refresh when local ports become available or change. Custom authentication ports are respected.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Portable progress resumes after reconnecting or restarting the Manager
|
||||||
|
---
|
||||||
|
The player Manager now saves remote baselines, checkpoints and logout progress durably. Repeated logins stay monitored, and transfer retries preserve the same character and session.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: known-issue
|
||||||
|
audience: admins
|
||||||
|
title: Older copies on another host may require maintenance before returning
|
||||||
|
---
|
||||||
|
Experimental portable play blocks an outdated existing copy on another host. Automatic refresh while that remote worldserver runs is not available. Your canonical character remains saved in your Manager.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: client
|
||||||
|
type: changed
|
||||||
|
audience: players
|
||||||
|
title: Install the matching CoA Custom 1.9.1 client files
|
||||||
|
---
|
||||||
|
The races installer verifies and installs all five client archives, including the new races and appearance corrections.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: changed
|
||||||
|
audience: players
|
||||||
|
title: Install the CoA Custom 1.9.2 client patches
|
||||||
|
---
|
||||||
|
Installs the updated Hozen and Centaur assets and quest safety addon. Existing CoA Custom 1.9.1 installations remain recognized when updating or removing patches.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: added
|
||||||
|
audience: admins
|
||||||
|
title: Report Content Scaling problems directly to its repository
|
||||||
|
---
|
||||||
|
The report form now includes a separate Content Scaling destination.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: added
|
||||||
|
audience: admins
|
||||||
|
title: Send custom race problem reports directly to their maintainer
|
||||||
|
---
|
||||||
|
The report form now includes Custom Races as a separate destination.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Internet sharing restores the LAN address after server restarts
|
||||||
|
---
|
||||||
|
Friends on the local network receive the server's LAN address and network mask while internet players keep using its public address.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Server updates preserve the order of database migrations added during merges
|
||||||
|
---
|
||||||
|
Older database snapshots no longer run after newer updates when preparing server packages. This prevents outdated Manastorm reward ranges from overwriting newer progression data.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: added
|
||||||
|
audience: admins
|
||||||
|
title: Configure custom race availability for new characters
|
||||||
|
---
|
||||||
|
Choose individual races in a compact table inside module settings using the installed server catalog. Saving requires a compatible server build and a stopped server. Client synchronization is not yet automatic.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Public listing offers every realm that starts together, not just the main one
|
||||||
|
---
|
||||||
|
With Wildcard or Warcraft Reborn started next to Conquest of Azeroth, Settings now has one listing block per realm, each with its own name, description and access options.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: changed
|
||||||
|
audience: admins
|
||||||
|
title: Public listing is a short list of realms with a window for the details
|
||||||
|
---
|
||||||
|
Settings shows one line per realm with its state, and publishing opens a window. Publish all realms at once. Account creation and portable characters are chosen before publishing; portable characters are on by default.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: added
|
||||||
|
audience: admins
|
||||||
|
title: Configure profession and defense skill gains in server settings
|
||||||
|
---
|
||||||
|
Advanced rate settings now include prospecting and milling skill gains, plus the points gained from crafting, defense and gathering.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Starting a server sets the character classes of the realm chosen on Overview
|
||||||
|
---
|
||||||
|
A new Conquest of Azeroth server could show two class models, or none, on the character creation screen. The Manager now sets the model of the chosen realm before every start.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: added
|
||||||
|
audience: admins
|
||||||
|
title: Start Wildcard and Warcraft Reborn together with Conquest of Azeroth
|
||||||
|
---
|
||||||
|
Settings now has two options, one for Wildcard and one for Warcraft Reborn. Turn on either one, or both to run all three realms at once, each with its own characters and port.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: added
|
||||||
|
audience: admins
|
||||||
|
title: Find and edit CoA options in the existing server settings
|
||||||
|
---
|
||||||
|
Search includes the separate CoA configuration, including legacy mount flight. Changes go to the correct file; realm profile controls stay managed by the Manager.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Existing unsupported character records no longer block unrelated server updates
|
||||||
|
---
|
||||||
|
Updates compare each affected character with its saved pre-update state. Unchanged older problems are reported as warnings without changing characters. Newly missing race/class data still blocks the update and triggers recovery; schema and identity checks remain enforced.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Recovery can stop an unfinished world startup after restoring an older launcher
|
||||||
|
---
|
||||||
|
If the world console is unavailable, stop only the verified recorded world process. Keep MySQL running if ownership or shutdown cannot be confirmed.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: New server installation waits for slower database startup
|
||||||
|
---
|
||||||
|
Allow up to five minutes for MySQL to become ready. Failed installations stop their temporary database before cleaning up its files.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: added
|
||||||
|
audience: admins
|
||||||
|
title: Control portable characters and keep Manager running in the system tray
|
||||||
|
---
|
||||||
|
Realm access settings can enable portable characters. Closing the window keeps Manager in the tray, with commands to reopen or exit. Offline realm messages explain why players cannot connect.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: changed
|
||||||
|
audience: admins
|
||||||
|
title: Settings group updates, startup and maintenance with translated release history
|
||||||
|
---
|
||||||
|
Server and Manager keep separate update controls. Read their published changes in one place, including translations of the latest releases in all six interface languages. Saved notes remain available offline. Find public realm controls under Play with friends.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: changed
|
||||||
|
audience: admins
|
||||||
|
title: Update and launch without updating share a divided button
|
||||||
|
---
|
||||||
|
Server and game client actions each use two adjacent segments of equal height. Both actions remain visible and keep their own availability checks.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Simultaneous update checks share results or wait their turn
|
||||||
|
---
|
||||||
|
Repeated checks no longer compete with another foreground or background check in the same Manager window. Maintenance and recovery locks remain enforced.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Maximizing the window keeps text and controls at a comfortable size
|
||||||
|
---
|
||||||
|
The interface no longer enlarges with window width. System display scaling and browser zoom still work, and large action buttons use more compact spacing.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Slow server startup no longer triggers an early update rollback
|
||||||
|
---
|
||||||
|
World startup now allows up to 25 minutes with either bot system and waits for both game and console ports within one deadline. Servers that stop during startup still fail immediately.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Account creation verifies a lost console reply against the requested login
|
||||||
|
---
|
||||||
|
Confirm the requested credentials after a lost reply, block creation during another server action, and explicitly report accounts whose administrator access could not be confirmed.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Abandoned game relay tunnels close their local connection immediately
|
||||||
|
---
|
||||||
|
Dropping a tunnel shuts down its shared socket directly instead of relying only on a background message, releasing its local read and write connection.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Keep disabled graphics components disabled during client updates
|
||||||
|
---
|
||||||
|
Client settings can disable DXVK and graphics enhancements. Existing launcher DISABLED files are respected.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: added
|
||||||
|
audience: admins
|
||||||
|
title: Force-stop an unresponsive world after a failed normal shutdown
|
||||||
|
---
|
||||||
|
Confirm the risk of unsaved progress before stopping verified server processes. Shared databases stay running until every owned world has stopped.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Crash history includes reports from every world and Windows text files
|
||||||
|
---
|
||||||
|
Create and verify the crash report folder before native startup, and include reports from simultaneous worlds and files containing Windows ANSI text.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Show the online bot count for Playerbots on the overview
|
||||||
|
---
|
||||||
|
The overview displays bot population for both supported bot systems.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: added
|
||||||
|
audience: admins
|
||||||
|
title: Disable public server browsing in Settings
|
||||||
|
---
|
||||||
|
Turn off public server browsing to block catalog list and detail requests. When browsing is enabled, load the list with Refresh.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Keep deliberate stops and update shutdowns from triggering crash restart
|
||||||
|
---
|
||||||
|
Status checks no longer forget a stop request while the world is still shutting down. Update validation and recovery do not trigger automatic crash restarts.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Show available update notes even when release history is cached
|
||||||
|
---
|
||||||
|
Fetch the release notes for the offered update when they are missing from the cached history, including when an update becomes available while the history is open.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Server startup waits for a responsive console before reporting success
|
||||||
|
---
|
||||||
|
An open port no longer marks a loading world as ready. Account creation checks that the console processes commands before sending a create request.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Restore the existing Manager window when launching it again
|
||||||
|
---
|
||||||
|
Choose whether closing the window exits the Manager or minimizes it to the tray. Tray actions restore the window on the UI thread.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: added
|
||||||
|
audience: admins
|
||||||
|
title: Dungeon Clear can be enabled when SQUID bots are active
|
||||||
|
---
|
||||||
|
Dungeon Clear starts disabled. Switching SQUID bots off also switches Dungeon Clear off; enabling SQUID again leaves Dungeon Clear off until you choose to enable it.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: added
|
||||||
|
audience: admins
|
||||||
|
title: Diagnostic exports include launcher stages and lock owner records
|
||||||
|
---
|
||||||
|
Support packages include recent launcher diagnostics for each realm, with sensitive fields removed. Recorded lock owners help diagnose overlapping startup and shutdown actions.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Custom Races patch installation recovers from interrupted downloads
|
||||||
|
---
|
||||||
|
Unfinished downloads resume automatically. Invalid archives in Downloads are skipped without changing them, and damaged cached archives are downloaded again.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: added
|
||||||
|
audience: admins
|
||||||
|
title: Choose normal logs, errors only or no server logs in maintenance settings
|
||||||
|
---
|
||||||
|
The logging preset updates both the game world and login server, including their configuration templates. Previous settings are saved in configuration snapshots. Restart the server to apply the change.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Update checks temporarily suspend bot population and restore your configuration
|
||||||
|
---
|
||||||
|
Validation preserves the selected bot system and its population limits. Original configuration files are restored after validation, including recovery from interrupted updates.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Update validation keeps MySQL running between compatible checks
|
||||||
|
---
|
||||||
|
Database checks and the temporary server startup share one MySQL session. The server still stops before files or database snapshots are replaced or restored.
|
||||||
@@ -0,0 +1,6 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Update and recovery checks use the temporary login port even with a Windows override
|
||||||
|
---
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: added
|
||||||
|
audience: admins
|
||||||
|
title: Settings for how much help bots get in dungeons and raids
|
||||||
|
---
|
||||||
|
Bot damage, healing, damage taken and tank threat can now be tuned under Bots, Combat. Everything defaults to 1 (no change); a switch turns the extra help for four hard bosses on.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: added
|
||||||
|
audience: players
|
||||||
|
title: Install community addons from the Manager
|
||||||
|
---
|
||||||
|
The game client card lists SquidBots Lite, DragonUI, IncahootsCoA and CoACombat. Each comes from its author's GitHub at a pinned version, every file is checked before it goes into Interface/AddOns, and the Manager updates or removes only what it installed.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: added
|
||||||
|
audience: players
|
||||||
|
title: Old item and creature data is cleared before every Play
|
||||||
|
---
|
||||||
|
After a server update the game showed old names and stats from its own cache (Cache/WDB). Play now clears that cache first; it fills again within seconds. A switch next to the client graphics settings turns it off.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: players
|
||||||
|
title: Turning the custom races client patch on or off takes seconds again
|
||||||
|
---
|
||||||
|
V2 has over 7,000 files and switching it could run for many minutes. Now only the files the game itself loads are hidden, and the rest stays in place. A switch that was cut short is undone safely.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: changed
|
||||||
|
audience: players
|
||||||
|
title: The custom races client is updated to Custom Races V2
|
||||||
|
---
|
||||||
|
The client update installs V2 and starts its own CoACustomRace.exe; Ascension.exe is left as it was. Four archives are the same as in 1.9.2, so a game folder that already had 1.9.2 downloads only the rest.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: The database moves to a free port when Windows reserves or another program takes 3307
|
||||||
|
---
|
||||||
|
Hyper-V, WSL and Docker can reserve a range that includes the database port; the start then waited 30 seconds and failed. The database now picks a free port and records it, and a reserved game port is named as such at once.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: added
|
||||||
|
audience: admins
|
||||||
|
title: Your own MySQL settings survive restarts and updates
|
||||||
|
---
|
||||||
|
Settings, Service has a MySQL settings box. Its options are added to my.ini at every start of the database; before, my.ini was rewritten and hand edits were lost. Port, addresses and data paths stay managed.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: admins
|
||||||
|
title: Disabled custom races stay disabled after a server update that adds races
|
||||||
|
---
|
||||||
|
A race list saved before Custom Races V2 no longer matched V2's race catalog, and the server then ignored it and turned custom races off. Before a start the Manager now keeps the list when every disabled race kept its ID and name.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: added
|
||||||
|
audience: admins
|
||||||
|
title: Rename your realms in the Manager
|
||||||
|
---
|
||||||
|
Settings, Startup has a name for every realm. A running server shows it at once, the game client picks it on the next Play, and it stays after restarts and updates. Before, the launcher wrote the default name back at every start.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: fixed
|
||||||
|
audience: players
|
||||||
|
title: The account for a friend's server is in the login box at every Play
|
||||||
|
---
|
||||||
|
The account the Manager made on a listed server was filled in only when joining. Play now fills it in every time, also after another server's account was used.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: added
|
||||||
|
audience: admins
|
||||||
|
title: Restart the world every day at a chosen time
|
||||||
|
---
|
||||||
|
Settings, Startup, Scheduled restart: at that local time the world restarts with an in-game countdown and comes back by itself; the database keeps running. It works without the Manager open and needs a server with the new launcher.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: added
|
||||||
|
audience: admins
|
||||||
|
title: Switches for the Custom Races V2 subclasses, Hero Races and the /dev menu
|
||||||
|
---
|
||||||
|
The Custom Races settings now hold Subclasses and Hero Races (subclasses, the Thin Twins, the Two-Headed Ogre, two players per character) and the GM /dev menu, each with its own switch.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: added
|
||||||
|
audience: admins
|
||||||
|
title: Companion bots on Wildcard and Warcraft Reborn
|
||||||
|
---
|
||||||
|
With a server build that supports it, Companions can be switched on for Wildcard and Warcraft Reborn: bots get whole Wildcard archetypes or Reborn abilities by level, and bot creation survives a crash without duplicates.
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
---
|
||||||
|
area: manager
|
||||||
|
type: added
|
||||||
|
audience: admins
|
||||||
|
title: The Custom Races card tells which characters stay out while races are off
|
||||||
|
---
|
||||||
|
With custom races off, the card shows how many player characters and bots of custom races cannot enter the world, and offers to delete the companion bots of those races.
|
||||||
+348
-1
@@ -112,6 +112,8 @@
|
|||||||
"Corfirean/coa-server-manager:20261016-preserve-core-migration-history.md",
|
"Corfirean/coa-server-manager:20261016-preserve-core-migration-history.md",
|
||||||
"Corfirean/coa-server-manager:20261016-shared-auth-migration-history.md",
|
"Corfirean/coa-server-manager:20261016-shared-auth-migration-history.md",
|
||||||
"Corfirean/coa-server-manager:20261016-update-compatibility-wording.md",
|
"Corfirean/coa-server-manager:20261016-update-compatibility-wording.md",
|
||||||
|
"Corfirean/coa-server-manager:20261017-creature-difficulty-rates.md",
|
||||||
|
"Corfirean/coa-server-manager:20261017-existing-router-mapping.md",
|
||||||
"Corfirean/coa-server-manager:20261018-custom-races-client.md",
|
"Corfirean/coa-server-manager:20261018-custom-races-client.md",
|
||||||
"Corfirean/coa-server-manager:20261019-portable-stop-diagnostics.md",
|
"Corfirean/coa-server-manager:20261019-portable-stop-diagnostics.md",
|
||||||
"Corfirean/coa-server-manager:20261019-remote-character-class-names.md",
|
"Corfirean/coa-server-manager:20261019-remote-character-class-names.md",
|
||||||
@@ -120,7 +122,75 @@
|
|||||||
"Corfirean/coa-server-manager:20261021-portable-experimental.md",
|
"Corfirean/coa-server-manager:20261021-portable-experimental.md",
|
||||||
"Corfirean/coa-server-manager:20261021-scaling-health-settings.md",
|
"Corfirean/coa-server-manager:20261021-scaling-health-settings.md",
|
||||||
"Corfirean/coa-server-manager:20261021-warcraft-reborn-realm.md",
|
"Corfirean/coa-server-manager:20261021-warcraft-reborn-realm.md",
|
||||||
"Corfirean/coa-server-manager:20261022-custom-races-client.md"
|
"Corfirean/coa-server-manager:20261022-custom-races-client.md",
|
||||||
|
"Corfirean/coa-server-manager:20261022-scaling-progression-modes.md",
|
||||||
|
"Corfirean/coa-server-manager:20261023-ah-bot-single-switch.md",
|
||||||
|
"Corfirean/coa-server-manager:20261023-interface-language-coverage.md",
|
||||||
|
"Corfirean/coa-server-manager:20261023-online-players-exclude-squid-bots.md",
|
||||||
|
"Corfirean/coa-server-manager:20261023-shared-addons-links.md",
|
||||||
|
"Corfirean/coa-server-manager:20261023-time-is-time-settings.md",
|
||||||
|
"Corfirean/coa-server-manager:20261023-update-check-database-timeout.md",
|
||||||
|
"Corfirean/coa-server-manager:20261024-portable-admission.md",
|
||||||
|
"Corfirean/coa-server-manager:20261024-portable-owner-core-activation.md",
|
||||||
|
"Corfirean/coa-server-manager:20261024-portable-schema-nine.md",
|
||||||
|
"Corfirean/coa-server-manager:20261024-relay-authentication.md",
|
||||||
|
"Corfirean/coa-server-manager:20261024-relay-recovery.md",
|
||||||
|
"Corfirean/coa-server-manager:20261024-remote-progress.md",
|
||||||
|
"Corfirean/coa-server-manager:20261024-remote-refresh.md",
|
||||||
|
"Corfirean/coa-server-manager:20261025-custom-races-191.md",
|
||||||
|
"Corfirean/coa-server-manager:20261026-custom-races-192.md",
|
||||||
|
"Corfirean/coa-server-manager:20261027-content-scaling-reports.md",
|
||||||
|
"Corfirean/coa-server-manager:20261027-custom-races-reports.md",
|
||||||
|
"Corfirean/coa-server-manager:20261027-internet-lan-address.md",
|
||||||
|
"Corfirean/coa-server-manager:20261027-merged-database-migration-order.md",
|
||||||
|
"Corfirean/coa-server-manager:20261027-per-race-server-settings.md",
|
||||||
|
"Corfirean/coa-server-manager:20261027-public-list-shows-every-running-realm.md",
|
||||||
|
"Corfirean/coa-server-manager:20261027-public-listing-window.md",
|
||||||
|
"Corfirean/coa-server-manager:20261027-skill-gain-controls.md",
|
||||||
|
"Corfirean/coa-server-manager:20261027-start-checks-the-realm-class-setting.md",
|
||||||
|
"Corfirean/coa-server-manager:20261027-start-wildcard-and-reborn-with-coa.md",
|
||||||
|
"Corfirean/coa-server-manager:20261028-coa-config-search.md",
|
||||||
|
"Corfirean/coa-server-manager:20261028-existing-character-update-validation.md",
|
||||||
|
"Corfirean/coa-server-manager:20261028-legacy-world-shutdown.md",
|
||||||
|
"Corfirean/coa-server-manager:20261028-mysql-install-startup.md",
|
||||||
|
"Corfirean/coa-server-manager:20261028-portable-settings-and-tray.md",
|
||||||
|
"Corfirean/coa-server-manager:20261028-settings-release-history.md",
|
||||||
|
"Corfirean/coa-server-manager:20261028-split-update-actions.md",
|
||||||
|
"Corfirean/coa-server-manager:20261028-update-check-queue.md",
|
||||||
|
"Corfirean/coa-server-manager:20261028-window-density.md",
|
||||||
|
"Corfirean/coa-server-manager:20261029-slow-world-startup.md",
|
||||||
|
"Corfirean/coa-server-manager:20261030-account-console-confirmation.md",
|
||||||
|
"Corfirean/coa-server-manager:20261030-close-abandoned-relay-sockets.md",
|
||||||
|
"Corfirean/coa-server-manager:20261030-disabled-client-renderers.md",
|
||||||
|
"Corfirean/coa-server-manager:20261030-force-stop-unresponsive-world.md",
|
||||||
|
"Corfirean/coa-server-manager:20261030-native-crash-reports.md",
|
||||||
|
"Corfirean/coa-server-manager:20261030-playerbots-overview-count.md",
|
||||||
|
"Corfirean/coa-server-manager:20261030-public-server-browsing-control.md",
|
||||||
|
"Corfirean/coa-server-manager:20261030-stop-does-not-trigger-auto-restart.md",
|
||||||
|
"Corfirean/coa-server-manager:20261030-update-history-target-cache.md",
|
||||||
|
"Corfirean/coa-server-manager:20261030-wait-for-world-console-readiness.md",
|
||||||
|
"Corfirean/coa-server-manager:20261030-window-lifecycle.md",
|
||||||
|
"Corfirean/coa-server-manager:20261031-dungeon-clear-dependency.md",
|
||||||
|
"Corfirean/coa-server-manager:20261031-launcher-diagnostics-export.md",
|
||||||
|
"Corfirean/coa-server-manager:20261031-recover-client-patch-downloads.md",
|
||||||
|
"Corfirean/coa-server-manager:20261031-server-logging-controls.md",
|
||||||
|
"Corfirean/coa-server-manager:20261031-validation-bot-population.md",
|
||||||
|
"Corfirean/coa-server-manager:20261031-validation-mysql-reuse.md",
|
||||||
|
"Corfirean/coa-server-manager:20261103-isolated-login-port.md",
|
||||||
|
"Corfirean/coa-server-manager:20261107-bot-strength-scaling-settings.md",
|
||||||
|
"Corfirean/coa-server-manager:20261115-addon-catalog.md",
|
||||||
|
"Corfirean/coa-server-manager:20261115-clear-game-cache.md",
|
||||||
|
"Corfirean/coa-server-manager:20261115-custom-races-fast-toggle.md",
|
||||||
|
"Corfirean/coa-server-manager:20261115-custom-races-v2-client.md",
|
||||||
|
"Corfirean/coa-server-manager:20261115-database-port-relocation.md",
|
||||||
|
"Corfirean/coa-server-manager:20261115-mysql-custom-options.md",
|
||||||
|
"Corfirean/coa-server-manager:20261115-race-restriction-kept.md",
|
||||||
|
"Corfirean/coa-server-manager:20261115-realm-names.md",
|
||||||
|
"Corfirean/coa-server-manager:20261115-remembered-friend-login.md",
|
||||||
|
"Corfirean/coa-server-manager:20261115-scheduled-restart.md",
|
||||||
|
"Corfirean/coa-server-manager:20261115-v2-feature-switches.md",
|
||||||
|
"Corfirean/coa-server-manager:20261116-companions-wildcard-reborn.md",
|
||||||
|
"Corfirean/coa-server-manager:20261116-custom-race-characters-off.md"
|
||||||
],
|
],
|
||||||
"releases": [
|
"releases": [
|
||||||
{
|
{
|
||||||
@@ -623,6 +693,283 @@
|
|||||||
"links": [
|
"links": [
|
||||||
"[Guides and screenshots](https://github.com/Corfirean/coa-server-manager/blob/master/docs/README.md)"
|
"[Guides and screenshots](https://github.com/Corfirean/coa-server-manager/blob/master/docs/README.md)"
|
||||||
]
|
]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"tag": "v0.7.2",
|
||||||
|
"version": "0.7.2",
|
||||||
|
"date": "2026-10-23",
|
||||||
|
"url": "https://github.com/Corfirean/coa-server-manager/releases/tag/v0.7.2",
|
||||||
|
"notes": [
|
||||||
|
"Advanced settings cover creature melee damage, spell damage and health by rank",
|
||||||
|
"Internet sharing accepts existing port forwards to the same server",
|
||||||
|
"The Auction House Bot card has a single switch",
|
||||||
|
"More character and server browser controls now use your selected language",
|
||||||
|
"Online player counts correctly separate random bots from players",
|
||||||
|
"Custom races work with shared addon folders on another drive",
|
||||||
|
"Configure the day and night cycle from the module settings",
|
||||||
|
"A stalled database inspection no longer blocks server maintenance indefinitely"
|
||||||
|
],
|
||||||
|
"commit": "4d59ce8cb1d4abd7f4992370e9a7ba4dc6bd02f7",
|
||||||
|
"compare": "https://github.com/Corfirean/coa-server-manager/compare/v0.7.1...v0.7.2"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"tag": "v0.7.3",
|
||||||
|
"version": "0.7.3",
|
||||||
|
"date": "2026-10-23",
|
||||||
|
"url": "https://github.com/Corfirean/coa-server-manager/releases/tag/v0.7.3",
|
||||||
|
"notes": [
|
||||||
|
"Portable characters open again after using an experimental Manager"
|
||||||
|
],
|
||||||
|
"commit": "2715170622665f62c396fe1a79f7ef6504713ef1",
|
||||||
|
"experimentalFeatures": [
|
||||||
|
"portable-characters"
|
||||||
|
],
|
||||||
|
"compare": "https://github.com/Corfirean/coa-server-manager/compare/v0.7.2...v0.7.3"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"tag": "v0.8.0",
|
||||||
|
"version": "0.8.0",
|
||||||
|
"date": "2026-10-24",
|
||||||
|
"url": "https://github.com/Corfirean/coa-server-manager/releases/tag/v0.8.0",
|
||||||
|
"notes": [
|
||||||
|
"Server owners can allow portable characters per realm",
|
||||||
|
"Allowing portable characters also prepares the server for portable sessions",
|
||||||
|
"Managers stay compatible with the public connection service",
|
||||||
|
"Relay connections recover and use the ports of the installed server",
|
||||||
|
"Portable progress resumes after reconnecting or restarting the Manager",
|
||||||
|
"Older copies on another host may require maintenance before returning"
|
||||||
|
],
|
||||||
|
"commit": "b00e732c7f53f33680aaf6bd520da64b70b26a5a",
|
||||||
|
"compare": "https://github.com/Corfirean/coa-server-manager/compare/v0.7.3...v0.8.0",
|
||||||
|
"experimentalFeatures": [
|
||||||
|
"portable-characters"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"tag": "v0.8.1",
|
||||||
|
"version": "0.8.1",
|
||||||
|
"date": "2026-10-25",
|
||||||
|
"url": "https://github.com/Corfirean/coa-server-manager/releases/tag/v0.8.1",
|
||||||
|
"notes": [
|
||||||
|
"Install the matching CoA Custom 1.9.1 client files"
|
||||||
|
],
|
||||||
|
"commit": "02e3a9e4e66870a627feeb0b4d3ec2d75a23973d",
|
||||||
|
"compare": "https://github.com/Corfirean/coa-server-manager/compare/v0.8.0...v0.8.1",
|
||||||
|
"experimentalFeatures": [
|
||||||
|
"portable-characters"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"tag": "v0.8.2",
|
||||||
|
"version": "0.8.2",
|
||||||
|
"date": "2026-10-27",
|
||||||
|
"url": "https://github.com/Corfirean/coa-server-manager/releases/tag/v0.8.2",
|
||||||
|
"notes": [
|
||||||
|
"Installs the verified CoA Custom 1.9.2 client patches and quest safety addon, while recognizing existing 1.9.1 installations",
|
||||||
|
"Server updates preserve the order of database migrations introduced during merges, preventing older snapshots from overwriting newer progression"
|
||||||
|
],
|
||||||
|
"commit": "81b040ef02763c7cf7a3a3da1424b73177e9d433",
|
||||||
|
"compare": "https://github.com/Corfirean/coa-server-manager/compare/v0.8.1...v0.8.2",
|
||||||
|
"experimentalFeatures": [
|
||||||
|
"portable-characters"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"tag": "v0.9.0",
|
||||||
|
"version": "0.9.0",
|
||||||
|
"date": "2026-10-28",
|
||||||
|
"url": "https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.0",
|
||||||
|
"notes": [
|
||||||
|
"Choose Parallel or Global level scaling in module settings",
|
||||||
|
"Report Content Scaling problems directly to its repository",
|
||||||
|
"Send custom race problem reports directly to their maintainer",
|
||||||
|
"Internet sharing restores the LAN address after server restarts",
|
||||||
|
"Configure custom race availability for new characters",
|
||||||
|
"Public listing offers every realm that starts together, not just the main one",
|
||||||
|
"Public listing is a short list of realms with a window for the details",
|
||||||
|
"Configure profession and defense skill gains in server settings",
|
||||||
|
"Starting a server sets the character classes of the realm chosen on Overview",
|
||||||
|
"Start Wildcard and Warcraft Reborn together with Conquest of Azeroth",
|
||||||
|
"Control portable characters and keep Manager running in the system tray"
|
||||||
|
],
|
||||||
|
"commit": "dc97095bd6b36d9b5111f04f0cfd88e1fb2ab1f1",
|
||||||
|
"compare": "https://github.com/Corfirean/coa-server-manager/compare/v0.8.2...v0.9.0",
|
||||||
|
"experimentalFeatures": [
|
||||||
|
"portable-characters"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"version": "0.9.1",
|
||||||
|
"tag": "v0.9.1",
|
||||||
|
"date": "2026-10-28",
|
||||||
|
"notes": [
|
||||||
|
"Existing unsupported character records no longer block unrelated server updates"
|
||||||
|
],
|
||||||
|
"experimentalFeatures": [
|
||||||
|
"portable-characters"
|
||||||
|
],
|
||||||
|
"url": "https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.1",
|
||||||
|
"compare": "https://github.com/Corfirean/coa-server-manager/compare/v0.9.0...v0.9.1",
|
||||||
|
"commit": "8bbf16ed4f14e9b78c680783e4be5d8c580cc06b"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"tag": "v0.9.2",
|
||||||
|
"version": "0.9.2",
|
||||||
|
"date": "2026-10-28",
|
||||||
|
"url": "https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.2",
|
||||||
|
"notes": [
|
||||||
|
"New server installation waits for slower database startup",
|
||||||
|
"Find and edit CoA options in the existing server settings",
|
||||||
|
"Simultaneous update checks share results or wait their turn",
|
||||||
|
"Recovery can stop an unfinished world startup after restoring an older launcher"
|
||||||
|
],
|
||||||
|
"commit": "2d9c6a65bbb1e296dc919e4c9e5785ed9d4a070b",
|
||||||
|
"compare": "https://github.com/Corfirean/coa-server-manager/compare/v0.9.1...v0.9.2",
|
||||||
|
"experimentalFeatures": [
|
||||||
|
"portable-characters"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"tag": "v0.9.3",
|
||||||
|
"version": "0.9.3",
|
||||||
|
"date": "2026-10-29",
|
||||||
|
"url": "https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.3",
|
||||||
|
"notes": [
|
||||||
|
"Slow server startup no longer triggers an early update rollback"
|
||||||
|
],
|
||||||
|
"commit": "e7b76137d1b22a7596c2b1fa05ca9d12403b99d3",
|
||||||
|
"compare": "https://github.com/Corfirean/coa-server-manager/compare/v0.9.2...v0.9.3",
|
||||||
|
"experimentalFeatures": [
|
||||||
|
"portable-characters"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"tag": "v0.9.4",
|
||||||
|
"version": "0.9.4",
|
||||||
|
"date": "2026-10-29",
|
||||||
|
"url": "https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.4",
|
||||||
|
"notes": [
|
||||||
|
"Settings group updates, startup and maintenance with translated release history",
|
||||||
|
"Update and launch without updating share a divided button",
|
||||||
|
"Maximizing the window keeps text and controls at a comfortable size"
|
||||||
|
],
|
||||||
|
"commit": "c004b90c54fa358b3037c56b093cf019dfcf02b8",
|
||||||
|
"compare": "https://github.com/Corfirean/coa-server-manager/compare/v0.9.3...v0.9.4",
|
||||||
|
"experimentalFeatures": [
|
||||||
|
"portable-characters"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"tag": "v0.9.5",
|
||||||
|
"version": "0.9.5",
|
||||||
|
"date": "2026-10-30",
|
||||||
|
"url": "https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.5",
|
||||||
|
"notes": [
|
||||||
|
"Account creation verifies a lost console reply against the requested login",
|
||||||
|
"Abandoned game relay tunnels close their local connection immediately",
|
||||||
|
"Keep disabled graphics components disabled during client updates",
|
||||||
|
"Force-stop an unresponsive world after a failed normal shutdown",
|
||||||
|
"Crash history includes reports from every world and Windows text files",
|
||||||
|
"Show the online bot count for Playerbots on the overview",
|
||||||
|
"Disable public server browsing in Settings",
|
||||||
|
"Keep deliberate stops and update shutdowns from triggering crash restart",
|
||||||
|
"Server startup waits for a responsive console before reporting success",
|
||||||
|
"Restore the existing Manager window when launching it again"
|
||||||
|
],
|
||||||
|
"commit": "642da8fdc1a0165aea74fbd1ab1b46933fc7e589",
|
||||||
|
"compare": "https://github.com/Corfirean/coa-server-manager/compare/v0.9.4...v0.9.5"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"tag": "v0.9.7",
|
||||||
|
"version": "0.9.7",
|
||||||
|
"date": "2026-10-30",
|
||||||
|
"url": "https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.7",
|
||||||
|
"notes": [
|
||||||
|
"Show available update notes even when release history is cached"
|
||||||
|
],
|
||||||
|
"commit": "ba5816e3aea471d5b870e5f0db0b03920c071ed3",
|
||||||
|
"compare": "https://github.com/Corfirean/coa-server-manager/compare/v0.9.5...v0.9.7"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"tag": "v0.9.8",
|
||||||
|
"version": "0.9.8",
|
||||||
|
"date": "2026-11-01",
|
||||||
|
"url": "https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.8",
|
||||||
|
"notes": [
|
||||||
|
"Dungeon Clear can be enabled when SQUID bots are active",
|
||||||
|
"Diagnostic exports include launcher stages and lock owner records",
|
||||||
|
"Choose normal logs, errors only or no server logs in maintenance settings",
|
||||||
|
"Update checks temporarily suspend bot population and restore your configuration",
|
||||||
|
"Update validation keeps MySQL running between compatible checks"
|
||||||
|
],
|
||||||
|
"commit": "076fba185c4d96d74f7258d6ca0cae6a4ae4a613",
|
||||||
|
"compare": "https://github.com/Corfirean/coa-server-manager/compare/v0.9.7...v0.9.8"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"tag": "v0.9.9",
|
||||||
|
"version": "0.9.9",
|
||||||
|
"date": "2026-11-04",
|
||||||
|
"url": "https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.9",
|
||||||
|
"notes": [
|
||||||
|
"Update and recovery checks use the temporary login port even with a Windows override"
|
||||||
|
],
|
||||||
|
"commit": "173248efbe24da9b4c1b5ca12fa7580fcd1e8ea7",
|
||||||
|
"compare": "https://github.com/Corfirean/coa-server-manager/compare/v0.9.8...v0.9.9"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"tag": "v0.9.10",
|
||||||
|
"version": "0.9.10",
|
||||||
|
"date": "2026-11-08",
|
||||||
|
"url": "https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.10",
|
||||||
|
"notes": [
|
||||||
|
"Custom Races patch installation recovers from interrupted downloads"
|
||||||
|
],
|
||||||
|
"commit": "711f378ae82f75d3fc64368c042889c773315c54",
|
||||||
|
"compare": "https://github.com/Corfirean/coa-server-manager/compare/v0.9.9...v0.9.10"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"tag": "v0.9.12",
|
||||||
|
"version": "0.9.12",
|
||||||
|
"date": "2026-11-14",
|
||||||
|
"url": "https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.12",
|
||||||
|
"notes": [
|
||||||
|
"Settings for how much help bots get in dungeons and raids"
|
||||||
|
],
|
||||||
|
"commit": "d71c5635e3262a775b400a1c90ac81d7bddcbeaf",
|
||||||
|
"compare": "https://github.com/Corfirean/coa-server-manager/compare/v0.9.10...v0.9.12"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"tag": "v0.9.13",
|
||||||
|
"version": "0.9.13",
|
||||||
|
"date": "2026-11-15",
|
||||||
|
"url": "https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.13",
|
||||||
|
"notes": [
|
||||||
|
"The custom races client is updated to Custom Races V2"
|
||||||
|
],
|
||||||
|
"commit": "d3527312803fb5a3e1cd48e01496645a8bbc9dcf",
|
||||||
|
"compare": "https://github.com/Corfirean/coa-server-manager/compare/v0.9.12...v0.9.13"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"tag": "v0.9.14",
|
||||||
|
"version": "0.9.14",
|
||||||
|
"date": "2026-11-16",
|
||||||
|
"url": "https://github.com/Corfirean/coa-server-manager/releases/tag/v0.9.14",
|
||||||
|
"notes": [
|
||||||
|
"Install community addons from the Manager",
|
||||||
|
"Old item and creature data is cleared before every Play",
|
||||||
|
"Turning the custom races client patch on or off takes seconds again",
|
||||||
|
"The database moves to a free port when Windows reserves or another program takes 3307",
|
||||||
|
"Your own MySQL settings survive restarts and updates",
|
||||||
|
"Disabled custom races stay disabled after a server update that adds races",
|
||||||
|
"Rename your realms in the Manager",
|
||||||
|
"The account for a friend's server is in the login box at every Play",
|
||||||
|
"Restart the world every day at a chosen time",
|
||||||
|
"Switches for the Custom Races V2 subclasses, Hero Races and the /dev menu",
|
||||||
|
"Companion bots on Wildcard and Warcraft Reborn",
|
||||||
|
"The Custom Races card tells which characters stay out while races are off"
|
||||||
|
],
|
||||||
|
"commit": "1f64da3ae064b3f02d2bb11d818c44d26a557045",
|
||||||
|
"compare": "https://github.com/Corfirean/coa-server-manager/compare/v0.9.13...v0.9.14"
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
@@ -15,6 +15,15 @@ pub const MAX_USERNAME: usize = 16;
|
|||||||
pub const MIN_PASSWORD: usize = 8;
|
pub const MIN_PASSWORD: usize = 8;
|
||||||
pub const MAX_PASSWORD: usize = 16;
|
pub const MAX_PASSWORD: usize = 16;
|
||||||
pub const MAX_CHARACTERS: usize = 200;
|
pub const MAX_CHARACTERS: usize = 200;
|
||||||
|
pub const MAX_SESSION_BYTES: usize = 12 * 1024 * 1024;
|
||||||
|
|
||||||
|
#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)]
|
||||||
|
#[serde(rename_all = "snake_case")]
|
||||||
|
pub enum SessionMessageKind {
|
||||||
|
Started,
|
||||||
|
Checkpoint,
|
||||||
|
Collection,
|
||||||
|
}
|
||||||
|
|
||||||
/// A game account name: 3 to 16 ASCII letters, digits or `_`, not beginning or ending with `_`.
|
/// A game account name: 3 to 16 ASCII letters, digits or `_`, not beginning or ending with `_`.
|
||||||
pub fn valid_username(s: &str) -> bool {
|
pub fn valid_username(s: &str) -> bool {
|
||||||
@@ -103,6 +112,16 @@ pub enum Request {
|
|||||||
TransferOffer {
|
TransferOffer {
|
||||||
transfer_id: Uuid,
|
transfer_id: Uuid,
|
||||||
character_id: Uuid,
|
character_id: Uuid,
|
||||||
|
ruleset: String,
|
||||||
|
canonical_revision: u64,
|
||||||
|
content_hash: String,
|
||||||
|
total_size: usize,
|
||||||
|
collections: BTreeMap<String, Vec<u32>>,
|
||||||
|
},
|
||||||
|
OwnedTransferOffer {
|
||||||
|
transfer_id: Uuid,
|
||||||
|
character_id: Uuid,
|
||||||
|
ruleset: String,
|
||||||
canonical_revision: u64,
|
canonical_revision: u64,
|
||||||
content_hash: String,
|
content_hash: String,
|
||||||
total_size: usize,
|
total_size: usize,
|
||||||
@@ -127,6 +146,24 @@ pub enum Request {
|
|||||||
transfer_id: Uuid,
|
transfer_id: Uuid,
|
||||||
character_id: Uuid,
|
character_id: Uuid,
|
||||||
},
|
},
|
||||||
|
SessionPoll {
|
||||||
|
character_id: Uuid,
|
||||||
|
session_id: Uuid,
|
||||||
|
},
|
||||||
|
SessionRead {
|
||||||
|
character_id: Uuid,
|
||||||
|
session_id: Uuid,
|
||||||
|
message_hash: String,
|
||||||
|
offset: usize,
|
||||||
|
},
|
||||||
|
SessionAck {
|
||||||
|
character_id: Uuid,
|
||||||
|
session_id: Uuid,
|
||||||
|
message_hash: String,
|
||||||
|
offset: usize,
|
||||||
|
total_size: usize,
|
||||||
|
data: String,
|
||||||
|
},
|
||||||
/// Phase 13: Request a short-lived relay allocation for a relayed JOIN.
|
/// Phase 13: Request a short-lived relay allocation for a relayed JOIN.
|
||||||
AllocateRelay {
|
AllocateRelay {
|
||||||
player_id: Uuid,
|
player_id: Uuid,
|
||||||
@@ -171,6 +208,22 @@ pub struct CharacterEntry {
|
|||||||
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
|
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
|
||||||
#[serde(tag = "op", rename_all = "snake_case")]
|
#[serde(tag = "op", rename_all = "snake_case")]
|
||||||
pub enum Response {
|
pub enum Response {
|
||||||
|
SessionPending {
|
||||||
|
kind: SessionMessageKind,
|
||||||
|
total_size: usize,
|
||||||
|
content_hash: String,
|
||||||
|
},
|
||||||
|
SessionIdle {
|
||||||
|
closed: bool,
|
||||||
|
},
|
||||||
|
SessionData {
|
||||||
|
offset: usize,
|
||||||
|
data: String,
|
||||||
|
},
|
||||||
|
SessionAcked {
|
||||||
|
received_size: usize,
|
||||||
|
complete: bool,
|
||||||
|
},
|
||||||
Welcome {
|
Welcome {
|
||||||
realm_id: coa_registry_proto::RealmId,
|
realm_id: coa_registry_proto::RealmId,
|
||||||
automatic: bool,
|
automatic: bool,
|
||||||
@@ -189,6 +242,7 @@ pub enum Response {
|
|||||||
/// appearance and vanity ids the Host holds for the account (kind -> ids).
|
/// appearance and vanity ids the Host holds for the account (kind -> ids).
|
||||||
Claimed {
|
Claimed {
|
||||||
character_id: Uuid,
|
character_id: Uuid,
|
||||||
|
ruleset: String,
|
||||||
sha256: String,
|
sha256: String,
|
||||||
payload: String,
|
payload: String,
|
||||||
collections: BTreeMap<String, Vec<u32>>,
|
collections: BTreeMap<String, Vec<u32>>,
|
||||||
@@ -245,7 +299,10 @@ pub fn decode_request(bytes: &[u8]) -> Result<Request> {
|
|||||||
.map_err(|_| ControlError::Invalid("a request is not valid".into()))?;
|
.map_err(|_| ControlError::Invalid("a request is not valid".into()))?;
|
||||||
if !matches!(
|
if !matches!(
|
||||||
&r,
|
&r,
|
||||||
Request::TransferOffer { .. } | Request::TransferChunk { .. }
|
Request::TransferOffer { .. }
|
||||||
|
| Request::OwnedTransferOffer { .. }
|
||||||
|
| Request::TransferChunk { .. }
|
||||||
|
| Request::SessionAck { .. }
|
||||||
) && bytes.len() > MAX_CONTROL_REQUEST_BYTES
|
) && bytes.len() > MAX_CONTROL_REQUEST_BYTES
|
||||||
{
|
{
|
||||||
return Err(ControlError::Limit(
|
return Err(ControlError::Limit(
|
||||||
@@ -253,6 +310,34 @@ pub fn decode_request(bytes: &[u8]) -> Result<Request> {
|
|||||||
));
|
));
|
||||||
}
|
}
|
||||||
match &r {
|
match &r {
|
||||||
|
Request::SessionRead {
|
||||||
|
message_hash,
|
||||||
|
offset,
|
||||||
|
..
|
||||||
|
} => {
|
||||||
|
if message_hash.len() != 64
|
||||||
|
|| !message_hash.bytes().all(|b| b.is_ascii_hexdigit())
|
||||||
|
|| *offset > MAX_SESSION_BYTES
|
||||||
|
{
|
||||||
|
return invalid("invalid portable session read");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
Request::SessionAck {
|
||||||
|
message_hash,
|
||||||
|
offset,
|
||||||
|
total_size,
|
||||||
|
data,
|
||||||
|
..
|
||||||
|
} => {
|
||||||
|
if message_hash.len() != 64
|
||||||
|
|| !message_hash.bytes().all(|b| b.is_ascii_hexdigit())
|
||||||
|
|| *total_size > MAX_SESSION_BYTES
|
||||||
|
|| *offset > *total_size
|
||||||
|
|| data.len() > 48 * 1024
|
||||||
|
{
|
||||||
|
return invalid("invalid portable session acknowledgement chunk");
|
||||||
|
}
|
||||||
|
}
|
||||||
Request::Provision {
|
Request::Provision {
|
||||||
desired, password, ..
|
desired, password, ..
|
||||||
} => {
|
} => {
|
||||||
@@ -273,11 +358,22 @@ pub fn decode_request(bytes: &[u8]) -> Result<Request> {
|
|||||||
return invalid("the client name is too long")
|
return invalid("the client name is too long")
|
||||||
}
|
}
|
||||||
Request::TransferOffer {
|
Request::TransferOffer {
|
||||||
|
ruleset,
|
||||||
|
content_hash,
|
||||||
|
total_size,
|
||||||
|
collections,
|
||||||
|
..
|
||||||
|
}
|
||||||
|
| Request::OwnedTransferOffer {
|
||||||
|
ruleset,
|
||||||
content_hash,
|
content_hash,
|
||||||
total_size,
|
total_size,
|
||||||
collections,
|
collections,
|
||||||
..
|
..
|
||||||
} => {
|
} => {
|
||||||
|
if !matches!(ruleset.as_str(), "coa" | "wildcard" | "reborn") {
|
||||||
|
return invalid("transfer ruleset must be coa, wildcard, or reborn");
|
||||||
|
}
|
||||||
if content_hash.len() != 64 || !content_hash.chars().all(|c| c.is_ascii_hexdigit()) {
|
if content_hash.len() != 64 || !content_hash.chars().all(|c| c.is_ascii_hexdigit()) {
|
||||||
return invalid("transfer content hash must be 64 hex characters");
|
return invalid("transfer content hash must be 64 hex characters");
|
||||||
}
|
}
|
||||||
@@ -430,6 +526,7 @@ mod tests {
|
|||||||
let offer = Request::TransferOffer {
|
let offer = Request::TransferOffer {
|
||||||
transfer_id: tid,
|
transfer_id: tid,
|
||||||
character_id: cid,
|
character_id: cid,
|
||||||
|
ruleset: "coa".into(),
|
||||||
canonical_revision: 5,
|
canonical_revision: 5,
|
||||||
content_hash: hash.clone(),
|
content_hash: hash.clone(),
|
||||||
total_size: 1024,
|
total_size: 1024,
|
||||||
@@ -442,6 +539,7 @@ mod tests {
|
|||||||
let bad_hash = Request::TransferOffer {
|
let bad_hash = Request::TransferOffer {
|
||||||
transfer_id: tid,
|
transfer_id: tid,
|
||||||
character_id: cid,
|
character_id: cid,
|
||||||
|
ruleset: "coa".into(),
|
||||||
canonical_revision: 5,
|
canonical_revision: 5,
|
||||||
content_hash: "too_short".into(),
|
content_hash: "too_short".into(),
|
||||||
total_size: 1024,
|
total_size: 1024,
|
||||||
@@ -466,5 +564,21 @@ mod tests {
|
|||||||
};
|
};
|
||||||
let resp_dec = decode_response(&encode_response(&resp)).unwrap();
|
let resp_dec = decode_response(&encode_response(&resp)).unwrap();
|
||||||
assert_eq!(resp, resp_dec);
|
assert_eq!(resp, resp_dec);
|
||||||
|
|
||||||
|
// Control protocol v2 requires ruleset in TransferOffer; missing is rejected
|
||||||
|
let missing_ruleset_json = serde_json::json!({
|
||||||
|
"op": "transfer_offer",
|
||||||
|
"transfer_id": tid,
|
||||||
|
"character_id": cid,
|
||||||
|
"canonical_revision": 5,
|
||||||
|
"content_hash": hash,
|
||||||
|
"total_size": 1024,
|
||||||
|
"collections": {}
|
||||||
|
});
|
||||||
|
let encoded_missing = serde_json::to_vec(&missing_ruleset_json).unwrap();
|
||||||
|
assert!(
|
||||||
|
decode_request(&encoded_missing).is_err(),
|
||||||
|
"missing ruleset in v2 must be rejected"
|
||||||
|
);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -112,6 +112,10 @@ pub struct ProbeResponse {
|
|||||||
pub all_reachable: bool,
|
pub all_reachable: bool,
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// Coordinator authentication is independent of the encrypted application protocol.
|
||||||
|
/// Changing portable messages must not invalidate deployed v1 host/player proofs.
|
||||||
|
pub const COORDINATOR_PROTOCOL_VERSION: u32 = 1;
|
||||||
|
|
||||||
pub fn challenge_nonce() -> String {
|
pub fn challenge_nonce() -> String {
|
||||||
let mut n = [0u8; 32];
|
let mut n = [0u8; 32];
|
||||||
n[..16].copy_from_slice(Uuid::new_v4().as_bytes());
|
n[..16].copy_from_slice(Uuid::new_v4().as_bytes());
|
||||||
@@ -122,7 +126,7 @@ pub fn challenge_nonce() -> String {
|
|||||||
fn host_input(realm: &RealmId, nonce: &str, ts: i64) -> Vec<u8> {
|
fn host_input(realm: &RealmId, nonce: &str, ts: i64) -> Vec<u8> {
|
||||||
format!(
|
format!(
|
||||||
"coa-coord-host-v1\n{}\n{realm}\n{nonce}\n{ts}",
|
"coa-coord-host-v1\n{}\n{realm}\n{nonce}\n{ts}",
|
||||||
crate::CONTROL_PROTOCOL_VERSION
|
COORDINATOR_PROTOCOL_VERSION
|
||||||
)
|
)
|
||||||
.into_bytes()
|
.into_bytes()
|
||||||
}
|
}
|
||||||
@@ -130,7 +134,7 @@ fn host_input(realm: &RealmId, nonce: &str, ts: i64) -> Vec<u8> {
|
|||||||
fn player_input(player: &Uuid, public_key: &str, realm: &RealmId, nonce: &str, ts: i64) -> Vec<u8> {
|
fn player_input(player: &Uuid, public_key: &str, realm: &RealmId, nonce: &str, ts: i64) -> Vec<u8> {
|
||||||
format!(
|
format!(
|
||||||
"coa-coord-player-v1\n{}\n{}\n{public_key}\n{realm}\n{nonce}\n{ts}",
|
"coa-coord-player-v1\n{}\n{}\n{public_key}\n{realm}\n{nonce}\n{ts}",
|
||||||
crate::CONTROL_PROTOCOL_VERSION,
|
COORDINATOR_PROTOCOL_VERSION,
|
||||||
player.hyphenated()
|
player.hyphenated()
|
||||||
)
|
)
|
||||||
.into_bytes()
|
.into_bytes()
|
||||||
@@ -277,6 +281,14 @@ pub fn to_text(frame: &Frame) -> String {
|
|||||||
mod tests {
|
mod tests {
|
||||||
use super::*;
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn deployed_coordinator_proofs_stay_v1_when_application_protocol_changes() {
|
||||||
|
let realm = RealmId::new();
|
||||||
|
let player = Uuid::now_v7();
|
||||||
|
assert_eq!(host_input(&realm, "nonce", 42), format!("coa-coord-host-v1\n1\n{realm}\nnonce\n42").into_bytes());
|
||||||
|
assert_eq!(player_input(&player, "public", &realm, "nonce", 42), format!("coa-coord-player-v1\n1\n{player}\npublic\n{realm}\nnonce\n42").into_bytes());
|
||||||
|
}
|
||||||
|
|
||||||
fn key(n: u8) -> SigningKey {
|
fn key(n: u8) -> SigningKey {
|
||||||
SigningKey::from_bytes(&[n; 32])
|
SigningKey::from_bytes(&[n; 32])
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -16,7 +16,7 @@ pub mod coord;
|
|||||||
pub mod noise;
|
pub mod noise;
|
||||||
pub mod relay;
|
pub mod relay;
|
||||||
|
|
||||||
pub const CONTROL_PROTOCOL_VERSION: u32 = 1;
|
pub const CONTROL_PROTOCOL_VERSION: u32 = 2;
|
||||||
|
|
||||||
#[derive(Debug, thiserror::Error, PartialEq, Eq)]
|
#[derive(Debug, thiserror::Error, PartialEq, Eq)]
|
||||||
pub enum ControlError {
|
pub enum ControlError {
|
||||||
|
|||||||
@@ -90,6 +90,7 @@ fn test_app_request_hostile_limits_and_validation() {
|
|||||||
let offer = Request::TransferOffer {
|
let offer = Request::TransferOffer {
|
||||||
transfer_id: Uuid::now_v7(),
|
transfer_id: Uuid::now_v7(),
|
||||||
character_id: Uuid::now_v7(),
|
character_id: Uuid::now_v7(),
|
||||||
|
ruleset: "coa".into(),
|
||||||
canonical_revision: 1,
|
canonical_revision: 1,
|
||||||
content_hash: "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef".into(),
|
content_hash: "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef".into(),
|
||||||
total_size: 1024,
|
total_size: 1024,
|
||||||
@@ -105,6 +106,7 @@ fn test_app_request_hostile_limits_and_validation() {
|
|||||||
let bad_hash_offer = Request::TransferOffer {
|
let bad_hash_offer = Request::TransferOffer {
|
||||||
transfer_id: Uuid::now_v7(),
|
transfer_id: Uuid::now_v7(),
|
||||||
character_id: Uuid::now_v7(),
|
character_id: Uuid::now_v7(),
|
||||||
|
ruleset: "coa".into(),
|
||||||
canonical_revision: 1,
|
canonical_revision: 1,
|
||||||
content_hash: "not_a_valid_hex_hash".into(),
|
content_hash: "not_a_valid_hex_hash".into(),
|
||||||
total_size: 1024,
|
total_size: 1024,
|
||||||
@@ -112,6 +114,18 @@ fn test_app_request_hostile_limits_and_validation() {
|
|||||||
};
|
};
|
||||||
assert!(decode_request(&encode_request(&bad_hash_offer)).is_err());
|
assert!(decode_request(&encode_request(&bad_hash_offer)).is_err());
|
||||||
|
|
||||||
|
// 4b. Invalid ruleset rejected
|
||||||
|
let bad_ruleset_offer = Request::TransferOffer {
|
||||||
|
transfer_id: Uuid::now_v7(),
|
||||||
|
character_id: Uuid::now_v7(),
|
||||||
|
ruleset: "invalid_ruleset".into(),
|
||||||
|
canonical_revision: 1,
|
||||||
|
content_hash: "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef".into(),
|
||||||
|
total_size: 1024,
|
||||||
|
collections: BTreeMap::new(),
|
||||||
|
};
|
||||||
|
assert!(decode_request(&encode_request(&bad_ruleset_offer)).is_err());
|
||||||
|
|
||||||
// 5. TransferChunk offset out of bounds
|
// 5. TransferChunk offset out of bounds
|
||||||
let bad_offset_chunk = Request::TransferChunk {
|
let bad_offset_chunk = Request::TransferChunk {
|
||||||
transfer_id: Uuid::now_v7(),
|
transfer_id: Uuid::now_v7(),
|
||||||
|
|||||||
@@ -5,6 +5,7 @@ edition.workspace = true
|
|||||||
license.workspace = true
|
license.workspace = true
|
||||||
|
|
||||||
[dependencies]
|
[dependencies]
|
||||||
|
socket2 = "0.6"
|
||||||
serde = { version = "1", features = ["derive"] }
|
serde = { version = "1", features = ["derive"] }
|
||||||
serde_json = "1"
|
serde_json = "1"
|
||||||
sha2 = "0.10"
|
sha2 = "0.10"
|
||||||
@@ -37,7 +38,7 @@ rand_core = { version = "0.6", features = ["getrandom"] }
|
|||||||
ed25519-dalek = { version = "2", features = ["rand_core"] }
|
ed25519-dalek = { version = "2", features = ["rand_core"] }
|
||||||
|
|
||||||
[target.'cfg(windows)'.dependencies]
|
[target.'cfg(windows)'.dependencies]
|
||||||
windows-sys = { version = "0.60", features = ["Win32_Foundation", "Win32_Storage_FileSystem", "Win32_System_Threading", "Win32_System_SystemInformation", "Win32_System_Diagnostics_ToolHelp", "Win32_NetworkManagement_IpHelper", "Win32_Networking_WinSock", "Win32_Security_Cryptography", "Win32_UI_Shell", "Win32_System_Registry", "Win32_UI_WindowsAndMessaging"] }
|
windows-sys = { version = "0.60", features = ["Win32_Foundation", "Win32_Storage_FileSystem", "Win32_System_Threading", "Win32_System_Console", "Win32_System_SystemInformation", "Win32_System_Diagnostics_ToolHelp", "Win32_NetworkManagement_IpHelper", "Win32_Networking_WinSock", "Win32_Security_Cryptography", "Win32_UI_Shell", "Win32_System_Registry", "Win32_UI_WindowsAndMessaging"] }
|
||||||
|
|
||||||
[features]
|
[features]
|
||||||
testkit = []
|
testkit = []
|
||||||
@@ -0,0 +1,154 @@
|
|||||||
|
use coa_core::{
|
||||||
|
db::{Account, Db},
|
||||||
|
driver::{self, Verb},
|
||||||
|
ra::Ra,
|
||||||
|
Result,
|
||||||
|
};
|
||||||
|
use std::path::PathBuf;
|
||||||
|
fn main() -> Result<()> {
|
||||||
|
let root = PathBuf::from(std::env::args().nth(1).expect("disposable fixture"));
|
||||||
|
assert!(root
|
||||||
|
.file_name()
|
||||||
|
.unwrap()
|
||||||
|
.to_string_lossy()
|
||||||
|
.starts_with("coa-update-recovery-fixture-"));
|
||||||
|
assert!(root.join("recovery-e2e-started").is_file());
|
||||||
|
let result = std::panic::catch_unwind(|| -> Result<()> {
|
||||||
|
let started = driver::run(&root, Verb::StartAll)?;
|
||||||
|
assert!(started.ok, "{}", started.output);
|
||||||
|
assert!(root.join("Core/Crashes").is_dir());
|
||||||
|
let db = Db::from_repack(&root, Account::Admin)?;
|
||||||
|
println!("Account acceptance: server started, connecting to RA");
|
||||||
|
let mut ra = Ra::connect(&root)?;
|
||||||
|
println!("Account acceptance: RA authenticated");
|
||||||
|
let name = "STABILITYACCT2";
|
||||||
|
assert_eq!(
|
||||||
|
db.query("SELECT COUNT(*) FROM acore_auth.account WHERE username='STABILITYACCT2';")?
|
||||||
|
.trim(),
|
||||||
|
"0"
|
||||||
|
);
|
||||||
|
println!("Account acceptance: sending create command");
|
||||||
|
coa_core::accounts::create(&root, name, "PrivateTest773", true)?;
|
||||||
|
println!("Account acceptance: created");
|
||||||
|
assert_eq!(db.query("SELECT COUNT(*) FROM acore_auth.account WHERE username='STABILITYACCT2' AND LENGTH(salt)=32 AND LENGTH(verifier)=32;")?.trim(), "1");
|
||||||
|
assert!(ra
|
||||||
|
.create_account(name, "PrivateTest773")
|
||||||
|
.unwrap_err()
|
||||||
|
.to_string()
|
||||||
|
.contains("already taken"));
|
||||||
|
ra.set_account_password(name, "PrivateTest774")?;
|
||||||
|
ra.set_account_access(name, 3)?;
|
||||||
|
assert_eq!(db.query("SELECT gmlevel FROM acore_auth.account_access WHERE id=(SELECT id FROM acore_auth.account WHERE username='STABILITYACCT2');")?.trim(), "3");
|
||||||
|
ra.delete_account(name)?;
|
||||||
|
assert_eq!(
|
||||||
|
db.query("SELECT COUNT(*) FROM acore_auth.account WHERE username='STABILITYACCT2';")?
|
||||||
|
.trim(),
|
||||||
|
"0"
|
||||||
|
);
|
||||||
|
lost_reply(&root, &db)?;
|
||||||
|
println!("PASS: native RA account create, SRP salt/verifier, duplicate refusal, password change, administrator access and deletion");
|
||||||
|
Ok(())
|
||||||
|
});
|
||||||
|
let stopped = driver::run(&root, Verb::StopAll)?;
|
||||||
|
assert!(stopped.ok, "{}", stopped.output);
|
||||||
|
result.map_err(|_| {
|
||||||
|
coa_core::Error::Invalid("Native account acceptance failed; fixture stopped".into())
|
||||||
|
})?
|
||||||
|
}
|
||||||
|
|
||||||
|
fn lost_reply(root: &std::path::Path, db: &Db) -> Result<()> {
|
||||||
|
use std::io::{Read, Write};
|
||||||
|
use std::net::{TcpListener, TcpStream};
|
||||||
|
let path = root.join("Settings/repack.json");
|
||||||
|
let original = std::fs::read(&path)?;
|
||||||
|
struct Restore(std::path::PathBuf, Vec<u8>);
|
||||||
|
impl Drop for Restore {
|
||||||
|
fn drop(&mut self) {
|
||||||
|
std::fs::write(&self.0, &self.1).expect("restore disposable fixture settings");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
let restore = Restore(path.clone(), original.clone());
|
||||||
|
let actual = coa_core::layout::read_ports(root).ra;
|
||||||
|
for (name, forward, ready) in [
|
||||||
|
("STABLOSTREPLY", true, true),
|
||||||
|
("STABNOTCREATED", false, true),
|
||||||
|
("STABNOTREADY", false, false),
|
||||||
|
] {
|
||||||
|
assert_eq!(
|
||||||
|
db.query(&format!(
|
||||||
|
"SELECT COUNT(*) FROM acore_auth.account WHERE username='{name}';"
|
||||||
|
))?
|
||||||
|
.trim(),
|
||||||
|
"0"
|
||||||
|
);
|
||||||
|
let listener = TcpListener::bind(("127.0.0.1", 0))?;
|
||||||
|
let mut config: serde_json::Value = serde_json::from_slice(&original)?;
|
||||||
|
config["raPort"] = listener.local_addr()?.port().into();
|
||||||
|
coa_core::fsx::atomic_write_json(&path, &config)?;
|
||||||
|
let proxy = std::thread::spawn(move || {
|
||||||
|
fn until(s: &mut TcpStream, marker: &[u8]) -> Vec<u8> {
|
||||||
|
s.set_read_timeout(Some(std::time::Duration::from_secs(30)))
|
||||||
|
.unwrap();
|
||||||
|
let mut bytes = Vec::new();
|
||||||
|
let mut byte = [0];
|
||||||
|
while !bytes.ends_with(marker) {
|
||||||
|
s.read_exact(&mut byte).unwrap();
|
||||||
|
bytes.push(byte[0]);
|
||||||
|
}
|
||||||
|
bytes
|
||||||
|
}
|
||||||
|
let (mut client, _) = listener.accept().unwrap();
|
||||||
|
let mut server = TcpStream::connect(("127.0.0.1", actual)).unwrap();
|
||||||
|
for marker in [b"Username: ".as_slice(), b"Password: ".as_slice()] {
|
||||||
|
client.write_all(&until(&mut server, marker)).unwrap();
|
||||||
|
server.write_all(&until(&mut client, b"\r\n")).unwrap();
|
||||||
|
}
|
||||||
|
client.write_all(&until(&mut server, b"AC>")).unwrap();
|
||||||
|
let readiness = until(&mut client, b"\r\n");
|
||||||
|
assert_eq!(readiness, b"server info\r\n");
|
||||||
|
if !ready {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
server.write_all(&readiness).unwrap();
|
||||||
|
client.write_all(&until(&mut server, b"AC>")).unwrap();
|
||||||
|
let command = until(&mut client, b"\r\n");
|
||||||
|
if forward {
|
||||||
|
server.write_all(&command).unwrap();
|
||||||
|
let _ = until(&mut server, b"AC>");
|
||||||
|
}
|
||||||
|
});
|
||||||
|
let outcome = coa_core::accounts::create(root, name, "PrivateTest773", false);
|
||||||
|
proxy.join().unwrap();
|
||||||
|
std::fs::write(&path, &original)?;
|
||||||
|
if forward {
|
||||||
|
outcome?;
|
||||||
|
assert_eq!(
|
||||||
|
db.query(&format!(
|
||||||
|
"SELECT COUNT(*) FROM acore_auth.account WHERE username='{name}';"
|
||||||
|
))?
|
||||||
|
.trim(),
|
||||||
|
"1"
|
||||||
|
);
|
||||||
|
assert!(coa_core::accounts::create(root, name, "DifferentPass77", false).is_err());
|
||||||
|
Ra::connect(root)?.delete_account(name)?;
|
||||||
|
} else {
|
||||||
|
assert!(outcome.is_err());
|
||||||
|
if !ready {
|
||||||
|
assert!(outcome
|
||||||
|
.unwrap_err()
|
||||||
|
.to_string()
|
||||||
|
.contains("No create command was sent"));
|
||||||
|
}
|
||||||
|
assert_eq!(
|
||||||
|
db.query(&format!(
|
||||||
|
"SELECT COUNT(*) FROM acore_auth.account WHERE username='{name}';"
|
||||||
|
))?
|
||||||
|
.trim(),
|
||||||
|
"0"
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
drop(restore);
|
||||||
|
println!("PASS: a lost native console reply is reconciled by exact SRP credentials; a command that was never executed is rejected");
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
@@ -0,0 +1,11 @@
|
|||||||
|
use coa_core::{crashes, Result};
|
||||||
|
fn main()->Result<()> {
|
||||||
|
let root=std::path::PathBuf::from(std::env::args().nth(1).expect("marked native fixture"));
|
||||||
|
assert!(root.join("recovery-e2e-started").is_file());
|
||||||
|
let reports=crashes::list(&root,30)?;
|
||||||
|
let matching:Vec<_>=reports.iter().filter(|r|r.full_log.contains("AllowableRaces")).collect();
|
||||||
|
assert!(!matching.is_empty());
|
||||||
|
assert!(matching.iter().all(|r|r.exception_code.as_deref()==Some("C0000420")));
|
||||||
|
println!("PASS: Manager discovered {} actual worldserver SQL assertion reports from Core/Crashes, including Windows ANSI text",matching.len());
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
@@ -0,0 +1,91 @@
|
|||||||
|
use coa_core::{
|
||||||
|
db::{Account, Db},
|
||||||
|
driver::{self, Verb},
|
||||||
|
ra::Ra,
|
||||||
|
Result,
|
||||||
|
};
|
||||||
|
use std::{
|
||||||
|
path::PathBuf,
|
||||||
|
time::{Duration, Instant},
|
||||||
|
};
|
||||||
|
fn main() -> Result<()> {
|
||||||
|
let root = PathBuf::from(
|
||||||
|
std::env::args()
|
||||||
|
.nth(1)
|
||||||
|
.expect("disposable recovery fixture"),
|
||||||
|
);
|
||||||
|
assert!(root
|
||||||
|
.file_name()
|
||||||
|
.unwrap()
|
||||||
|
.to_string_lossy()
|
||||||
|
.starts_with("coa-update-recovery-fixture-"));
|
||||||
|
assert!(root.join("recovery-e2e-started").is_file());
|
||||||
|
let result = std::panic::catch_unwind(|| -> Result<()> {
|
||||||
|
let start = driver::run(&root, Verb::StartAll)?;
|
||||||
|
assert!(start.ok, "{}", start.output);
|
||||||
|
let db = Db::from_repack(&root, Account::Admin)?;
|
||||||
|
coa_core::companions::ensure_templates(&db)?;
|
||||||
|
let mut ra = Ra::connect(&root)?;
|
||||||
|
let before = coa_core::population::query(&root)?;
|
||||||
|
assert_eq!(before.bots_online, 0);
|
||||||
|
let rejected = db.query("SELECT name, at_login FROM acore_characters.characters WHERE guid=3030 AND account IN (SELECT id FROM acore_auth.account WHERE username LIKE 'COABOTHOST%');")?;
|
||||||
|
assert!(rejected.contains("Christian Shadowheart"));
|
||||||
|
assert_eq!(rejected.split_whitespace().last(), Some("1"));
|
||||||
|
println!("Repair reply: {}", ra.run("botcmd spawnbot 3030")?);
|
||||||
|
let repair_deadline = Instant::now() + Duration::from_secs(60);
|
||||||
|
loop {
|
||||||
|
let row = db.query(
|
||||||
|
"SELECT name, at_login, online FROM acore_characters.characters WHERE guid=3030;",
|
||||||
|
)?;
|
||||||
|
if row.trim().ends_with("0\t1") {
|
||||||
|
assert!(!row.contains("Christian Shadowheart"));
|
||||||
|
println!("PASS: the exact previously rejected companion was renamed by server validation and logged in");
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
assert!(
|
||||||
|
Instant::now() < repair_deadline,
|
||||||
|
"previously rejected companion logged in"
|
||||||
|
);
|
||||||
|
std::thread::sleep(Duration::from_secs(1));
|
||||||
|
}
|
||||||
|
let _ = ra.despawn_all()?;
|
||||||
|
let clear_deadline = Instant::now() + Duration::from_secs(30);
|
||||||
|
while coa_core::population::query(&root)?.bots_online > 0 {
|
||||||
|
assert!(Instant::now() < clear_deadline);
|
||||||
|
std::thread::sleep(Duration::from_secs(1));
|
||||||
|
}
|
||||||
|
println!("Spawn reply: {}", ra.spawn_bots(21)?);
|
||||||
|
let deadline = Instant::now() + Duration::from_secs(180);
|
||||||
|
loop {
|
||||||
|
let pop = coa_core::population::query(&root)?;
|
||||||
|
if pop.bots_online >= 21 {
|
||||||
|
println!(
|
||||||
|
"PASS: {} companions logged in; real players={}",
|
||||||
|
pop.bots_online, pop.players_online
|
||||||
|
);
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
if Instant::now() > deadline {
|
||||||
|
return Err(coa_core::Error::Invalid(format!(
|
||||||
|
"Only {} of 21 companion logins completed",
|
||||||
|
pop.bots_online
|
||||||
|
)));
|
||||||
|
}
|
||||||
|
std::thread::sleep(Duration::from_secs(2));
|
||||||
|
}
|
||||||
|
let _ = ra.cancel_spawning()?;
|
||||||
|
let _ = ra.despawn_all()?;
|
||||||
|
let deadline = Instant::now() + Duration::from_secs(30);
|
||||||
|
while coa_core::population::query(&root)?.bots_online > 0 {
|
||||||
|
assert!(Instant::now() < deadline, "companions despawned");
|
||||||
|
std::thread::sleep(Duration::from_secs(1));
|
||||||
|
}
|
||||||
|
println!("PASS: companion despawn completed");
|
||||||
|
Ok(())
|
||||||
|
});
|
||||||
|
let stopped = driver::run(&root, Verb::StopAll)?;
|
||||||
|
assert!(stopped.ok, "{}", stopped.output);
|
||||||
|
result.map_err(|_| {
|
||||||
|
coa_core::Error::Invalid("Companion native acceptance panicked; fixture stopped".into())
|
||||||
|
})?
|
||||||
|
}
|
||||||
@@ -0,0 +1,12 @@
|
|||||||
|
use coa_core::{crashes, Result};
|
||||||
|
fn main() -> Result<()> {
|
||||||
|
let root = std::path::PathBuf::from(std::env::args().nth(1).expect("native crash evidence"));
|
||||||
|
assert!(root.join(".crash-report-evidence").is_file());
|
||||||
|
let reports = crashes::list(&root, 10)?;
|
||||||
|
assert_eq!(reports.len(), 1);
|
||||||
|
assert_eq!(reports[0].exception_code.as_deref(), Some("C0000005"));
|
||||||
|
assert_eq!(reports[0].category, "access_violation");
|
||||||
|
assert!(!reports[0].full_log.is_empty());
|
||||||
|
println!("PASS: Manager crash history discovers and classifies the actual native handler report from Core/Crashes");
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
@@ -0,0 +1,90 @@
|
|||||||
|
use coa_core::{driver, fsx, process, Result};
|
||||||
|
#[cfg(windows)]
|
||||||
|
use std::os::windows::process::CommandExt;
|
||||||
|
use std::{
|
||||||
|
path::Path,
|
||||||
|
process::{Child, Command, Stdio},
|
||||||
|
};
|
||||||
|
|
||||||
|
struct OwnedChild(Child);
|
||||||
|
impl Drop for OwnedChild {
|
||||||
|
fn drop(&mut self) {
|
||||||
|
let _ = self.0.kill();
|
||||||
|
let _ = self.0.wait();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
fn copy_tree(source: &Path, target: &Path) -> Result<()> {
|
||||||
|
std::fs::create_dir_all(target)?;
|
||||||
|
for entry in std::fs::read_dir(source)? {
|
||||||
|
let entry = entry?;
|
||||||
|
let destination = target.join(entry.file_name());
|
||||||
|
if entry.file_type()?.is_dir() {
|
||||||
|
copy_tree(&entry.path(), &destination)?;
|
||||||
|
} else {
|
||||||
|
std::fs::copy(entry.path(), destination)?;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
fn spawn(path: &Path) -> OwnedChild {
|
||||||
|
let mut cmd = Command::new(path);
|
||||||
|
cmd.args(["-t", "127.0.0.1"])
|
||||||
|
.stdin(Stdio::null())
|
||||||
|
.stdout(Stdio::null())
|
||||||
|
.stderr(Stdio::null());
|
||||||
|
#[cfg(windows)]
|
||||||
|
cmd.creation_flags(0x0800_0000);
|
||||||
|
OwnedChild(cmd.spawn().unwrap())
|
||||||
|
}
|
||||||
|
fn main() -> Result<()> {
|
||||||
|
assert!(cfg!(windows));
|
||||||
|
let source = std::path::PathBuf::from(
|
||||||
|
std::env::args()
|
||||||
|
.nth(1)
|
||||||
|
.expect("marked disposable runtime source"),
|
||||||
|
);
|
||||||
|
assert_eq!(
|
||||||
|
std::fs::read(source.join(".release-schema-fixture"))?,
|
||||||
|
b"disposable release-schema fixture"
|
||||||
|
);
|
||||||
|
let temp = tempfile::tempdir()?;
|
||||||
|
let root = temp.path();
|
||||||
|
copy_tree(&source.join("Runtime"), &root.join("Runtime"))?;
|
||||||
|
std::fs::create_dir_all(root.join("Core"))?;
|
||||||
|
std::fs::create_dir_all(root.join("Scripts"))?;
|
||||||
|
let system =
|
||||||
|
std::path::PathBuf::from(std::env::var_os("SystemRoot").unwrap()).join("System32/ping.exe");
|
||||||
|
std::fs::copy(&system, root.join("Core/worldserver.exe"))?;
|
||||||
|
std::fs::copy(&system, root.join("foreign.exe"))?;
|
||||||
|
let mut ports = Vec::new();
|
||||||
|
let mut listeners = Vec::new();
|
||||||
|
for _ in 0..4 {
|
||||||
|
let listener = std::net::TcpListener::bind("127.0.0.1:0")?;
|
||||||
|
ports.push(listener.local_addr()?.port());
|
||||||
|
listeners.push(listener);
|
||||||
|
}
|
||||||
|
let config = serde_json::json!({"mysqlPort":ports[0],"authPort":ports[1],"worldPort":ports[2],"raPort":ports[3],"raUsername":"fixture","raPassword":"fixture"});
|
||||||
|
fsx::atomic_write_json(&root.join("Settings/repack.json"), &config)?;
|
||||||
|
drop(listeners);
|
||||||
|
let mut launcher = std::fs::read_to_string(source.join("Scripts/manage.py"))?;
|
||||||
|
launcher.push_str("\nfrom contextlib import nullcontext\ndef control_lock(): return nullcontext()\ndef stop_all(config):\n assert not process('world'), 'world must stop before database'\n (ROOT/'database-stage').write_text('safe')\n");
|
||||||
|
fsx::atomic_write(&root.join("Scripts/manage.py"), launcher.as_bytes())?;
|
||||||
|
let mut foreign = spawn(&root.join("foreign.exe"));
|
||||||
|
let foreign_identity = process::identity(foreign.0.id()).unwrap();
|
||||||
|
fsx::atomic_write_json(&root.join(".state/world.json"), &foreign_identity)?;
|
||||||
|
let rejected = driver::force_stop(root)?;
|
||||||
|
assert!(!rejected.ok, "a foreign world record must be rejected");
|
||||||
|
assert!(!root.join("database-stage").exists());
|
||||||
|
assert!(foreign.0.try_wait()?.is_none());
|
||||||
|
let mut owned = spawn(&root.join("Core/worldserver.exe"));
|
||||||
|
let stopped = driver::force_stop(root)?;
|
||||||
|
assert!(stopped.ok, "{}", stopped.output);
|
||||||
|
assert!(owned.0.try_wait()?.is_some());
|
||||||
|
assert!(
|
||||||
|
foreign.0.try_wait()?.is_none(),
|
||||||
|
"foreign process was untouched"
|
||||||
|
);
|
||||||
|
assert_eq!(std::fs::read(root.join("database-stage"))?, b"safe");
|
||||||
|
println!("PASS: native Windows forced-stop rejects foreign records, recovers the exact owned world identity, stops it before the database stage, and leaves the foreign process alive");
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
@@ -0,0 +1,114 @@
|
|||||||
|
//! The Rust launcher on a DISPOSABLE repack, side by side with Scripts/manage.py:
|
||||||
|
//!
|
||||||
|
//! 1. install the stable server into a new folder on unused ports;
|
||||||
|
//! 2. coa-launcher start-all, then manage.py status-json must see every service;
|
||||||
|
//! 3. manage.py stop-all stops what coa-launcher started;
|
||||||
|
//! 4. manage.py start-all, coa-launcher status-json sees it, coa-launcher stop-all stops it;
|
||||||
|
//! 5. both stop-alls leave nothing of the repack running.
|
||||||
|
//!
|
||||||
|
//! usage: launcher_e2e <new folder ending in -fixture> <coa-launcher.exe>
|
||||||
|
use std::path::Path;
|
||||||
|
use std::process::Command;
|
||||||
|
|
||||||
|
use coa_core::install::{install_base, Params};
|
||||||
|
use coa_core::registry::Registry;
|
||||||
|
|
||||||
|
fn free_port() -> u16 {
|
||||||
|
std::net::TcpListener::bind("127.0.0.1:0").unwrap().local_addr().unwrap().port()
|
||||||
|
}
|
||||||
|
|
||||||
|
fn run(exe: &Path, args: &[&str]) -> (bool, String) {
|
||||||
|
let out = Command::new(exe).args(args).output().unwrap();
|
||||||
|
let text = String::from_utf8_lossy(&out.stdout).into_owned() + &String::from_utf8_lossy(&out.stderr);
|
||||||
|
(out.status.success(), text)
|
||||||
|
}
|
||||||
|
|
||||||
|
fn launcher(root: &Path, exe: &Path, action: &str) -> (bool, String) {
|
||||||
|
let r = root.to_string_lossy().into_owned();
|
||||||
|
let t = std::time::Instant::now();
|
||||||
|
let out = run(exe, &["--root", &r, action]);
|
||||||
|
println!("[coa-launcher {action}] ok={} in {:?}\n{}", out.0, t.elapsed(), indent(&out.1));
|
||||||
|
out
|
||||||
|
}
|
||||||
|
|
||||||
|
fn manage(root: &Path, action: &str) -> (bool, String) {
|
||||||
|
let python = root.join("Runtime/python/python.exe");
|
||||||
|
let script = root.join("Scripts/manage.py").to_string_lossy().into_owned();
|
||||||
|
let t = std::time::Instant::now();
|
||||||
|
let out = run(&python, &["-B", &script, action]);
|
||||||
|
println!("[manage.py {action}] ok={} in {:?}\n{}", out.0, t.elapsed(), indent(&out.1));
|
||||||
|
out
|
||||||
|
}
|
||||||
|
|
||||||
|
fn indent(s: &str) -> String {
|
||||||
|
s.lines().map(|l| format!(" {l}")).collect::<Vec<_>>().join("\n")
|
||||||
|
}
|
||||||
|
|
||||||
|
fn status(out: &str) -> serde_json::Value {
|
||||||
|
let line = out.lines().rev().find(|l| l.trim_start().starts_with('{')).expect("a JSON status line");
|
||||||
|
serde_json::from_str(line).unwrap()
|
||||||
|
}
|
||||||
|
|
||||||
|
fn all(v: &serde_json::Value, running: bool) -> bool {
|
||||||
|
["mysql", "auth", "world", "relay"].iter().all(|k| v[*k] == running)
|
||||||
|
}
|
||||||
|
|
||||||
|
fn main() {
|
||||||
|
let a: Vec<String> = std::env::args().skip(1).collect();
|
||||||
|
let root = Path::new(&a[0]);
|
||||||
|
let exe = Path::new(&a[1]);
|
||||||
|
assert!(a[0].ends_with("-fixture"), "a folder ending in -fixture is required");
|
||||||
|
if root.join("Core/worldserver.exe").is_file() {
|
||||||
|
println!("reusing the installed fixture");
|
||||||
|
} else {
|
||||||
|
install(root);
|
||||||
|
}
|
||||||
|
test(root, exe);
|
||||||
|
}
|
||||||
|
|
||||||
|
fn install(root: &Path) {
|
||||||
|
assert!(!root.exists(), "a new folder is required");
|
||||||
|
let reg_dir = std::env::temp_dir().join("coa-launcher-e2e-registry");
|
||||||
|
let _ = std::fs::remove_dir_all(®_dir);
|
||||||
|
let reg = Registry::at(reg_dir.join("installs.json"));
|
||||||
|
// what the Manager installs: the stable release's installation image
|
||||||
|
let image = coa_core::install::Source::Installation(Box::new(coa_core::channels::resolve("stable").expect("stable channel")));
|
||||||
|
let installed = install_base(
|
||||||
|
&Params { source: image, dest: root.into(), trusted_key: coa_core::signing::EMBEDDED_PUBLIC_KEY, registry: ®, cancel: Default::default() },
|
||||||
|
&|s| eprintln!(" {:>3}% {}", s.percent, s.step),
|
||||||
|
)
|
||||||
|
.expect("install");
|
||||||
|
println!("installed {}", installed.version);
|
||||||
|
let repack = root.join("Settings/repack.json");
|
||||||
|
let mut cfg: serde_json::Value = serde_json::from_slice(&std::fs::read(&repack).unwrap()).unwrap();
|
||||||
|
for k in ["mysqlPort", "authPort", "worldPort", "raPort"] {
|
||||||
|
cfg[k] = free_port().into();
|
||||||
|
}
|
||||||
|
std::fs::write(&repack, serde_json::to_vec_pretty(&cfg).unwrap()).unwrap();
|
||||||
|
}
|
||||||
|
|
||||||
|
fn test(root: &Path, exe: &Path) {
|
||||||
|
// 2. Rust starts, Python sees it
|
||||||
|
assert!(launcher(root, exe, "start-all").0, "coa-launcher start-all");
|
||||||
|
let seen = status(&manage(root, "status-json").1);
|
||||||
|
assert!(all(&seen, true), "manage.py must see the services coa-launcher started: {seen}");
|
||||||
|
// 3. Python stops what Rust started
|
||||||
|
assert!(manage(root, "stop-all").0, "manage.py stop-all");
|
||||||
|
assert!(all(&status(&launcher(root, exe, "status-json").1), false));
|
||||||
|
|
||||||
|
// 4. Python starts, Rust sees and stops it
|
||||||
|
assert!(manage(root, "start-all").0, "manage.py start-all");
|
||||||
|
let seen = status(&launcher(root, exe, "status-json").1);
|
||||||
|
assert!(all(&seen, true), "coa-launcher must see the services manage.py started: {seen}");
|
||||||
|
assert!(launcher(root, exe, "stop-all").0, "coa-launcher stop-all");
|
||||||
|
assert!(all(&status(&manage(root, "status-json").1), false));
|
||||||
|
|
||||||
|
// 5. Rust alone, a second time (start on a server it stopped)
|
||||||
|
assert!(launcher(root, exe, "start-all").0);
|
||||||
|
assert!(launcher(root, exe, "stop-all").0);
|
||||||
|
let left = coa_core::process::find_by_exe(&root.join("mysql/bin/mysqld.exe")).len()
|
||||||
|
+ coa_core::process::find_by_exe(&root.join("Core/worldserver.exe")).len()
|
||||||
|
+ coa_core::process::find_by_exe(&root.join("Core/authserver.exe")).len();
|
||||||
|
assert_eq!(left, 0, "nothing of the repack may be left running");
|
||||||
|
println!("LAUNCHER E2E PASS");
|
||||||
|
}
|
||||||
@@ -0,0 +1,199 @@
|
|||||||
|
use base64::{engine::general_purpose::STANDARD, Engine};
|
||||||
|
use coa_core::{
|
||||||
|
backup,
|
||||||
|
db::Db,
|
||||||
|
driver::{self, Verb},
|
||||||
|
fsx,
|
||||||
|
manifest::{Kind, Migration},
|
||||||
|
package::{self, BuildOptions},
|
||||||
|
pkgsource::Source,
|
||||||
|
registry::MetaDir,
|
||||||
|
update::{self, RepackEnv},
|
||||||
|
Result,
|
||||||
|
};
|
||||||
|
use ed25519_dalek::{Signer, SigningKey};
|
||||||
|
use std::{collections::BTreeMap, path::PathBuf};
|
||||||
|
fn main() -> Result<()> {
|
||||||
|
let root = PathBuf::from(
|
||||||
|
std::env::args()
|
||||||
|
.nth(1)
|
||||||
|
.expect("qualified disposable fixture"),
|
||||||
|
);
|
||||||
|
let sql = std::fs::read(std::env::args().nth(2).expect("corrective SQL"))?;
|
||||||
|
assert_eq!(
|
||||||
|
root.file_name().unwrap(),
|
||||||
|
"coa-schema-fixture-stability-upgrade-76-85-20261030"
|
||||||
|
);
|
||||||
|
assert!(root.join(".release-schema-fixture").is_file());
|
||||||
|
assert!(!root.join("legacy-start-data-e2e-started").exists());
|
||||||
|
fsx::atomic_write(
|
||||||
|
&root.join("legacy-start-data-e2e-started"),
|
||||||
|
b"disposable regression test",
|
||||||
|
)?;
|
||||||
|
let result = std::panic::catch_unwind(|| -> Result<()> {
|
||||||
|
let meta = coa_core::registry::metadata_dir_for(&root)?;
|
||||||
|
let mut identities = String::new();
|
||||||
|
let mut custom = String::new();
|
||||||
|
backup::with_database(&root, |db| {
|
||||||
|
assert_eq!(
|
||||||
|
db.query(
|
||||||
|
"SELECT COUNT(*) FROM acore_world.playercreateinfo WHERE race IN (33,45);"
|
||||||
|
)?
|
||||||
|
.trim(),
|
||||||
|
"0"
|
||||||
|
);
|
||||||
|
let base: u32 = db
|
||||||
|
.query("SELECT MAX(guid)+100 FROM acore_characters.characters;")?
|
||||||
|
.trim()
|
||||||
|
.parse()
|
||||||
|
.unwrap();
|
||||||
|
clone_character(db, base, 33, 12, "Thinprobe")?;
|
||||||
|
clone_character(db, base + 1, 45, 30, "Leperprobe")?;
|
||||||
|
identities = db.query(&format!(
|
||||||
|
"SELECT * FROM acore_characters.characters WHERE guid IN ({base},{});",
|
||||||
|
base + 1
|
||||||
|
))?;
|
||||||
|
let missing = coa_core::character_start_check::missing(db)?;
|
||||||
|
assert!(missing
|
||||||
|
.iter()
|
||||||
|
.any(|c| c.guid == base && c.race == 33 && c.class == 12));
|
||||||
|
assert!(missing
|
||||||
|
.iter()
|
||||||
|
.any(|c| c.guid == base + 1 && c.race == 45 && c.class == 30));
|
||||||
|
db.query("INSERT INTO acore_world.playercreateinfo SELECT 33,class,map,zone,position_x+0.125,position_y,position_z,orientation FROM acore_world.playercreateinfo WHERE race=1 AND class=32;")?;
|
||||||
|
custom =
|
||||||
|
db.query("SELECT * FROM acore_world.playercreateinfo WHERE race=33 AND class=32;")?;
|
||||||
|
fsx::atomic_write(
|
||||||
|
&root.join("legacy-probe-guids.json"),
|
||||||
|
serde_json::to_string(&[base, base + 1])?.as_bytes(),
|
||||||
|
)?;
|
||||||
|
println!("PASS: reproduced missing starting data for existing race 33/class 12 and race 45/class 30 characters");
|
||||||
|
Ok(())
|
||||||
|
})?;
|
||||||
|
let source = root.join("legacy-start-data-source");
|
||||||
|
let pkg = root.join("legacy-start-data-package");
|
||||||
|
fsx::atomic_write(
|
||||||
|
&source.join("Core/legacy-start-data-proof.txt"),
|
||||||
|
b"corrective migration acceptance",
|
||||||
|
)?;
|
||||||
|
fsx::atomic_write(
|
||||||
|
&source.join("_migrations/world/stabilization_legacy_starts.sql"),
|
||||||
|
&sql,
|
||||||
|
)?;
|
||||||
|
let manifest = package::build(
|
||||||
|
&source,
|
||||||
|
&pkg,
|
||||||
|
&BuildOptions {
|
||||||
|
kind: Kind::Update,
|
||||||
|
version: "2.0.0".into(),
|
||||||
|
core_commit: None,
|
||||||
|
bots_commit: None,
|
||||||
|
built_at: "private regression acceptance".into(),
|
||||||
|
part_size: 1 << 20,
|
||||||
|
migrations: vec![Migration {
|
||||||
|
id: "stabilization_legacy_starts".into(),
|
||||||
|
db: "world".into(),
|
||||||
|
sha256: fsx::sha256_bytes(&sql),
|
||||||
|
compatible_sha256: vec![],
|
||||||
|
destructive: false,
|
||||||
|
}],
|
||||||
|
},
|
||||||
|
&|_| {},
|
||||||
|
)?;
|
||||||
|
let key = SigningKey::generate(&mut rand_core::OsRng);
|
||||||
|
fsx::atomic_write(
|
||||||
|
&pkg.join("manifest.json.sig"),
|
||||||
|
STANDARD
|
||||||
|
.encode(
|
||||||
|
key.sign(&std::fs::read(pkg.join("manifest.json"))?)
|
||||||
|
.to_bytes(),
|
||||||
|
)
|
||||||
|
.as_bytes(),
|
||||||
|
)?;
|
||||||
|
let trusted = STANDARD.encode(key.verifying_key().to_bytes());
|
||||||
|
let env = RepackEnv {
|
||||||
|
root: &root,
|
||||||
|
meta_dir: &meta,
|
||||||
|
};
|
||||||
|
let out = update::apply(
|
||||||
|
&update::Params {
|
||||||
|
root: &root,
|
||||||
|
meta_dir: &meta,
|
||||||
|
source: Source::Dir(pkg),
|
||||||
|
trusted_key: &trusted,
|
||||||
|
cancel: Default::default(),
|
||||||
|
resolutions: BTreeMap::new(),
|
||||||
|
env: &env,
|
||||||
|
fail_after_ops: None,
|
||||||
|
},
|
||||||
|
&|step, pct| println!("{pct}% {step}"),
|
||||||
|
)?;
|
||||||
|
assert_eq!(out.txn.state, update::State::Committed);
|
||||||
|
assert_eq!(
|
||||||
|
MetaDir::open(&meta)?.1.core.version.as_deref(),
|
||||||
|
Some("2.0.0")
|
||||||
|
);
|
||||||
|
backup::with_database(&root, |db| {
|
||||||
|
let guids: Vec<u32> =
|
||||||
|
serde_json::from_slice(&std::fs::read(root.join("legacy-probe-guids.json"))?)?;
|
||||||
|
assert_eq!(
|
||||||
|
db.query(&format!(
|
||||||
|
"SELECT * FROM acore_characters.characters WHERE guid IN ({},{});",
|
||||||
|
guids[0], guids[1]
|
||||||
|
))?,
|
||||||
|
identities
|
||||||
|
);
|
||||||
|
assert!(coa_core::character_start_check::missing(db)?
|
||||||
|
.iter()
|
||||||
|
.all(|c| !guids.contains(&c.guid)));
|
||||||
|
assert_eq!(
|
||||||
|
db.query("SELECT * FROM acore_world.playercreateinfo WHERE race=33 AND class=32;")?,
|
||||||
|
custom
|
||||||
|
);
|
||||||
|
assert!(coa_core::migrations::status(db, &manifest.migrations)?
|
||||||
|
.iter()
|
||||||
|
.all(|m| m.status == coa_core::migrations::Status::Applied));
|
||||||
|
let before = counts(db)?;
|
||||||
|
db.query(&format!(
|
||||||
|
"USE acore_world; {}",
|
||||||
|
String::from_utf8_lossy(&sql)
|
||||||
|
))?;
|
||||||
|
assert_eq!(counts(db)?, before);
|
||||||
|
assert_eq!(
|
||||||
|
db.query("SELECT * FROM acore_world.playercreateinfo WHERE race=33 AND class=32;")?,
|
||||||
|
custom
|
||||||
|
);
|
||||||
|
println!("PASS: signed Manager update restored legacy starts, preserved complete character rows and custom starts, and remained idempotent on a second SQL execution");
|
||||||
|
Ok(())
|
||||||
|
})?;
|
||||||
|
Ok(())
|
||||||
|
});
|
||||||
|
let stopped = driver::run(&root, Verb::StopAll)?;
|
||||||
|
assert!(stopped.ok, "{}", stopped.output);
|
||||||
|
result.map_err(|_| {
|
||||||
|
coa_core::Error::Invalid("Legacy start regression failed; fixture stopped".into())
|
||||||
|
})?
|
||||||
|
}
|
||||||
|
fn counts(db: &Db) -> Result<String> {
|
||||||
|
db.query("SELECT COUNT(*) FROM acore_world.playercreateinfo WHERE race IN (33,45); SELECT COUNT(*) FROM acore_world.playercreateinfo_item WHERE race IN (33,45); SELECT COUNT(*) FROM acore_world.playercreateinfo_action WHERE race IN (33,45); SELECT COUNT(*) FROM acore_world.player_race_stats WHERE Race IN (33,45); SELECT COUNT(*) FROM acore_world.ascension_custom_class_race WHERE race IN (33,45);")
|
||||||
|
}
|
||||||
|
fn clone_character(db: &Db, guid: u32, race: u32, class: u32, name: &str) -> Result<()> {
|
||||||
|
let columns = db.query("SHOW COLUMNS FROM acore_characters.characters;")?;
|
||||||
|
let names: Vec<_> = columns
|
||||||
|
.lines()
|
||||||
|
.map(|l| l.split('\t').next().unwrap())
|
||||||
|
.collect();
|
||||||
|
let values: Vec<String> = names
|
||||||
|
.iter()
|
||||||
|
.map(|c| match *c {
|
||||||
|
"guid" => guid.to_string(),
|
||||||
|
"name" => format!("'{name}'"),
|
||||||
|
"race" => race.to_string(),
|
||||||
|
"class" => class.to_string(),
|
||||||
|
"online" | "at_login" => "0".into(),
|
||||||
|
_ => format!("`{c}`"),
|
||||||
|
})
|
||||||
|
.collect();
|
||||||
|
db.query(&format!("INSERT INTO acore_characters.characters ({}) SELECT {} FROM acore_characters.characters WHERE class={class} LIMIT 1;",names.iter().map(|c|format!("`{c}`")).collect::<Vec<_>>().join(","),values.join(",")))?;
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
@@ -0,0 +1,149 @@
|
|||||||
|
//! The Manager's start/stop (`driver`) on the Rust launcher, on a DISPOSABLE repack:
|
||||||
|
//!
|
||||||
|
//! 1. driver start-all: every service runs, the console answers, manage.py is not touched and sees the services;
|
||||||
|
//! 2. driver stop-all stops everything;
|
||||||
|
//! 3. manage.py start-all, then driver stop-all stops what Python started;
|
||||||
|
//! 4. a taken world port fails with the typed "port in use" code (no stderr parsing), then stop-all;
|
||||||
|
//! 5. driver start-all, then the forced stop;
|
||||||
|
//! 6. with a realm profile: the realm row gets the profile's name, manage.py is still not edited;
|
||||||
|
//! 7. nothing of the repack is left running.
|
||||||
|
//!
|
||||||
|
//! usage: manager_launcher_e2e <existing folder ending in -fixture>
|
||||||
|
use std::path::Path;
|
||||||
|
use std::process::Command;
|
||||||
|
use std::time::Instant;
|
||||||
|
|
||||||
|
use coa_core::driver::{self, Verb};
|
||||||
|
use coa_core::error::ErrorCode;
|
||||||
|
use coa_core::launcher::{services, settings::Settings, state};
|
||||||
|
|
||||||
|
fn indent(s: &str) -> String {
|
||||||
|
s.lines().map(|l| format!(" {l}")).collect::<Vec<_>>().join("\n")
|
||||||
|
}
|
||||||
|
|
||||||
|
fn drive(root: &Path, verb: Verb) -> driver::DriverOutcome {
|
||||||
|
let t = Instant::now();
|
||||||
|
let out = driver::run(root, verb).expect("driver");
|
||||||
|
println!("[driver {verb:?}] ok={} code={:?} in {:?}\n{}", out.ok, out.code, t.elapsed(), indent(&out.output));
|
||||||
|
out
|
||||||
|
}
|
||||||
|
|
||||||
|
fn manage(root: &Path, action: &str) -> (bool, String) {
|
||||||
|
let python = root.join("Runtime/python/python.exe");
|
||||||
|
let script = root.join("Scripts/manage.py").to_string_lossy().into_owned();
|
||||||
|
let t = Instant::now();
|
||||||
|
let out = Command::new(python).args(["-B", &script, action]).output().unwrap();
|
||||||
|
let text = String::from_utf8_lossy(&out.stdout).into_owned() + &String::from_utf8_lossy(&out.stderr);
|
||||||
|
println!("[manage.py {action}] ok={} in {:?}\n{}", out.status.success(), t.elapsed(), indent(&text));
|
||||||
|
(out.status.success(), text)
|
||||||
|
}
|
||||||
|
|
||||||
|
fn python_status(root: &Path) -> serde_json::Value {
|
||||||
|
let (ok, out) = manage(root, "status-json");
|
||||||
|
assert!(ok);
|
||||||
|
let line = out.lines().rev().find(|l| l.trim_start().starts_with('{')).expect("a JSON status line");
|
||||||
|
serde_json::from_str(line).unwrap()
|
||||||
|
}
|
||||||
|
|
||||||
|
fn all(v: &serde_json::Value, running: bool) -> bool {
|
||||||
|
["mysql", "auth", "world", "relay"].iter().all(|k| v[*k] == running)
|
||||||
|
}
|
||||||
|
|
||||||
|
fn nothing_running(root: &Path) -> bool {
|
||||||
|
["mysql", "auth", "world", "supervisor", "relay"].iter().all(|n| state::running(root, n).is_none())
|
||||||
|
&& ["mysql/bin/mysqld.exe", "Core/authserver.exe", "Core/worldserver.exe"]
|
||||||
|
.iter()
|
||||||
|
.all(|exe| coa_core::process::find_by_exe(&root.join(exe)).is_empty())
|
||||||
|
}
|
||||||
|
|
||||||
|
fn console(root: &Path) -> String {
|
||||||
|
let cfg = Settings::load(root, 0).unwrap();
|
||||||
|
let mut ra = coa_core::ra::Ra::connect_to(cfg.ra_port, &cfg.ra_username, &cfg.ra_password).unwrap();
|
||||||
|
ra.run("server info").unwrap()
|
||||||
|
}
|
||||||
|
|
||||||
|
fn realm_name(root: &Path) -> String {
|
||||||
|
services::mysql(root, Some("SELECT name FROM acore_auth.realmlist WHERE id=1;"), None).unwrap()
|
||||||
|
}
|
||||||
|
|
||||||
|
fn main() {
|
||||||
|
let a: Vec<String> = std::env::args().skip(1).collect();
|
||||||
|
let root = Path::new(&a[0]);
|
||||||
|
assert!(a[0].ends_with("-fixture"), "a folder ending in -fixture is required");
|
||||||
|
assert!(nothing_running(root), "the fixture must be stopped before the test");
|
||||||
|
let manage_py = root.join("Scripts/manage.py");
|
||||||
|
let original = std::fs::read(&manage_py).unwrap();
|
||||||
|
let profile = root.join("Settings/realm-profile.json");
|
||||||
|
assert!(!profile.exists(), "the fixture starts without a realm profile");
|
||||||
|
|
||||||
|
// 1
|
||||||
|
let started = drive(root, Verb::StartAll);
|
||||||
|
assert!(started.ok, "start-all");
|
||||||
|
assert!(all(&python_status(root), true), "manage.py sees what the Manager started");
|
||||||
|
let info = console(root);
|
||||||
|
println!("[console] {}", info.lines().next().unwrap_or(""));
|
||||||
|
assert_eq!(std::fs::read(&manage_py).unwrap(), original, "manage.py is not rewritten");
|
||||||
|
assert_eq!(realm_name(root), "AzerothCore", "no profile: the launcher's own realm name");
|
||||||
|
|
||||||
|
let shipped = root.join("Scripts/coa-launcher.exe");
|
||||||
|
let supervisor = state::running(root, "supervisor").expect("a supervisor");
|
||||||
|
println!("[supervisor] {}", supervisor.exe);
|
||||||
|
let expected = if shipped.is_file() { "coa-launcher.exe" } else { "python.exe" };
|
||||||
|
assert!(supervisor.exe.to_lowercase().ends_with(expected), "the world is supervised by {expected}");
|
||||||
|
let relay = state::running(root, "relay").expect("a bug-report relay");
|
||||||
|
println!("[relay] {}", relay.exe);
|
||||||
|
assert!(relay.exe.to_lowercase().ends_with(expected), "the relay is run by {expected}");
|
||||||
|
assert!(state::running(root, "relay-ready").is_some_and(|r| r.pid == relay.pid), "the relay reported ready");
|
||||||
|
|
||||||
|
// 2
|
||||||
|
assert!(drive(root, Verb::StopAll).ok, "stop-all");
|
||||||
|
assert!(nothing_running(root), "1-2 left something running");
|
||||||
|
|
||||||
|
// 2b: the repack's Python launcher stops a world the Manager started
|
||||||
|
assert!(drive(root, Verb::StartAll).ok);
|
||||||
|
assert!(manage(root, "stop-all").0, "manage.py stops what the Manager started");
|
||||||
|
assert!(nothing_running(root), "2b left something running");
|
||||||
|
|
||||||
|
// 3
|
||||||
|
assert!(manage(root, "start-all").0);
|
||||||
|
assert!(drive(root, Verb::StopAll).ok, "driver stops what manage.py started");
|
||||||
|
assert!(nothing_running(root), "3 left something running");
|
||||||
|
|
||||||
|
// 4
|
||||||
|
let cfg = Settings::load(root, 0).unwrap();
|
||||||
|
let blocker = std::net::TcpListener::bind(("127.0.0.1", cfg.world_port)).unwrap();
|
||||||
|
let refused = drive(root, Verb::StartAll);
|
||||||
|
assert!(!refused.ok);
|
||||||
|
assert_eq!(refused.code, Some(ErrorCode::PortInUse), "typed port error");
|
||||||
|
assert!(refused.output.contains(&format!("Port {}", cfg.world_port)));
|
||||||
|
drop(blocker);
|
||||||
|
assert!(drive(root, Verb::StopAll).ok);
|
||||||
|
assert!(nothing_running(root), "4 left something running");
|
||||||
|
|
||||||
|
// 5
|
||||||
|
assert!(drive(root, Verb::StartAll).ok);
|
||||||
|
let t = Instant::now();
|
||||||
|
let forced = driver::force_stop(root).expect("force stop");
|
||||||
|
println!("[driver force_stop] ok={} in {:?}\n{}", forced.ok, t.elapsed(), indent(&forced.output));
|
||||||
|
assert!(forced.ok && forced.output.contains("Force-stopped"));
|
||||||
|
assert!(nothing_running(root), "5 left something running");
|
||||||
|
|
||||||
|
// 6
|
||||||
|
std::fs::write(&profile, br#"{"active":"coa","wildcard_created":false}"#).unwrap();
|
||||||
|
let result = std::panic::catch_unwind(|| {
|
||||||
|
assert!(drive(root, Verb::StartAll).ok, "start-all with a realm profile");
|
||||||
|
assert_eq!(realm_name(root), "Conquest of Azeroth");
|
||||||
|
assert_eq!(std::fs::read(&manage_py).unwrap(), original, "manage.py is not edited for a realm profile either");
|
||||||
|
assert!(drive(root, Verb::StopAll).ok);
|
||||||
|
});
|
||||||
|
std::fs::remove_file(&profile).unwrap();
|
||||||
|
std::fs::write(&manage_py, &original).unwrap();
|
||||||
|
if result.is_err() {
|
||||||
|
let _ = driver::run(root, Verb::StopAll);
|
||||||
|
panic!("step 6 failed");
|
||||||
|
}
|
||||||
|
|
||||||
|
// 7
|
||||||
|
assert!(nothing_running(root), "something of the repack is still running");
|
||||||
|
println!("PASS: the Manager starts and stops through the Rust launcher, interoperates with manage.py, typed errors");
|
||||||
|
}
|
||||||
@@ -1,8 +1,15 @@
|
|||||||
//! Read-only audit, or explicit SQL checks on a disposable database fixture.
|
//! Read-only audit, or explicit SQL checks on a disposable database fixture.
|
||||||
use coa_core::{db::{Account, Db}, migrations::{self, Store}, manifest::Manifest, realms::Mode};
|
use coa_core::{
|
||||||
|
db::{Account, Db},
|
||||||
|
manifest::Manifest,
|
||||||
|
migrations::{self, Store},
|
||||||
|
realms::Mode,
|
||||||
|
};
|
||||||
fn main() -> Result<(), Box<dyn std::error::Error>> {
|
fn main() -> Result<(), Box<dyn std::error::Error>> {
|
||||||
let args: Vec<_> = std::env::args().collect();
|
let args: Vec<_> = std::env::args().collect();
|
||||||
if args.len() < 3 { return Err("usage: migration_plan <root> <signed-manifest> [--apply|--sql-only <migration-directory>]".into()); }
|
if args.len() < 3 {
|
||||||
|
return Err("usage: migration_plan <root> <signed-manifest> [--apply|--sql-only <migration-directory>]".into());
|
||||||
|
}
|
||||||
let root = std::path::Path::new(&args[1]);
|
let root = std::path::Path::new(&args[1]);
|
||||||
let bytes = std::fs::read(&args[2])?;
|
let bytes = std::fs::read(&args[2])?;
|
||||||
let signature = std::fs::read_to_string(format!("{}.sig", args[2]))?;
|
let signature = std::fs::read_to_string(format!("{}.sig", args[2]))?;
|
||||||
@@ -11,21 +18,57 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
|
|||||||
for (index, mode) in [Mode::Coa, Mode::Wildcard].into_iter().enumerate() {
|
for (index, mode) in [Mode::Coa, Mode::Wildcard].into_iter().enumerate() {
|
||||||
let db = Db::from_repack(root, Account::Admin)?.for_realm(mode);
|
let db = Db::from_repack(root, Account::Admin)?.for_realm(mode);
|
||||||
let rows = db.load_readonly()?;
|
let rows = db.load_readonly()?;
|
||||||
let relevant: Vec<_> = rows.iter().filter(|r| r.id == "rev_20260903_01_live_class_baseline").map(|r| format!("{} {:?} {}",r.db,r.status,r.baseline)).collect();
|
let relevant: Vec<_> = rows
|
||||||
|
.iter()
|
||||||
|
.filter(|r| r.id == "rev_20260903_01_live_class_baseline")
|
||||||
|
.map(|r| format!("{} {:?} {}", r.db, r.status, r.baseline))
|
||||||
|
.collect();
|
||||||
println!("{} baseline history: {:?}", mode.name(), relevant);
|
println!("{} baseline history: {:?}", mode.name(), relevant);
|
||||||
let list: Vec<_> = manifest.migrations.iter().filter(|m|index==0 || m.db!="auth").cloned().collect();
|
let list: Vec<_> = manifest
|
||||||
|
.migrations
|
||||||
|
.iter()
|
||||||
|
.filter(|m| index == 0 || m.db != "auth")
|
||||||
|
.cloned()
|
||||||
|
.collect();
|
||||||
let plan = migrations::status(&db, &list)?;
|
let plan = migrations::status(&db, &list)?;
|
||||||
println!("{} pending: {:?}",mode.name(),plan.iter().filter(|m|m.status!=migrations::Status::Applied).map(|m|(&m.db,&m.id,m.status)).collect::<Vec<_>>());
|
println!(
|
||||||
|
"{} pending: {:?}",
|
||||||
|
mode.name(),
|
||||||
|
plan.iter()
|
||||||
|
.filter(|m| m.status != migrations::Status::Applied)
|
||||||
|
.map(|m| (&m.db, &m.id, m.status))
|
||||||
|
.collect::<Vec<_>>()
|
||||||
|
);
|
||||||
}
|
}
|
||||||
if args.get(3).is_some_and(|s| s == "--apply" || s == "--sql-only") {
|
if args
|
||||||
assert!(root.file_name().unwrap().to_string_lossy().starts_with("update-database-diagnosis-") && root.join(".coa-update-fixture").is_file(), "Only disposable fixture roots may be changed");
|
.get(3)
|
||||||
|
.is_some_and(|s| s == "--apply" || s == "--sql-only")
|
||||||
|
{
|
||||||
|
assert!(
|
||||||
|
root.file_name()
|
||||||
|
.unwrap()
|
||||||
|
.to_string_lossy()
|
||||||
|
.starts_with("update-database-diagnosis-")
|
||||||
|
&& root.join(".coa-update-fixture").is_file(),
|
||||||
|
"Only disposable fixture roots may be changed"
|
||||||
|
);
|
||||||
if args[3] == "--sql-only" {
|
if args[3] == "--sql-only" {
|
||||||
let db = Db::from_repack(root, Account::Admin)?.for_realm(Mode::Coa);
|
let db = Db::from_repack(root, Account::Admin)?.for_realm(Mode::Coa);
|
||||||
let identity = || -> coa_core::Result<String> {
|
let identity = || -> coa_core::Result<String> {
|
||||||
let mut rows = String::new();
|
let mut rows = String::new();
|
||||||
for (schema,table,columns) in [("acore_auth","account","id,HEX(username)"),("acore_characters","characters","guid,account,HEX(name)"),("acore_characters_wildcard","characters","guid,account,HEX(name)")] {
|
for (schema, table, columns) in [
|
||||||
|
("acore_auth", "account", "id,HEX(username)"),
|
||||||
|
("acore_characters", "characters", "guid,account,HEX(name)"),
|
||||||
|
(
|
||||||
|
"acore_characters_wildcard",
|
||||||
|
"characters",
|
||||||
|
"guid,account,HEX(name)",
|
||||||
|
),
|
||||||
|
] {
|
||||||
rows.push_str(schema);
|
rows.push_str(schema);
|
||||||
rows.push_str(&db.query(&format!("SELECT {columns} FROM {schema}.{table} ORDER BY 1;"))?);
|
rows.push_str(&db.query(&format!(
|
||||||
|
"SELECT {columns} FROM {schema}.{table} ORDER BY 1;"
|
||||||
|
))?);
|
||||||
}
|
}
|
||||||
Ok(coa_core::fsx::sha256_bytes(rows.as_bytes()))
|
Ok(coa_core::fsx::sha256_bytes(rows.as_bytes()))
|
||||||
};
|
};
|
||||||
@@ -33,22 +76,46 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
|
|||||||
migrations::verify_files(&manifest.migrations, std::path::Path::new(&args[4]))?;
|
migrations::verify_files(&manifest.migrations, std::path::Path::new(&args[4]))?;
|
||||||
for (index, mode) in [Mode::Coa, Mode::Wildcard].into_iter().enumerate() {
|
for (index, mode) in [Mode::Coa, Mode::Wildcard].into_iter().enumerate() {
|
||||||
let realm_db = db.clone().for_realm(mode);
|
let realm_db = db.clone().for_realm(mode);
|
||||||
let list: Vec<_> = manifest.migrations.iter().filter(|m|index==0 || m.db!="auth").cloned().collect();
|
let list: Vec<_> = manifest
|
||||||
let result = migrations::apply_pending(&realm_db,&list,std::path::Path::new(&args[4]),&||Ok("disposable fixture".into()))?;
|
.migrations
|
||||||
println!("{} SQL result: {}",mode.name(),serde_json::to_string(&result)?);
|
.iter()
|
||||||
if result.failed.is_some() {return Err("SQL failed; fixture preserved".into());}
|
.filter(|m| index == 0 || m.db != "auth")
|
||||||
|
.cloned()
|
||||||
|
.collect();
|
||||||
|
let result = migrations::apply_pending(
|
||||||
|
&realm_db,
|
||||||
|
&list,
|
||||||
|
std::path::Path::new(&args[4]),
|
||||||
|
&|| Ok("disposable fixture".into()),
|
||||||
|
)?;
|
||||||
|
println!(
|
||||||
|
"{} SQL result: {}",
|
||||||
|
mode.name(),
|
||||||
|
serde_json::to_string(&result)?
|
||||||
|
);
|
||||||
|
if result.failed.is_some() {
|
||||||
|
return Err("SQL failed; fixture preserved".into());
|
||||||
|
}
|
||||||
}
|
}
|
||||||
assert_eq!(before, identity()?, "Account or character identity changed");
|
assert_eq!(before, identity()?, "Account or character identity changed");
|
||||||
println!("Account and character identities preserved: {}", before);
|
println!("Account and character identities preserved: {}", before);
|
||||||
let capture = root.join("captured-schema");
|
let capture = root.join("captured-schema");
|
||||||
coa_core::schema_check::capture(&db, &capture)?;
|
coa_core::schema_check::capture(&db, &capture)?;
|
||||||
println!("Captured schema SHA256: {}",coa_core::fsx::sha256_file(&capture.join(coa_core::schema_check::CONTRACT))?);
|
println!(
|
||||||
|
"Captured schema SHA256: {}",
|
||||||
|
coa_core::fsx::sha256_file(&capture.join(coa_core::schema_check::CONTRACT))?
|
||||||
|
);
|
||||||
return Ok(());
|
return Ok(());
|
||||||
}
|
}
|
||||||
if args.len() != 5 { return Err("Migration directory required".into()); }
|
if args.len() != 5 {
|
||||||
|
return Err("Migration directory required".into());
|
||||||
|
}
|
||||||
use coa_core::update::{Env, RepackEnv};
|
use coa_core::update::{Env, RepackEnv};
|
||||||
let meta = coa_core::registry::metadata_dir_for(root)?;
|
let meta = coa_core::registry::metadata_dir_for(root)?;
|
||||||
let env = RepackEnv { root, meta_dir: &meta };
|
let env = RepackEnv {
|
||||||
|
root,
|
||||||
|
meta_dir: &meta,
|
||||||
|
};
|
||||||
let result = env.migrate(&manifest, std::path::Path::new(&args[4]));
|
let result = env.migrate(&manifest, std::path::Path::new(&args[4]));
|
||||||
let _ = coa_core::driver::run(root, coa_core::driver::Verb::StopAll);
|
let _ = coa_core::driver::run(root, coa_core::driver::Verb::StopAll);
|
||||||
println!("Application result: {}", serde_json::to_string(&result?)?);
|
println!("Application result: {}", serde_json::to_string(&result?)?);
|
||||||
|
|||||||
@@ -457,7 +457,7 @@ fn run() -> Result<(), String> {
|
|||||||
}
|
}
|
||||||
("collection-states", [out]) => {
|
("collection-states", [out]) => {
|
||||||
let states = OwnerService::new(&mut store)
|
let states = OwnerService::new(&mut store)
|
||||||
.collection_states()
|
.collection_states(coa_core::portable::Ruleset::Coa)
|
||||||
.map_err(|e| e.to_string())?;
|
.map_err(|e| e.to_string())?;
|
||||||
for s in &states {
|
for s in &states {
|
||||||
println!(
|
println!(
|
||||||
@@ -618,7 +618,7 @@ fn run() -> Result<(), String> {
|
|||||||
let set =
|
let set =
|
||||||
coa_core::portable::collection::IdSet::from_ids(ids).map_err(|e| e.to_string())?;
|
coa_core::portable::collection::IdSet::from_ids(ids).map_err(|e| e.to_string())?;
|
||||||
let merge = store
|
let merge = store
|
||||||
.merge_collection(profile, kind, &set)
|
.merge_collection(profile, coa_core::portable::Ruleset::Coa, kind, &set)
|
||||||
.map_err(|e| e.to_string())?;
|
.map_err(|e| e.to_string())?;
|
||||||
println!(
|
println!(
|
||||||
"{kind}: {} id(s) added{}",
|
"{kind}: {} id(s) added{}",
|
||||||
@@ -633,7 +633,7 @@ fn run() -> Result<(), String> {
|
|||||||
let profile = store.default_profile().map_err(|e| e.to_string())?;
|
let profile = store.default_profile().map_err(|e| e.to_string())?;
|
||||||
for kind in coa_core::portable::session::protocol::COLLECTION_KINDS {
|
for kind in coa_core::portable::session::protocol::COLLECTION_KINDS {
|
||||||
match store
|
match store
|
||||||
.collection_info(profile, kind)
|
.collection_info(profile, coa_core::portable::Ruleset::Coa, kind)
|
||||||
.map_err(|e| e.to_string())?
|
.map_err(|e| e.to_string())?
|
||||||
{
|
{
|
||||||
Some(i) => println!(
|
Some(i) => println!(
|
||||||
|
|||||||
@@ -0,0 +1,170 @@
|
|||||||
|
//! The Rust bug-report relay against the repack's `BugReport/relay.py`, offline (a scripted service, no network):
|
||||||
|
//!
|
||||||
|
//! 1. the same reports and the same service answers give the same `.status` files and journal rows;
|
||||||
|
//! 2. each relay continues the other's journal: what one delivered is never sent again by the other, and a post the
|
||||||
|
//! other left in progress is uncertain.
|
||||||
|
//!
|
||||||
|
//! usage: relay_equivalence <repack folder with Runtime/python and BugReport/relay.py>
|
||||||
|
use std::path::{Path, PathBuf};
|
||||||
|
use std::process::Command;
|
||||||
|
use std::sync::{Arc, Mutex};
|
||||||
|
|
||||||
|
use coa_core::launcher::relay::{Failure, Relay, Service};
|
||||||
|
|
||||||
|
const REPORTS: [(&str, &str); 5] = [
|
||||||
|
("1-00000000000000a1", "COABUG1\r\nQuest broken\r\nThe NPC is gone.\r\n"),
|
||||||
|
("9-00000000000000b2", "COABUG1\nRate limited\nBody text\n"),
|
||||||
|
("3-00000000000000c3", "COABUG1\nRejected\nBody\n"),
|
||||||
|
("4-00000000000000d4", "COABUG1\nxy\nTitle too short\n"),
|
||||||
|
("5-00000000000000e5", "COABUG1\nUnknown outcome\nBody\n"),
|
||||||
|
];
|
||||||
|
|
||||||
|
/// The answers per title, in the vocabulary of both relays.
|
||||||
|
fn answer(title: &str) -> std::result::Result<u64, Failure> {
|
||||||
|
match title {
|
||||||
|
"Quest broken" => Ok(101),
|
||||||
|
"Rate limited" => Err(Failure::Limited(60)),
|
||||||
|
"Rejected" => Err(Failure::Invalid),
|
||||||
|
_ => Err(Failure::Uncertain),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
const PYTHON: &str = r#"
|
||||||
|
import importlib.util, sys, json
|
||||||
|
from pathlib import Path
|
||||||
|
spec = importlib.util.spec_from_file_location("relay", sys.argv[1]); relay = importlib.util.module_from_spec(spec); spec.loader.exec_module(relay)
|
||||||
|
spool = Path(sys.argv[2]); calls = []
|
||||||
|
class Fake:
|
||||||
|
def create(self, title, body):
|
||||||
|
calls.append(title)
|
||||||
|
if title == "Quest broken": return 101
|
||||||
|
if title == "Rate limited": raise relay.DeliveryError("limited", 60)
|
||||||
|
if title == "Rejected": raise relay.DeliveryError("invalid")
|
||||||
|
raise relay.DeliveryError("uncertain")
|
||||||
|
t = [float(sys.argv[3])]
|
||||||
|
def clock():
|
||||||
|
t[0] += 3
|
||||||
|
return t[0]
|
||||||
|
r = relay.Relay(spool, Fake(), clock=clock)
|
||||||
|
for path in sorted(spool.glob("*.report")):
|
||||||
|
r.process(path)
|
||||||
|
r.close()
|
||||||
|
print(json.dumps(calls))
|
||||||
|
"#;
|
||||||
|
|
||||||
|
struct Scripted(Arc<Mutex<Vec<String>>>);
|
||||||
|
impl Service for Scripted {
|
||||||
|
fn create(&self, title: &str, _: &str) -> std::result::Result<u64, Failure> {
|
||||||
|
self.0.lock().unwrap().push(title.into());
|
||||||
|
answer(title)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
fn spool(dir: &Path) -> PathBuf {
|
||||||
|
std::fs::create_dir_all(dir).unwrap();
|
||||||
|
for (key, text) in REPORTS {
|
||||||
|
std::fs::write(dir.join(format!("{key}.report")), text).unwrap();
|
||||||
|
}
|
||||||
|
dir.into()
|
||||||
|
}
|
||||||
|
|
||||||
|
fn python(repack: &Path, spool: &Path, start: f64) -> Vec<String> {
|
||||||
|
let out = Command::new(repack.join("Runtime/python/python.exe"))
|
||||||
|
.args(["-I", "-B", "-c", PYTHON])
|
||||||
|
.arg(repack.join("BugReport/relay.py"))
|
||||||
|
.arg(spool)
|
||||||
|
.arg(start.to_string())
|
||||||
|
.output()
|
||||||
|
.unwrap();
|
||||||
|
assert!(out.status.success(), "{}", String::from_utf8_lossy(&out.stderr));
|
||||||
|
serde_json::from_slice(&out.stdout).unwrap()
|
||||||
|
}
|
||||||
|
|
||||||
|
/// The clock of both relays: `start`, then 3 seconds later at every reading.
|
||||||
|
fn rust(spool: &Path, start: f64) -> Vec<String> {
|
||||||
|
let calls = Arc::new(Mutex::new(Vec::new()));
|
||||||
|
let t = Mutex::new(start);
|
||||||
|
let clock = move || {
|
||||||
|
let mut v = t.lock().unwrap();
|
||||||
|
*v += 3.0;
|
||||||
|
*v
|
||||||
|
};
|
||||||
|
let relay = Relay::with_clock(spool, Scripted(calls.clone()), Box::new(clock)).unwrap();
|
||||||
|
relay.pass().unwrap();
|
||||||
|
drop(relay);
|
||||||
|
let c = calls.lock().unwrap().clone();
|
||||||
|
c
|
||||||
|
}
|
||||||
|
|
||||||
|
/// `.status` files and journal rows (without the post time).
|
||||||
|
fn snapshot(spool: &Path) -> (Vec<(String, String)>, Vec<String>) {
|
||||||
|
let mut statuses: Vec<(String, String)> = std::fs::read_dir(spool)
|
||||||
|
.unwrap()
|
||||||
|
.flatten()
|
||||||
|
.filter(|e| e.path().extension().is_some_and(|x| x == "status"))
|
||||||
|
.map(|e| (e.file_name().to_string_lossy().into_owned(), std::fs::read_to_string(e.path()).unwrap()))
|
||||||
|
.collect();
|
||||||
|
statuses.sort();
|
||||||
|
let db = rusqlite::Connection::open(spool.join("relay.sqlite3")).unwrap();
|
||||||
|
let mut q = db.prepare("SELECT key, digest, marker, state, number, next_try FROM deliveries ORDER BY key").unwrap();
|
||||||
|
let rows = q
|
||||||
|
.query_map([], |r| {
|
||||||
|
Ok(format!(
|
||||||
|
"{}|{}|{}|{}|{:?}|{}",
|
||||||
|
r.get::<_, String>(0)?,
|
||||||
|
r.get::<_, String>(1)?,
|
||||||
|
r.get::<_, String>(2)?,
|
||||||
|
r.get::<_, String>(3)?,
|
||||||
|
r.get::<_, Option<i64>>(4)?,
|
||||||
|
r.get::<_, f64>(5)?
|
||||||
|
))
|
||||||
|
})
|
||||||
|
.unwrap()
|
||||||
|
.map(Result::unwrap)
|
||||||
|
.collect();
|
||||||
|
(statuses, rows)
|
||||||
|
}
|
||||||
|
|
||||||
|
fn main() {
|
||||||
|
let repack = PathBuf::from(std::env::args().nth(1).expect("repack folder"));
|
||||||
|
let work = tempfile::tempdir().unwrap();
|
||||||
|
|
||||||
|
// 1
|
||||||
|
let (a, b) = (spool(&work.path().join("python")), spool(&work.path().join("rust")));
|
||||||
|
let py_calls = python(&repack, &a, 1000.0);
|
||||||
|
let rs_calls = rust(&b, 1000.0);
|
||||||
|
println!("python posted {py_calls:?}\nrust posted {rs_calls:?}");
|
||||||
|
assert_eq!(py_calls, rs_calls, "the same reports are posted");
|
||||||
|
let (pa, pb) = (snapshot(&a), snapshot(&b));
|
||||||
|
for s in &pa.0 {
|
||||||
|
println!(" {} = {}", s.0, s.1.trim());
|
||||||
|
}
|
||||||
|
assert_eq!(pa, pb, "the same statuses and journal");
|
||||||
|
|
||||||
|
|
||||||
|
// 2: each continues the other's journal. Before the retry times nothing is sent again; after them only the
|
||||||
|
// rate-limited report is (created, rejected and uncertain ones never are).
|
||||||
|
assert!(python(&repack, &b, 1000.0).is_empty(), "Python does not resend what Rust handled");
|
||||||
|
assert!(rust(&a, 1000.0).is_empty(), "Rust does not resend what Python handled");
|
||||||
|
// Later passes: the queued reports go out, a refused or uncertain one never again.
|
||||||
|
for start in [5000.0, 6000.0, 7000.0] {
|
||||||
|
let (p, r) = (python(&repack, &b, start), rust(&a, start));
|
||||||
|
println!("at {start}: python on rust's journal posted {p:?}, rust on python's posted {r:?}");
|
||||||
|
assert_eq!(p, r, "the same retries");
|
||||||
|
assert!(!p.iter().any(|t| t == "Quest broken" || t == "Unknown outcome"), "created and uncertain are final");
|
||||||
|
}
|
||||||
|
assert_eq!(snapshot(&a), snapshot(&b), "the same after a retry by the other relay");
|
||||||
|
for dir in [&a, &b] {
|
||||||
|
let db = rusqlite::Connection::open(dir.join("relay.sqlite3")).unwrap();
|
||||||
|
db.execute("UPDATE deliveries SET state='posting' WHERE key='9-00000000000000b2'", []).unwrap();
|
||||||
|
}
|
||||||
|
python(&repack, &b, 9000.0);
|
||||||
|
rust(&a, 9000.0);
|
||||||
|
for dir in [&a, &b] {
|
||||||
|
let db = rusqlite::Connection::open(dir.join("relay.sqlite3")).unwrap();
|
||||||
|
let state: String = db.query_row("SELECT state FROM deliveries WHERE key='9-00000000000000b2'", [], |r| r.get(0)).unwrap();
|
||||||
|
assert_eq!(state, "uncertain", "an interrupted post is not retried ({})", dir.display());
|
||||||
|
}
|
||||||
|
assert_eq!(snapshot(&a), snapshot(&b), "still the same after the crossover");
|
||||||
|
println!("PASS: relay journals, statuses and posts are the same in Python and Rust");
|
||||||
|
}
|
||||||
@@ -0,0 +1,103 @@
|
|||||||
|
//! SQUID database provisioning in Rust gives exactly what Scripts/squid_playerbots.py gives, on a DISPOSABLE repack:
|
||||||
|
//! the same journals (coa_squid_migrations, coa_squid_pending) in every schema, the same acore_playerbots tables
|
||||||
|
//! with the same row counts, the same playerbots.conf. Each side starts from the same state (SQUID never
|
||||||
|
//! provisioned), and a second run of each must change nothing.
|
||||||
|
//!
|
||||||
|
//! usage: squid_equivalence <fixture ending in -fixture> <coa-launcher.exe>
|
||||||
|
use std::path::Path;
|
||||||
|
use std::process::Command;
|
||||||
|
|
||||||
|
use coa_core::launcher::{services, squid};
|
||||||
|
|
||||||
|
fn sql(root: &Path, q: &str) -> String {
|
||||||
|
services::mysql(root, Some(q), None).unwrap_or_else(|e| panic!("{q}: {e}"))
|
||||||
|
}
|
||||||
|
|
||||||
|
/// What provisioning leaves behind, comparable between runs.
|
||||||
|
fn snapshot(root: &Path) -> String {
|
||||||
|
let mut out = Vec::new();
|
||||||
|
for schema in ["acore_characters", "acore_world", "acore_playerbots"] {
|
||||||
|
let tables = sql(root, &format!("SELECT TABLE_NAME FROM information_schema.TABLES WHERE TABLE_SCHEMA='{schema}' ORDER BY TABLE_NAME;"));
|
||||||
|
for t in tables.lines() {
|
||||||
|
if schema != "acore_playerbots" && !t.starts_with("coa_squid") {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
let n = sql(root, &format!("SELECT COUNT(*) FROM `{schema}`.`{t}`;"));
|
||||||
|
out.push(format!("{schema}.{t} rows={n}"));
|
||||||
|
if t == "coa_squid_migrations" || t == "coa_squid_pending" {
|
||||||
|
for row in sql(root, &format!("SELECT path, sha256 FROM `{schema}`.`{t}` ORDER BY path;")).lines() {
|
||||||
|
out.push(format!(" {row}"));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
let conf = std::fs::read_to_string(root.join("Core/configs/modules/playerbots.conf")).unwrap();
|
||||||
|
out.push(format!("playerbots.conf:\n{}", conf.replace("\r\n", "\n")));
|
||||||
|
out.join("\n")
|
||||||
|
}
|
||||||
|
|
||||||
|
fn reset(root: &Path, conf: &[u8]) {
|
||||||
|
sql(root, "DROP DATABASE IF EXISTS acore_playerbots;");
|
||||||
|
for schema in ["acore_characters", "acore_world"] {
|
||||||
|
sql(root, &format!("DROP TABLE IF EXISTS `{schema}`.coa_squid_migrations, `{schema}`.coa_squid_pending;"));
|
||||||
|
}
|
||||||
|
std::fs::write(root.join("Core/configs/modules/playerbots.conf"), conf).unwrap();
|
||||||
|
}
|
||||||
|
|
||||||
|
fn python(root: &Path) {
|
||||||
|
let harness = root.join(".state/squid_harness.py");
|
||||||
|
std::fs::write(
|
||||||
|
&harness,
|
||||||
|
"import sys, pathlib\nroot = pathlib.Path(sys.argv[1])\nsys.path.insert(0, str(root / 'Scripts'))\nsys.argv = ['manage.py']\nimport manage\nfrom squid_playerbots import prepare_playerbots\nprepare_playerbots(manage.ROOT, manage.settings(), manage.mysql)\n",
|
||||||
|
)
|
||||||
|
.unwrap();
|
||||||
|
let out = Command::new(root.join("Runtime/python/python.exe")).arg("-B").arg(&harness).arg(root).output().unwrap();
|
||||||
|
assert!(out.status.success(), "python: {}{}", String::from_utf8_lossy(&out.stdout), String::from_utf8_lossy(&out.stderr));
|
||||||
|
print!("{}", String::from_utf8_lossy(&out.stdout));
|
||||||
|
}
|
||||||
|
|
||||||
|
fn rust(root: &Path) {
|
||||||
|
let cfg = coa_core::launcher::Settings::load(root, 0).unwrap();
|
||||||
|
squid::prepare_playerbots(root, cfg.mysql_port, &|q| services::mysql(root, Some(q), None), &|m| println!("{m}")).unwrap();
|
||||||
|
}
|
||||||
|
|
||||||
|
fn main() {
|
||||||
|
let a: Vec<String> = std::env::args().skip(1).collect();
|
||||||
|
let root = Path::new(&a[0]);
|
||||||
|
let exe = Path::new(&a[1]);
|
||||||
|
assert!(a[0].ends_with("-fixture"));
|
||||||
|
let modules = root.join("Core/configs/modules");
|
||||||
|
// SQUID on, Companions off
|
||||||
|
let companions = std::fs::read_to_string(modules.join("mod_coa_playerbots.conf")).unwrap();
|
||||||
|
std::fs::write(modules.join("mod_coa_playerbots.conf"), companions.replace("CoaBots.Enable = 1", "CoaBots.Enable = 0")).unwrap();
|
||||||
|
let squid_conf = std::fs::read_to_string(modules.join("playerbots.conf")).unwrap().replace("AiPlayerbot.Enabled = 0", "AiPlayerbot.Enabled = 1");
|
||||||
|
let r = root.to_string_lossy().into_owned();
|
||||||
|
let started = Command::new(exe).args(["--root", &r, "start-mysql"]).output().unwrap();
|
||||||
|
assert!(started.status.success(), "{}", String::from_utf8_lossy(&started.stderr));
|
||||||
|
|
||||||
|
reset(root, squid_conf.as_bytes());
|
||||||
|
let t = std::time::Instant::now();
|
||||||
|
python(root);
|
||||||
|
println!("python provisioned in {:?}", t.elapsed());
|
||||||
|
let by_python = snapshot(root);
|
||||||
|
python(root);
|
||||||
|
assert_eq!(snapshot(root), by_python, "a second Python run changed something");
|
||||||
|
|
||||||
|
reset(root, squid_conf.as_bytes());
|
||||||
|
let t = std::time::Instant::now();
|
||||||
|
rust(root);
|
||||||
|
println!("rust provisioned in {:?}", t.elapsed());
|
||||||
|
let by_rust = snapshot(root);
|
||||||
|
rust(root);
|
||||||
|
assert_eq!(snapshot(root), by_rust, "a second Rust run changed something");
|
||||||
|
|
||||||
|
if by_python != by_rust {
|
||||||
|
std::fs::write(root.join(".state/squid-python.txt"), &by_python).unwrap();
|
||||||
|
std::fs::write(root.join(".state/squid-rust.txt"), &by_rust).unwrap();
|
||||||
|
panic!("Rust and Python differ: see .state/squid-python.txt and squid-rust.txt");
|
||||||
|
}
|
||||||
|
println!("{} lines of journal/table/config state are identical", by_rust.lines().count());
|
||||||
|
let stopped = Command::new(exe).args(["--root", &r, "stop-all"]).output().unwrap();
|
||||||
|
assert!(stopped.status.success());
|
||||||
|
println!("SQUID EQUIVALENCE PASS");
|
||||||
|
}
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
use coa_core::{backup, schema_check, Result};
|
||||||
|
fn main()->Result<()> {
|
||||||
|
let root=std::path::PathBuf::from(std::env::args().nth(1).unwrap());
|
||||||
|
let contract=std::path::PathBuf::from(std::env::args().nth(2).unwrap());
|
||||||
|
assert!(root.join("recovery-e2e-started").is_file());
|
||||||
|
assert!(contract.join(".release-schema-fixture").is_file());
|
||||||
|
backup::with_database(&root,|db| {for p in schema_check::check(db,&contract)? {println!("{}.{}.{}: {}",p.database,p.table,p.column,p.detail);} Ok(())})
|
||||||
|
}
|
||||||
@@ -0,0 +1,132 @@
|
|||||||
|
use base64::{engine::general_purpose::STANDARD, Engine};
|
||||||
|
use coa_core::{
|
||||||
|
backup,
|
||||||
|
driver::{self, Verb},
|
||||||
|
fsx,
|
||||||
|
manifest::{Kind, Migration},
|
||||||
|
package::{self, BuildOptions},
|
||||||
|
pkgsource::Source,
|
||||||
|
update::{self, RepackEnv},
|
||||||
|
Result,
|
||||||
|
};
|
||||||
|
use ed25519_dalek::{Signer, SigningKey};
|
||||||
|
use std::{collections::BTreeMap, path::PathBuf};
|
||||||
|
fn main() -> Result<()> {
|
||||||
|
let root = PathBuf::from(std::env::args().nth(1).unwrap());
|
||||||
|
let core = PathBuf::from(std::env::args().nth(2).unwrap());
|
||||||
|
let release = PathBuf::from(std::env::args().nth(3).unwrap());
|
||||||
|
assert!(root.join("recovery-e2e-started").is_file());
|
||||||
|
let result = std::panic::catch_unwind(|| -> Result<()> {
|
||||||
|
let meta = coa_core::registry::metadata_dir_for(&root)?;
|
||||||
|
let source = root.join("schema-sync-source-v2");
|
||||||
|
let pkg = root.join("schema-sync-package-v2");
|
||||||
|
assert!(!pkg.exists());
|
||||||
|
fsx::atomic_write(
|
||||||
|
&source.join("Core/schema-sync-proof.txt"),
|
||||||
|
b"official schema migration acceptance",
|
||||||
|
)?;
|
||||||
|
let published =
|
||||||
|
coa_core::manifest::Manifest::parse(&std::fs::read(release.join("manifest.json"))?)?;
|
||||||
|
let contract_path = PathBuf::from("C:/games/source/coa-schema-fixture-stability-upgrade-76-85-20261030/Scripts/database-schema.json");
|
||||||
|
let contract = std::fs::read(contract_path)?;
|
||||||
|
let expected = published
|
||||||
|
.files
|
||||||
|
.iter()
|
||||||
|
.find(|f| f.path == "Scripts/database-schema.json")
|
||||||
|
.unwrap();
|
||||||
|
assert_eq!(fsx::sha256_bytes(&contract), expected.sha256);
|
||||||
|
fsx::atomic_write(&source.join("Scripts/database-schema.json"), &contract)?;
|
||||||
|
let mut migrations: Vec<Migration> = Vec::new();
|
||||||
|
for id in [
|
||||||
|
"rev_1793212891571528600",
|
||||||
|
"rev_20261027_18_coa_strange_piece_of_scrap_faction_diamond",
|
||||||
|
] {
|
||||||
|
let m = published
|
||||||
|
.migrations
|
||||||
|
.iter()
|
||||||
|
.find(|m| m.id == id)
|
||||||
|
.unwrap()
|
||||||
|
.clone();
|
||||||
|
let sql = std::fs::read(
|
||||||
|
core.join(format!("data/sql/updates/pending_db_{}/{}.sql", m.db, m.id)),
|
||||||
|
)?;
|
||||||
|
assert_eq!(fsx::sha256_bytes(&sql), m.sha256);
|
||||||
|
fsx::atomic_write(
|
||||||
|
&source.join(format!("_migrations/{}/{}.sql", m.db, m.id)),
|
||||||
|
&sql,
|
||||||
|
)?;
|
||||||
|
migrations.push(m);
|
||||||
|
}
|
||||||
|
package::build(
|
||||||
|
&source,
|
||||||
|
&pkg,
|
||||||
|
&BuildOptions {
|
||||||
|
kind: Kind::Update,
|
||||||
|
version: "3.0.0".into(),
|
||||||
|
core_commit: None,
|
||||||
|
bots_commit: None,
|
||||||
|
built_at: "private native fixture schema sync".into(),
|
||||||
|
part_size: 1 << 20,
|
||||||
|
migrations,
|
||||||
|
},
|
||||||
|
&|_| {},
|
||||||
|
)?;
|
||||||
|
let key = SigningKey::generate(&mut rand_core::OsRng);
|
||||||
|
fsx::atomic_write(
|
||||||
|
&pkg.join("manifest.json.sig"),
|
||||||
|
STANDARD
|
||||||
|
.encode(
|
||||||
|
key.sign(&std::fs::read(pkg.join("manifest.json"))?)
|
||||||
|
.to_bytes(),
|
||||||
|
)
|
||||||
|
.as_bytes(),
|
||||||
|
)?;
|
||||||
|
let trusted = STANDARD.encode(key.verifying_key().to_bytes());
|
||||||
|
let env = RepackEnv {
|
||||||
|
root: &root,
|
||||||
|
meta_dir: &meta,
|
||||||
|
};
|
||||||
|
let out = update::apply(
|
||||||
|
&update::Params {
|
||||||
|
root: &root,
|
||||||
|
meta_dir: &meta,
|
||||||
|
source: Source::Dir(pkg),
|
||||||
|
trusted_key: &trusted,
|
||||||
|
cancel: Default::default(),
|
||||||
|
resolutions: BTreeMap::from([(
|
||||||
|
"Scripts/database-schema.json".into(),
|
||||||
|
update::Resolution::Replace,
|
||||||
|
)]),
|
||||||
|
env: &env,
|
||||||
|
fail_after_ops: None,
|
||||||
|
},
|
||||||
|
&|step, pct| println!("{pct}% {step}"),
|
||||||
|
)?;
|
||||||
|
assert_eq!(out.txn.state, update::State::Committed);
|
||||||
|
backup::with_database(&root, |db| {
|
||||||
|
assert_eq!(
|
||||||
|
db.query("SELECT name,at_login FROM acore_characters.characters WHERE guid=3030;")?
|
||||||
|
.trim(),
|
||||||
|
"Christian Shadowheart\t1"
|
||||||
|
);
|
||||||
|
assert_eq!(
|
||||||
|
db.query("SELECT id FROM acore_characters.manager_recovery_probe;")?
|
||||||
|
.trim(),
|
||||||
|
"42"
|
||||||
|
);
|
||||||
|
assert_eq!(
|
||||||
|
db.query("SELECT id FROM acore_world.manager_recovery_probe;")?
|
||||||
|
.trim(),
|
||||||
|
"44"
|
||||||
|
);
|
||||||
|
Ok(())
|
||||||
|
})?;
|
||||||
|
println!("PASS: the exact two published migrations brought the old fixture schema forward through the Manager updater while preserving the rejected companion and recovery probes");
|
||||||
|
Ok(())
|
||||||
|
});
|
||||||
|
let stop = driver::run(&root, Verb::StopAll)?;
|
||||||
|
assert!(stop.ok, "{}", stop.output);
|
||||||
|
result.map_err(|_| {
|
||||||
|
coa_core::Error::Invalid("Schema sync acceptance failed; fixture stopped".into())
|
||||||
|
})?
|
||||||
|
}
|
||||||
@@ -0,0 +1,166 @@
|
|||||||
|
use base64::{engine::general_purpose::STANDARD, Engine};
|
||||||
|
use coa_core::{
|
||||||
|
backup, driver, fsx,
|
||||||
|
manifest::{Kind, Migration},
|
||||||
|
package::{self, BuildOptions},
|
||||||
|
pkgsource::Source,
|
||||||
|
registry::MetaDir,
|
||||||
|
update::{self, RepackEnv},
|
||||||
|
Result,
|
||||||
|
};
|
||||||
|
use ed25519_dalek::{Signer, SigningKey};
|
||||||
|
use std::{collections::BTreeMap, path::PathBuf};
|
||||||
|
|
||||||
|
fn main() -> Result<()> {
|
||||||
|
let root = PathBuf::from(
|
||||||
|
std::env::args()
|
||||||
|
.nth(1)
|
||||||
|
.expect("disposable recovery fixture"),
|
||||||
|
);
|
||||||
|
assert!(root
|
||||||
|
.file_name()
|
||||||
|
.unwrap()
|
||||||
|
.to_string_lossy()
|
||||||
|
.starts_with("coa-update-recovery-fixture-"));
|
||||||
|
assert!(root.join("recovery-e2e-started").is_file());
|
||||||
|
let cycles_only = std::env::args().nth(2).as_deref() == Some("--cycles-only");
|
||||||
|
if !cycles_only {
|
||||||
|
assert!(!root.join("success-e2e-started").exists());
|
||||||
|
fsx::atomic_write(
|
||||||
|
&root.join("success-e2e-started"),
|
||||||
|
b"disposable success acceptance",
|
||||||
|
)?;
|
||||||
|
}
|
||||||
|
let result = std::panic::catch_unwind(std::panic::AssertUnwindSafe(|| {
|
||||||
|
if cycles_only {
|
||||||
|
restart_cycles(&root)
|
||||||
|
} else {
|
||||||
|
exercise(&root)
|
||||||
|
}
|
||||||
|
}));
|
||||||
|
assert!(
|
||||||
|
driver::run(&root, driver::Verb::StopAll)?.ok,
|
||||||
|
"fixture shutdown"
|
||||||
|
);
|
||||||
|
result.map_err(|_| {
|
||||||
|
coa_core::Error::Invalid(
|
||||||
|
"Success acceptance assertion failed; fixture services stopped".into(),
|
||||||
|
)
|
||||||
|
})?
|
||||||
|
}
|
||||||
|
|
||||||
|
fn exercise(root: &std::path::Path) -> Result<()> {
|
||||||
|
let meta = coa_core::registry::metadata_dir_for(root)?;
|
||||||
|
assert!(update::unfinished(&meta).is_none());
|
||||||
|
assert!(driver::run(root, driver::Verb::StopAll)?.ok);
|
||||||
|
let source = root.join("success-source");
|
||||||
|
let pkg = root.join("success-package");
|
||||||
|
fsx::atomic_write(
|
||||||
|
&source.join("Core/stabilization-success.txt"),
|
||||||
|
b"verified update",
|
||||||
|
)?;
|
||||||
|
let sql = b"UPDATE manager_recovery_probe SET id=44 WHERE id=43;";
|
||||||
|
fsx::atomic_write(
|
||||||
|
&source.join("_migrations/world/stabilization_success.sql"),
|
||||||
|
sql,
|
||||||
|
)?;
|
||||||
|
let manifest = package::build(
|
||||||
|
&source,
|
||||||
|
&pkg,
|
||||||
|
&BuildOptions {
|
||||||
|
kind: Kind::Update,
|
||||||
|
version: "2.0.0".into(),
|
||||||
|
core_commit: None,
|
||||||
|
bots_commit: None,
|
||||||
|
built_at: "disposable acceptance".into(),
|
||||||
|
part_size: 1 << 20,
|
||||||
|
migrations: vec![Migration {
|
||||||
|
id: "stabilization_success".into(),
|
||||||
|
db: "world".into(),
|
||||||
|
sha256: fsx::sha256_bytes(sql),
|
||||||
|
compatible_sha256: vec![],
|
||||||
|
destructive: false,
|
||||||
|
}],
|
||||||
|
},
|
||||||
|
&|_| {},
|
||||||
|
)?;
|
||||||
|
let key = SigningKey::generate(&mut rand_core::OsRng);
|
||||||
|
fsx::atomic_write(
|
||||||
|
&pkg.join("manifest.json.sig"),
|
||||||
|
STANDARD
|
||||||
|
.encode(
|
||||||
|
key.sign(&std::fs::read(pkg.join("manifest.json"))?)
|
||||||
|
.to_bytes(),
|
||||||
|
)
|
||||||
|
.as_bytes(),
|
||||||
|
)?;
|
||||||
|
let trusted = STANDARD.encode(key.verifying_key().to_bytes());
|
||||||
|
let env = RepackEnv {
|
||||||
|
root,
|
||||||
|
meta_dir: &meta,
|
||||||
|
};
|
||||||
|
let outcome = update::apply(
|
||||||
|
&update::Params {
|
||||||
|
root,
|
||||||
|
meta_dir: &meta,
|
||||||
|
source: Source::Dir(pkg),
|
||||||
|
trusted_key: &trusted,
|
||||||
|
cancel: Default::default(),
|
||||||
|
resolutions: BTreeMap::new(),
|
||||||
|
env: &env,
|
||||||
|
fail_after_ops: None,
|
||||||
|
},
|
||||||
|
&|step, pct| println!("{pct}% {step}"),
|
||||||
|
)?;
|
||||||
|
assert_eq!(outcome.txn.state, update::State::Committed);
|
||||||
|
assert_eq!(
|
||||||
|
MetaDir::open(&meta)?.1.core.version.as_deref(),
|
||||||
|
Some("2.0.0")
|
||||||
|
);
|
||||||
|
assert!(update::unfinished(&meta).is_none());
|
||||||
|
assert_eq!(
|
||||||
|
std::fs::read(root.join("Core/stabilization-success.txt"))?,
|
||||||
|
b"verified update"
|
||||||
|
);
|
||||||
|
backup::with_database(root, |db| {
|
||||||
|
assert_eq!(
|
||||||
|
db.query("SELECT id FROM acore_characters.manager_recovery_probe;")?,
|
||||||
|
"42"
|
||||||
|
);
|
||||||
|
assert_eq!(
|
||||||
|
db.query("SELECT id FROM acore_characters.manager_recovery_view;")?,
|
||||||
|
"42"
|
||||||
|
);
|
||||||
|
assert_eq!(
|
||||||
|
db.query("SELECT id FROM acore_world.manager_recovery_probe;")?,
|
||||||
|
"44"
|
||||||
|
);
|
||||||
|
assert!(coa_core::migrations::status(db, &manifest.migrations)?
|
||||||
|
.iter()
|
||||||
|
.all(|m| m.status == coa_core::migrations::Status::Applied));
|
||||||
|
Ok(())
|
||||||
|
})?;
|
||||||
|
restart_cycles(root)?;
|
||||||
|
println!("PASS: signed update committed after failed rehearsal and recovery; SQL, files, metadata and player data verified; two native restart cycles passed");
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
fn restart_cycles(root: &std::path::Path) -> Result<()> {
|
||||||
|
for cycle in 0..2 {
|
||||||
|
let stopped = driver::run(root, driver::Verb::StopAll)?;
|
||||||
|
assert!(
|
||||||
|
stopped.ok,
|
||||||
|
"Stop cycle {cycle}: {}",
|
||||||
|
coa_core::diag::redact(&stopped.output)
|
||||||
|
);
|
||||||
|
let started = driver::run(root, driver::Verb::StartAll)?;
|
||||||
|
assert!(started.ok, "{}", started.output);
|
||||||
|
let pop = coa_core::population::query(root)?;
|
||||||
|
println!(
|
||||||
|
"Restart cycle {cycle}: world ready, players={}, bots={}",
|
||||||
|
pop.players_online, pop.bots_online
|
||||||
|
);
|
||||||
|
}
|
||||||
|
println!("PASS: two native restart cycles finished");
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
@@ -30,15 +30,27 @@ fn main() -> Result<()> {
|
|||||||
.unwrap()
|
.unwrap()
|
||||||
.to_string_lossy()
|
.to_string_lossy()
|
||||||
.starts_with("coa-update-recovery-fixture-"));
|
.starts_with("coa-update-recovery-fixture-"));
|
||||||
|
let resume = std::env::args().nth(2).as_deref() == Some("--verify-recovered");
|
||||||
|
let result = std::panic::catch_unwind(std::panic::AssertUnwindSafe(|| {
|
||||||
|
if resume {
|
||||||
|
assert!(root.join("recovery-e2e-started").is_file());
|
||||||
|
let manifest = coa_core::manifest::Manifest::parse(&std::fs::read(
|
||||||
|
root.join("fixture-package/manifest.json"),
|
||||||
|
)?)?;
|
||||||
|
verify_recovered(&root, &manifest)
|
||||||
|
} else {
|
||||||
assert!(
|
assert!(
|
||||||
!root.join("recovery-e2e-started").exists(),
|
!root.join("recovery-e2e-started").exists(),
|
||||||
"Use a new fixture; never reuse an owned server"
|
"Use a new fixture"
|
||||||
);
|
);
|
||||||
fsx::atomic_write(&root.join("recovery-e2e-started"), b"disposable fixture")?;
|
fsx::atomic_write(&root.join("recovery-e2e-started"), b"disposable fixture")?;
|
||||||
let result = exercise(&root);
|
exercise(&root)
|
||||||
let stopped = driver::run(&root, Verb::StopAll)?;
|
}
|
||||||
assert!(stopped.ok);
|
}));
|
||||||
result
|
assert!(driver::run(&root, Verb::StopAll)?.ok);
|
||||||
|
result.map_err(|_| {
|
||||||
|
Error::Invalid("Recovery acceptance assertion failed; owned services were stopped".into())
|
||||||
|
})?
|
||||||
}
|
}
|
||||||
|
|
||||||
fn exercise(root: &Path) -> Result<()> {
|
fn exercise(root: &Path) -> Result<()> {
|
||||||
@@ -122,9 +134,18 @@ fn exercise(root: &Path) -> Result<()> {
|
|||||||
assert!(
|
assert!(
|
||||||
error
|
error
|
||||||
.to_string()
|
.to_string()
|
||||||
.contains("private update rehearsal failed"),
|
.contains("files and databases were restored to the recovery point"),
|
||||||
"{error}"
|
"{error}"
|
||||||
);
|
);
|
||||||
|
verify_recovered(root, &manifest)
|
||||||
|
}
|
||||||
|
|
||||||
|
fn verify_recovered(root: &Path, manifest: &coa_core::manifest::Manifest) -> Result<()> {
|
||||||
|
let meta = coa_core::registry::metadata_dir_for(root)?;
|
||||||
|
let env = RepackEnv {
|
||||||
|
root,
|
||||||
|
meta_dir: &meta,
|
||||||
|
};
|
||||||
assert!(!root.join("Core/recovery-probe.txt").exists());
|
assert!(!root.join("Core/recovery-probe.txt").exists());
|
||||||
assert!(update::unfinished(&meta).is_none());
|
assert!(update::unfinished(&meta).is_none());
|
||||||
assert_eq!(
|
assert_eq!(
|
||||||
@@ -168,6 +189,6 @@ fn exercise(root: &Path) -> Result<()> {
|
|||||||
Db::from_repack(root, Account::Admin)?.realm(),
|
Db::from_repack(root, Account::Admin)?.realm(),
|
||||||
coa_core::realms::Mode::Coa
|
coa_core::realms::Mode::Coa
|
||||||
);
|
);
|
||||||
println!("PASS: private rehearsal caught failed SQL before changing the installed world, characters, ledger, objects, files or version; complete recovery succeeded");
|
println!("PASS: failed SQL was rolled back; characters, world, ledger, views, triggers, routines, files and version were verified; the saved recovery point was restored again");
|
||||||
Ok(())
|
Ok(())
|
||||||
}
|
}
|
||||||
@@ -1,15 +1,37 @@
|
|||||||
//! Exercise the production updater only on a disposable copy of an installed server.
|
//! Exercise the production updater only on a disposable copy of an installed server.
|
||||||
use coa_core::{registry::MetaDir, update::{self, Env, RepackEnv}};
|
use coa_core::{
|
||||||
|
registry::MetaDir,
|
||||||
|
update::{self, Env, RepackEnv},
|
||||||
|
};
|
||||||
fn main() -> Result<(), Box<dyn std::error::Error>> {
|
fn main() -> Result<(), Box<dyn std::error::Error>> {
|
||||||
let args: Vec<_> = std::env::args().collect();
|
let args: Vec<_> = std::env::args().collect();
|
||||||
if args.len()!=3 && args.len()!=4 {return Err("usage: upgrade_fixture <disposable-root> <signed-package-directory>".into());}
|
if args.len() != 3 && args.len() != 4 {
|
||||||
|
return Err("usage: upgrade_fixture <disposable-root> <signed-package-directory>".into());
|
||||||
|
}
|
||||||
let root = std::path::Path::new(&args[1]);
|
let root = std::path::Path::new(&args[1]);
|
||||||
assert!(root.file_name().unwrap().to_string_lossy().starts_with("coa-schema-fixture-real") && root.join(".coa-update-fixture").is_file(),"Disposable fixture required");
|
assert!(
|
||||||
|
root.file_name()
|
||||||
|
.unwrap()
|
||||||
|
.to_string_lossy()
|
||||||
|
.starts_with("coa-schema-fixture-real")
|
||||||
|
&& root.join(".coa-update-fixture").is_file(),
|
||||||
|
"Disposable fixture required"
|
||||||
|
);
|
||||||
let meta = coa_core::registry::metadata_dir_for(root)?;
|
let meta = coa_core::registry::metadata_dir_for(root)?;
|
||||||
let (_, installed) = MetaDir::open(&meta)?;
|
let (_, installed) = MetaDir::open(&meta)?;
|
||||||
assert_eq!(coa_core::fsx::canonicalize_lenient(std::path::Path::new(&installed.server_path))?,coa_core::fsx::canonicalize_lenient(root)?,"Fixture metadata must point to the copy");
|
assert_eq!(
|
||||||
assert!(installed.client_path.is_none(),"Detach the real client from fixture metadata");
|
coa_core::fsx::canonicalize_lenient(std::path::Path::new(&installed.server_path))?,
|
||||||
let env=RepackEnv{root,meta_dir:&meta};
|
coa_core::fsx::canonicalize_lenient(root)?,
|
||||||
|
"Fixture metadata must point to the copy"
|
||||||
|
);
|
||||||
|
assert!(
|
||||||
|
installed.client_path.is_none(),
|
||||||
|
"Detach the real client from fixture metadata"
|
||||||
|
);
|
||||||
|
let env = RepackEnv {
|
||||||
|
root,
|
||||||
|
meta_dir: &meta,
|
||||||
|
};
|
||||||
if args.get(3).is_some_and(|flag| flag == "--validate-only") {
|
if args.get(3).is_some_and(|flag| flag == "--validate-only") {
|
||||||
let result = env.validate();
|
let result = env.validate();
|
||||||
let _ = coa_core::driver::run(root, coa_core::driver::Verb::StopAll);
|
let _ = coa_core::driver::run(root, coa_core::driver::Verb::StopAll);
|
||||||
@@ -17,7 +39,19 @@ fn main() -> Result<(),Box<dyn std::error::Error>> {
|
|||||||
println!("Startup and identity validation passed");
|
println!("Startup and identity validation passed");
|
||||||
return Ok(());
|
return Ok(());
|
||||||
}
|
}
|
||||||
let outcome=update::apply(&update::Params{root,meta_dir:&meta,source:coa_core::pkgsource::Source::Dir(args[2].clone().into()),trusted_key:coa_core::signing::EMBEDDED_PUBLIC_KEY,cancel:Default::default(),resolutions:Default::default(),env:&env,fail_after_ops:None},&|phase,percent|println!("{percent}% {phase}"));
|
let outcome = update::apply(
|
||||||
|
&update::Params {
|
||||||
|
root,
|
||||||
|
meta_dir: &meta,
|
||||||
|
source: coa_core::pkgsource::Source::Dir(args[2].clone().into()),
|
||||||
|
trusted_key: coa_core::signing::EMBEDDED_PUBLIC_KEY,
|
||||||
|
cancel: Default::default(),
|
||||||
|
resolutions: Default::default(),
|
||||||
|
env: &env,
|
||||||
|
fail_after_ops: None,
|
||||||
|
},
|
||||||
|
&|phase, percent| println!("{percent}% {phase}"),
|
||||||
|
);
|
||||||
let stopped = coa_core::driver::run(root, coa_core::driver::Verb::StopAll);
|
let stopped = coa_core::driver::run(root, coa_core::driver::Verb::StopAll);
|
||||||
println!("Shutdown after test: {:?}", stopped.map(|r| r.ok));
|
println!("Shutdown after test: {:?}", stopped.map(|r| r.ok));
|
||||||
let outcome = outcome?;
|
let outcome = outcome?;
|
||||||
|
|||||||
@@ -80,6 +80,60 @@ fn upper(name: &str) -> Result<String> {
|
|||||||
Ok(name.to_ascii_uppercase())
|
Ok(name.to_ascii_uppercase())
|
||||||
}
|
}
|
||||||
|
|
||||||
|
pub fn create(root: &Path, name: &str, password: &str, administrator: bool) -> Result<()> {
|
||||||
|
validate_account(name, password)?;
|
||||||
|
let name = name.to_ascii_uppercase();
|
||||||
|
let db = Db::from_repack(root, Account::Admin)?;
|
||||||
|
if db
|
||||||
|
.query(&format!(
|
||||||
|
"SELECT COUNT(*) FROM acore_auth.account WHERE username='{name}';"
|
||||||
|
))?
|
||||||
|
.trim()
|
||||||
|
!= "0"
|
||||||
|
{
|
||||||
|
return Err(Error::Invalid("That account name is already taken.".into()));
|
||||||
|
}
|
||||||
|
let mut ra = Ra::connect(root)?;
|
||||||
|
ra.performance().map_err(|error| Error::Invalid(format!("The server console is not ready for account creation. No create command was sent. {error}")))?;
|
||||||
|
let confirmed = ra.create_account(&name, password);
|
||||||
|
if let Err(error) = confirmed {
|
||||||
|
let stored = db.query(&format!(
|
||||||
|
"SELECT HEX(salt), HEX(verifier) FROM acore_auth.account WHERE username='{name}';"
|
||||||
|
))?;
|
||||||
|
if !matches_credentials(&stored, &name, password) {
|
||||||
|
return Err(Error::Invalid(format!("Account creation was not confirmed. Refresh the account list before retrying. {error}")));
|
||||||
|
}
|
||||||
|
if administrator {
|
||||||
|
ra = Ra::connect(root).map_err(|error| Error::Invalid(format!("The account was created, but administrator access was not confirmed. Refresh the account list and check its access level. {error}")))?;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if administrator {
|
||||||
|
if let Err(error) = ra.make_administrator(&name) {
|
||||||
|
let access = db.query(&format!("SELECT COUNT(*) FROM acore_auth.account_access WHERE id=(SELECT id FROM acore_auth.account WHERE username='{name}') AND gmlevel=3 AND RealmID=-1;"))?;
|
||||||
|
if access.trim() != "1" {
|
||||||
|
return Err(Error::Invalid(format!("The account was created, but administrator access was not confirmed. Refresh the account list and check its access level. {error}")));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
fn matches_credentials(stored: &str, name: &str, password: &str) -> bool {
|
||||||
|
let Some((salt, verifier)) = stored.trim().split_once('\t') else {
|
||||||
|
return false;
|
||||||
|
};
|
||||||
|
let Ok(salt) = hex::decode(salt) else {
|
||||||
|
return false;
|
||||||
|
};
|
||||||
|
let Ok(salt): std::result::Result<[u8; 32], _> = salt.try_into() else {
|
||||||
|
return false;
|
||||||
|
};
|
||||||
|
let Ok(verifier) = hex::decode(verifier) else {
|
||||||
|
return false;
|
||||||
|
};
|
||||||
|
verifier.as_slice() == crate::srp6::verifier(name, password, &salt)
|
||||||
|
}
|
||||||
|
|
||||||
/// Give the account a new name. Needs the world console (the new password is what makes the login work again) and an
|
/// 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.
|
/// 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<()> {
|
pub fn rename(root: &Path, ra: &mut Ra, old: &str, new: &str, password: &str) -> Result<()> {
|
||||||
@@ -165,6 +219,19 @@ pub fn delete(root: &Path, ra: &mut Ra, name: &str) -> Result<()> {
|
|||||||
mod tests {
|
mod tests {
|
||||||
use super::*;
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn lost_reply_requires_the_exact_requested_credentials() {
|
||||||
|
let salt = [42; 32];
|
||||||
|
let verifier = crate::srp6::verifier("NewPlayer", "Password77", &salt);
|
||||||
|
let stored = format!("{}\t{}\n", hex::encode(salt), hex::encode(verifier));
|
||||||
|
assert!(matches_credentials(&stored, "NEWPLAYER", "password77"));
|
||||||
|
assert!(!matches_credentials(&stored, "NEWPLAYER", "wrongpass"));
|
||||||
|
assert!(!matches_credentials(&stored, "OTHERPLAYER", "Password77"));
|
||||||
|
for value in ["", "NULL\tNULL", "00\t00", "malformed"] {
|
||||||
|
assert!(!matches_credentials(value, "NewPlayer", "Password77"));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
fn rows_from_the_client_become_accounts() {
|
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 out = "2\tALICE\t3\t0\t2026-09-30 21:04:11\t4\n5\tBOB\t0\t1\t\t0\n7\tBROKEN\n";
|
||||||
|
|||||||
@@ -0,0 +1,494 @@
|
|||||||
|
//! A catalog of game addons the Manager can install into a client's `Interface/AddOns`.
|
||||||
|
//!
|
||||||
|
//! Every addon is pinned to a commit of its GitHub repository; the catalog lists each file it installs with its
|
||||||
|
//! git blob SHA-1 and size, which are checked after download (GitHub's archives are not byte-stable, their
|
||||||
|
//! contents are). The Manager records what it installed in `Interface/AddOns/.coa-addons.json` and only ever
|
||||||
|
//! removes or replaces those folders; a folder of the same name that someone else put there is moved to
|
||||||
|
//! `Interface/AddOns/.coa-addons-backup` first.
|
||||||
|
|
||||||
|
use std::collections::BTreeMap;
|
||||||
|
use std::fs;
|
||||||
|
use std::io::{Read, Write};
|
||||||
|
use std::path::{Path, PathBuf};
|
||||||
|
|
||||||
|
use serde::{Deserialize, Serialize};
|
||||||
|
use sha1::{Digest, Sha1};
|
||||||
|
|
||||||
|
use crate::download::{Cancel, Transport};
|
||||||
|
use crate::error::{Error, Result};
|
||||||
|
use crate::fsx;
|
||||||
|
|
||||||
|
static CATALOG: &str = include_str!("../../../addons/catalog.json");
|
||||||
|
const STATE: &str = ".coa-addons.json";
|
||||||
|
const BACKUP: &str = ".coa-addons-backup";
|
||||||
|
/// No addon archive is anywhere near this; a larger answer is not what the catalog describes.
|
||||||
|
const MAX_ARCHIVE: u64 = 1 << 30;
|
||||||
|
|
||||||
|
#[derive(Debug, Clone, Deserialize)]
|
||||||
|
struct AddonFile {
|
||||||
|
path: String,
|
||||||
|
from: String,
|
||||||
|
sha1: String,
|
||||||
|
size: u64,
|
||||||
|
}
|
||||||
|
|
||||||
|
#[derive(Debug, Clone, Deserialize)]
|
||||||
|
struct Entry {
|
||||||
|
id: String,
|
||||||
|
name: String,
|
||||||
|
description: BTreeMap<String, String>,
|
||||||
|
author: String,
|
||||||
|
license: String,
|
||||||
|
#[serde(default)]
|
||||||
|
needs: Option<String>,
|
||||||
|
repo: String,
|
||||||
|
commit: String,
|
||||||
|
archive: String,
|
||||||
|
folders: Vec<String>,
|
||||||
|
files: Vec<AddonFile>,
|
||||||
|
}
|
||||||
|
|
||||||
|
#[derive(Deserialize)]
|
||||||
|
struct Catalog {
|
||||||
|
addons: Vec<Entry>,
|
||||||
|
}
|
||||||
|
|
||||||
|
#[derive(Debug, Default, Clone, Serialize, Deserialize)]
|
||||||
|
struct Installed {
|
||||||
|
commit: String,
|
||||||
|
folders: Vec<String>,
|
||||||
|
}
|
||||||
|
|
||||||
|
/// One addon of the catalog as the Manager shows it for a client.
|
||||||
|
#[derive(Debug, Clone, Serialize)]
|
||||||
|
#[serde(rename_all = "camelCase")]
|
||||||
|
pub struct AddonView {
|
||||||
|
pub id: String,
|
||||||
|
pub name: String,
|
||||||
|
pub description: BTreeMap<String, String>,
|
||||||
|
pub author: String,
|
||||||
|
pub license: String,
|
||||||
|
/// A server module the addon is made for (`playerbots`), shown as a hint.
|
||||||
|
pub needs: Option<String>,
|
||||||
|
pub repo: String,
|
||||||
|
pub size: u64,
|
||||||
|
pub installed: bool,
|
||||||
|
pub update_available: bool,
|
||||||
|
/// Folders of this addon that are in the client but were not installed by the Manager.
|
||||||
|
pub foreign_folders: Vec<String>,
|
||||||
|
/// Installed by something else, shown so nobody looks for it twice: `custom-races` (the client patch).
|
||||||
|
pub bundled: Option<String>,
|
||||||
|
}
|
||||||
|
|
||||||
|
fn catalog() -> Result<Vec<Entry>> {
|
||||||
|
let catalog: Catalog = serde_json::from_str(CATALOG)?;
|
||||||
|
for entry in &catalog.addons {
|
||||||
|
for folder in &entry.folders {
|
||||||
|
if folder.is_empty() || folder.contains(['/', '\\']) || folder.starts_with('.') {
|
||||||
|
return Err(Error::Invalid(format!("Invalid addon folder in the catalog: {folder}")));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
Ok(catalog.addons)
|
||||||
|
}
|
||||||
|
|
||||||
|
fn addons_dir(client: &Path) -> PathBuf {
|
||||||
|
client.join("Interface").join("AddOns")
|
||||||
|
}
|
||||||
|
|
||||||
|
fn read_state(client: &Path) -> BTreeMap<String, Installed> {
|
||||||
|
fsx::read_json(&addons_dir(client).join(STATE)).unwrap_or_default()
|
||||||
|
}
|
||||||
|
|
||||||
|
fn write_state(client: &Path, state: &BTreeMap<String, Installed>) -> Result<()> {
|
||||||
|
fsx::atomic_write_json(&addons_dir(client).join(STATE), state)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// The catalog with what is installed in `client`.
|
||||||
|
pub fn list(client: &Path) -> Result<Vec<AddonView>> {
|
||||||
|
let state = read_state(client);
|
||||||
|
let dir = addons_dir(client);
|
||||||
|
let owned: Vec<&String> = state.values().flat_map(|i| i.folders.iter()).collect();
|
||||||
|
Ok(catalog()?
|
||||||
|
.into_iter()
|
||||||
|
.map(|entry| {
|
||||||
|
let installed = state.get(&entry.id);
|
||||||
|
AddonView {
|
||||||
|
foreign_folders: entry
|
||||||
|
.folders
|
||||||
|
.iter()
|
||||||
|
.filter(|f| dir.join(f).exists() && !owned.contains(f))
|
||||||
|
.cloned()
|
||||||
|
.collect(),
|
||||||
|
size: entry.files.iter().map(|f| f.size).sum(),
|
||||||
|
installed: installed.is_some(),
|
||||||
|
update_available: installed.is_some_and(|i| i.commit != entry.commit),
|
||||||
|
id: entry.id,
|
||||||
|
name: entry.name,
|
||||||
|
description: entry.description,
|
||||||
|
author: entry.author,
|
||||||
|
license: entry.license,
|
||||||
|
needs: entry.needs,
|
||||||
|
repo: entry.repo,
|
||||||
|
bundled: None,
|
||||||
|
}
|
||||||
|
})
|
||||||
|
.chain(std::iter::once(dev_menu(&dir)))
|
||||||
|
.collect())
|
||||||
|
}
|
||||||
|
|
||||||
|
/// The /dev menu addon of Custom Races V2: the client patch installs it and switches it with the patch.
|
||||||
|
fn dev_menu(dir: &Path) -> AddonView {
|
||||||
|
let mut description = BTreeMap::new();
|
||||||
|
for (lang, text) in [
|
||||||
|
("en", "The in-game /dev editor for game masters. It comes with the Custom Races V2 client patch and is switched with it."),
|
||||||
|
("ru", "Внутриигровой редактор /dev для гейм-мастеров. Ставится вместе с клиентским патчем Custom Races V2 и включается вместе с ним."),
|
||||||
|
("de", "Der /dev-Editor im Spiel für Spielleiter. Er kommt mit dem Client-Patch Custom Races V2 und wird mit ihm geschaltet."),
|
||||||
|
("fr", "L'éditeur /dev en jeu pour les maîtres du jeu. Il vient avec le patch client Custom Races V2 et s'active avec lui."),
|
||||||
|
("es", "El editor /dev del juego para los máster. Viene con el parche de cliente Custom Races V2 y se activa con él."),
|
||||||
|
("zh", "供游戏管理员使用的游戏内 /dev 编辑器。随 Custom Races V2 客户端补丁安装,并随补丁一起开关。"),
|
||||||
|
] {
|
||||||
|
description.insert(lang.to_string(), text.to_string());
|
||||||
|
}
|
||||||
|
AddonView {
|
||||||
|
id: "coa-dev-menu".into(),
|
||||||
|
name: "CoA Dev Menu".into(),
|
||||||
|
description,
|
||||||
|
author: "ilusixn".into(),
|
||||||
|
license: "see repository".into(),
|
||||||
|
needs: None,
|
||||||
|
repo: "https://github.com/ilusixn/ilusixn-dev-menu".into(),
|
||||||
|
size: 0,
|
||||||
|
installed: dir.join("CoA_DevMenu/CoA_DevMenu.toc").is_file(),
|
||||||
|
update_available: false,
|
||||||
|
foreign_folders: Vec::new(),
|
||||||
|
bundled: Some("custom-races".into()),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// The git blob id of `bytes` (what the catalog records for each file).
|
||||||
|
fn git_blob_sha1(bytes: &[u8]) -> String {
|
||||||
|
let mut hasher = Sha1::new();
|
||||||
|
hasher.update(format!("blob {}\0", bytes.len()).as_bytes());
|
||||||
|
hasher.update(bytes);
|
||||||
|
hex::encode(hasher.finalize())
|
||||||
|
}
|
||||||
|
|
||||||
|
fn download(transport: &dyn Transport, url: &str, dest: &Path, cancel: &Cancel) -> Result<()> {
|
||||||
|
crate::download::check_url(url)?;
|
||||||
|
let reply = transport.get(url, 0).map_err(Error::Invalid)?;
|
||||||
|
if reply.status != 200 {
|
||||||
|
return Err(Error::Invalid(format!("The addon download answered HTTP {}.", reply.status)));
|
||||||
|
}
|
||||||
|
let mut body = reply.body.take(MAX_ARCHIVE + 1);
|
||||||
|
let mut file = fs::File::create(dest)?;
|
||||||
|
let mut buf = vec![0u8; 1 << 20];
|
||||||
|
let mut total = 0u64;
|
||||||
|
loop {
|
||||||
|
if cancel.is_set() {
|
||||||
|
return Err(Error::Invalid("Operation cancelled.".into()));
|
||||||
|
}
|
||||||
|
let n = body.read(&mut buf)?;
|
||||||
|
if n == 0 {
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
total += n as u64;
|
||||||
|
if total > MAX_ARCHIVE {
|
||||||
|
return Err(Error::Invalid("The addon download is larger than any catalog addon.".into()));
|
||||||
|
}
|
||||||
|
file.write_all(&buf[..n])?;
|
||||||
|
}
|
||||||
|
file.sync_all()?;
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Unpack the catalog's files of `entry` from `archive` into `staging`, checking every one.
|
||||||
|
fn unpack(entry: &Entry, archive: &Path, staging: &Path) -> Result<()> {
|
||||||
|
let mut zip = zip::ZipArchive::new(fs::File::open(archive)?)
|
||||||
|
.map_err(|e| Error::Invalid(format!("The addon download is not a zip archive: {e}")))?;
|
||||||
|
// GitHub archives hold everything under one top folder (`<repo>-<commit>/`).
|
||||||
|
let mut by_path = BTreeMap::new();
|
||||||
|
for index in 0..zip.len() {
|
||||||
|
let name = zip
|
||||||
|
.by_index(index)
|
||||||
|
.map_err(|e| Error::Invalid(e.to_string()))?
|
||||||
|
.name()
|
||||||
|
.replace('\\', "/");
|
||||||
|
if let Some((_, inner)) = name.split_once('/') {
|
||||||
|
by_path.insert(inner.to_string(), index);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
for file in &entry.files {
|
||||||
|
let index = *by_path
|
||||||
|
.get(&file.from)
|
||||||
|
.ok_or_else(|| Error::Invalid(format!("The addon download lacks {}.", file.from)))?;
|
||||||
|
let mut zipped = zip.by_index(index).map_err(|e| Error::Invalid(e.to_string()))?;
|
||||||
|
let mut bytes = Vec::with_capacity(file.size as usize);
|
||||||
|
zipped.by_ref().take(file.size + 1).read_to_end(&mut bytes)?;
|
||||||
|
if bytes.len() as u64 != file.size || git_blob_sha1(&bytes) != file.sha1 {
|
||||||
|
return Err(Error::Invalid(format!("{} failed verification.", file.from)));
|
||||||
|
}
|
||||||
|
let target = fsx::safe_join(staging, &file.path)?;
|
||||||
|
if let Some(parent) = target.parent() {
|
||||||
|
fs::create_dir_all(parent)?;
|
||||||
|
}
|
||||||
|
fs::write(target, bytes)?;
|
||||||
|
}
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
fn stamp() -> String {
|
||||||
|
chrono::Local::now().format("%Y%m%d-%H%M%S").to_string()
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Install or update `id` in `client` from `transport`.
|
||||||
|
pub fn install_with(transport: &dyn Transport, client: &Path, id: &str, cancel: &Cancel) -> Result<Vec<AddonView>> {
|
||||||
|
if crate::client::is_running(client) {
|
||||||
|
return Err(Error::Invalid("Close the game before installing addons.".into()));
|
||||||
|
}
|
||||||
|
let entry = catalog()?
|
||||||
|
.into_iter()
|
||||||
|
.find(|e| e.id == id)
|
||||||
|
.ok_or_else(|| Error::Invalid(format!("Unknown addon {id}.")))?;
|
||||||
|
install_entry(transport, client, &entry, cancel)?;
|
||||||
|
list(client)
|
||||||
|
}
|
||||||
|
|
||||||
|
fn install_entry(transport: &dyn Transport, client: &Path, entry: &Entry, cancel: &Cancel) -> Result<()> {
|
||||||
|
let dir = addons_dir(client);
|
||||||
|
fs::create_dir_all(&dir)?;
|
||||||
|
// Staged next to AddOns' own folders, so the final moves stay on one volume even for a linked AddOns.
|
||||||
|
let staging = tempfile::Builder::new().prefix(".coa-addon-").tempdir_in(&dir)?;
|
||||||
|
let archive = staging.path().join("archive.zip");
|
||||||
|
download(transport, &entry.archive, &archive, cancel)?;
|
||||||
|
let unpacked = staging.path().join("files");
|
||||||
|
unpack(entry, &archive, &unpacked)?;
|
||||||
|
if cancel.is_set() {
|
||||||
|
return Err(Error::Invalid("Operation cancelled.".into()));
|
||||||
|
}
|
||||||
|
let mut state = read_state(client);
|
||||||
|
let ours: Vec<String> = state.values().flat_map(|i| i.folders.clone()).collect();
|
||||||
|
// Move what is in the way out first, so a failed move leaves the client as it was.
|
||||||
|
let mut moved: Vec<(PathBuf, PathBuf)> = Vec::new();
|
||||||
|
let undo = |moved: &[(PathBuf, PathBuf)]| {
|
||||||
|
for (from, to) in moved.iter().rev() {
|
||||||
|
let _ = fs::rename(to, from);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
for folder in &entry.folders {
|
||||||
|
let target = dir.join(folder);
|
||||||
|
if !target.exists() {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
let aside = if ours.contains(folder) {
|
||||||
|
staging.path().join("old").join(folder)
|
||||||
|
} else {
|
||||||
|
dir.join(BACKUP).join(format!("{folder}-{}", stamp()))
|
||||||
|
};
|
||||||
|
if let Some(parent) = aside.parent() {
|
||||||
|
fs::create_dir_all(parent)?;
|
||||||
|
}
|
||||||
|
if let Err(e) = fs::rename(&target, &aside) {
|
||||||
|
undo(&moved);
|
||||||
|
return Err(Error::Invalid(format!("{folder} is in use and could not be replaced: {e}")));
|
||||||
|
}
|
||||||
|
moved.push((target, aside));
|
||||||
|
}
|
||||||
|
let mut placed: Vec<PathBuf> = Vec::new();
|
||||||
|
for folder in &entry.folders {
|
||||||
|
let target = dir.join(folder);
|
||||||
|
if let Err(e) = fs::rename(unpacked.join(folder), &target) {
|
||||||
|
for p in &placed {
|
||||||
|
let _ = fs::remove_dir_all(p);
|
||||||
|
}
|
||||||
|
undo(&moved);
|
||||||
|
return Err(Error::Invalid(format!("{folder} could not be installed: {e}")));
|
||||||
|
}
|
||||||
|
placed.push(target);
|
||||||
|
}
|
||||||
|
state.insert(
|
||||||
|
entry.id.clone(),
|
||||||
|
Installed {
|
||||||
|
commit: entry.commit.clone(),
|
||||||
|
folders: entry.folders.clone(),
|
||||||
|
},
|
||||||
|
);
|
||||||
|
write_state(client, &state)?;
|
||||||
|
tracing::info!(addon = %entry.id, commit = %entry.commit, "addon installed");
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
pub fn install(client: &Path, id: &str, cancel: &Cancel) -> Result<Vec<AddonView>> {
|
||||||
|
install_with(&crate::download::HttpTransport::with_total_timeout(1800)?, client, id, cancel)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Remove an addon the Manager installed (only its recorded folders).
|
||||||
|
pub fn remove(client: &Path, id: &str) -> Result<Vec<AddonView>> {
|
||||||
|
if crate::client::is_running(client) {
|
||||||
|
return Err(Error::Invalid("Close the game before removing addons.".into()));
|
||||||
|
}
|
||||||
|
let mut state = read_state(client);
|
||||||
|
let Some(installed) = state.remove(id) else {
|
||||||
|
return list(client);
|
||||||
|
};
|
||||||
|
let dir = addons_dir(client);
|
||||||
|
for folder in &installed.folders {
|
||||||
|
if folder.is_empty() || folder.contains(['/', '\\']) || folder.starts_with('.') {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
let target = dir.join(folder);
|
||||||
|
if target.exists() {
|
||||||
|
fs::remove_dir_all(&target)?;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
write_state(client, &state)?;
|
||||||
|
list(client)
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod tests {
|
||||||
|
use super::*;
|
||||||
|
use crate::download::Reply;
|
||||||
|
|
||||||
|
struct Serve(Vec<u8>);
|
||||||
|
impl Transport for Serve {
|
||||||
|
fn get(&self, _: &str, _: u64) -> std::result::Result<Reply, String> {
|
||||||
|
Ok(Reply { status: 200, content_range: None, body: Box::new(std::io::Cursor::new(self.0.clone())) })
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A GitHub-like archive of the catalog entry `id` with the given file bodies (path in repo -> bytes).
|
||||||
|
fn archive(entry: &Entry, body: &dyn Fn(&AddonFile) -> Vec<u8>) -> Vec<u8> {
|
||||||
|
let mut out = std::io::Cursor::new(Vec::new());
|
||||||
|
let mut zip = zip::ZipWriter::new(&mut out);
|
||||||
|
for file in &entry.files {
|
||||||
|
zip.start_file(format!("repo-{}/{}", entry.commit, file.from), zip::write::SimpleFileOptions::default())
|
||||||
|
.unwrap();
|
||||||
|
zip.write_all(&body(file)).unwrap();
|
||||||
|
}
|
||||||
|
zip.finish().unwrap();
|
||||||
|
out.into_inner()
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A small catalog entry whose files hash to what the archive will hold.
|
||||||
|
fn small_entry() -> Entry {
|
||||||
|
let bytes = b"## Interface: 30300\n".to_vec();
|
||||||
|
Entry {
|
||||||
|
id: "t".into(),
|
||||||
|
name: "T".into(),
|
||||||
|
description: BTreeMap::new(),
|
||||||
|
author: "a".into(),
|
||||||
|
license: "x".into(),
|
||||||
|
needs: None,
|
||||||
|
repo: "r".into(),
|
||||||
|
commit: "c1".into(),
|
||||||
|
archive: "https://example.invalid/a.zip".into(),
|
||||||
|
folders: vec!["TestAddon".into()],
|
||||||
|
files: vec![AddonFile {
|
||||||
|
path: "TestAddon/TestAddon.toc".into(),
|
||||||
|
from: "TestAddon/TestAddon.toc".into(),
|
||||||
|
sha1: git_blob_sha1(&bytes),
|
||||||
|
size: bytes.len() as u64,
|
||||||
|
}],
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn the_catalog_is_valid_and_pins_every_addon() {
|
||||||
|
let entries = catalog().unwrap();
|
||||||
|
assert!(entries.len() >= 4);
|
||||||
|
let views = list(Path::new("C:/no-such-client")).unwrap();
|
||||||
|
assert_eq!(views.iter().filter(|v| v.bundled.is_some()).count(), 1, "the dev menu is shown, not installable");
|
||||||
|
for e in &entries {
|
||||||
|
assert_eq!(e.commit.len(), 40, "{}", e.id);
|
||||||
|
assert!(e.archive.starts_with("https://codeload.github.com/") && e.archive.ends_with(&e.commit));
|
||||||
|
assert!(e.description.contains_key("en") && e.description.contains_key("ru"));
|
||||||
|
for folder in &e.folders {
|
||||||
|
assert!(e.files.iter().any(|f| f.path.eq_ignore_ascii_case(&format!("{folder}/{folder}.toc"))
|
||||||
|
|| f.path.starts_with(&format!("{folder}/")) && f.path.ends_with(".toc")), "{folder} has no toc");
|
||||||
|
}
|
||||||
|
for f in &e.files {
|
||||||
|
fsx::safe_join(Path::new("C:/x"), &f.path).unwrap();
|
||||||
|
assert!(e.folders.iter().any(|folder| f.path.starts_with(&format!("{folder}/"))));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
#[ignore = "Downloads the catalog's small addons from GitHub"]
|
||||||
|
fn the_real_catalog_installs_from_github() {
|
||||||
|
let client = tempfile::tempdir().unwrap();
|
||||||
|
for id in ["incahoots", "coacombat", "squidbots-lite"] {
|
||||||
|
let views = install(client.path(), id, &Cancel::default()).unwrap();
|
||||||
|
let view = views.iter().find(|v| v.id == id).unwrap();
|
||||||
|
assert!(view.installed && !view.update_available, "{id}");
|
||||||
|
}
|
||||||
|
assert!(addons_dir(client.path()).join("IncahootsCoA/IncahootsCoA.toc").is_file());
|
||||||
|
assert!(addons_dir(client.path()).join("SquidBotsLite/SquidBotsLite.toc").is_file());
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn git_blob_ids_match_git() {
|
||||||
|
// `printf 'hello\n' | git hash-object --stdin`
|
||||||
|
assert_eq!(git_blob_sha1(b"hello\n"), "ce013625030ba8dba906f756967f9e9ca394464a");
|
||||||
|
}
|
||||||
|
|
||||||
|
fn unpack_and_place(entry: &Entry, client: &Path, bytes: Vec<u8>) -> Result<()> {
|
||||||
|
let dir = addons_dir(client);
|
||||||
|
fs::create_dir_all(&dir)?;
|
||||||
|
let staging = tempfile::tempdir_in(&dir)?;
|
||||||
|
let archive = staging.path().join("a.zip");
|
||||||
|
download(&Serve(bytes), &entry.archive, &archive, &Cancel::default())?;
|
||||||
|
unpack(entry, &archive, &staging.path().join("files"))
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn a_tampered_or_incomplete_download_is_refused() {
|
||||||
|
let client = tempfile::tempdir().unwrap();
|
||||||
|
let entry = small_entry();
|
||||||
|
let good = archive(&entry, &|_| b"## Interface: 30300\n".to_vec());
|
||||||
|
unpack_and_place(&entry, client.path(), good).unwrap();
|
||||||
|
let bad = archive(&entry, &|_| b"## Interface: 30300 evil\n".to_vec());
|
||||||
|
assert!(unpack_and_place(&entry, client.path(), bad).unwrap_err().to_string().contains("verification"));
|
||||||
|
let empty = {
|
||||||
|
let mut out = std::io::Cursor::new(Vec::new());
|
||||||
|
zip::ZipWriter::new(&mut out).finish().unwrap();
|
||||||
|
out.into_inner()
|
||||||
|
};
|
||||||
|
assert!(unpack_and_place(&entry, client.path(), empty).unwrap_err().to_string().contains("lacks"));
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn install_update_and_remove_keep_other_folders() {
|
||||||
|
let client = tempfile::tempdir().unwrap();
|
||||||
|
let mut entry = small_entry();
|
||||||
|
let dir = addons_dir(client.path());
|
||||||
|
fs::create_dir_all(dir.join("TestAddon")).unwrap();
|
||||||
|
fs::write(dir.join("TestAddon/mine.lua"), b"player's own").unwrap();
|
||||||
|
fs::create_dir_all(dir.join("Other")).unwrap();
|
||||||
|
let serve = Serve(archive(&entry, &|_| b"## Interface: 30300
|
||||||
|
".to_vec()));
|
||||||
|
install_entry(&serve, client.path(), &entry, &Cancel::default()).unwrap();
|
||||||
|
assert!(dir.join("TestAddon/TestAddon.toc").is_file());
|
||||||
|
assert!(!dir.join("TestAddon/mine.lua").exists(), "the player's folder was set aside");
|
||||||
|
let backups: Vec<_> = fs::read_dir(dir.join(BACKUP)).unwrap().flatten().collect();
|
||||||
|
assert_eq!(backups.len(), 1);
|
||||||
|
assert!(backups[0].path().join("mine.lua").is_file());
|
||||||
|
assert_eq!(read_state(client.path())["t"].commit, "c1");
|
||||||
|
// An update replaces the Manager's own folder without another backup.
|
||||||
|
entry.commit = "c2".into();
|
||||||
|
install_entry(&serve, client.path(), &entry, &Cancel::default()).unwrap();
|
||||||
|
assert_eq!(read_state(client.path())["t"].commit, "c2");
|
||||||
|
assert_eq!(fs::read_dir(dir.join(BACKUP)).unwrap().count(), 1);
|
||||||
|
// A failed download changes nothing.
|
||||||
|
let broken = Serve(archive(&entry, &|_| b"tampered".to_vec()));
|
||||||
|
assert!(install_entry(&broken, client.path(), &entry, &Cancel::default()).is_err());
|
||||||
|
assert!(dir.join("TestAddon/TestAddon.toc").is_file());
|
||||||
|
remove(client.path(), "t").unwrap();
|
||||||
|
assert!(!dir.join("TestAddon").exists());
|
||||||
|
assert!(dir.join("Other").is_dir());
|
||||||
|
assert!(!read_state(client.path()).contains_key("t"));
|
||||||
|
// No leftover staging folders.
|
||||||
|
assert!(fs::read_dir(&dir).unwrap().flatten().all(|e| !e.file_name().to_string_lossy().starts_with(".coa-addon-")));
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,5 +1,5 @@
|
|||||||
//! Every setting of the world server's configuration, for people who want more than the curated list: the documented
|
//! 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
|
//! settings come from `worldserver.conf.dist` and `modules/coa.conf.dist`, the current
|
||||||
//! values from the configuration the next start will use. Anything that holds a password, a port, an address, a folder or
|
//! 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.
|
//! the database connection is left out; the Manager owns those.
|
||||||
|
|
||||||
@@ -10,7 +10,7 @@ use std::path::Path;
|
|||||||
use serde::Serialize;
|
use serde::Serialize;
|
||||||
|
|
||||||
use crate::config::parser::ConfFile;
|
use crate::config::parser::ConfFile;
|
||||||
use crate::config::{take_snapshot, targets, Scope};
|
use crate::config::{take_snapshot, targets, Scope, Targets};
|
||||||
use crate::error::{Error, Result};
|
use crate::error::{Error, Result};
|
||||||
use crate::fsx;
|
use crate::fsx;
|
||||||
|
|
||||||
@@ -39,6 +39,14 @@ fn hidden(key: &str) -> bool {
|
|||||||
|| k.starts_with("logindatabase.")
|
|| k.starts_with("logindatabase.")
|
||||||
|| k.starts_with("worlddatabase.")
|
|| k.starts_with("worlddatabase.")
|
||||||
|| k.starts_with("characterdatabase.")
|
|| k.starts_with("characterdatabase.")
|
||||||
|
|| [
|
||||||
|
"coa.classmodel",
|
||||||
|
"coa.realmtype",
|
||||||
|
"coa.gamemodemask",
|
||||||
|
"coa.mapclass10towarrior",
|
||||||
|
"coa.clientbooleanconfigs",
|
||||||
|
]
|
||||||
|
.contains(&k.as_str())
|
||||||
|| [
|
|| [
|
||||||
"bindip",
|
"bindip",
|
||||||
"realmid",
|
"realmid",
|
||||||
@@ -121,16 +129,34 @@ fn dist_path(root: &Path) -> std::path::PathBuf {
|
|||||||
root.join("Core/configs/worldserver.conf.dist")
|
root.join("Core/configs/worldserver.conf.dist")
|
||||||
}
|
}
|
||||||
|
|
||||||
|
fn sources(root: &Path) -> Result<Vec<(std::path::PathBuf, Targets)>> {
|
||||||
|
let mut result = vec![(dist_path(root), targets(root, Scope::Server)?)];
|
||||||
|
let dist = root.join("Core/configs/modules/coa.conf.dist");
|
||||||
|
if dist.is_file() {
|
||||||
|
let active = root.join("Core/configs/modules/coa.conf");
|
||||||
|
result.push((
|
||||||
|
dist,
|
||||||
|
Targets {
|
||||||
|
read: active.clone(),
|
||||||
|
writes: vec![active],
|
||||||
|
generated: None,
|
||||||
|
},
|
||||||
|
));
|
||||||
|
}
|
||||||
|
Ok(result)
|
||||||
|
}
|
||||||
|
|
||||||
pub fn list(root: &Path) -> Result<Vec<Item>> {
|
pub fn list(root: &Path) -> Result<Vec<Item>> {
|
||||||
let dist = fs::read_to_string(dist_path(root)).map_err(|_| {
|
let mut items = Vec::new();
|
||||||
Error::Invalid(
|
for (dist_path, t) in sources(root)? {
|
||||||
"The documented settings file (worldserver.conf.dist) was not found on this server."
|
let dist = fs::read_to_string(&dist_path)?;
|
||||||
.into(),
|
let active = ConfFile::parse_bytes(&if t.read.exists() {
|
||||||
)
|
fs::read(&t.read)?
|
||||||
|
} else {
|
||||||
|
dist.as_bytes().to_vec()
|
||||||
})?;
|
})?;
|
||||||
let t = targets(root, Scope::Server)?;
|
items.extend(
|
||||||
let active = ConfFile::parse_bytes(&fs::read(&t.read)?)?;
|
parse_dist(&dist)
|
||||||
Ok(parse_dist(&dist)
|
|
||||||
.into_iter()
|
.into_iter()
|
||||||
.filter(|(k, _, _)| !hidden(k))
|
.filter(|(k, _, _)| !hidden(k))
|
||||||
.map(|(key, default, doc)| {
|
.map(|(key, default, doc)| {
|
||||||
@@ -147,26 +173,41 @@ pub fn list(root: &Path) -> Result<Vec<Item>> {
|
|||||||
changed,
|
changed,
|
||||||
}
|
}
|
||||||
})
|
})
|
||||||
.collect())
|
.collect::<Vec<_>>(),
|
||||||
|
);
|
||||||
|
}
|
||||||
|
Ok(items)
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Change settings that exist in the documented file. A value is one line of at most 500 characters. Returns the keys
|
/// 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).
|
/// 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>> {
|
pub fn save(root: &Path, meta: &Path, changes: &BTreeMap<String, String>) -> Result<Vec<String>> {
|
||||||
let known: BTreeMap<String, String> =
|
let _lock = crate::update::operation_lock(meta)?;
|
||||||
parse_dist(&fs::read_to_string(dist_path(root)).map_err(|_| {
|
crate::update::ensure_recovered(meta)?;
|
||||||
Error::Invalid("worldserver.conf.dist was not found on this server.".into())
|
let sources = sources(root)?;
|
||||||
})?)
|
let mut known = BTreeMap::new();
|
||||||
.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 originals: Vec<(std::path::PathBuf, Vec<u8>)> = Vec::new();
|
||||||
let mut confs: Vec<ConfFile> = Vec::new();
|
let mut confs: Vec<ConfFile> = Vec::new();
|
||||||
|
let mut owners = Vec::new();
|
||||||
|
for (index, (dist, t)) in sources.iter().enumerate() {
|
||||||
|
let defaults = fs::read(dist)?;
|
||||||
|
for (key, default, _) in parse_dist(&String::from_utf8_lossy(&defaults)) {
|
||||||
|
if known.insert(key.clone(), (default, index)).is_some() {
|
||||||
|
return Err(Error::Invalid(format!(
|
||||||
|
"{key} is documented in more than one configuration file."
|
||||||
|
)));
|
||||||
|
}
|
||||||
|
}
|
||||||
for p in &t.writes {
|
for p in &t.writes {
|
||||||
let bytes = fs::read(p)?;
|
let bytes = if p.exists() {
|
||||||
|
fs::read(p)?
|
||||||
|
} else {
|
||||||
|
defaults.clone()
|
||||||
|
};
|
||||||
confs.push(ConfFile::parse_bytes(&bytes)?);
|
confs.push(ConfFile::parse_bytes(&bytes)?);
|
||||||
originals.push((p.clone(), bytes));
|
originals.push((p.clone(), bytes));
|
||||||
|
owners.push(index);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
let mut changed = Vec::new();
|
let mut changed = Vec::new();
|
||||||
for (key, value) in changes {
|
for (key, value) in changes {
|
||||||
@@ -181,9 +222,21 @@ pub fn save(root: &Path, meta: &Path, changes: &BTreeMap<String, String>) -> Res
|
|||||||
"The value of {key} must be one line of text."
|
"The value of {key} must be one line of text."
|
||||||
)));
|
)));
|
||||||
}
|
}
|
||||||
let same = confs.iter().all(|c| match c.get(key) {
|
let (default, owner) = &known[key];
|
||||||
|
if default.parse::<f64>().is_ok() && !value.parse::<f64>().is_ok_and(f64::is_finite)
|
||||||
|
|| key == "CoA.LegacyMountFlight" && !matches!(value, "0" | "1")
|
||||||
|
{
|
||||||
|
return Err(Error::Invalid(format!(
|
||||||
|
"The value of {key} must be a number matching its documented default."
|
||||||
|
)));
|
||||||
|
}
|
||||||
|
let same = confs
|
||||||
|
.iter()
|
||||||
|
.zip(&owners)
|
||||||
|
.filter(|(_, index)| *index == owner)
|
||||||
|
.all(|(c, _)| match c.get(key) {
|
||||||
Some(v) => v.trim() == value,
|
Some(v) => v.trim() == value,
|
||||||
None => known[key] == value,
|
None => default == value,
|
||||||
});
|
});
|
||||||
if !same {
|
if !same {
|
||||||
changed.push((key.clone(), value.to_string()));
|
changed.push((key.clone(), value.to_string()));
|
||||||
@@ -192,20 +245,31 @@ pub fn save(root: &Path, meta: &Path, changes: &BTreeMap<String, String>) -> Res
|
|||||||
if changed.is_empty() {
|
if changed.is_empty() {
|
||||||
return Ok(Vec::new());
|
return Ok(Vec::new());
|
||||||
}
|
}
|
||||||
for c in &mut confs {
|
for (c, owner) in confs.iter_mut().zip(&owners) {
|
||||||
for (k, v) in &changed {
|
for (k, v) in &changed {
|
||||||
|
if known[k].1 == *owner {
|
||||||
c.set(k, v, &["Added by CoA Server Manager"]);
|
c.set(k, v, &["Added by CoA Server Manager"]);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
}
|
||||||
let texts: Vec<String> = confs.iter().map(ConfFile::to_text).collect();
|
let texts: Vec<String> = confs.iter().map(ConfFile::to_text).collect();
|
||||||
for text in &texts {
|
for (text, owner) in texts.iter().zip(&owners) {
|
||||||
let reread = ConfFile::parse(text);
|
let reread = ConfFile::parse(text);
|
||||||
for (k, v) in &changed {
|
for (k, v) in &changed {
|
||||||
if reread.get(k).map(str::trim) != Some(v.as_str()) {
|
if known[k].1 == *owner && reread.get(k).map(str::trim) != Some(v.as_str()) {
|
||||||
return Err(Error::Invalid(format!("internal check failed for {k}")));
|
return Err(Error::Invalid(format!("internal check failed for {k}")));
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
let affected: std::collections::BTreeSet<_> =
|
||||||
|
changed.iter().map(|(key, _)| known[key].1).collect();
|
||||||
|
let (originals, texts): (Vec<_>, Vec<_>) = originals
|
||||||
|
.into_iter()
|
||||||
|
.zip(texts)
|
||||||
|
.zip(owners)
|
||||||
|
.filter(|(_, owner)| affected.contains(owner))
|
||||||
|
.map(|(pair, _)| pair)
|
||||||
|
.unzip();
|
||||||
take_snapshot(
|
take_snapshot(
|
||||||
meta,
|
meta,
|
||||||
Scope::Server,
|
Scope::Server,
|
||||||
@@ -232,6 +296,114 @@ pub fn save(root: &Path, meta: &Path, changes: &BTreeMap<String, String>) -> Res
|
|||||||
mod tests {
|
mod tests {
|
||||||
use super::*;
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn unrelated_saves_do_not_create_coa_files_and_existing_realm_values_are_preserved() {
|
||||||
|
let d = tempfile::tempdir().unwrap();
|
||||||
|
let (root, meta) = server(d.path());
|
||||||
|
let module = root.join("Core/configs/modules");
|
||||||
|
fs::create_dir_all(&module).unwrap();
|
||||||
|
fs::write(
|
||||||
|
module.join("coa.conf.dist"),
|
||||||
|
"CoA.LegacyMountFlight = 0\nCoA.ClassModel = \"coa\"\n",
|
||||||
|
)
|
||||||
|
.unwrap();
|
||||||
|
save(
|
||||||
|
&root,
|
||||||
|
&meta,
|
||||||
|
&BTreeMap::from([("Rate.Drop.Item.Rare".into(), "1.5".into())]),
|
||||||
|
)
|
||||||
|
.unwrap();
|
||||||
|
assert!(!module.join("coa.conf").exists());
|
||||||
|
fs::write(
|
||||||
|
module.join("coa.conf"),
|
||||||
|
"# Reborn realm\nCoA.ClassModel = \"wcr\"\nCustom.Preserved = 42\n",
|
||||||
|
)
|
||||||
|
.unwrap();
|
||||||
|
assert!(save(
|
||||||
|
&root,
|
||||||
|
&meta,
|
||||||
|
&BTreeMap::from([("CoA.ClassModel".into(), "\"coa\"".into())])
|
||||||
|
)
|
||||||
|
.is_err());
|
||||||
|
save(
|
||||||
|
&root,
|
||||||
|
&meta,
|
||||||
|
&BTreeMap::from([("CoA.LegacyMountFlight".into(), "1".into())]),
|
||||||
|
)
|
||||||
|
.unwrap();
|
||||||
|
let actual = fs::read_to_string(module.join("coa.conf")).unwrap();
|
||||||
|
assert!(
|
||||||
|
actual.contains("CoA.ClassModel = \"wcr\"") && actual.contains("Custom.Preserved = 42")
|
||||||
|
);
|
||||||
|
assert!(actual.contains("# Reborn realm"));
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn coa_settings_are_found_saved_to_the_module_and_snapshotted_without_profile_overrides() {
|
||||||
|
let d = tempfile::tempdir().unwrap();
|
||||||
|
let (root, meta) = server(d.path());
|
||||||
|
let module = root.join("Core/configs/modules");
|
||||||
|
fs::create_dir_all(&module).unwrap();
|
||||||
|
let defaults = "[worldserver]\n# Mount flight rules\nCoA.LegacyMountFlight = 0\nCoA.ClassModel = \"coa\"\nCoA.RealmType = \"live\"\n";
|
||||||
|
fs::write(module.join("coa.conf.dist"), defaults).unwrap();
|
||||||
|
let original_world = fs::read(root.join("Core/configs/worldserver.conf")).unwrap();
|
||||||
|
let items = list(&root).unwrap();
|
||||||
|
assert!(items
|
||||||
|
.iter()
|
||||||
|
.any(|i| i.key == "CoA.LegacyMountFlight" && i.value == "0"));
|
||||||
|
assert!(!items
|
||||||
|
.iter()
|
||||||
|
.any(|i| i.key == "CoA.ClassModel" || i.key == "CoA.RealmType"));
|
||||||
|
for value in ["2", "invalid", "1\nInjected = 1"] {
|
||||||
|
assert!(save(
|
||||||
|
&root,
|
||||||
|
&meta,
|
||||||
|
&BTreeMap::from([("CoA.LegacyMountFlight".into(), value.into())])
|
||||||
|
)
|
||||||
|
.is_err());
|
||||||
|
}
|
||||||
|
assert!(!module.join("coa.conf").exists());
|
||||||
|
save(
|
||||||
|
&root,
|
||||||
|
&meta,
|
||||||
|
&BTreeMap::from([
|
||||||
|
("CoA.LegacyMountFlight".into(), "1".into()),
|
||||||
|
("Rate.Drop.Item.Rare".into(), "1.5".into()),
|
||||||
|
]),
|
||||||
|
)
|
||||||
|
.unwrap();
|
||||||
|
assert!(fs::read_to_string(module.join("coa.conf"))
|
||||||
|
.unwrap()
|
||||||
|
.contains("CoA.LegacyMountFlight = 1"));
|
||||||
|
let world = fs::read_to_string(root.join("Core/configs/worldserver.conf")).unwrap();
|
||||||
|
assert!(!world.contains("CoA.LegacyMountFlight"));
|
||||||
|
assert!(world.contains("Rate.Drop.Item.Rare = 1.5"));
|
||||||
|
assert!(!String::from_utf8(original_world)
|
||||||
|
.unwrap()
|
||||||
|
.contains("CoA.LegacyMountFlight"));
|
||||||
|
assert_eq!(
|
||||||
|
list(&root)
|
||||||
|
.unwrap()
|
||||||
|
.iter()
|
||||||
|
.find(|i| i.key == "CoA.LegacyMountFlight")
|
||||||
|
.unwrap()
|
||||||
|
.value,
|
||||||
|
"1"
|
||||||
|
);
|
||||||
|
assert!(!crate::config::list_snapshots(&meta).is_empty());
|
||||||
|
let saved = crate::config::list_snapshots(&meta).remove(0);
|
||||||
|
crate::config::restore_snapshot(&meta, &saved.id).unwrap();
|
||||||
|
assert_eq!(
|
||||||
|
list(&root)
|
||||||
|
.unwrap()
|
||||||
|
.iter()
|
||||||
|
.find(|i| i.key == "CoA.LegacyMountFlight")
|
||||||
|
.unwrap()
|
||||||
|
.value,
|
||||||
|
"0"
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
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";
|
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) {
|
fn server(d: &Path) -> (std::path::PathBuf, std::path::PathBuf) {
|
||||||
|
|||||||
@@ -261,7 +261,9 @@ pub fn config_files(root: &Path) -> Vec<String> {
|
|||||||
for e in rd.flatten() {
|
for e in rd.flatten() {
|
||||||
let n = e.file_name().to_string_lossy().to_string();
|
let n = e.file_name().to_string_lossy().to_string();
|
||||||
// database.json holds generated database passwords; it is launcher state, not configuration.
|
// database.json holds generated database passwords; it is launcher state, not configuration.
|
||||||
if e.path().is_file() && (n.contains(".template") || n == "repack.json" || n == "docker.json") {
|
if e.path().is_file()
|
||||||
|
&& (n.contains(".template") || n == "repack.json" || n == "docker.json")
|
||||||
|
{
|
||||||
out.push(format!("Settings/{n}"));
|
out.push(format!("Settings/{n}"));
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -306,7 +308,9 @@ pub fn with_database<T>(root: &Path, f: impl FnOnce(&Db) -> Result<T>) -> Result
|
|||||||
let db = Db::from_repack(root, Account::Admin)?;
|
let db = Db::from_repack(root, Account::Admin)?;
|
||||||
let observed = process::observe(root, &read_ports(root));
|
let observed = process::observe(root, &read_ports(root));
|
||||||
let mysql_was_up = observed.mysql.state == ServiceState::Running && db.ping();
|
let mysql_was_up = observed.mysql.state == ServiceState::Running && db.ping();
|
||||||
if !mysql_was_up {
|
let db = if mysql_was_up {
|
||||||
|
db
|
||||||
|
} else {
|
||||||
let out = driver::run(root, Verb::StartMysql)?;
|
let out = driver::run(root, Verb::StartMysql)?;
|
||||||
if !out.ok {
|
if !out.ok {
|
||||||
// Keep the launcher's own last lines: the title alone ("Something went wrong") hides the cause.
|
// Keep the launcher's own last lines: the title alone ("Something went wrong") hides the cause.
|
||||||
@@ -315,7 +319,9 @@ pub fn with_database<T>(root: &Path, f: impl FnOnce(&Db) -> Result<T>) -> Result
|
|||||||
driver::startup_failure(root, &out)
|
driver::startup_failure(root, &out)
|
||||||
)));
|
)));
|
||||||
}
|
}
|
||||||
}
|
// The start may have moved the database to another port (a reserved or taken one).
|
||||||
|
Db::from_repack(root, Account::Admin)?
|
||||||
|
};
|
||||||
let result = f(&db);
|
let result = f(&db);
|
||||||
if !mysql_was_up {
|
if !mysql_was_up {
|
||||||
let now = process::observe(root, &read_ports(root));
|
let now = process::observe(root, &read_ports(root));
|
||||||
@@ -381,12 +387,19 @@ pub fn create(
|
|||||||
let build = || -> Result<Vec<Component>> {
|
let build = || -> Result<Vec<Component>> {
|
||||||
let mut components = Vec::new();
|
let mut components = Vec::new();
|
||||||
let realm = crate::realms::state(root)?;
|
let realm = crate::realms::state(root)?;
|
||||||
let mut databases: Vec<(String, &str)> = wanted_databases(kind).iter()
|
let mut databases: Vec<(String, &str)> = wanted_databases(kind)
|
||||||
.map(|name| Ok((name.to_string(), realm.active.schema(name)?))).collect::<Result<_>>()?;
|
.iter()
|
||||||
|
.map(|name| Ok((name.to_string(), realm.active.schema(name)?)))
|
||||||
|
.collect::<Result<_>>()?;
|
||||||
if kind != Kind::Config {
|
if kind != Kind::Config {
|
||||||
for other in realm.modes().into_iter().filter(|m| *m != realm.active) {
|
for other in realm.modes().into_iter().filter(|m| *m != realm.active) {
|
||||||
databases.push((format!("{}-characters", other.name()), other.schema("characters")?));
|
databases.push((
|
||||||
if kind == Kind::Full { databases.push((format!("{}-world", other.name()), other.schema("world")?)); }
|
format!("{}-characters", other.name()),
|
||||||
|
other.schema("characters")?,
|
||||||
|
));
|
||||||
|
if kind == Kind::Full {
|
||||||
|
databases.push((format!("{}-world", other.name()), other.schema("world")?));
|
||||||
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
if kind != Kind::Config && with_database(root, |db| db.schema_exists("acore_playerbots"))? {
|
if kind != Kind::Config && with_database(root, |db| db.schema_exists("acore_playerbots"))? {
|
||||||
@@ -427,16 +440,24 @@ pub fn create(
|
|||||||
return Err(e);
|
return Err(e);
|
||||||
}
|
}
|
||||||
};
|
};
|
||||||
let mysql_snapshot = if kind == Kind::Full && matches!(trigger, Trigger::BeforeUpdate | Trigger::BeforeRepair) && cfg!(windows) && !crate::docker::is_docker(root) {
|
let mysql_snapshot = if kind == Kind::Full
|
||||||
|
&& matches!(trigger, Trigger::BeforeUpdate | Trigger::BeforeRepair)
|
||||||
|
&& cfg!(windows)
|
||||||
|
&& !crate::docker::is_docker(root)
|
||||||
|
{
|
||||||
progress("Saving a complete stopped MySQL recovery copy");
|
progress("Saving a complete stopped MySQL recovery copy");
|
||||||
match crate::mysql_snapshot::capture(root, &partial) {
|
match crate::mysql_snapshot::capture(root, &partial) {
|
||||||
Ok(snapshot) => Some(snapshot),
|
Ok(snapshot) => Some(snapshot),
|
||||||
Err(error) => {
|
Err(error) => {
|
||||||
if let Ok(owned) = fsx::ensure_within(&backups_dir(meta), &partial) { let _ = fs::remove_dir_all(owned); }
|
if let Ok(owned) = fsx::ensure_within(&backups_dir(meta), &partial) {
|
||||||
|
let _ = fs::remove_dir_all(owned);
|
||||||
|
}
|
||||||
return Err(error);
|
return Err(error);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
} else { None };
|
} else {
|
||||||
|
None
|
||||||
|
};
|
||||||
let point = RecoveryPoint {
|
let point = RecoveryPoint {
|
||||||
realm: crate::realms::state(root)?.active,
|
realm: crate::realms::state(root)?.active,
|
||||||
schema: 1,
|
schema: 1,
|
||||||
@@ -485,7 +506,9 @@ pub fn verify(meta: &Path, id: &str) -> Result<VerifyReport> {
|
|||||||
let dir = point_dir(meta, id)?;
|
let dir = point_dir(meta, id)?;
|
||||||
let mut problems = Vec::new();
|
let mut problems = Vec::new();
|
||||||
if let Some(snapshot) = &point.mysql_snapshot {
|
if let Some(snapshot) = &point.mysql_snapshot {
|
||||||
if let Err(error) = crate::mysql_snapshot::verify(&dir, snapshot) { problems.push(error.to_string()); }
|
if let Err(error) = crate::mysql_snapshot::verify(&dir, snapshot) {
|
||||||
|
problems.push(error.to_string());
|
||||||
|
}
|
||||||
}
|
}
|
||||||
let mut names = std::collections::BTreeSet::new();
|
let mut names = std::collections::BTreeSet::new();
|
||||||
let mut schemas = std::collections::BTreeSet::new();
|
let mut schemas = std::collections::BTreeSet::new();
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
//! Signed channel pointers select one immutable package for an entire transaction.
|
//! Signed channel pointers select one immutable package for an entire transaction.
|
||||||
use serde::{Deserialize, Serialize};
|
|
||||||
use crate::{Error, Result};
|
|
||||||
use crate::pkgsource::{fetch_small, Source};
|
use crate::pkgsource::{fetch_small, Source};
|
||||||
|
use crate::{Error, Result};
|
||||||
|
use serde::{Deserialize, Serialize};
|
||||||
|
|
||||||
#[derive(Debug, Serialize, Deserialize)]
|
#[derive(Debug, Serialize, Deserialize)]
|
||||||
#[serde(rename_all = "camelCase", deny_unknown_fields)]
|
#[serde(rename_all = "camelCase", deny_unknown_fields)]
|
||||||
@@ -21,15 +21,22 @@ pub struct Envelope {
|
|||||||
}
|
}
|
||||||
|
|
||||||
pub fn verify(bytes: &[u8], channel: &str, key: &str) -> Result<Pointer> {
|
pub fn verify(bytes: &[u8], channel: &str, key: &str) -> Result<Pointer> {
|
||||||
let envelope: Envelope = serde_json::from_slice(bytes).map_err(|e| Error::InvalidManifest(e.to_string()))?;
|
let envelope: Envelope =
|
||||||
|
serde_json::from_slice(bytes).map_err(|e| Error::InvalidManifest(e.to_string()))?;
|
||||||
crate::signing::verify(envelope.payload.as_bytes(), &envelope.signature, key)?;
|
crate::signing::verify(envelope.payload.as_bytes(), &envelope.signature, key)?;
|
||||||
let pointer: Pointer = serde_json::from_str(&envelope.payload).map_err(|e| Error::InvalidManifest(e.to_string()))?;
|
let pointer: Pointer = serde_json::from_str(&envelope.payload)
|
||||||
if pointer.schema != 1 || pointer.channel != channel
|
.map_err(|e| Error::InvalidManifest(e.to_string()))?;
|
||||||
|
if pointer.schema != 1
|
||||||
|
|| pointer.channel != channel
|
||||||
|| pointer.release_tag != format!("server-{}", pointer.version)
|
|| pointer.release_tag != format!("server-{}", pointer.version)
|
||||||
|| pointer.version.is_empty()
|
|| pointer.version.is_empty()
|
||||||
|| !pointer.version.bytes().all(|b| b.is_ascii_digit() || b == b'.')
|
|| !pointer
|
||||||
|
.version
|
||||||
|
.bytes()
|
||||||
|
.all(|b| b.is_ascii_digit() || b == b'.')
|
||||||
|| pointer.snapshot.len() != 64
|
|| pointer.snapshot.len() != 64
|
||||||
|| !pointer.snapshot.bytes().all(|b| b.is_ascii_hexdigit()) {
|
|| !pointer.snapshot.bytes().all(|b| b.is_ascii_hexdigit())
|
||||||
|
{
|
||||||
return Err(Error::InvalidManifest("Invalid channel pointer".into()));
|
return Err(Error::InvalidManifest("Invalid channel pointer".into()));
|
||||||
}
|
}
|
||||||
Ok(pointer)
|
Ok(pointer)
|
||||||
@@ -39,21 +46,37 @@ pub fn resolve(channel: &str) -> Result<Source> {
|
|||||||
if channel != "stable" && channel != "edge" {
|
if channel != "stable" && channel != "edge" {
|
||||||
return Err(Error::InvalidManifest("Unknown release channel".into()));
|
return Err(Error::InvalidManifest("Unknown release channel".into()));
|
||||||
}
|
}
|
||||||
let source = Source::Url("https://raw.githubusercontent.com/Corfirean/coa-server-build/channels".into());
|
let source =
|
||||||
|
Source::Url("https://raw.githubusercontent.com/Corfirean/coa-server-build/channels".into());
|
||||||
let bytes = fetch_small(&source, &format!("{channel}.json"))?;
|
let bytes = fetch_small(&source, &format!("{channel}.json"))?;
|
||||||
let pointer = verify(&bytes, channel, crate::signing::EMBEDDED_PUBLIC_KEY)?;
|
let pointer = verify(&bytes, channel, crate::signing::EMBEDDED_PUBLIC_KEY)?;
|
||||||
Ok(Source::Url(format!("https://github.com/Corfirean/coa-server-build/releases/download/{}", pointer.release_tag)))
|
Ok(Source::Url(format!(
|
||||||
|
"https://github.com/Corfirean/coa-server-build/releases/download/{}",
|
||||||
|
pointer.release_tag
|
||||||
|
)))
|
||||||
}
|
}
|
||||||
|
|
||||||
pub fn sign(pointer: &Pointer, seed: &str) -> Result<Vec<u8>> {
|
pub fn sign(pointer: &Pointer, seed: &str) -> Result<Vec<u8>> {
|
||||||
use base64::{engine::general_purpose::STANDARD, Engine};
|
use base64::{engine::general_purpose::STANDARD, Engine};
|
||||||
use ed25519_dalek::{Signer, SigningKey};
|
use ed25519_dalek::{Signer, SigningKey};
|
||||||
let seed: [u8; 32] = STANDARD.decode(seed.trim()).map_err(|_| Error::Invalid("Invalid signing key".into()))?
|
let seed: [u8; 32] = STANDARD
|
||||||
.try_into().map_err(|_| Error::Invalid("Invalid signing key length".into()))?;
|
.decode(seed.trim())
|
||||||
|
.map_err(|_| Error::Invalid("Invalid signing key".into()))?
|
||||||
|
.try_into()
|
||||||
|
.map_err(|_| Error::Invalid("Invalid signing key length".into()))?;
|
||||||
let payload = serde_json::to_string(pointer).map_err(|e| Error::Invalid(e.to_string()))?;
|
let payload = serde_json::to_string(pointer).map_err(|e| Error::Invalid(e.to_string()))?;
|
||||||
let signature = STANDARD.encode(SigningKey::from_bytes(&seed).sign(payload.as_bytes()).to_bytes());
|
let signature = STANDARD.encode(
|
||||||
let bytes = serde_json::to_vec(&Envelope { payload, signature }).map_err(|e| Error::Invalid(e.to_string()))?;
|
SigningKey::from_bytes(&seed)
|
||||||
verify(&bytes, &pointer.channel, crate::signing::EMBEDDED_PUBLIC_KEY)?;
|
.sign(payload.as_bytes())
|
||||||
|
.to_bytes(),
|
||||||
|
);
|
||||||
|
let bytes = serde_json::to_vec(&Envelope { payload, signature })
|
||||||
|
.map_err(|e| Error::Invalid(e.to_string()))?;
|
||||||
|
verify(
|
||||||
|
&bytes,
|
||||||
|
&pointer.channel,
|
||||||
|
crate::signing::EMBEDDED_PUBLIC_KEY,
|
||||||
|
)?;
|
||||||
Ok(bytes)
|
Ok(bytes)
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -67,12 +90,21 @@ mod tests {
|
|||||||
let sk = SigningKey::from_bytes(&[17; 32]);
|
let sk = SigningKey::from_bytes(&[17; 32]);
|
||||||
let payload = serde_json::to_string(pointer).unwrap();
|
let payload = serde_json::to_string(pointer).unwrap();
|
||||||
let signature = STANDARD.encode(sk.sign(payload.as_bytes()).to_bytes());
|
let signature = STANDARD.encode(sk.sign(payload.as_bytes()).to_bytes());
|
||||||
(serde_json::to_vec(&Envelope { payload, signature }).unwrap(), STANDARD.encode(sk.verifying_key().to_bytes()))
|
(
|
||||||
|
serde_json::to_vec(&Envelope { payload, signature }).unwrap(),
|
||||||
|
STANDARD.encode(sk.verifying_key().to_bytes()),
|
||||||
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
fn verifies_identity_signature_and_immutable_tag() {
|
fn verifies_identity_signature_and_immutable_tag() {
|
||||||
let mut p = Pointer { schema: 1, channel: "stable".into(), version: "0.261010.40".into(), release_tag: "server-0.261010.40".into(), snapshot: "a".repeat(64) };
|
let mut p = Pointer {
|
||||||
|
schema: 1,
|
||||||
|
channel: "stable".into(),
|
||||||
|
version: "0.261010.40".into(),
|
||||||
|
release_tag: "server-0.261010.40".into(),
|
||||||
|
snapshot: "a".repeat(64),
|
||||||
|
};
|
||||||
let (bytes, key) = signed(&p);
|
let (bytes, key) = signed(&p);
|
||||||
assert_eq!(verify(&bytes, "stable", &key).unwrap().version, p.version);
|
assert_eq!(verify(&bytes, "stable", &key).unwrap().version, p.version);
|
||||||
assert!(verify(&bytes, "edge", &key).is_err());
|
assert!(verify(&bytes, "edge", &key).is_err());
|
||||||
|
|||||||
@@ -0,0 +1,124 @@
|
|||||||
|
//! Update-only comparison of existing unsupported character starts. Never repairs or deletes rows.
|
||||||
|
use crate::{db::Db, Error, Result};
|
||||||
|
use serde::{Deserialize, Serialize};
|
||||||
|
use std::collections::{BTreeMap, BTreeSet};
|
||||||
|
use std::path::Path;
|
||||||
|
|
||||||
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Serialize, Deserialize)]
|
||||||
|
pub struct MissingStart {
|
||||||
|
pub guid: u32,
|
||||||
|
pub race: u32,
|
||||||
|
pub class: u32,
|
||||||
|
}
|
||||||
|
|
||||||
|
#[derive(Debug, Clone, Serialize, Deserialize)]
|
||||||
|
pub struct Baseline {
|
||||||
|
pub schema: u32,
|
||||||
|
pub realms: BTreeMap<String, BTreeSet<MissingStart>>,
|
||||||
|
}
|
||||||
|
|
||||||
|
pub fn parse_missing(text: &str) -> Result<BTreeSet<MissingStart>> {
|
||||||
|
text.lines()
|
||||||
|
.map(|line| {
|
||||||
|
let values = line
|
||||||
|
.split('\t')
|
||||||
|
.map(str::parse::<u32>)
|
||||||
|
.collect::<std::result::Result<Vec<_>, _>>()
|
||||||
|
.map_err(|_| {
|
||||||
|
Error::Invalid("Cannot read existing character start identities.".into())
|
||||||
|
})?;
|
||||||
|
if values.len() != 3 {
|
||||||
|
return Err(Error::Invalid(
|
||||||
|
"Incomplete character start identity.".into(),
|
||||||
|
));
|
||||||
|
}
|
||||||
|
Ok(MissingStart {
|
||||||
|
guid: values[0],
|
||||||
|
race: values[1],
|
||||||
|
class: values[2],
|
||||||
|
})
|
||||||
|
})
|
||||||
|
.collect()
|
||||||
|
}
|
||||||
|
|
||||||
|
pub fn missing(db: &Db) -> Result<BTreeSet<MissingStart>> {
|
||||||
|
parse_missing(&db.query("SELECT c.guid,c.race,c.class FROM acore_characters.characters c LEFT JOIN acore_world.playercreateinfo p ON p.race=c.race AND p.class=c.class WHERE p.race IS NULL;")?)
|
||||||
|
}
|
||||||
|
|
||||||
|
pub fn capture(db: &Db, root: &Path) -> Result<Baseline> {
|
||||||
|
let mut realms = BTreeMap::new();
|
||||||
|
for mode in crate::realms::state(root)?.modes() {
|
||||||
|
realms.insert(
|
||||||
|
mode.name().to_owned(),
|
||||||
|
missing(&db.clone().for_realm(mode))?,
|
||||||
|
);
|
||||||
|
}
|
||||||
|
Ok(Baseline { schema: 1, realms })
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Match identity and race/class, never just totals: one new failure cannot replace an old one.
|
||||||
|
pub fn introduced(
|
||||||
|
current: &BTreeSet<MissingStart>,
|
||||||
|
before: &BTreeSet<MissingStart>,
|
||||||
|
) -> BTreeSet<MissingStart> {
|
||||||
|
current.difference(before).copied().collect()
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod tests {
|
||||||
|
use super::*;
|
||||||
|
#[test]
|
||||||
|
fn old_gaps_are_not_new_character_loss() {
|
||||||
|
let before = parse_missing("1\t44\t14\n2\t44\t14\n3\t44\t14").unwrap();
|
||||||
|
assert!(introduced(&before, &before).is_empty());
|
||||||
|
assert!(introduced(&BTreeSet::new(), &before).is_empty());
|
||||||
|
let replaced = parse_missing("1\t44\t14\n2\t44\t14\n4\t44\t14").unwrap();
|
||||||
|
assert_eq!(
|
||||||
|
introduced(&replaced, &before),
|
||||||
|
parse_missing("4\t44\t14").unwrap()
|
||||||
|
);
|
||||||
|
let changed = parse_missing("1\t44\t15").unwrap();
|
||||||
|
assert_eq!(introduced(&changed, &before), changed);
|
||||||
|
assert_eq!(introduced(&before, &BTreeSet::new()), before);
|
||||||
|
}
|
||||||
|
#[test]
|
||||||
|
fn malformed_identity_is_not_silently_ignored() {
|
||||||
|
for text in ["1\t44", "bad\t44\t14", "1\t44\t14\t0", "1\t44\t-1"] {
|
||||||
|
assert!(parse_missing(text).is_err());
|
||||||
|
}
|
||||||
|
assert!(parse_missing("").unwrap().is_empty());
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn reported_174_old_records_cannot_mask_one_newly_hidden_character() {
|
||||||
|
// Reproduce the report's scale without shipping another person's diagnostics or identities.
|
||||||
|
let before: BTreeSet<_> = (1..=174)
|
||||||
|
.map(|guid| MissingStart {
|
||||||
|
guid,
|
||||||
|
race: 44,
|
||||||
|
class: 14,
|
||||||
|
})
|
||||||
|
.collect();
|
||||||
|
assert!(introduced(&before, &before).is_empty());
|
||||||
|
let mut after = before.clone();
|
||||||
|
after.remove(&MissingStart {
|
||||||
|
guid: 1,
|
||||||
|
race: 44,
|
||||||
|
class: 14,
|
||||||
|
});
|
||||||
|
after.insert(MissingStart {
|
||||||
|
guid: 175,
|
||||||
|
race: 44,
|
||||||
|
class: 14,
|
||||||
|
});
|
||||||
|
assert_eq!(after.len(), before.len());
|
||||||
|
assert_eq!(
|
||||||
|
introduced(&after, &before),
|
||||||
|
BTreeSet::from([MissingStart {
|
||||||
|
guid: 175,
|
||||||
|
race: 44,
|
||||||
|
class: 14
|
||||||
|
}])
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
+126
-24
@@ -15,7 +15,8 @@ use crate::fsx;
|
|||||||
pub use crate::glue_config;
|
pub use crate::glue_config;
|
||||||
|
|
||||||
pub const ADDON_NAME: &str = "CoABotUI";
|
pub const ADDON_NAME: &str = "CoABotUI";
|
||||||
const EXECUTABLES: [&str; 3] = ["Ascension.exe", "Wow.exe", "WoW.exe"];
|
// CoA Custom Races V2 ships its own client (CoACustomRace.exe) next to Ascension.exe and must be started instead.
|
||||||
|
const EXECUTABLES: [&str; 4] = ["CoACustomRace.exe", "Ascension.exe", "Wow.exe", "WoW.exe"];
|
||||||
|
|
||||||
pub fn is_running(client: &Path) -> bool {
|
pub fn is_running(client: &Path) -> bool {
|
||||||
if crate::platform::flavor() == crate::platform::Flavor::Docker {
|
if crate::platform::flavor() == crate::platform::Flavor::Docker {
|
||||||
@@ -71,13 +72,23 @@ fn realm_config(old: &[u8], realm: &str) -> Vec<u8> {
|
|||||||
}
|
}
|
||||||
|
|
||||||
pub fn sync_realm(client: &Path, meta: &Path, mode: crate::realms::Mode) -> Result<bool> {
|
pub fn sync_realm(client: &Path, meta: &Path, mode: crate::realms::Mode) -> Result<bool> {
|
||||||
sync_realm_when_closed(client, meta, mode, is_running(client))
|
let realm = match mode {
|
||||||
|
crate::realms::Mode::Coa => "Conquest of Azeroth",
|
||||||
|
crate::realms::Mode::Wildcard => "Wildcard",
|
||||||
|
crate::realms::Mode::Reborn => "Warcraft Reborn",
|
||||||
|
};
|
||||||
|
sync_realm_when_closed(client, meta, realm, is_running(client))
|
||||||
|
}
|
||||||
|
|
||||||
|
/// [`sync_realm`] with the realm's name as the server shows it (the owner may have renamed it).
|
||||||
|
pub fn sync_realm_named(client: &Path, meta: &Path, realm: &str) -> Result<bool> {
|
||||||
|
sync_realm_when_closed(client, meta, realm, is_running(client))
|
||||||
}
|
}
|
||||||
|
|
||||||
fn sync_realm_when_closed(
|
fn sync_realm_when_closed(
|
||||||
client: &Path,
|
client: &Path,
|
||||||
meta: &Path,
|
meta: &Path,
|
||||||
mode: crate::realms::Mode,
|
realm: &str,
|
||||||
running: bool,
|
running: bool,
|
||||||
) -> Result<bool> {
|
) -> Result<bool> {
|
||||||
if running {
|
if running {
|
||||||
@@ -89,11 +100,6 @@ fn sync_realm_when_closed(
|
|||||||
Err(e) if e.kind() == std::io::ErrorKind::NotFound => Vec::new(),
|
Err(e) if e.kind() == std::io::ErrorKind::NotFound => Vec::new(),
|
||||||
Err(e) => return Err(e.into()),
|
Err(e) => return Err(e.into()),
|
||||||
};
|
};
|
||||||
let realm = match mode {
|
|
||||||
crate::realms::Mode::Coa => "Conquest of Azeroth",
|
|
||||||
crate::realms::Mode::Wildcard => "Wildcard",
|
|
||||||
crate::realms::Mode::Reborn => "Warcraft Reborn",
|
|
||||||
};
|
|
||||||
let new = realm_config(&old, realm);
|
let new = realm_config(&old, realm);
|
||||||
if new == old {
|
if new == old {
|
||||||
return Ok(true);
|
return Ok(true);
|
||||||
@@ -409,6 +415,38 @@ pub fn install_addon(client: &Path, meta: &Path, source: &Path) -> Result<()> {
|
|||||||
Ok(())
|
Ok(())
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// Remove the game's cache of server data (`Cache/WDB/<locale>/*.wdb`: creatures, items, quests, pages). The client
|
||||||
|
/// keeps answers it got from a server; after the server's data changes they show old names and stats until the
|
||||||
|
/// cache is gone. Only `.wdb` files under `Cache/WDB` are removed. Returns how many.
|
||||||
|
pub fn clear_game_cache(client: &Path) -> Result<usize> {
|
||||||
|
if is_running(client) {
|
||||||
|
return Ok(0);
|
||||||
|
}
|
||||||
|
let root = client.join("Cache").join("WDB");
|
||||||
|
let mut removed = 0;
|
||||||
|
let Ok(locales) = fs::read_dir(&root) else {
|
||||||
|
return Ok(0);
|
||||||
|
};
|
||||||
|
for locale in locales.flatten() {
|
||||||
|
if !locale.file_type().is_ok_and(|t| t.is_dir()) {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
let Ok(files) = fs::read_dir(locale.path()) else {
|
||||||
|
continue;
|
||||||
|
};
|
||||||
|
for file in files.flatten() {
|
||||||
|
let path = file.path();
|
||||||
|
let is_wdb = path
|
||||||
|
.extension()
|
||||||
|
.is_some_and(|e| e.eq_ignore_ascii_case("wdb"));
|
||||||
|
if is_wdb && file.file_type().is_ok_and(|t| t.is_file()) && fs::remove_file(&path).is_ok() {
|
||||||
|
removed += 1;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
Ok(removed)
|
||||||
|
}
|
||||||
|
|
||||||
/// Start the game client. The caller is responsible for making sure the server is ready first.
|
/// Start the game client. The caller is responsible for making sure the server is ready first.
|
||||||
pub fn launch(client: &Path) -> Result<u32> {
|
pub fn launch(client: &Path) -> Result<u32> {
|
||||||
let exe =
|
let exe =
|
||||||
@@ -417,11 +455,21 @@ pub fn launch(client: &Path) -> Result<u32> {
|
|||||||
return crate::wine::launch(client, exe);
|
return crate::wine::launch(client, exe);
|
||||||
}
|
}
|
||||||
let executable = client.join(exe);
|
let executable = client.join(exe);
|
||||||
let spawn = || Command::new(&executable).current_dir(client).spawn().map(|child| child.id());
|
let spawn = || {
|
||||||
|
Command::new(&executable)
|
||||||
|
.current_dir(client)
|
||||||
|
.spawn()
|
||||||
|
.map(|child| child.id())
|
||||||
|
};
|
||||||
#[cfg(windows)]
|
#[cfg(windows)]
|
||||||
{ launch_with_elevation_fallback(spawn, || launch_elevated(&executable, client)).map_err(Into::into) }
|
{
|
||||||
|
launch_with_elevation_fallback(spawn, || launch_elevated(&executable, client))
|
||||||
|
.map_err(Into::into)
|
||||||
|
}
|
||||||
#[cfg(not(windows))]
|
#[cfg(not(windows))]
|
||||||
{ spawn().map_err(Into::into) }
|
{
|
||||||
|
spawn().map_err(Into::into)
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Start normally first; ask Windows for elevation only when the client requires it (ERROR_ELEVATION_REQUIRED, 740).
|
/// Start normally first; ask Windows for elevation only when the client requires it (ERROR_ELEVATION_REQUIRED, 740).
|
||||||
@@ -443,9 +491,15 @@ fn launch_elevated(executable: &Path, directory: &Path) -> std::io::Result<u32>
|
|||||||
use std::os::windows::ffi::OsStrExt;
|
use std::os::windows::ffi::OsStrExt;
|
||||||
use windows_sys::Win32::Foundation::CloseHandle;
|
use windows_sys::Win32::Foundation::CloseHandle;
|
||||||
use windows_sys::Win32::System::Threading::GetProcessId;
|
use windows_sys::Win32::System::Threading::GetProcessId;
|
||||||
use windows_sys::Win32::UI::Shell::{ShellExecuteExW, SHELLEXECUTEINFOW, SEE_MASK_NOCLOSEPROCESS, SEE_MASK_NOASYNC};
|
use windows_sys::Win32::UI::Shell::{
|
||||||
|
ShellExecuteExW, SEE_MASK_NOASYNC, SEE_MASK_NOCLOSEPROCESS, SHELLEXECUTEINFOW,
|
||||||
|
};
|
||||||
use windows_sys::Win32::UI::WindowsAndMessaging::SW_SHOWNORMAL;
|
use windows_sys::Win32::UI::WindowsAndMessaging::SW_SHOWNORMAL;
|
||||||
let file: Vec<u16> = executable.as_os_str().encode_wide().chain(Some(0)).collect();
|
let file: Vec<u16> = executable
|
||||||
|
.as_os_str()
|
||||||
|
.encode_wide()
|
||||||
|
.chain(Some(0))
|
||||||
|
.collect();
|
||||||
let cwd: Vec<u16> = directory.as_os_str().encode_wide().chain(Some(0)).collect();
|
let cwd: Vec<u16> = directory.as_os_str().encode_wide().chain(Some(0)).collect();
|
||||||
let verb: Vec<u16> = "runas".encode_utf16().chain(Some(0)).collect();
|
let verb: Vec<u16> = "runas".encode_utf16().chain(Some(0)).collect();
|
||||||
let mut info = SHELLEXECUTEINFOW {
|
let mut info = SHELLEXECUTEINFOW {
|
||||||
@@ -457,12 +511,22 @@ fn launch_elevated(executable: &Path, directory: &Path) -> std::io::Result<u32>
|
|||||||
nShow: SW_SHOWNORMAL,
|
nShow: SW_SHOWNORMAL,
|
||||||
..Default::default()
|
..Default::default()
|
||||||
};
|
};
|
||||||
if unsafe { ShellExecuteExW(&mut info) } == 0 { return Err(std::io::Error::last_os_error()); }
|
if unsafe { ShellExecuteExW(&mut info) } == 0 {
|
||||||
if info.hProcess.is_null() { return Err(std::io::Error::other("Windows did not return the game process handle.")); }
|
return Err(std::io::Error::last_os_error());
|
||||||
|
}
|
||||||
|
if info.hProcess.is_null() {
|
||||||
|
return Err(std::io::Error::other(
|
||||||
|
"Windows did not return the game process handle.",
|
||||||
|
));
|
||||||
|
}
|
||||||
let pid = unsafe { GetProcessId(info.hProcess) };
|
let pid = unsafe { GetProcessId(info.hProcess) };
|
||||||
let error = std::io::Error::last_os_error();
|
let error = std::io::Error::last_os_error();
|
||||||
unsafe { CloseHandle(info.hProcess); }
|
unsafe {
|
||||||
if pid == 0 { return Err(error); }
|
CloseHandle(info.hProcess);
|
||||||
|
}
|
||||||
|
if pid == 0 {
|
||||||
|
return Err(error);
|
||||||
|
}
|
||||||
Ok(pid)
|
Ok(pid)
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -581,15 +645,50 @@ pub fn recover_all_realmlist_overrides(meta_roots: &[PathBuf]) -> usize {
|
|||||||
#[cfg(test)]
|
#[cfg(test)]
|
||||||
mod tests {
|
mod tests {
|
||||||
use super::*;
|
use super::*;
|
||||||
|
#[test]
|
||||||
|
fn only_the_server_data_cache_is_cleared() {
|
||||||
|
let d = tempfile::tempdir().unwrap();
|
||||||
|
let wdb = d.path().join("Cache/WDB/enUS");
|
||||||
|
fs::create_dir_all(&wdb).unwrap();
|
||||||
|
fs::write(wdb.join("creaturecache.wdb"), b"x").unwrap();
|
||||||
|
fs::write(wdb.join("itemcache.WDB"), b"x").unwrap();
|
||||||
|
fs::write(wdb.join("notes.txt"), b"keep").unwrap();
|
||||||
|
fs::create_dir_all(d.path().join("Data/Retail/Cache")).unwrap();
|
||||||
|
fs::write(d.path().join("Data/Retail/Cache/id-1.bin"), b"keep").unwrap();
|
||||||
|
assert_eq!(clear_game_cache(d.path()).unwrap(), 2);
|
||||||
|
assert!(wdb.join("notes.txt").is_file());
|
||||||
|
assert!(d.path().join("Data/Retail/Cache/id-1.bin").is_file());
|
||||||
|
assert_eq!(clear_game_cache(d.path()).unwrap(), 0);
|
||||||
|
assert_eq!(clear_game_cache(&d.path().join("missing")).unwrap(), 0);
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
#[cfg(windows)]
|
#[cfg(windows)]
|
||||||
#[test]
|
#[test]
|
||||||
fn elevation_is_requested_only_when_windows_requires_it() {
|
fn elevation_is_requested_only_when_windows_requires_it() {
|
||||||
assert_eq!(launch_with_elevation_fallback(|| Ok(17), || panic!("unneeded elevation")).unwrap(), 17);
|
assert_eq!(
|
||||||
assert_eq!(launch_with_elevation_fallback(|| Err(std::io::Error::from_raw_os_error(740)), || Ok(23)).unwrap(), 23);
|
launch_with_elevation_fallback(|| Ok(17), || panic!("unneeded elevation")).unwrap(),
|
||||||
let error = launch_with_elevation_fallback(|| Err(std::io::Error::from_raw_os_error(2)), || panic!("wrong error elevated")).unwrap_err();
|
17
|
||||||
|
);
|
||||||
|
assert_eq!(
|
||||||
|
launch_with_elevation_fallback(
|
||||||
|
|| Err(std::io::Error::from_raw_os_error(740)),
|
||||||
|
|| Ok(23)
|
||||||
|
)
|
||||||
|
.unwrap(),
|
||||||
|
23
|
||||||
|
);
|
||||||
|
let error = launch_with_elevation_fallback(
|
||||||
|
|| Err(std::io::Error::from_raw_os_error(2)),
|
||||||
|
|| panic!("wrong error elevated"),
|
||||||
|
)
|
||||||
|
.unwrap_err();
|
||||||
assert_eq!(error.raw_os_error(), Some(2));
|
assert_eq!(error.raw_os_error(), Some(2));
|
||||||
let cancelled = launch_with_elevation_fallback(|| Err(std::io::Error::from_raw_os_error(740)), || Err(std::io::Error::from_raw_os_error(1223))).unwrap_err();
|
let cancelled = launch_with_elevation_fallback(
|
||||||
|
|| Err(std::io::Error::from_raw_os_error(740)),
|
||||||
|
|| Err(std::io::Error::from_raw_os_error(1223)),
|
||||||
|
)
|
||||||
|
.unwrap_err();
|
||||||
assert_eq!(cancelled.raw_os_error(), Some(1223));
|
assert_eq!(cancelled.raw_os_error(), Some(1223));
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -620,7 +719,10 @@ mod tests {
|
|||||||
assert!(sync_realm(&c, &meta, crate::realms::Mode::Wildcard).unwrap());
|
assert!(sync_realm(&c, &meta, crate::realms::Mode::Wildcard).unwrap());
|
||||||
assert_eq!(fs::read(c.join("WTF/Config.wtf")).unwrap(), original);
|
assert_eq!(fs::read(c.join("WTF/Config.wtf")).unwrap(), original);
|
||||||
assert!(sync_realm(&c, &meta, crate::realms::Mode::Reborn).unwrap());
|
assert!(sync_realm(&c, &meta, crate::realms::Mode::Reborn).unwrap());
|
||||||
assert_eq!(fs::read(c.join("WTF/Config.wtf")).unwrap(), b"SET sound 1\r\nSET realmName \"Warcraft Reborn\"\r\n");
|
assert_eq!(
|
||||||
|
fs::read(c.join("WTF/Config.wtf")).unwrap(),
|
||||||
|
b"SET sound 1\r\nSET realmName \"Warcraft Reborn\"\r\n"
|
||||||
|
);
|
||||||
}
|
}
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
@@ -630,10 +732,10 @@ mod tests {
|
|||||||
let meta = d.path().join("meta");
|
let meta = d.path().join("meta");
|
||||||
let original = b"SET realmName \"Wildcard\"\n";
|
let original = b"SET realmName \"Wildcard\"\n";
|
||||||
fs::write(c.join("WTF/Config.wtf"), original).unwrap();
|
fs::write(c.join("WTF/Config.wtf"), original).unwrap();
|
||||||
assert!(!sync_realm_when_closed(&c, &meta, crate::realms::Mode::Coa, true).unwrap());
|
assert!(!sync_realm_when_closed(&c, &meta, "Conquest of Azeroth", true).unwrap());
|
||||||
assert_eq!(fs::read(c.join("WTF/Config.wtf")).unwrap(), original);
|
assert_eq!(fs::read(c.join("WTF/Config.wtf")).unwrap(), original);
|
||||||
assert!(!backup_dir(&meta).exists());
|
assert!(!backup_dir(&meta).exists());
|
||||||
assert!(sync_realm_when_closed(&c, &meta, crate::realms::Mode::Coa, false).unwrap());
|
assert!(sync_realm_when_closed(&c, &meta, "Conquest of Azeroth", false).unwrap());
|
||||||
assert_eq!(
|
assert_eq!(
|
||||||
fs::read(c.join("WTF/Config.wtf")).unwrap(),
|
fs::read(c.join("WTF/Config.wtf")).unwrap(),
|
||||||
b"SET realmName \"Conquest of Azeroth\"\n"
|
b"SET realmName \"Conquest of Azeroth\"\n"
|
||||||
|
|||||||
Loaded 100 of 320 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user