Assets And Map Editor

A cross-platform visual editor for Tibia assets and maps.
Getting Started »  ·  Changelog  ·  Report Bug  ·  Request Feature

---

Overview

Assets And Map Editor is a desktop application for editing Tibia game assets and maps. It provides a unified workspace for managing DAT, SPR, OTB, and OTBM files with a modern, dark-themed interface.

Built with Avalonia UI for true cross-platform support — runs natively on Windows, macOS (Intel & Apple Silicon), and Linux without browser dependencies or Electron overhead.

Features

Asset Editing

• Load, inspect, and edit DAT, SPR, and OTB files
• Full sprite composition grid with animation preview
• Copy, paste, and drag-and-drop sprites between items
• Export sprites with full RGBA alpha channel
• OBD (Object Builder Data) import and export
• Bulk operations: multi-select, delete, find duplicates, compact sprites
• Mismatch detection between client and server item definitions

Map Editing

• Integrated OTBM map editor with canvas, palette, and catalog
• XML-based brush system with visual editor
• Wall auto-alignment and border automagic
• Minimap overlay — navigable, movable, and resizable
• Ghost floor rendering for multi-level editing

Cross-Session Operations

• Merge assets across sessions with sprite-hash deduplication
• Batch transplant items, outfits, effects, and missiles between versions
• Category-aware operations with per-type breakdowns

Workflow

• Unified Save All (Ctrl+S) for OTB, DAT, SPR, and Map
• Session persistence — viewport, paths, and state across restarts
• Unsaved changes protection with confirmation dialogs

Downloads

Pre-built binaries are available for every major platform. No runtime installation required — each release is a self-contained single-file executable.

Platform	Architecture	Download
Windows	x64	disttopic-assets-and-map-editor-windows-x64.zip
Windows	ARM64	disttopic-assets-and-map-editor-windows-arm64.zip
macOS	Apple Silicon (M1+)	disttopic-assets-and-map-editor-macos-arm64.zip
macOS	Intel x64	disttopic-assets-and-map-editor-macos-x64.zip
Linux	x64	disttopic-assets-and-map-editor-linux-x64.zip
Linux	ARM64	disttopic-assets-and-map-editor-linux-arm64.zip

See all versions on the Releases page.

Each release also includes a checksums.sha256 file. Verify your download before running:

# Linux / macOS
sha256sum --check checksums.sha256

# Windows (PowerShell)
Get-FileHash disttopic-assets-and-map-editor-windows-x64.zip -Algorithm SHA256

Windows users: Windows SmartScreen may show an "Unknown publisher" warning because the binary is not yet commercially code-signed. You can verify authenticity by checking the SHA-256 hash and reviewing the CI build log. See Build and Release Verification for full details.

Building from Source

Prerequisites

• .NET 10 SDK

Build

git clone https://github.com/DistTopic/assets-and-map-editor.git
cd assets-and-map-editor
dotnet build src/App/AssetsAndMapEditor.App.csproj

Publish (self-contained)

dotnet publish src/App/AssetsAndMapEditor.App.csproj \
  -c Release \
  -r <RID> \
  --self-contained true \
  -p:PublishSingleFile=true \
  -p:IncludeNativeLibrariesForSelfExtract=true \
  -o publish/

Replace <RID> with your target runtime: win-x64, win-arm64, osx-arm64, osx-x64, linux-x64, or linux-arm64.

Documentation

Document	Description
Getting Started	First-time setup, download verification, and basic usage
Architecture	Project structure and design decisions
File Formats	DAT, SPR, OTB, OTBM, and brush format reference
Build & Verification	Reproducing builds and verifying release integrity
Branching Strategy	GitFlow model and branch protection rules
Changelog	Version history with commit references
Contributing	How to contribute to the project
Code of Conduct	Community standards
Security Policy	Reporting vulnerabilities and verifying releases

Project Structure

assets-and-map-editor/
├── src/
│   ├── App/                  # Main application (Avalonia UI)
│   │   ├── Controls/         # Custom UI controls (MapCanvas, SpriteStrip, etc.)
│   │   ├── Converters/       # XAML value converters
│   │   ├── Models/           # Data models (DAT, SPR, OTB, OTBM, Brushes)
│   │   ├── ViewModels/       # MVVM view models
│   │   └── Views/            # AXAML views and windows
│   └── OTB/                  # OTB file format library
├── .github/workflows/        # CI/CD pipeline
├── docs/                     # Extended documentation
├── CHANGELOG.md
├── CONTRIBUTING.md
├── CODE_OF_CONDUCT.md
├── SECURITY.md
└── LICENSE

License

This project is licensed under the GNU General Public License v3.0 — see the LICENSE file for details.

---

Made with Avalonia UI and .NET  ·  Maintained by DistTopic