Skip to content

Repository files navigation

ObjectBuilder Studio — Open Tibia DAT/SPR Asset Editor

A Windows desktop editor for Open Tibia, OTServ, OTCv8, PXG, and PokeTibia DAT/SPR assets. It is an independent, modern successor to the MIT-licensed Object Builder.

ObjectBuilder Studio editing DAT/SPR assets

Download

Get the latest Windows x64 build from GitHub Releases:

  • Setup — standard Windows installer with optional shortcuts
  • Portable — runs without installation
  • SHA256SUMS.txt — checksums for verifying both executables

The binaries are currently unsigned, so Windows may show a Microsoft Defender SmartScreen warning. Compare the downloaded file with SHA256SUMS.txt before running it:

Get-FileHash .\ObjectBuilder-Studio-Setup-*-x64.exe -Algorithm SHA256

Quick start

  1. Back up the client assets you want to edit.
  2. Open a folder containing exactly one .dat and one .spr file.
  3. Choose the format options required by the client and review the detected headers.
  4. Browse or edit objects, properties, animations, and sprites.
  5. Use Save As to export into a separate directory. Source assets are not overwritten directly.

Features

  • browse and edit items, outfits, effects, missiles, and sprites
  • add, duplicate, remove, search, undo, and redo objects
  • preview composed sprites, outfit colors, layers, patterns, and animations
  • import and export 32×32 PNG sprites and object sprite sheets
  • bulk sprite replacement and full object/sprite export
  • deterministic DAT writing with round-trip verification
  • paired DAT/SPR export with backups and rollback
  • responsive browsing for very large SPR files

Supported formats

  • standard or 32-bit DAT category counts
  • standard or 32-bit sprite IDs
  • RGB or transparency-enabled SPR payloads
  • optional improved-animation records and frame groups
  • implemented DAT properties for the 10.10–10.56 object model
  • explicitly configured custom OTCv8, PXG, and PokeTibia layouts

Format options are explicit because file signatures alone do not identify every custom client layout.

Known limitations

  • prebuilt releases currently support Windows x64 only
  • binaries are not code-signed
  • OTB editing is not implemented
  • some original Object Builder subsystems and client variants remain unsupported
  • unknown DAT properties stop with a detailed error instead of being skipped
  • real-client coverage is strongest for the verified large OTCv8/PXG format

Build from source

Requires Node.js 22 or 24.

git clone https://github.com/NesDevr/objectbuilder-studio.git
cd objectbuilder-studio
npm ci
npm run dev

Useful checks and packaging commands:

npm test
npm run build
npm run dist

npm run dist creates the NSIS installer and portable executable in release/. Portable object bundles follow OBJECT_BUNDLE_SCHEMA.md.

License

ObjectBuilder Studio is available under the MIT License. Proprietary game assets are not included.

About

Modern Windows DAT and SPR asset editor for Open Tibia, OTServ, OTCv8, PXG, and PokeTibia clients.

Topics

Resources

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages