Skip to content

An alternative tibia client for otserv written in C++20 and Lua, made with a modular system that uses lua scripts for ingame interface and functionality, making otclient flexible and easy to customize



Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
May 11, 2023 11:38
August 2, 2023 13:32
September 26, 2019 18:23
January 26, 2023 16:02
September 23, 2022 15:01
July 9, 2012 12:26
September 23, 2022 15:01
December 31, 2019 10:07
August 2, 2023 13:39
July 28, 2023 14:51
January 17, 2013 09:34

OTCLient - Redemption

Discord Shield Build - Ubuntu Build - Windows License: MIT

Based on edubart/otclient Rev: 2.760

Note: for those who are with the walking system stuttering...


  • C++20
  • Refactored/Optimized Rendering System
  • Auto Reload Module (init.lua)
  • Attached Effects System (to create aura, wings...) (code sample: effects.lua, outfit_618.lua, code test)
  • Idle Animation Support
  • Highlight Mouse Target (press shift to select any object)
  • Crosshair
  • Floor Shadowing
  • Floor View Mode (Normal, Fade, Locked, Always, Always with transparency)
  • Anti-Aliasing Mode Options (Note: Smooth Retro will consume a little more GPU)
  • Floating Effects Option
  • Optimized Terminal
  • Refactored Walk System
  • Support for more mouse buttons, for example 4 and 5
  • Module Controller System (Code example)
  • Some bugs fixed contained in edubart/otclient
  • Client 12.85 ~ 12.92, 13.00 ~ 13.14 support (protobuf)
  • Market has been rewritten to work only Canary
  • Async Texture Loading
  • Tile Widget
Community (Features)
OTClient V8 (Features)
  • Lighting System
  • Floor Fading
  • Path Finding

- Want to help? Just open a PR.

What is otclient?

Otclient is an alternative Tibia client for usage with otserv. It aims to be complete and flexible, for that it uses LUA scripting for all game interface functionality and configurations files with a syntax similar to CSS for the client interface design. Otclient works with a modular system, this means that each functionality is a separated module, giving the possibility to users modify and customize anything easily. Users can also create new mods and extend game interface for their own purposes. Otclient is written in C++20 and heavily scripted in lua.

For a server to connect to, you can build your own with the forgottenserver or canary.

The Mobile Project

This is a fork of edubart's otclient. The objective of this fork it's to develop a runnable otclient on mobiles devices.

Tasks that need to do:

  • Compile on Android devices
  • Compile on Apple devices
  • Adapt the UI reusing the existing lua code

Current compiling tutorials:

Where do I download?

Compiled for Windows can be found here (but can be outdated):

NOTE: You will need to download spr/dat files on your own and place them in data/things/VERSION/ (i.e: data/things/1098/Tibia.spr)


Beyond of it's flexibility with scripts, otclient comes with tons of other features that make possible the creation of new client side stuff in otserv that was not possible before. These include, sound system, graphics effects with shaders, modules/addons system, animated textures, styleable user interface, transparency, multi language, in game lua terminal, an OpenGL 2.0 ES engine that make possible to port to mobile platforms. Otclient is also flexible enough to create tibia tools like map editors just using scripts, because it wasn't designed to be just a client, instead otclient was designed to be a combination of a framework and tibia APIs.


If you are interested in compiling this project, just go to the wiki.

Build and run with Docker

To build the image:

docker build -t mehah/otclient .

To run the built image:

# Disable access control for the X server.
xhost +

# Run the container image with the required bindings to the host devices and volumes.
docker run -it --rm \
  --env DISPLAY \
  --volume /tmp/.X11-unix:/tmp/.X11-unix \
  --device /dev/dri \
  --device /dev/snd mehah/otclient /bin/bash

# Enable access control for the X server.
xhost -

Need help?

Try to ask questions in discord


Have found a bug? Please create an issue in our bug tracker


Otclient is made available under the MIT License, thus this means that you are free to do whatever you want, commercial, non-commercial, closed or open.


An alternative tibia client for otserv written in C++20 and Lua, made with a modular system that uses lua scripts for ingame interface and functionality, making otclient flexible and easy to customize






Sponsor this project