mirror of
https://github.com/Cockatrice/Cockatrice.git
synced 2026-11-13 13:30:00 -08:00
59 lines
4 KiB
Markdown
59 lines
4 KiB
Markdown
# Running Continuumatrice alongside Cockatrice (Linux)
|
|
|
|
Continuumatrice is an independent application. You can keep normal upstream **Cockatrice for MTG** installed and run both without mixing profiles or overwriting executables.
|
|
|
|
## Binary and build target
|
|
|
|
The CMake client target is now `continuumatrice` on every platform. A compatibility build target named `cockatrice` remains for older automation, but it creates **no executable** with the old name.
|
|
|
|
```bash
|
|
git pull --ff-only origin feature/continuumatrice-product-migration
|
|
cmake -S . -B build --fresh -G Ninja -DCMAKE_BUILD_TYPE=Release -DWITH_CLIENT=ON -DWITH_SERVER=ON -DWITH_ORACLE=OFF
|
|
cmake --build build --target continuumatrice continuum-servatrice --parallel 16
|
|
./build/continuumatrice/continuumatrice
|
|
```
|
|
|
|
If you previously compiled the fork under the old name, `build/cockatrice/cockatrice` can remain as an **outdated, stale executable** in the build directory. Launch `build/continuumatrice/continuumatrice` instead. Do not remove your system's normal `/usr/bin/cockatrice` application.
|
|
|
|
The standalone executable on Linux installs as `bin/continuumatrice`. The new `continuumatrice.desktop` launcher installs alongside the normal `cockatrice.desktop`. Its application name and desktop-file ID are also `continuumatrice`, so Wayland and desktop launchers distinguish the applications.
|
|
|
|
The fork installs its own original `continuumatrice.svg` icon, separate from Cockatrice artwork. The independent desktop launcher and `continuumatrice://` URI scheme do not take ownership of upstream `cockatrice://` links or `.cod` deck associations.
|
|
|
|
This fork intentionally does **not** install Cockatrice's `cockatrice-cod.xml` MIME handler or register the `cockatrice://` URL scheme in the new Linux desktop file. The normal MTG client keeps its default deck file and URL associations.
|
|
|
|
## Data isolation
|
|
|
|
Assuming typical XDG locations (and no `portable.dat` file):
|
|
|
|
- Data and databases: `~/.local/share/Continuumatrice/`
|
|
- Decks: `~/.local/share/Continuumatrice/decks/`
|
|
- Card images: `~/.local/share/Continuumatrice/pics/`
|
|
- Custom XML: `~/.local/share/Continuumatrice/customsets/`
|
|
- Preferences: `~/.local/share/Continuumatrice/settings/`
|
|
- Cache: `~/.cache/Continuumatrice/`
|
|
- Linux shared translations: `<install-prefix>/share/continuumatrice/translations`
|
|
- Linux shared themes: `<install-prefix>/share/continuumatrice/themes`
|
|
|
|
Its per-user single-instance local socket uses a Continuumatrice-specific name.
|
|
|
|
## System installation (optional)
|
|
|
|
If you want a separate `continuumatrice` command and a graphical launcher, first configure the build with a prefix of your choice (e.g., `/usr/local` for a system install). Then:
|
|
|
|
```bash
|
|
sudo cmake --install build
|
|
```
|
|
|
|
This uses the build's existing `CMAKE_INSTALL_PREFIX`; check `build/CMakeCache.txt` if unsure. The Linux client-specific install rules do not replace `bin/cockatrice` or `cockatrice.desktop`.
|
|
|
|
For immediate testing, skip installation and run the executable directly from the build tree. This change has not been compiled in this environment; verify with your openSUSE compiler.
|
|
|
|
## Cross-platform status
|
|
|
|
This migration also gives the Windows and macOS application package and URL registrations separate names. Those packaging flows have **not** been validated on Windows or macOS; installers must not be published until installation, upgrade, and uninstall testing demonstrates that neither platform affects upstream Cockatrice.
|
|
|
|
## Dedicated multiplayer server: Continuum-Servatrice
|
|
|
|
Both components are built by default. The server target is `continuum-servatrice` and its binary is `build/continuum-servatrice/continuum-servatrice`. The original MTG Servatrice executable and configuration are not used.
|
|
|
|
See [server hosting guide](continuum-servatrice-hosting.md) for the isolated MySQL schema and configuration commands. The default sample ports are TCP **4757** and WebSocket **4758**, chosen not to collide with MTG Servatrice's 4747/4748. Hosting outside your local network requires explicit firewall/reverse proxy/TLS planning.
|