Cockatrice

Table of Contents

FAQ & Troubleshooting (Servatrice server related)

Frequently Asked Questions (FAQ)

Quick Start Guide "How to set up a server?"

Troubleshooting

Newly created server rooms don't show up in the Server tab
My server doesn't have enough entropy after installing servatrice
My games are not preserved when a player disconnects from the server

This page will list all frequently asked questions by the admins of Cockatrice servers (Servatrice) with appropriate answers, supplemented by a section about troubleshooting.

Frequently Asked Questions | Troubleshooting

Frequently Asked Questions (FAQ)

Quick Start Guide "How to set up a server?"

Quick Start Guide "How to set up a server?"

Download and install the latest version of Cockatrice (even a portable install will work);
Adapt servatrice.ini to your needs (you can find it in the install directory);
For a simple install, you can hardcode rooms and an user password in the config file;
A complete install would require you to install a database server to store users, rooms, replays, etc.. The software is available at https://dev.mysql.com/downloads/mysql/, then you need to create a database for servatrice following the steps at https://github.com/Cockatrice/Cockatrice/wiki/Setting-up-Servatrice
You can then run servatrice.exe: it's a command-line program , so it has no graphical interface, it will just open a black window with log messages. By default it will look for its servatrice.ini somewhere inside your user profile folder, you can copy your configuration there or start servatrice.exe with the "--config c:\path\to\servatrice.ini" parameter.
You may want to create a batch file to start servatrice with your favorite parameters, or even register it as a service to have it start automatically;
You may also want to adapt your windows firewall/router settings to expose port 4748 to the internet to make internet users able to connect via websocket connection.

Troubleshooting

Newly created server rooms don't show up in the `Server` tab

After properly creating your room(s), they show up in the SQL database. You still need to restart the server to make Servatrice poll these new entries from the database. Now the server room list in the Server tab should include all new rooms.

My server doesn't have enough entropy after installing `servatrice`

Servatrice does a lot of calculations with random numbers, which can decrease the amount of entropy available to the system. If your system has low entropy (less than 1000), you'll want to install rng-tools, which uses your motherboard's TPM to generate new entropy. If your motherboard doesn't have a TPM (it probably has one if it's from 2006 or later) you can install haveged.

You can check the amount of entropy available with cat /proc/sys/kernel/random/entropy_avail

My games are not preserved when a player disconnects from the server

This happens because Servatrice does not preserve game state for anonymous players. If an anonymous player disconnects, that player cannot rejoin the game. To solve this, simply register all players into Servatrice before starting a new game! This way, even if a player timeouts during a game session, he can re-join at a later time in order to continue playing.

This requires that Servatrice utilize a database (MySQL, currently) in order to allow player registrations. Follow the installation instructions for Servatrice with MySQL in order to properly configure this.

Welcome to the Cockatrice Wiki

Technical

Customizing Cockatrice

Servatrice Server

Helping Cockatrice

Feel free to contact and connect with us on Discord and Reddit!

FAQ & Troubleshooting (Servatrice server related)