mirror of
https://github.com/Corfirean/coa-server-manager.git
synced 2026-11-20 03:25:56 +00:00
fix(control): MR2.1 fail-closed world-port resolution and ruleset invariant verification
- Make world_port resolution fallible (Result<u16>) across LocalBackend, HostService, DirectRouteManager, and RelayLink without default fallbacks to 8085. - Enforce strict 4-way invariant: local_id ruleset == RealmAccess.mode == Db.realm() == RealmInfo.ruleset. Malformed or unknown suffixes fail closed. - If Wildcard is selected and world-port resolution fails (or simultaneous mode is disabled), Direct and Relay fail closed with actionable error and zero fallback to CoA. - Fix documentation drift in docs/WILDCARD.md and docs/MULTIRULESET_PORTABLE_AUDIT.md regarding simultaneous execution, distinct ports, and current vs historical baseline.
This commit is contained in:
1 parent
5343020bed
commit
ba143e1ccd
16 files changed
+463
-135
No files matched your search
+14
-8
@@ -4,10 +4,16 @@ Overview offers CoA and Wildcard. The installed worldserver must contain Wildcar
|
||||
already have its Wildcard migrations. The Manager refuses an unsupported binary, an occupied realm ID 2 or an
|
||||
existing destination database rather than overwrite them.
|
||||
|
||||
The first switch copies the CoA world into `acore_world_wildcard` and creates `acore_characters_wildcard` from
|
||||
the character schema and neutral server seed tables. Existing characters, card collections and progress are not
|
||||
copied. Accounts remain in shared `acore_auth`. Realm IDs 1 and 2 share the world port; only the selected world
|
||||
runs, and the inactive realm is listed offline. A switch while running stops the server gracefully and restarts it.
|
||||
CoA and Wildcard have separate character and world databases (`acore_characters` / `acore_world` for CoA, and
|
||||
`acore_characters_wildcard` / `acore_world_wildcard` for Wildcard). Accounts remain in shared `acore_auth`.
|
||||
|
||||
When simultaneous realm execution is enabled in configuration (`simultaneous: true`), both CoA and Wildcard
|
||||
realms can run concurrently:
|
||||
- Primary and secondary world ports (`ports.world` and `secondary_world_port`, e.g. 8085 and 8086) and RA ports
|
||||
are distinct.
|
||||
- Remote routing (both Direct Ingress and Relay links) is strictly bound to the specific ruleset realm selected:
|
||||
routing to a Wildcard realm targets the Wildcard world port and never advertises or connects to the CoA port.
|
||||
- When simultaneous execution is disabled, only the currently active realm runs and provides world service.
|
||||
|
||||
Configuration profiles are saved under `Settings/realm-profiles`. An interrupted switch can restore its previous
|
||||
configuration from the journal. CoA companion bots cannot be enabled on Wildcard. Content Scaling and the other
|
||||
@@ -21,12 +27,12 @@ adapter before the next start.
|
||||
|
||||
## Portable Characters on Wildcard
|
||||
|
||||
As of v0.7.1 (MR2), Wildcard realms fully participate in the Portable Characters subsystem with strict multi-ruleset isolation:
|
||||
As of v0.7.1, Wildcard realms participate in the Portable Characters subsystem with strict multi-ruleset isolation:
|
||||
- **Canonical Model:** Wildcard portable characters carry `ruleset: "wildcard"` and `content_namespace: "wildcard"`.
|
||||
- **Claim & Export:** Real characters played on a Wildcard realm (`acore_characters_wildcard`) can be claimed and exported into canonical portable snapshots. Wildcard character builds—including spells, talents, skills, action bars, settings, inventory, pets, and currencies—are fully captured.
|
||||
- **Import & Session Runtime:** A Wildcard portable character can be transferred to a remote Wildcard host, imported into its `acore_characters_wildcard` database, armed in a runtime session (Session Protocol 3), and played live with automatic checkpoints and logout synchronization.
|
||||
- **Claim & Export:** Characters played on a Wildcard realm (`acore_characters_wildcard`) can be claimed and exported into canonical portable snapshots. Wildcard character builds—including spells, talents, skills, action bars, settings, inventory, pets, and currencies—are preserved.
|
||||
- **Import & Session Runtime:** A Wildcard portable character can be transferred to a remote Wildcard host, imported into its `acore_characters_wildcard` database, armed in a runtime session (Session Protocol 3), and tracked through checkpoints and logout synchronization.
|
||||
- **Collections:** Wildcard collections (`wildcard:appearance` and `wildcard:vanity`) are partitioned separately from CoA collections. Unlocks on a Wildcard realm union into the profile's Wildcard collections and never touch CoA collections.
|
||||
- **Fail-Closed Protection:** Any attempt to transfer or import a CoA character into a Wildcard realm, or vice versa, is rejected at the protocol and database boundaries with zero mutation.
|
||||
- **Fail-Closed Protection:** Any attempt to transfer or import a CoA character into a Wildcard realm, or vice versa, is rejected at the protocol and database boundaries with zero mutation. If world-port resolution fails or a realm mode is inactive, Direct and Relay routing fail closed.
|
||||
|
||||

|
||||
|
||||
|
||||
Reference in new issue
Block a user