A cross-platform virtual tabletop for multiplayer card games
Go to file
Basile Clement 286a7494d3
client: Support arbitrary game zones (#5877)
* Remove `isView` flag from CardZone

This flag is used for two purposes:

 1. It is used as a check for casting to a zone to a `ZoneViewZone`;

 2. Non-view zones are added to the player's zones on construction

This patch removes the `isView` flag and instead:

 1. We directly cast zones to `ZoneViewZone` using a dynamic (qobject)
    cast and use the result of the cast instead of the `isView` flag to
    detect if we are a view zone or not;

 2. The player records its own zones when they are created, simplifying
    control flow.

* Review

* client: Support arbitrary game zones

Currently, the client ignores cards in unknown zones, as there is an
implicit assumption that the set of zones known by the server and the
client are the same.

This patch makes it so that the client accept "custom zones" from the
server (zones outside the builtin deck, graveyard, exile, sideboard,
table, stack and hand zones) using the information from the
ServerInfo_CardZone. Moving cards from/into these zones happens
through a "View custom zone" action in the Game > Player menu and
properly appears in the chat.

Note that this patch intentionally does not introduce any support for
having the server actually create such zones. Instead, this patch aims
to improve backwards compatibility for when we do get to adding this
capability in the future, by making sure that current clients will be
able to interact with future new zones (even if suboptimally).
2025-05-06 21:18:08 -04:00
.ci Remove Fedora 40 build and Add Fedora 42 build (#5893) 2025-04-29 22:18:18 -04:00
.github ci: temporarily remove run-vcpkg step (#5902) 2025-05-04 15:02:11 +02:00
.husky Webatrice: husky (#4591) 2022-03-13 13:44:51 -04:00
.tx CI: Add action for pulling new translations (#4911) 2023-10-15 18:47:15 -04:00
cmake Add custom server-side pawn colors (#5543) 2025-02-02 03:25:25 +00:00
cockatrice client: Support arbitrary game zones (#5877) 2025-05-06 21:18:08 -04:00
common client: Support arbitrary game zones (#5877) 2025-05-06 21:18:08 -04:00
dbconverter Add setting to auto focus search bar when opening card view window (#5906) 2025-05-04 20:09:11 -04:00
doc fix: Use isRebalanced to detect Arena cards (#5778) 2025-04-03 00:16:38 -04:00
oracle Refactor: clean up OracleImporter (#5871) 2025-04-21 16:29:42 -04:00
servatrice Modified setup_addfirstadmin script to bring it up to date to current cockatrice_users table (#5784) 2025-04-03 00:18:31 -04:00
tests Add setting to auto focus search bar when opening card view window (#5906) 2025-05-04 20:09:11 -04:00
vcpkg@c63619856b Bump to 2.11.0 for beta releases 2025-03-27 21:34:03 -04:00
webclient Bump serialize-javascript from 6.0.0 to 6.0.2 in /webclient (#5878) 2025-04-24 22:42:18 -04:00
.clang-format apply clang format to proto files (#4123) 2020-10-02 12:14:05 -04:00
.cmake-format.json rework formatting with cmake-format (#4627) 2022-06-08 21:14:26 -04:00
.codacy.yml yml config documentation (#2899) 2017-11-04 20:16:41 -04:00
.dockerignore Update CONTRIBUTING and more travis removing (#4179) 2020-11-28 03:14:15 -05:00
.gitignore Differentiate logging in order to silence certain modules. (#5419) 2025-01-05 17:38:51 -05:00
.gitmodules CI: Fix up Windows builds and add GitHub Actions for Windows (#4193) 2020-11-30 23:54:50 -05:00
CMakeLists.txt Bump to 2.11.0 for beta releases (#5796) 2025-04-06 12:27:11 +02:00
docker-compose.yml websocket is our default port/connection (#5679) 2025-03-14 21:43:11 -04:00
docker-compose.yml.windows websocket is our default port/connection (#5679) 2025-03-14 21:43:11 -04:00
Dockerfile feat: build and release docker images using github actions and container registry (#5807) 2025-05-02 18:10:09 -04:00
format.sh fix typo in format.sh (#4647) 2022-07-05 15:49:19 -04:00
LICENSE repo cleanup (#2826) 2017-08-11 21:42:45 -04:00
README.md feat: build and release docker images using github actions and container registry (#5807) 2025-05-02 18:10:09 -04:00
shell.nix nix: Add development utilities to shell.nix (#5725) 2025-03-15 19:03:26 +00:00
vcpkg.json Add openssl to windows reqs (#5074) 2024-07-13 12:38:43 -04:00


Cockatrice | Download | Related | Community | Contribute | Build | Run



To get started with Cockatrice ⇢ view our webpage
To get support, or suggest changes to the app ⇢ file an issue (How?) To help with development ⇢ learn how to contribute


Cockatrice

Cockatrice is an open-source, multiplatform application for playing tabletop card games over a network. The program's server design prevents users from manipulating the game for unfair advantage. The client also provides a single-player mode, which allows users to brew while offline.

This project uses C++ and the Qt libraries.
First work on a webclient with Typescript was started as well.

Download Cockatrice Eternal Download Count

Downloads are available for stable releases and the current beta version in development.
There is no strict release schedule for either of them.

Latest stable release:
Download Stable Release  
Latest beta version:
Download Beta Release   
While incorporating the latest fixes and features, beta builds may not be stable and/or contain new bugs!
Please report any findings when testing them!

Related Repositories

Community Resources Discord

Join our Discord community to connect with other projet contributors (#dev channel) or fellow users of the app. Come here to talk about the application, features, or just to hang out.

Important

For support regarding specific servers, please contact that server's admin/mods and use their dedicated communication channels rather than contacting the team building the software.

Contribute

Code

To contribute code to the project, please review our guidelines first.
We maintain two tags for contributors to easier find issues to potentially work on:

  • Good first issue
    Issues tagged in this way provide a simple way to get started. They don't require much experience to be worked on.
  • Help wanted
    This tag is used for issues that we are looking for somebody to pick up. Often this is for feature suggestions we support, but don't have the time to work on ourselves.

For both tags, we're willing to provide help to contributors in showing them where and how they can make changes, as well as code reviews for submitted changes.
We'll happily advice on how best to implement a feature, or we can show you where the codebase is doing something similar before you get too far along - put a note on an issue you want to discuss more on!

Cockatrice tries to use the Google Developer Documentation Style Guide to ensure consistent documentation. We encourage you to improve the documentation by suggesting edits based on this guide.

Kudos to our amazing contributors ❤️
Made with contrib.rocks.

Translations Transifex Project

Cockatrice uses Transifex to manage translations. You can help us bring Cockatrice, Oracle and Webatrice to your language and just adjust single wordings right from within your browser by visiting our Transifex project page.

Check out our Translator FAQ for more information about getting invovled, and join a group of hundreds of others!

Build CI Desktop CI Web

Dependencies: (for minimum versions search our CMake file)

Oracle can optionally use some packages to load compressed card files:


Basic compilation steps:

mkdir build
cd build
cmake ..
make

You can then

  • Create a Cockatrice installation inside the release folder:
    make install
    
  • Or make an installation package specific to your system:
    make package
    

Note

Detailed compiling instructions can be found in the Cockatrice wiki at Compiling Cockatrice


The following flags (with their non-default values) can be passed to cmake:

Flag Description
-DWITH_SERVER=1 Build Servatrice server
-DWITH_CLIENT=0 Don't build Cockatrice client
-DWITH_ORACLE=0 Don't build Oracle card database tool
-DCMAKE_BUILD_TYPE=Debug Compile in debug mode
Enables extra logging output, debug symbols, and much more verbose compiler warnings
-DWARNING_AS_ERROR=0 Don't treat compilation warnings as errors in debug mode
-DUPDATE_TRANSLATIONS=1 Configure make to update the translation .ts files for new strings in the source code
Note: make clean will remove the .ts files
-DTEST=1 Enable regression tests
Note: make test to run tests, googletest will be downloaded if not available
-DFORCE_USE_QT5=1 Skip looking for Qt6 before trying to find Qt5

Run

Cockatrice is the game client
Oracle fetches card data
Servatrice is the server

Docker

You can run an instance of Servatrice (the Cockatrice server) using Docker and our Dockerfile.

For more information, have a look in our wiki section on Setting up Servatrice.
There, you'll also find more hints on our docker-compose file which will configure and run both a MySQL server and Servatrice.

License GPLv2 License

Cockatrice is free software, licensed under the GPLv2.