canary

Project Overview

Canary is a free and open-source MMORPG server emulator for the OpenTibia community, written in C++20 and Lua. It is a fork of the OTServBR-Global project, including server core, datapacks, Lua scripts, database schema, build presets, and development tooling.

Key Features

• Complete Tibia server emulation supporting protocol 15.25
• Written in C++20 and Lua for performance and extensibility
• Docker quickstart: One-command deployment with MariaDB, MyAAC, and login services
• Multi-protocol runtime support (current, 11.00, 8.60)
• Lua API reference with VSCode IntelliSense stubs

Target Audience

• OpenTibia community members and server administrators
• MMORPG server developers
• Players and developers interested in Tibia emulation

Quick Start

1. Run the quickstart from the docker directory:

   cd docker
   cp .env.dist .env
   docker compose up -d --build

2. Access local endpoints: Website http://localhost:8080, Login http://localhost:8088/login

3. Game port is 7172

Core Advantages

• Open-source and free (GPL-2.0)
• Docker one-command deployment for quick testing
• Active community support and ongoing development

System Requirements

• OS: Cross-platform (Linux, Windows, macOS)
• Additional Dependencies: Docker (for quickstart), CMake, C++20 compiler (for source build)

Notes

• Docker quickstart is intended for local development, testing, and LAN demos — do not expose directly to the public Internet