Crystal Server

Project

Crystal Server is a free and open-source MMORPG server emulator written in C++.

It is based on The Forgotten Server project forked from Open Tibia.

This project was created a long time ago to distribute a stable and safe distro for those who want to have a Tibia otserv.

To connect to the server and to take a stable experience, you can use the Game Client or mehah's OTCLient.

If you want edit the map, use the Remere's Map Editor.

You are subject to our code of conduct, read at this link.

You can use your own tool to generate Monster Loot and Monster Elements at this link.

Official Discord

Enjoy our Discord

Thanks

• Open Tibia and their contributors.
• The Forgotten Server and their contributors.
• Crystal Server and their contributors.

Issues

We use the issue tracker on GitHub. Keep in mind that everyone who is watching the repository gets notified by e-mail when there is an activity, so be thoughtful and avoid writing comments that aren't meant for an issue (e.g. "+1"). If you'd like for an issue to be fixed faster, you should either fix it yourself and submit a pull request, or place a bounty on the issue.

Pull requests

Before creating a pull request please keep in mind:

• Do not send Pull Request changing the map, as we can't review the changes.
• Focus on fixing only one thing, mixing too much things on the same Pull Request make it harder to review, harder to test and if we need to revert the change it will remove other things together.
• Follow the project indentation, if your editor support you can use the editorconfig to automatic configure the indentation.
• There are people that doesn't play the game on the official server, so explain your changes to help understand what are you changing and why.
• Avoid opening a Pull Request to just update one line of a XML file.

Download Latest Executable

• Follow the steps in the video below to download the latest executable available, compiled by GitHub Actions.

downlaoding.crystalserver.mp4

Compiling from Source (Guided Scripts)

If you prefer to compile the server yourself, you can use one of our guided installer scripts. You only need to download the file that matches your operating system (crystal_windows_installer.ps1 for Windows, or linux_installer.sh for Linux).

Windows (PowerShell)

A guided PowerShell script is available to automate the entire compilation process, including the installation of Git, CMake, and Visual Studio.

1. Download the crystal_windows_installer.ps1 script to your computer.
2. Right-click your Start menu and select "Windows Terminal (Admin)" or "PowerShell (Admin)".
3. Due to Windows security, you must first bypass the execution policy for this session. Type the following command and press Enter:

   Set-ExecutionPolicy Bypass -Scope Process

4. Navigate to the script's location (e.g., your Desktop):

   cd C:\Users\YourUser\Desktop

5. Run the installer:

   .\crystal_windows_installer.ps1

6. The script will automatically set the correct policy for future runs and guide you through the language, branch, and installation steps.

Linux (Bash)

A guided Bash script is available for most modern distributions (Debian/Ubuntu, Arch, Fedora).

1. Download the linux_installer.sh script.
2. Open your terminal and navigate to the script's location.
3. Make the script executable:

   chmod +x linux_installer.sh

4. Run the installer (do not use sudo to run the script itself):

   ./linux_installer.sh

5. The script will guide you through the process and will only ask for your password (via sudo) when it needs to install system packages.