A powerful TypeScript library for manipulating core Open Tibia files (.dat, .spr, .otb). This library serves as a foundation for building tools like Map Editors, Item Editors, and automated asset generators.
This project provides a wide range of tools for working with Tibia client files and generating resources for servers or third-party tools.
- Item Image Generator: Generate individual images or sprite sheets for items.
- Outfit Image Generator: Create outfit images with support for different directions and animation states.
- Effect & Missile Generators: Generate animation frames for magic effects and projectiles.
- GIF Conversion: Integrated tools to convert image sequences into animated GIFs (useful for wikis or web previews).
- YOLO Annotation Generator: Automatically create datasets for training YOLO detection and segmentation models by extracting sprites and generating their segmentation masks.
- OTB Editor: A functional example of how to programmatically edit
items.otbfiles (e.g., filtering items by ID). - PHP Tools: Includes PHP utilities for dynamic outfit coloring and image cache management.
- Node.js installed on your system.
-
Clone or download this repository.
-
Open a terminal in the project folder.
-
Install dependencies:
npm install
-
Build the project:
npm run build
Once the project is built (files will appear in the js/ folder), you can open the .html files directly in your web browser (Chrome recommended):
itemImageGenerator.html: Item image generator.outfitImageGenerator.html: Outfit image generator.otbEditor.html: Basic OTB file editor.yoloSegAnnotationGenerator.html: AI training data generator.
modules/: Main source code (File logic, binary handlers, structures).tools/: Additional PHP utilities and conversion scripts.output/: Default folder for generated files.