Atlas Editor

A desktop suite of Tibia 12+/15.x asset tools, bundled into a single Tauri 2 app for Windows, macOS, and Linux. It is the official asset tooling for the atlas OT server — but works standalone with any Tibia 12+ client bundle or TFS-derived items.otb.

• Assets Editor — browse and edit a modern client assets bundle (appearances.dat + sprite sheets) and the optional items.otb server catalog, with undo/redo, cross-reference badges, sprite editing, sprite-animation timing, NPC trade data, GIF/PNG export, and .obd cross-client import.
• Map Converter — translate item IDs in .otbm maps between server numbering (TFS-style items.otb) and client numbering (OTBR/Nostalrius), in either direction. Point it at your server's items.otb for an exact mapping, or fall back to the built-in community table.
• OTB Converter — turn a legacy server bundle (items.otb plus Tibia 7.x–10.x .dat/.spr) into a modern Tibia 12+ assets folder. Coming soon.
• Map Editor — load and edit .otbm worlds. Coming soon.

The Assets Editor and Map Converter are shippable today. The OTB Converter and Map Editor are placeholders in the launcher while the underlying parsers catch up.

Every tool is localized in English, Portuguese (BR), and Spanish.

Ecosystem

Atlas Editor is part of a small family of atlas-kit projects:

Project	Role	License
atlas	OT server. Consumes the appearances.dat + items.otb bundle this editor produces.	GPL-2.0
atlas-editor (this repo)	Desktop tooling for editing client assets and the OTB catalog.	Apache-2.0

The two projects share no code — only the OTB extension byte assignments documented in docs/otb-format.md, which any TFS-derived server can adopt independently. The editor stays Apache-2.0 so it can be embedded in proprietary workflows; the server stays GPL-2.0.

Documentation

All deeper docs live under docs/:

• Build & dev setup — prerequisites, dev loop, and production installers per platform.
• Architecture — crate split, IPC model, state management, persistence guarantees.
• OTB format extensions — byte-level spec of the 0x80+ Atlas attributes so any server can adopt them.
• Legacy .spr notes — for the planned cross-client importer.
• Roadmap — reference-port phases and status.
• Performance audit — recent findings and fixes.
• Contributing — PR flow, code style, release procedure.

Quick start

git clone https://github.com/atlas-kit/atlas-assets-editor.git
cd atlas-assets-editor
npm --prefix frontend install
cargo install tauri-cli --version "^2.0" --locked
cargo tauri dev

Hit a snag? See docs/build.md for full prerequisites and OS-specific setup.

License

Apache License 2.0. Atlas Editor is free for commercial and non-commercial use, including in proprietary or paid Tibia servers.