diff --git a/.gitignore b/.gitignore index 4fbf69e..2ed3730 100644 --- a/.gitignore +++ b/.gitignore @@ -1,8 +1,10 @@ _site/ +site/ .sass-cache/ .jekyll-cache/ .jekyll-metadata vendor/ +.venv/ node_modules/ .bundle/ .DS_Store diff --git a/docs/assets/css/custom.css b/docs/assets/css/custom.css new file mode 100644 index 0000000..fd2a700 --- /dev/null +++ b/docs/assets/css/custom.css @@ -0,0 +1,193 @@ +/* ── DistTopic custom light theme ────────────────────────────── */ + +/* Language selector button — garante visibilidade no header claro */ +.md-header__button { + color: rgba(255,255,255,0.87) !important; +} +.md-header__button:hover { + color: #fff !important; +} + +/* Dropdown do seletor de idioma */ +.md-select__inner { + background-color: #fff !important; + border: 1px solid #e0e0e0 !important; + box-shadow: 0 4px 16px rgba(0,0,0,0.12) !important; +} +.md-select__link { + color: #37474f !important; +} +.md-select__link:hover, +.md-select__link--active { + color: #3f51b5 !important; + background-color: rgba(63,81,181,0.08) !important; +} + +/* ── Gallery grid ─────────────────────────────────────────────── */ +.gallery-grid { + display: grid; + grid-template-columns: repeat(auto-fill, minmax(340px, 1fr)); + gap: 1.25rem; + margin: 1.5rem 0; +} + +.gallery-item { + /* button reset */ + -webkit-appearance: none; + appearance: none; + padding: 0; + cursor: pointer; + font: inherit; + width: 100%; + /* card */ + display: block; + text-decoration: none !important; + border-radius: 10px; + overflow: hidden; + border: 1px solid #e0e0e0; + background: #0d1117; + box-shadow: 0 2px 8px rgba(0,0,0,0.07); + transition: box-shadow .2s ease, transform .2s ease; + color: inherit !important; +} + +.gallery-item:hover { + box-shadow: 0 8px 28px rgba(0,0,0,0.16); + transform: translateY(-3px); +} + +.gallery-item figure { + margin: 0; +} + +.gallery-thumb { + overflow: hidden; + line-height: 0; +} + +.gallery-item img { + display: block; + width: 100%; + height: auto; + transition: transform .35s ease; + border: none !important; + border-radius: 0 !important; + box-shadow: none !important; + margin: 0 !important; +} + +.gallery-item:hover img { + transform: scale(1.04); +} + +.gallery-item figcaption { + padding: .75rem 1rem .85rem; + background: #fff; + border-top: 1px solid #e0e0e0; +} + +.gallery-item figcaption strong { + display: block; + color: #263238; + font-size: .875rem; + font-weight: 600; + margin-bottom: .25rem; +} + +.gallery-item figcaption span { + color: #546e7a; + font-size: .78rem; + line-height: 1.45; + display: block; +} + +/* ── Lightbox dialog ─────────────────────────────────────────── */ +#gallery-lightbox { + border: none; + padding: 0; + background: transparent; + box-shadow: none; + max-width: none; + max-height: none; + overflow: visible; +} + +#gallery-lightbox::backdrop { + background: rgba(0, 0, 0, 0.88); + cursor: zoom-out; +} + +.lb-wrap { + position: relative; +} + +.lb-close { + position: absolute; + top: -2.25rem; + right: 0; + width: 2rem; + height: 2rem; + background: rgba(255, 255, 255, 0.15); + border: 1px solid rgba(255, 255, 255, 0.35); + border-radius: 50%; + color: #fff; + font-size: 1.1rem; + line-height: 1; + cursor: pointer; + display: flex; + align-items: center; + justify-content: center; + transition: background 0.15s; +} + +.lb-close:hover { + background: rgba(255, 255, 255, 0.28); +} + +.lb-img { + display: block; + max-width: min(90vw, 960px); + max-height: 88vh; + border-radius: 8px; + box-shadow: 0 12px 48px rgba(0, 0, 0, 0.55); + cursor: default; +} + +/* ── Tables ──────────────────────────────────────────────────── */ +.md-typeset__table { + width: 100%; + min-width: 100%; +} + +.md-typeset__table table { + display: table !important; + width: 100% !important; +} + +.md-typeset table { + display: table !important; + width: 100% !important; +} + +.md-typeset table th { + text-align: center !important; + white-space: nowrap; +} + +.md-typeset table td { + text-align: center !important; +} + +.md-typeset table th:first-child, +.md-typeset table td:first-child { + text-align: left !important; +} + +/* Scrollbar fina */ +* { + scrollbar-width: thin; + scrollbar-color: #bdbdbd transparent; +} +::-webkit-scrollbar { width: 6px; height: 6px; } +::-webkit-scrollbar-thumb { background-color: #bdbdbd; border-radius: 3px; } +::-webkit-scrollbar-track { background: transparent; } diff --git a/docs/assets/css/github-dark.css b/docs/assets/css/github-dark.css index 1ce9e39..87c200b 100644 --- a/docs/assets/css/github-dark.css +++ b/docs/assets/css/github-dark.css @@ -490,6 +490,35 @@ code, pre, kbd, samp, color: var(--gh-blue) !important; } +/* ── Language selector ────────────────────────────────────────── */ +/* Material uses --md-primary-bg-color for header icons, which in our + custom palette equals the header background → invisible. Force fg. */ +.md-header__button, +.md-header__option .md-header__button { + color: var(--gh-fg-muted) !important; +} + +.md-header__button:hover { + color: var(--gh-fg) !important; +} + +/* Language picker dropdown */ +.md-select__inner { + background-color: var(--gh-canvas-subtle) !important; + border: 1px solid var(--gh-border) !important; + box-shadow: 0 8px 24px rgba(0,0,0,0.5) !important; +} + +.md-select__link { + color: var(--gh-fg-muted) !important; +} + +.md-select__link:hover, +.md-select__link--active { + color: var(--gh-blue) !important; + background-color: var(--gh-blue-muted) !important; +} + /* ── Scrollbar ────────────────────────────────────────────────── */ * { scrollbar-width: thin; diff --git a/docs/assets/images/screenshots/editor-map-context.png b/docs/assets/images/screenshots/editor-map-context.png new file mode 100644 index 0000000..a9bb84b Binary files /dev/null and b/docs/assets/images/screenshots/editor-map-context.png differ diff --git a/docs/assets/images/screenshots/editor-map-search.png b/docs/assets/images/screenshots/editor-map-search.png new file mode 100644 index 0000000..1d48347 Binary files /dev/null and b/docs/assets/images/screenshots/editor-map-search.png differ diff --git a/docs/assets/images/screenshots/editor-map-view.png b/docs/assets/images/screenshots/editor-map-view.png new file mode 100644 index 0000000..7ff6444 Binary files /dev/null and b/docs/assets/images/screenshots/editor-map-view.png differ diff --git a/docs/assets/images/screenshots/editor-menu-edit.png b/docs/assets/images/screenshots/editor-menu-edit.png new file mode 100644 index 0000000..c61f305 Binary files /dev/null and b/docs/assets/images/screenshots/editor-menu-edit.png differ diff --git a/docs/assets/images/screenshots/editor-menu-file.png b/docs/assets/images/screenshots/editor-menu-file.png new file mode 100644 index 0000000..3f9b75c Binary files /dev/null and b/docs/assets/images/screenshots/editor-menu-file.png differ diff --git a/docs/assets/images/screenshots/editor-menu-session.png b/docs/assets/images/screenshots/editor-menu-session.png new file mode 100644 index 0000000..2026794 Binary files /dev/null and b/docs/assets/images/screenshots/editor-menu-session.png differ diff --git a/docs/assets/images/screenshots/editor-menu-tools.png b/docs/assets/images/screenshots/editor-menu-tools.png new file mode 100644 index 0000000..8bfdc5a Binary files /dev/null and b/docs/assets/images/screenshots/editor-menu-tools.png differ diff --git a/docs/assets/images/screenshots/editor-menu-view.png b/docs/assets/images/screenshots/editor-menu-view.png new file mode 100644 index 0000000..0e8f07b Binary files /dev/null and b/docs/assets/images/screenshots/editor-menu-view.png differ diff --git a/docs/assets/images/screenshots/editor-otb-sprites.png b/docs/assets/images/screenshots/editor-otb-sprites.png new file mode 100644 index 0000000..23268d6 Binary files /dev/null and b/docs/assets/images/screenshots/editor-otb-sprites.png differ diff --git a/docs/assets/js/lightbox.js b/docs/assets/js/lightbox.js new file mode 100644 index 0000000..584b159 --- /dev/null +++ b/docs/assets/js/lightbox.js @@ -0,0 +1,53 @@ +/* Gallery lightbox — uses native element, no dependencies */ +(function () { + 'use strict'; + + function buildLightbox() { + var existing = document.getElementById('gallery-lightbox'); + if (existing) return existing; + + var dlg = document.createElement('dialog'); + dlg.id = 'gallery-lightbox'; + dlg.innerHTML = + '
' + + '' + + '' + + '
'; + document.body.appendChild(dlg); + + /* close on backdrop click */ + dlg.addEventListener('click', function (e) { + if (e.target === dlg) dlg.close(); + }); + + dlg.querySelector('.lb-close').addEventListener('click', function () { + dlg.close(); + }); + + return dlg; + } + + function bindGallery(dlg) { + document.querySelectorAll('.gallery-item[data-src]').forEach(function (btn) { + if (btn.dataset.lbBound) return; + btn.dataset.lbBound = '1'; + btn.addEventListener('click', function () { + var img = dlg.querySelector('.lb-img'); + img.src = btn.dataset.src; + img.alt = btn.dataset.alt || ''; + dlg.showModal(); + }); + }); + } + + function init() { + var dlg = buildLightbox(); + bindGallery(dlg); + } + + if (document.readyState === 'loading') { + document.addEventListener('DOMContentLoaded', init); + } else { + init(); + } +}()); diff --git a/docs/index.md b/docs/index.md index d563b29..7e188b0 100644 --- a/docs/index.md +++ b/docs/index.md @@ -52,7 +52,7 @@ A cross-platform visual editor for Tibia game assets — sprites, items, and out Built with **.NET 10** and **Avalonia UI 11**, it runs natively on 6 platforms with self-contained single-file executables. [Download](https://github.com/DistTopic/assets-and-map-editor/releases/latest){ .md-button .md-button--primary } -[Documentation](projects/assets-and-map-editor.md){ .md-button } +[Documentation](projects/assets-and-map-editor/index.md){ .md-button } --- diff --git a/docs/projects/assets-and-map-editor.md b/docs/projects/assets-and-map-editor.md deleted file mode 100644 index adc5c78..0000000 --- a/docs/projects/assets-and-map-editor.md +++ /dev/null @@ -1,102 +0,0 @@ ---- -title: Assets And Map Editor -description: Cross-platform visual editor for Tibia game assets. ---- - -# Assets And Map Editor - -A cross-platform visual editor for Tibia game assets — sprites, items, and outfits. - -![Latest Release](https://img.shields.io/github/v/release/DistTopic/assets-and-map-editor?include_prereleases&label=version&color=2f81f7) -![Downloads](https://img.shields.io/github/downloads/DistTopic/assets-and-map-editor/total?color=3fb950) -![Security](https://img.shields.io/github/actions/workflow/status/DistTopic/assets-and-map-editor/security-scan.yml?label=security%20scan&color=3fb950) - -[Download Latest](https://github.com/DistTopic/assets-and-map-editor/releases/latest){ .md-button .md-button--primary } -[Source Code](https://github.com/DistTopic/assets-and-map-editor){ .md-button } -[Report Issue](https://github.com/DistTopic/assets-and-map-editor/issues/new/choose){ .md-button } - ---- - -## Overview - -The Assets And Map Editor is a desktop application for viewing and editing Tibia game data files. It supports the DAT, SPR, OTB, and OTBM file formats used by Open Tibia servers. - -### Key features - -
- -- :material-monitor-multiple: **Cross-platform** - - Runs natively on Windows (x64/ARM64), macOS (x64/ARM64), and Linux (x64/ARM64). - -- :material-package-variant-closed: **Single-file executable** - - No installation or runtime required. Download, verify, and run. - -- :material-palette: **Modern UI** - - Built with Avalonia UI 11 for a native look and feel on each platform. - -- :material-shield-check: **Verified builds** - - Every release includes SHA-256 checksums for integrity verification. - -
- -## Supported platforms - -| Platform | Architecture | Format | -|----------|-------------|--------| -| Windows | x64, ARM64 | `.zip` (portable) | -| macOS | x64 (Intel), ARM64 (Apple Silicon) | `.zip` (app bundle) | -| Linux | x64, ARM64 | `.zip` (portable) | - -## Technology stack - -| Component | Technology | -|-----------|-----------| -| Runtime | .NET 10 LTS | -| Language | C# 13 | -| UI Framework | Avalonia UI 11.3 | -| MVVM | CommunityToolkit.Mvvm 8.4 | -| Compression | SharpCompress 0.38 | -| CI/CD | GitHub Actions | -| Security | CodeQL, Dependency Review | - -## Download & verify - -1. Download the latest release for your platform from [GitHub Releases](https://github.com/DistTopic/assets-and-map-editor/releases/latest) -2. Download the `checksums.sha256` file from the same release -3. Verify the integrity: - -=== "Linux / macOS" - - ```bash - sha256sum -c checksums.sha256 --ignore-missing - ``` - -=== "Windows (PowerShell)" - - ```powershell - (Get-FileHash .\AssetsEditor-*.zip -Algorithm SHA256).Hash - # Compare with the hash in checksums.sha256 - ``` - -!!! warning "Windows SmartScreen" - Windows may show a SmartScreen warning because the binary is not code-signed. This is expected for open source projects without code signing. Verify the SHA-256 checksum to confirm the file is authentic. See the [Security documentation](https://github.com/DistTopic/assets-and-map-editor/blob/main/SECURITY.md) for full details. - -## Documentation - -Full project documentation is in the repository: - -- [Getting Started](https://github.com/DistTopic/assets-and-map-editor/blob/main/docs/GETTING_STARTED.md) -- [Architecture](https://github.com/DistTopic/assets-and-map-editor/blob/main/docs/ARCHITECTURE.md) -- [File Formats](https://github.com/DistTopic/assets-and-map-editor/blob/main/docs/FILE_FORMATS.md) -- [Build & Verification](https://github.com/DistTopic/assets-and-map-editor/blob/main/docs/BUILD_AND_VERIFICATION.md) -- [Branching Strategy](https://github.com/DistTopic/assets-and-map-editor/blob/main/docs/BRANCHING_STRATEGY.md) -- [Contributing](https://github.com/DistTopic/assets-and-map-editor/blob/main/CONTRIBUTING.md) -- [Changelog](https://github.com/DistTopic/assets-and-map-editor/blob/main/CHANGELOG.md) - -## License - -Licensed under the [GNU General Public License v3.0](https://github.com/DistTopic/assets-and-map-editor/blob/main/LICENSE). diff --git a/docs/projects/assets-and-map-editor/features-interface.en.md b/docs/projects/assets-and-map-editor/features-interface.en.md new file mode 100644 index 0000000..743fc07 --- /dev/null +++ b/docs/projects/assets-and-map-editor/features-interface.en.md @@ -0,0 +1,85 @@ +# Interface + +A modern layout built for people who work with Open Tibia servers every day. + +--- + +## Menu navigation + +### File + +![File menu](/assets/images/screenshots/editor-menu-file.png) + +| Option | Shortcut | Description | +|--------|----------|-------------| +| Select Client Folder | — | Points to the folder with `.dat` and `.spr` client files | +| Open OTB... | — | Opens a server item file | +| Open Map... | — | Opens an `.otbm` map file | +| Save All | `⌘S` | Saves the open OTB and map | +| Export Selected... | `⌘E` | Exports the selected items | + +### Session + +![Session menu](/assets/images/screenshots/editor-menu-session.png) + +| Option | Description | +|--------|-------------| +| New Session | Creates a new editing session | +| Transplant Item... | Moves an item from another OTB into the current session | +| Merge Session Into Current... | Merges another session into the current one, preserving IDs | + +### View + +![View menu](/assets/images/screenshots/editor-menu-view.png) + +Controls what is shown in the map viewer: floors, grid, zones (PZ, PvP, NoLog), animations, waypoints, and lighting. + +### Tools + +![Tools menu](/assets/images/screenshots/editor-menu-tools.png) + +| Option | Description | +|--------|-------------| +| Brush Editor | Create and edit brushes for map painting | +| Find Unmapped Client Items... | Lists client items with no matching server entry | +| Find Duplicate Items... | Detects items sharing the same Client ID | +| Compact Sprites (Fill Empty Slots)... | Removes empty gaps in the sprite table | + +### Edit — Border Automagic + +![Edit — Border Automagic](/assets/images/screenshots/editor-menu-edit.png) + +When enabled, the editor automatically generates transition borders when painting adjacent tiles of different types. + +### Map context menu + +![Map context menu](/assets/images/screenshots/editor-map-context.png) + +Right-click any tile to access: + +| Option | Description | +|--------|-------------| +| Copy Server ID | Copies the item's server ID | +| Copy Client ID | Copies the item's client ID | +| Copy Position | Copies the X, Y, Z coordinates of the tile | +| Select RAW | Selects the tile in raw mode | +| Lookup in Collection | Finds the item in the brush collection | +| Browse Tile | Opens the tile inspection panel | + +--- + +## What you'll find + +- **Native dark theme** — easy on the eyes during long sprite analysis sessions +- **Three-panel layout** — side navigation, center view, and properties panel always visible +- **Keyboard shortcuts** — access core functions without interrupting your workflow +- **Status bar** — selected item ID, name, and type always visible at the bottom +- **Fully portable** — unzip and open, no installation, no extra dependencies + +## Available platforms + +| System | Status | +|--------|--------| +| Windows (x64 and ARM64) | ✅ Available | +| macOS (Intel and Apple Silicon) | ✅ Available | +| Linux (x64 and ARM64) | ✅ Available | diff --git a/docs/projects/assets-and-map-editor/features-interface.es.md b/docs/projects/assets-and-map-editor/features-interface.es.md new file mode 100644 index 0000000..e173802 --- /dev/null +++ b/docs/projects/assets-and-map-editor/features-interface.es.md @@ -0,0 +1,85 @@ +# Interfaz + +Un diseño moderno pensado para quienes trabajan con servidores Open Tibia a diario. + +--- + +## Navegación por menús + +### File + +![Menú File](/assets/images/screenshots/editor-menu-file.png) + +| Opción | Atajo | Descripción | +|--------|-------|-------------| +| Select Client Folder | — | Define la carpeta con los archivos `.dat` y `.spr` del cliente | +| Open OTB... | — | Abre un archivo de ítems del servidor | +| Open Map... | — | Abre un archivo de mapa `.otbm` | +| Save All | `⌘S` | Guarda el OTB y el mapa abiertos | +| Export Selected... | `⌘E` | Exporta los ítems seleccionados | + +### Session + +![Menú Session](/assets/images/screenshots/editor-menu-session.png) + +| Opción | Descripción | +|--------|-------------| +| New Session | Crea una nueva sesión de edición | +| Transplant Item... | Mueve un ítem de otro OTB a la sesión actual | +| Merge Session Into Current... | Combina otra sesión con la actual conservando IDs | + +### View + +![Menú View](/assets/images/screenshots/editor-menu-view.png) + +Controla qué se muestra en el visor del mapa: pisos, cuadrícula, zonas (PZ, PvP, NoLog), animaciones, waypoints e iluminación. + +### Tools + +![Menú Tools](/assets/images/screenshots/editor-menu-tools.png) + +| Opción | Descripción | +|--------|-------------| +| Brush Editor | Crea y edita brushes para pintura en el mapa | +| Find Unmapped Client Items... | Lista ítems del cliente sin correspondencia en el servidor | +| Find Duplicate Items... | Detecta ítems con el mismo Client ID | +| Compact Sprites (Fill Empty Slots)... | Elimina huecos vacíos en la tabla de sprites | + +### Edit — Border Automagic + +![Edit — Border Automagic](/assets/images/screenshots/editor-menu-edit.png) + +Cuando está activado, el editor genera bordes de transición automáticamente al pintar tiles adyacentes de tipos distintos. + +### Menú contextual del mapa + +![Menú contextual del mapa](/assets/images/screenshots/editor-map-context.png) + +Clic derecho en cualquier tile para acceder a: + +| Opción | Descripción | +|--------|-------------| +| Copy Server ID | Copia el ID del ítem en el servidor | +| Copy Client ID | Copia el ID del ítem en el cliente | +| Copy Position | Copia las coordenadas X, Y, Z del tile | +| Select RAW | Selecciona el tile en modo raw | +| Lookup in Collection | Localiza el ítem en la colección de brushes | +| Browse Tile | Abre el panel de inspección del tile | + +--- + +## Qué encontrarás + +- **Tema oscuro nativo** — ideal para analizar sprites en sesiones largas sin cansar la vista +- **Diseño de tres paneles** — navegación lateral, vista central y panel de propiedades siempre visibles +- **Atajos de teclado** — accede a las funciones principales sin interrumpir tu flujo de trabajo +- **Barra de estado** — ID, nombre y tipo del ítem seleccionado siempre visibles en la parte inferior +- **Totalmente portátil** — descomprime y abre, sin instalación ni dependencias adicionales + +## Plataformas disponibles + +| Sistema | Estado | +|---------|--------| +| Windows (x64 y ARM64) | ✅ Disponible | +| macOS (Intel y Apple Silicon) | ✅ Disponible | +| Linux (x64 y ARM64) | ✅ Disponible | diff --git a/docs/projects/assets-and-map-editor/features-interface.md b/docs/projects/assets-and-map-editor/features-interface.md new file mode 100644 index 0000000..1696f93 --- /dev/null +++ b/docs/projects/assets-and-map-editor/features-interface.md @@ -0,0 +1,86 @@ +# Interface + +Um visual moderno feito para quem trabalha com servidores Open Tibia no dia a dia. + +--- + +## Navegação pelos menus + +### File + +![Menu File](/assets/images/screenshots/editor-menu-file.png) + +| Opção | Atalho | Descrição | +|--------|--------|----------| +| Select Client Folder | — | Define a pasta com os arquivos `.dat` e `.spr` do cliente | +| Open OTB... | — | Abre um arquivo de itens do servidor | +| Open Map... | — | Abre um arquivo de mapa `.otbm` | +| Save All | `⌘S` | Salva OTB e mapa abertos | +| Export Selected... | `⌘E` | Exporta os itens selecionados | + +### Session + +![Menu Session](/assets/images/screenshots/editor-menu-session.png) + +| Opção | Descrição | +|--------|----------| +| New Session | Cria uma nova sessão de edição | +| Transplant Item... | Move um item de outro OTB para a sessão atual | +| Merge Session Into Current... | Mescla outra sessão na atual, preservando IDs | + +### View + +![Menu View](/assets/images/screenshots/editor-menu-view.png) + +Controla o que é exibido no visualizador de mapa: floors, grades, zonas (PZ, PvP, NoLog), animações, waypoints e iluminação. + +### Tools + +![Menu Tools](/assets/images/screenshots/editor-menu-tools.png) + +| Opção | Descrição | +|--------|----------| +| Brush Editor | Cria e edita brushes para pintura no mapa | +| Find Unmapped Client Items... | Lista itens do cliente sem correspondência no servidor | +| Find Duplicate Items... | Detecta itens com o mesmo Client ID em entradas diferentes | +| Compact Sprites (Fill Empty Slots)... | Remove lacunas vazias na tabela de sprites | + +### Edit — Border Automagic + +![Menu Edit — Border Automagic](/assets/images/screenshots/editor-menu-edit.png) + +Quando ativado, o editor gera bordas de transição automaticamente ao pintar tiles adjacentes de tipos diferentes. + +### Context menu do mapa + +![Context menu do mapa](/assets/images/screenshots/editor-map-context.png) + +Clique direito em qualquer tile para acessar: + +| Opção | Descrição | +|--------|----------| +| Copy Server ID | Copia o ID do item no servidor | +| Copy Client ID | Copia o ID do item no cliente | +| Copy Position | Copia as coordenadas X, Y, Z do tile | +| Select RAW | Seleciona o tile em modo raw | +| Lookup in Collection | Encontra o item na coleção de brushes | +| Browse Tile | Abre o painel de inspeção do tile | + +--- + +## O que você encontra + +- **Tema escuro nativo** — ideal para analisar sprites por longos períodos sem cansar a vista +- **Layout em três painéis** — navegação lateral, visualização central e painel de propriedades sempre visíveis +- **Atalhos de teclado** — acesse as principais funções sem tirar as mãos do teclado +- **Barra de status** — ID, nome e tipo do item selecionado sempre visíveis na parte inferior +- **Totalmente portátil** — descompacte e abra, sem instalação e sem dependências adicionais + +## Plataformas disponíveis + +| Sistema | Status | +|---------|--------| +| Windows (x64 e ARM64) | ✅ Disponível | +| macOS (Intel e Apple Silicon) | ✅ Disponível | +| Linux (x64 e ARM64) | ✅ Disponível | + diff --git a/docs/projects/assets-and-map-editor/features-items.en.md b/docs/projects/assets-and-map-editor/features-items.en.md new file mode 100644 index 0000000..549b159 --- /dev/null +++ b/docs/projects/assets-and-map-editor/features-items.en.md @@ -0,0 +1,20 @@ +# Items & OTB + +Find and edit any server item in seconds — no spreadsheets or external notes needed. + +![OTB Item Editor](/assets/images/screenshots/editor-otb-sprites.png) + +--- + +## What you can do + +- **Tree browsing** — explore all items organized by category, just as they appear on the server +- **Search by ID or name** — real-time filtering without waiting for the list to reload +- **View all attributes** — item type, group, and special properties gathered in one panel +- **Edit properties** — modify item visual attributes directly in the editor +- **Compare versions** — open two OTB files and see the differences side by side + +--- + +!!! info "Supported formats" + `.otb` read and write are both available. diff --git a/docs/projects/assets-and-map-editor/features-items.es.md b/docs/projects/assets-and-map-editor/features-items.es.md new file mode 100644 index 0000000..7befea7 --- /dev/null +++ b/docs/projects/assets-and-map-editor/features-items.es.md @@ -0,0 +1,20 @@ +# Ítems y OTB + +Encuentra y edita cualquier ítem de tu servidor en segundos — sin hojas de cálculo ni notas externas. + +![Editor de Ítems OTB](/assets/images/screenshots/editor-otb-sprites.png) + +--- + +## Qué puedes hacer + +- **Navegación en árbol** — explora todos los ítems organizados por categoría, igual que en el servidor +- **Buscar por ID o nombre** — filtrado en tiempo real sin esperar que se recargue la lista +- **Ver todos los atributos** — tipo, grupo y propiedades especiales del ítem en un solo panel +- **Editar propiedades** — modifica atributos visuales directamente en el editor +- **Comparar versiones** — abre dos archivos OTB y compara las diferencias lado a lado + +--- + +!!! info "Formatos soportados" + `.otb` tiene lectura y escritura disponibles. diff --git a/docs/projects/assets-and-map-editor/features-items.md b/docs/projects/assets-and-map-editor/features-items.md new file mode 100644 index 0000000..4b3e567 --- /dev/null +++ b/docs/projects/assets-and-map-editor/features-items.md @@ -0,0 +1,20 @@ +# Itens e OTB + +Encontre e edite qualquer item do seu servidor em segundos — sem planilhas nem anotações externas. + +![Editor de Itens OTB](/assets/images/screenshots/editor-otb-sprites.png) + +--- + +## O que você pode fazer + +- **Navegar em árvore** — explore todos os itens organizados por categoria, assim como aparecem no servidor +- **Busca por ID ou nome** — filtre em tempo real sem esperar a lista recarregar +- **Ver todos os atributos** — tipo, grupo e propriedades especiais do item reunidos em um painel +- **Editar propriedades** — modifique atributos visuais dos itens diretamente no editor +- **Comparar versões** — abra dois arquivos OTB e veja as diferenças lado a lado + +--- + +!!! info "Formatos suportados" + `.otb` tem leitura e escrita disponíveis. diff --git a/docs/projects/assets-and-map-editor/features-maps.en.md b/docs/projects/assets-and-map-editor/features-maps.en.md new file mode 100644 index 0000000..b6a019d --- /dev/null +++ b/docs/projects/assets-and-map-editor/features-maps.en.md @@ -0,0 +1,20 @@ +# OTBM Maps + +View and inspect your server map without any additional tools. + +![Top-down OTBM map viewer](/assets/images/screenshots/editor-map-view.png) + +--- + +## What you can do + +- **Top-down view** — see the full map with terrain types color-coded +- **Smooth zoom and scroll** — navigate from a specific region to a full world overview +- **Inspect tiles** — click any position to see the items, floor, and attributes present +- **Multiple floors** — switch between each map floor with a single click on the selector +- **Mini-map** — quick navigation panel so you never get lost on large maps + +--- + +!!! info "Supported formats" + Reading `.otbm` is available now. Editing and writing are in development — see [Work in Progress](wip.md). diff --git a/docs/projects/assets-and-map-editor/features-maps.es.md b/docs/projects/assets-and-map-editor/features-maps.es.md new file mode 100644 index 0000000..b56ea0d --- /dev/null +++ b/docs/projects/assets-and-map-editor/features-maps.es.md @@ -0,0 +1,20 @@ +# Mapas OTBM + +Visualiza e inspecciona el mapa de tu servidor sin herramientas adicionales. + +![Visor de mapa OTBM cenital](/assets/images/screenshots/editor-map-view.png) + +--- + +## Qué puedes hacer + +- **Vista cenital** — ve el mapa completo con terrenos diferenciados por color +- **Zoom y desplazamiento suave** — navega desde una región específica hasta la vista global del mundo +- **Inspeccionar tiles** — haz clic en cualquier posición para ver los ítems, piso y atributos presentes +- **Múltiples pisos** — cambia entre cada floor del mapa con un solo clic en el selector +- **Mini-mapa** — panel de navegación rápida para no perderte en mapas grandes + +--- + +!!! info "Formatos soportados" + Lectura de `.otbm` ya disponible. Edición y escritura en desarrollo — ver [En Desarrollo](wip.md). diff --git a/docs/projects/assets-and-map-editor/features-maps.md b/docs/projects/assets-and-map-editor/features-maps.md new file mode 100644 index 0000000..bd96568 --- /dev/null +++ b/docs/projects/assets-and-map-editor/features-maps.md @@ -0,0 +1,20 @@ +# Mapas OTBM + +Visualize e inspecione o mapa do seu servidor sem precisar de ferramentas adicionais. + +![Visualizador de mapa OTBM top-down](/assets/images/screenshots/editor-map-view.png) + +--- + +## O que você pode fazer + +- **Visualização top-down** — veja o mapa completo com cores diferenciadas por tipo de terreno +- **Zoom e scroll suave** — navegue de uma região específica até uma visão geral de todo o mundo +- **Inspecionar tiles** — clique em qualquer posição para ver os itens, andar e atributos presentes +- **Múltiplos andares** — alterne entre cada floor do mapa com um clique no seletor +- **Mini-mapa** — painel de orientação rápida para não se perder em mapas grandes + +--- + +!!! info "Formatos suportados" + Leitura de `.otbm` já disponível. Edição e escrita estão em desenvolvimento — veja [Em Desenvolvimento](wip.md). diff --git a/docs/projects/assets-and-map-editor/features-sprites.en.md b/docs/projects/assets-and-map-editor/features-sprites.en.md new file mode 100644 index 0000000..9bbe66f --- /dev/null +++ b/docs/projects/assets-and-map-editor/features-sprites.en.md @@ -0,0 +1,20 @@ +# Sprites & Animations + +Browse every sprite in your server right from the editor — no extra tools or manual unpacking needed. + +![OTB editor with sprite and animation viewer](/assets/images/screenshots/editor-otb-sprites.png) + +--- + +## What you can do + +- **Browse by category** — filter between items, creatures, effects, and projectiles with a single click +- **Zoom and adjustable grid** — zoom into individual sprites or view a full grid at once +- **Animation preview** — play any animated sprite frame by frame +- **Export as PNG** — save individual sprites in full quality directly from the editor +- **Import external sprites** — load PNG files from outside with a live preview before confirming the import + +--- + +!!! info "Supported formats" + Reading `.dat` and `.spr` is available now. Writing is under development — see [Work in Progress](wip.md). diff --git a/docs/projects/assets-and-map-editor/features-sprites.es.md b/docs/projects/assets-and-map-editor/features-sprites.es.md new file mode 100644 index 0000000..b36414d --- /dev/null +++ b/docs/projects/assets-and-map-editor/features-sprites.es.md @@ -0,0 +1,20 @@ +# Sprites y Animaciones + +Explora cada sprite de tu servidor desde el editor integrado — sin programas adicionales ni descompresión manual. + +![Editor OTB con visualizador de sprites y animaciones](/assets/images/screenshots/editor-otb-sprites.png) + +--- + +## Qué puedes hacer + +- **Navegar por categoría** — filtra entre ítems, criaturas, efectos y proyectiles con un clic +- **Zoom y cuadrícula ajustable** — acerca sprites individuales o ve la cuadrícula completa de una vez +- **Vista previa de animación** — reproduce cualquier sprite animado cuadro a cuadro +- **Exportar como PNG** — guarda sprites individuales en alta calidad directamente desde el editor +- **Importar sprites externos** — carga archivos PNG externos con vista previa en tiempo real antes de confirmar + +--- + +!!! info "Formatos soportados" + Lectura de `.dat` y `.spr` disponible. Escritura en desarrollo — ver [En Desarrollo](wip.md). diff --git a/docs/projects/assets-and-map-editor/features-sprites.md b/docs/projects/assets-and-map-editor/features-sprites.md new file mode 100644 index 0000000..636c4fb --- /dev/null +++ b/docs/projects/assets-and-map-editor/features-sprites.md @@ -0,0 +1,20 @@ +# Sprites e Animações + +Veja cada sprite do seu servidor no navegador integrado — sem precisar abrir outros programas ou descompactar arquivos manualmente. + +![Editor OTB com visualizador de sprites e animações](/assets/images/screenshots/editor-otb-sprites.png) + +--- + +## O que você pode fazer + +- **Navegar por categoria** — filtre entre itens, criaturas, efeitos e projéteis com um clique +- **Zoom e grade ajustável** — aproxime sprites individuais ou visualize um grid completo de uma só vez +- **Preview de animação** — reproduza qualquer sprite animado quadro a quadro +- **Exportar como PNG** — salve sprites individuais em alta qualidade diretamente do editor +- **Importar sprites externos** — carregue arquivos PNG de fora com prévia imediata antes de confirmar a importação + +--- + +!!! info "Formatos suportados" + `.dat` e `.spr` têm leitura disponível. Escrita está em desenvolvimento — veja [Em Desenvolvimento](wip.md). diff --git a/docs/projects/assets-and-map-editor/features.en.md b/docs/projects/assets-and-map-editor/features.en.md new file mode 100644 index 0000000..75cbea7 --- /dev/null +++ b/docs/projects/assets-and-map-editor/features.en.md @@ -0,0 +1,46 @@ +# Features + +Assets And Map Editor covers the main Tibia asset and map workflows — all in one portable tool, no installation needed. + +--- + +
+ +- :material-palette: **Sprites & Animations** + + --- + + Browse and export client sprites — items, creatures, effects, and projectiles with animation preview. + + [:octicons-arrow-right-24: See details](features-sprites.md) + +- :material-package-variant: **Items & OTB** + + --- + + Explore the server item table, filter by ID or name, and edit properties. + + [:octicons-arrow-right-24: See details](features-items.md) + +- :material-map: **OTBM Maps** + + --- + + Open and navigate server maps with zoom, multiple floors, and tile inspection. + + [:octicons-arrow-right-24: See details](features-maps.md) + +- :material-palette-swatch: **Interface** + + --- + + Three-panel layout with dark theme, keyboard shortcuts, and fully portable. + + [:octicons-arrow-right-24: See details](features-interface.md) + +
+ +--- + +Want to know what’s still being built? [Work in Progress →](wip.md) + diff --git a/docs/projects/assets-and-map-editor/features.es.md b/docs/projects/assets-and-map-editor/features.es.md new file mode 100644 index 0000000..16ab80b --- /dev/null +++ b/docs/projects/assets-and-map-editor/features.es.md @@ -0,0 +1,46 @@ +# Características + +Assets And Map Editor cubre los principales flujos de trabajo con assets y mapas de Tibia — en una sola herramienta portátil, sin instalación. + +--- + +
+ +- :material-palette: **Sprites y Animaciones** + + --- + + Explora y exporta sprites del cliente — ítems, criaturas, efectos y proyectiles con vista previa de animación. + + [:octicons-arrow-right-24: Ver detalles](features-sprites.md) + +- :material-package-variant: **Ítems y OTB** + + --- + + Explora la tabla de ítems del servidor, filtra por ID o nombre y edita propiedades. + + [:octicons-arrow-right-24: Ver detalles](features-items.md) + +- :material-map: **Mapas OTBM** + + --- + + Abre y navega mapas del servidor con zoom, múltiples pisos e inspección de tiles. + + [:octicons-arrow-right-24: Ver detalles](features-maps.md) + +- :material-palette-swatch: **Interfaz** + + --- + + Diseño de tres paneles con tema oscuro, atajos de teclado y totalmente portátil. + + [:octicons-arrow-right-24: Ver detalles](features-interface.md) + +
+ +--- + +¿Quieres saber qué se está desarrollando? [En Desarrollo →](wip.md) + diff --git a/docs/projects/assets-and-map-editor/features.md b/docs/projects/assets-and-map-editor/features.md new file mode 100644 index 0000000..657d562 --- /dev/null +++ b/docs/projects/assets-and-map-editor/features.md @@ -0,0 +1,47 @@ +# Funcionalidades + +O Assets And Map Editor cobre os principais fluxos de trabalho com assets e mapas de Tibia — em uma única ferramenta portátil, sem instalação. + +--- + +
+ +- :material-palette: **Sprites e Animações** + + --- + + Veja, navegue e exporte sprites do cliente — itens, criaturas, efeitos e projéteis com preview de animação. + + [:octicons-arrow-right-24: Ver detalhes](features-sprites.md) + +- :material-package-variant: **Itens e OTB** + + --- + + Explore a tabela de itens do servidor, filtre por ID ou nome e edite propriedades. + + [:octicons-arrow-right-24: Ver detalhes](features-items.md) + +- :material-map: **Mapas OTBM** + + --- + + Abra e navegue mapas do servidor com zoom, múltiplos andares e inspeção de tiles. + + [:octicons-arrow-right-24: Ver detalhes](features-maps.md) + +- :material-palette-swatch: **Interface** + + --- + + Layout em três painéis com tema escuro, atalhos e totalmente portátil. + + [:octicons-arrow-right-24: Ver detalhes](features-interface.md) + +
+ +--- + +Quer saber o que ainda está sendo desenvolvido? [Em Desenvolvimento →](wip.md) + + diff --git a/docs/projects/assets-and-map-editor/formats.en.md b/docs/projects/assets-and-map-editor/formats.en.md new file mode 100644 index 0000000..3111e4d --- /dev/null +++ b/docs/projects/assets-and-map-editor/formats.en.md @@ -0,0 +1,52 @@ +# Compatible Versions + +Supported file formats for reading and writing. + +--- + +## DAT / SPR — Tibia client visual assets + +The `.dat` and `.spr` files store metadata and sprites for all in-game objects. The editor supports multiple versions of the graphics protocol: + +| Protocol | Compatible clients | Read | Write | +|---------|--------------------|------|-------| +| 7.72 | Tibia 7.x | ✅ | 🚧 | +| 8.60 | Tibia 8.x | ✅ | 🚧 | +| 9.86 | Tibia 9.x | ✅ | 🚧 | +| 10.x | Tibia 10.0–10.98 | ✅ | 🚧 | +| 12.x (extended) | Tibia 12.x+ | ✅ | 🚧 | + +!!! note "Write support in progress" + DAT/SPR writing is being implemented. Track progress in the [roadmap](wip.md). + +--- + +## OTB — Server items (Open Tibia Binary) + +The `items.otb` file defines attributes and properties for all items used by an OpenTibia server. + +| OTB Version | Read | Write | +|------------|------|-------| +| v1 | ✅ | ✅ | +| v2 | ✅ | ✅ | +| v3 | ✅ | ✅ | + +--- + +## OTBM — Maps (Open Tibia Binary Map) + +The `.otbm` file stores the server world map, including terrain, items, and tiles. + +| OTBM Version | Read | Write | +|-------------|------|-------| +| v1 | ✅ | 🚧 | +| v2 | ✅ | 🚧 | + +--- + +## Legend + +| Symbol | Meaning | +|--------|---------| +| ✅ | Supported and stable | +| 🚧 | In development | diff --git a/docs/projects/assets-and-map-editor/formats.es.md b/docs/projects/assets-and-map-editor/formats.es.md new file mode 100644 index 0000000..9ecad26 --- /dev/null +++ b/docs/projects/assets-and-map-editor/formats.es.md @@ -0,0 +1,52 @@ +# Versiones Compatibles + +Formatos de archivo soportados para lectura y escritura. + +--- + +## DAT / SPR — Assets visuales del cliente Tibia + +Los archivos `.dat` y `.spr` almacenan metadatos y sprites de todos los objetos del juego. El editor soporta múltiples versiones del protocolo gráfico: + +| Protocolo | Clientes compatibles | Lectura | Escritura | +|-----------|---------------------|---------|-----------| +| 7.72 | Tibia 7.x | ✅ | 🚧 | +| 8.60 | Tibia 8.x | ✅ | 🚧 | +| 9.86 | Tibia 9.x | ✅ | 🚧 | +| 10.x | Tibia 10.0–10.98 | ✅ | 🚧 | +| 12.x (extended) | Tibia 12.x+ | ✅ | 🚧 | + +!!! note "Escritura en progreso" + La escritura para DAT/SPR está siendo implementada. Sigue el progreso en el [roadmap](wip.md). + +--- + +## OTB — Ítems del servidor (Open Tibia Binary) + +El archivo `items.otb` define atributos y propiedades de todos los ítems utilizados por un servidor OpenTibia. + +| Versión OTB | Lectura | Escritura | +|------------|---------|-----------| +| v1 | ✅ | ✅ | +| v2 | ✅ | ✅ | +| v3 | ✅ | ✅ | + +--- + +## OTBM — Mapas (Open Tibia Binary Map) + +El archivo `.otbm` almacena el mapa del mundo del servidor, incluyendo terrenos, ítems y tiles. + +| Versión OTBM | Lectura | Escritura | +|-------------|---------|-----------| +| v1 | ✅ | 🚧 | +| v2 | ✅ | 🚧 | + +--- + +## Leyenda + +| Símbolo | Significado | +|---------|-------------| +| ✅ | Soportado y estable | +| 🚧 | En desarrollo | diff --git a/docs/projects/assets-and-map-editor/formats.md b/docs/projects/assets-and-map-editor/formats.md new file mode 100644 index 0000000..182ed81 --- /dev/null +++ b/docs/projects/assets-and-map-editor/formats.md @@ -0,0 +1,52 @@ +# Versões Compatíveis + +Formatos de arquivo suportados para leitura e escrita. + +--- + +## DAT / SPR — Assets visuais do cliente Tibia + +Os arquivos `.dat` e `.spr` armazenam metadados e sprites de todos os objetos do jogo. O editor suporta múltiplas versões do protocolo gráfico: + +| Protocolo | Clientes compatíveis | Leitura | Escrita | +|-----------|---------------------|---------|---------| +| 7.72 | Tibia 7.x | ✅ | 🚧 | +| 8.60 | Tibia 8.x | ✅ | 🚧 | +| 9.86 | Tibia 9.x | ✅ | 🚧 | +| 10.x | Tibia 10.0–10.98 | ✅ | 🚧 | +| 12.x (extended) | Tibia 12.x+ | ✅ | 🚧 | + +!!! note "Escrita em andamento" + A escrita para DAT/SPR está sendo implementada. Acompanhe o progresso no [roadmap](wip.md). + +--- + +## OTB — Itens do servidor (Open Tibia Binary) + +O arquivo `items.otb` define atributos e propriedades de todos os itens utilizados pelo servidor OpenTibia. + +| Versão OTB | Leitura | Escrita | +|-----------|---------|---------| +| v1 | ✅ | ✅ | +| v2 | ✅ | ✅ | +| v3 | ✅ | ✅ | + +--- + +## OTBM — Mapas (Open Tibia Binary Map) + +O arquivo `.otbm` armazena o mapa do mundo do servidor, incluindo terrenos, itens e tiles. + +| Versão OTBM | Leitura | Escrita | +|------------|---------|---------| +| v1 | ✅ | 🚧 | +| v2 | ✅ | 🚧 | + +--- + +## Legenda + +| Símbolo | Significado | +|---------|-------------| +| ✅ | Suportado e estável | +| 🚧 | Em desenvolvimento | diff --git a/docs/projects/assets-and-map-editor/gallery.en.md b/docs/projects/assets-and-map-editor/gallery.en.md new file mode 100644 index 0000000..09558be --- /dev/null +++ b/docs/projects/assets-and-map-editor/gallery.en.md @@ -0,0 +1,200 @@ +# Gallery + +Real screenshots of the Assets And Map Editor in action. Click any image to enlarge. + +
+ + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + + + + + + + + +
+ +--- + +## Contribute {#contribute} + +1. Screenshot at minimum 1280×720 resolution +2. Open an [issue](https://github.com/DistTopic/assets-and-map-editor/issues) with label `documentation` +3. Or share on [Discord](https://discord.gg/NrzbcBhh66) diff --git a/docs/projects/assets-and-map-editor/gallery.es.md b/docs/projects/assets-and-map-editor/gallery.es.md new file mode 100644 index 0000000..a8b7b4a --- /dev/null +++ b/docs/projects/assets-and-map-editor/gallery.es.md @@ -0,0 +1,200 @@ +# Galería + +Capturas reales del Assets And Map Editor en uso. Haz clic en cualquier imagen para ampliarla. + +
+ + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + + + + + + + + +
+ +--- + +## Contribuir {#contribuir} + +1. Captura con resolución mínima 1280×720 +2. Abre un [issue](https://github.com/DistTopic/assets-and-map-editor/issues) con etiqueta `documentation` +3. O comparte en el [Discord](https://discord.gg/NrzbcBhh66) diff --git a/docs/projects/assets-and-map-editor/gallery.md b/docs/projects/assets-and-map-editor/gallery.md new file mode 100644 index 0000000..1fab635 --- /dev/null +++ b/docs/projects/assets-and-map-editor/gallery.md @@ -0,0 +1,200 @@ +# Galeria + +Prints reais do Assets And Map Editor em uso. Clique em qualquer imagem para ampliar. + +
+ + + + + + + + + + + + + + + + + + + +
+ + +
+ + + + + + + + + + + + + +
+ +--- + +## Contribuir {#contribuir} + +1. Screenshot com resolução mínima 1280×720 +2. Abra um [issue](https://github.com/DistTopic/assets-and-map-editor/issues) com label `documentation` +3. Ou envie no [Discord](https://discord.gg/NrzbcBhh66) diff --git a/docs/projects/assets-and-map-editor/index.en.md b/docs/projects/assets-and-map-editor/index.en.md new file mode 100644 index 0000000..66b75a0 --- /dev/null +++ b/docs/projects/assets-and-map-editor/index.en.md @@ -0,0 +1,31 @@ +# Assets And Map Editor — Overview + +**Cross-platform visual editor for Tibia game assets — sprites, items, and outfits.** + +[![Version](https://img.shields.io/github/v/release/DistTopic/assets-and-map-editor?include_prereleases&label=version&color=6e7681)](https://github.com/DistTopic/assets-and-map-editor/releases/latest) +[![Downloads](https://img.shields.io/github/downloads/DistTopic/assets-and-map-editor/total?color=6e7681)](https://github.com/DistTopic/assets-and-map-editor/releases) +[![License](https://img.shields.io/github/license/DistTopic/assets-and-map-editor?color=6e7681)](https://github.com/DistTopic/assets-and-map-editor/blob/main/LICENSE) + +[Download :material-download:](https://github.com/DistTopic/assets-and-map-editor/releases/latest){ .md-button .md-button--primary } +[Source Code :material-github:](https://github.com/DistTopic/assets-and-map-editor){ .md-button } +[Discord :fontawesome-brands-discord:](https://discord.gg/NrzbcBhh66){ .md-button } + +--- + +## What is it? + +The **Assets And Map Editor** is a desktop application for viewing and editing Tibia game data files. Built for Open Tibia servers, it supports **DAT**, **SPR**, **OTB**, and **OTBM** formats with a modern, cross-platform interface. + +## Supported platforms + +| Platform | Architecture | Format | +|----------|-------------|--------| +| Windows | x64, ARM64 | `.zip` (portable) | +| macOS | x64 (Intel), ARM64 (Apple Silicon) | `.zip` (app bundle) | +| Linux | x64, ARM64 | `.zip` (portable) | + +## Next steps + +- [Full feature list →](features.md) +- [Work in progress →](wip.md) +- [Screenshot gallery →](gallery.md) diff --git a/docs/projects/assets-and-map-editor/index.es.md b/docs/projects/assets-and-map-editor/index.es.md new file mode 100644 index 0000000..748a4e2 --- /dev/null +++ b/docs/projects/assets-and-map-editor/index.es.md @@ -0,0 +1,30 @@ +# Assets And Map Editor — Descripción General + +**Editor visual multiplataforma para assets del juego Tibia — sprites, ítems y outfits.** + +[![Versión](https://img.shields.io/github/v/release/DistTopic/assets-and-map-editor?include_prereleases&label=versión&color=6e7681)](https://github.com/DistTopic/assets-and-map-editor/releases/latest) +[![Licencia](https://img.shields.io/github/license/DistTopic/assets-and-map-editor?color=6e7681)](https://github.com/DistTopic/assets-and-map-editor/blob/main/LICENSE) + +[Descargar :material-download:](https://github.com/DistTopic/assets-and-map-editor/releases/latest){ .md-button .md-button--primary } +[Código Fuente :material-github:](https://github.com/DistTopic/assets-and-map-editor){ .md-button } +[Discord :fontawesome-brands-discord:](https://discord.gg/NrzbcBhh66){ .md-button } + +--- + +## ¿Qué es? + +El **Assets And Map Editor** es una aplicación de escritorio para visualizar y editar archivos de datos de Tibia. Soporta los formatos **DAT**, **SPR**, **OTB** y **OTBM** con una interfaz moderna y multiplataforma. + +## Plataformas soportadas + +| Plataforma | Arquitectura | Formato | +|------------|-------------|---------| +| Windows | x64, ARM64 | `.zip` (portátil) | +| macOS | x64 (Intel), ARM64 (Apple Silicon) | `.zip` (app bundle) | +| Linux | x64, ARM64 | `.zip` (portátil) | + +## Próximos pasos + +- [Lista completa de características →](features.md) +- [En desarrollo →](wip.md) +- [Galería de capturas →](gallery.md) diff --git a/docs/projects/assets-and-map-editor/index.md b/docs/projects/assets-and-map-editor/index.md new file mode 100644 index 0000000..b1de4a9 --- /dev/null +++ b/docs/projects/assets-and-map-editor/index.md @@ -0,0 +1,65 @@ +# Assets And Map Editor + +**Editor visual cross-platform para assets do jogo Tibia — sprites, itens e outfits.** + +[![Versão](https://img.shields.io/github/v/release/DistTopic/assets-and-map-editor?include_prereleases&label=versão&color=6e7681)](https://github.com/DistTopic/assets-and-map-editor/releases/latest) +[![Downloads](https://img.shields.io/github/downloads/DistTopic/assets-and-map-editor/total?color=6e7681)](https://github.com/DistTopic/assets-and-map-editor/releases) +[![Segurança](https://img.shields.io/github/actions/workflow/status/DistTopic/assets-and-map-editor/security-scan.yml?label=security+scan&color=6e7681)](https://github.com/DistTopic/assets-and-map-editor/actions) +[![Licença](https://img.shields.io/github/license/DistTopic/assets-and-map-editor?color=6e7681)](https://github.com/DistTopic/assets-and-map-editor/blob/main/LICENSE) + +[Baixar :material-download:](https://github.com/DistTopic/assets-and-map-editor/releases/latest){ .md-button .md-button--primary } +[Código Fonte :material-github:](https://github.com/DistTopic/assets-and-map-editor){ .md-button } +[Discord :fontawesome-brands-discord:](https://discord.gg/NrzbcBhh66){ .md-button } + +--- + +## O que é? + +O **Assets And Map Editor** é uma aplicação desktop para visualizar e editar arquivos de dados do Tibia. Desenvolvido para servidores Open Tibia, ele suporta os formatos **DAT**, **SPR**, **OTB** e **OTBM**, trazendo uma interface moderna e intuitiva para trabalhar com sprites, itens e mapas. + +## Por que usar? + +| Problema | Solução | +|----------|---------| +| Editores antigos só funcionam no Windows | ✅ Roda em Windows, macOS e Linux | +| Interface desatualizada | ✅ Interface moderna e intuitiva | +| Instalação complexa | ✅ Executável único, sem instalação | + +## Plataformas suportadas + +| Plataforma | Arquitetura | Formato | +|------------|-------------|---------| +| Windows | x64, ARM64 | `.zip` (portátil) | +| macOS | x64 (Intel), ARM64 (Apple Silicon) | `.zip` (app bundle) | +| Linux | x64, ARM64 | `.zip` (portátil) | + +## Download rápido + +=== "Windows" + + 1. Baixe `AssetsEditor-windows-x64.zip` na [página de releases](https://github.com/DistTopic/assets-and-map-editor/releases/latest) + 2. Extraia o `.zip` + 3. Execute `AssetsEditor.exe` + + !!! warning "Aviso do Windows" + O Windows pode exibir um aviso de segurança ao abrir o editor pela primeira vez. Clique em **Mais informações → Executar assim mesmo** para continuar. + +=== "macOS" + + 1. Baixe `AssetsEditor-macos-arm64.zip` (Apple Silicon) ou `...-x64.zip` (Intel) + 2. Extraia e execute + 3. Caso macOS bloqueie: `System Preferences → Security → Allow Anyway` + +=== "Linux" + + ```bash + unzip AssetsEditor-linux-x64.zip + chmod +x AssetsEditor + ./AssetsEditor + ``` + +## Próximos passos + +- [Funcionalidades completas →](features.md) +- [O que está sendo desenvolvido →](wip.md) +- [Galeria de screenshots →](gallery.md) diff --git a/docs/projects/assets-and-map-editor/requirements.en.md b/docs/projects/assets-and-map-editor/requirements.en.md new file mode 100644 index 0000000..d6c0e27 --- /dev/null +++ b/docs/projects/assets-and-map-editor/requirements.en.md @@ -0,0 +1,30 @@ +# System Requirements + +--- + +## Minimum and recommended + +| Resource | Minimum | Recommended | +|----------|---------|-------------| +| RAM | 512 MB | 2 GB | +| Disk space | 50 MB | 200 MB | +| Windows | 10 (1903+) | 11 | +| macOS | 12 Monterey | 13 Ventura+ | +| Linux | Ubuntu 20.04 / Debian 11 | Ubuntu 22.04+ | + +--- + +## Available platforms + +The editor ships as a self-contained executable — no installation, no external dependencies. + +| Operating system | Architecture | +|-----------------|-------------| +| Windows | x64 · ARM64 | +| macOS | Intel (x64) · Apple Silicon (ARM64) | +| Linux | x64 · ARM64 | + +!!! tip "No installation required" + Just download and run. No .NET runtime needs to be installed on your system. + +See the [releases page](https://github.com/DistTopic/assets-and-map-editor/releases) for all available downloads. diff --git a/docs/projects/assets-and-map-editor/requirements.es.md b/docs/projects/assets-and-map-editor/requirements.es.md new file mode 100644 index 0000000..619cac3 --- /dev/null +++ b/docs/projects/assets-and-map-editor/requirements.es.md @@ -0,0 +1,30 @@ +# Requisitos del Sistema + +--- + +## Mínimo y recomendado + +| Recurso | Mínimo | Recomendado | +|---------|--------|-------------| +| RAM | 512 MB | 2 GB | +| Espacio en disco | 50 MB | 200 MB | +| Windows | 10 (1903+) | 11 | +| macOS | 12 Monterey | 13 Ventura+ | +| Linux | Ubuntu 20.04 / Debian 11 | Ubuntu 22.04+ | + +--- + +## Plataformas disponibles + +El editor se distribuye como ejecutable autónomo — sin instalación, sin dependencias externas. + +| Sistema operativo | Arquitectura | +|------------------|-------------| +| Windows | x64 · ARM64 | +| macOS | Intel (x64) · Apple Silicon (ARM64) | +| Linux | x64 · ARM64 | + +!!! tip "Sin instalación necesaria" + Solo descarga y ejecuta. No es necesario instalar ninguna versión de .NET en el sistema. + +Visita la [página de releases](https://github.com/DistTopic/assets-and-map-editor/releases) para todos los descargas disponibles. diff --git a/docs/projects/assets-and-map-editor/requirements.md b/docs/projects/assets-and-map-editor/requirements.md new file mode 100644 index 0000000..dcea79f --- /dev/null +++ b/docs/projects/assets-and-map-editor/requirements.md @@ -0,0 +1,30 @@ +# Requisitos de Sistema + +--- + +## Mínimo e recomendado + +| Recurso | Mínimo | Recomendado | +|---------|--------|-------------| +| RAM | 512 MB | 2 GB | +| Espaço em disco | 50 MB | 200 MB | +| Windows | 10 (1903+) | 11 | +| macOS | 12 Monterey | 13 Ventura+ | +| Linux | Ubuntu 20.04 / Debian 11 | Ubuntu 22.04+ | + +--- + +## Plataformas disponíveis + +O editor é distribuído como executável autônomo — sem instalação, sem dependências externas. + +| Sistema operacional | Arquitetura | +|--------------------|-------------| +| Windows | x64 · ARM64 | +| macOS | Intel (x64) · Apple Silicon (ARM64) | +| Linux | x64 · ARM64 | + +!!! tip "Sem instalação necessária" + Basta baixar e executar. Nenhuma versão do .NET precisa estar instalada no sistema. + +Veja a [página de releases](https://github.com/DistTopic/assets-and-map-editor/releases) para todos os downloads disponíveis. diff --git a/docs/projects/assets-and-map-editor/wip.en.md b/docs/projects/assets-and-map-editor/wip.en.md new file mode 100644 index 0000000..fea3c70 --- /dev/null +++ b/docs/projects/assets-and-map-editor/wip.en.md @@ -0,0 +1,55 @@ +# Work in Progress + +What's being built and what's planned. + +!!! note "Transparency" + This page reflects the real state of the project. Items marked 🚧 are actively being developed. Suggestions are welcome on [Discord](https://discord.gg/NrzbcBhh66) or via [GitHub Issues](https://github.com/DistTopic/assets-and-map-editor/issues). + +--- + +## 🚧 Actively in Development + +### DAT/SPR Writing +The editor currently loads and displays DAT and SPR files but cannot save changes back to these formats yet. This is the most-requested feature and is actively being worked on. + +**Status:** Implementation in progress +**Blocker:** Ensuring compatibility across multiple Tibia protocol versions + +--- + +### OTBM Editing (maps) +The map viewer is functional. The next step is to enable tile editing, item placement/removal, and area export. + +**Status:** Viewer ✅ | Editor 🚧 + +--- + +### Batch sprite export +Export all sprites from a category at once, with configurable format (PNG, spritesheet) and naming convention options. + +**Status:** Design finalized, implementation pending + +--- + +## 📋 Backlog + +| Feature | Priority | Notes | +|---------|----------|-------| +| Batch sprite import | High | Depends on DAT/SPR write | +| OTB vs DAT validation | Medium | Detect inconsistencies | +| DAT version diff mode | Medium | Useful for client updates | +| Plugin system | Low | Extensibility via scripts | +| OBD export | Low | Object Builder compatibility | + +--- + +## ✅ Recently Completed + +| Version | Feature | +|---------|---------| +| v1.0.0-preview | DAT/SPR viewer | +| v1.0.0-preview | OTB reader | +| v1.0.0-preview | OTBM viewer | +| v1.0.0-preview | Cross-platform build (6 platforms) | +| v1.0.0-preview | SHA-256 checksums on releases | +| v1.0.0-preview | CI/CD with CodeQL | diff --git a/docs/projects/assets-and-map-editor/wip.es.md b/docs/projects/assets-and-map-editor/wip.es.md new file mode 100644 index 0000000..38b271e --- /dev/null +++ b/docs/projects/assets-and-map-editor/wip.es.md @@ -0,0 +1,43 @@ +# En Desarrollo + +Lo que se está construyendo actualmente y lo que está planificado. + +!!! note "Transparencia" + Esta página refleja el estado real del proyecto. Los ítems marcados como 🚧 están en desarrollo activo. Las sugerencias son bienvenidas en el [Discord](https://discord.gg/NrzbcBhh66) o vía [issues en GitHub](https://github.com/DistTopic/assets-and-map-editor/issues). + +--- + +## 🚧 En desarrollo activo + +### Escritura de DAT/SPR +El editor actualmente carga y visualiza archivos DAT y SPR, pero aún no puede guardar cambios en estos formatos. Esta es la funcionalidad más solicitada. + +**Estado:** Implementación en progreso + +--- + +### Edición de OTBM (mapas) +El visualizador de mapas está funcional. El próximo paso es habilitar la edición de tiles. + +**Estado:** Visualizador ✅ | Editor 🚧 + +--- + +## 📋 Backlog + +| Funcionalidad | Prioridad | +|--------------|-----------| +| Importación masiva de sprites | Alta | +| Validación OTB vs DAT | Media | +| Modo comparación de versiones | Media | + +--- + +## ✅ Completado recientemente + +| Versión | Funcionalidad | +|---------|--------------| +| v1.0.0-preview | Visualizador DAT/SPR | +| v1.0.0-preview | Lector OTB | +| v1.0.0-preview | Build multiplataforma (6 plataformas) | +| v1.0.0-preview | Checksums SHA-256 en releases | diff --git a/docs/projects/assets-and-map-editor/wip.md b/docs/projects/assets-and-map-editor/wip.md new file mode 100644 index 0000000..501c88e --- /dev/null +++ b/docs/projects/assets-and-map-editor/wip.md @@ -0,0 +1,63 @@ +# Em Desenvolvimento + +O que está sendo construído atualmente e o que está planejado. + +!!! note "Transparência" + Esta página reflete o estado real do projeto. Itens marcados como 🚧 estão sendo desenvolvidos ativamente. Sugestões são bem-vindas no [Discord](https://discord.gg/NrzbcBhh66) ou via [issues no GitHub](https://github.com/DistTopic/assets-and-map-editor/issues). + +--- + +## 🚧 Em desenvolvimento ativo + +### Escrita de DAT/SPR +Atualmente o editor carrega e visualiza arquivos DAT e SPR, mas ainda não permite salvar alterações de volta nesses formatos. Esta é a funcionalidade mais solicitada e está em desenvolvimento. + +**Status:** Implementação em progresso +**Bloqueio:** Garantir compatibilidade com múltiplas versões do protocolo Tibia + +--- + +### Edição de OTBM (mapas) +O visualizador de mapas está funcional. O próximo passo é permitir edição de tiles, adição/remoção de itens e exportação de áreas do mapa. + +**Status:** Visualizador ✅ | Editor 🚧 + +--- + +### Exportação em lote de sprites +Exportar todos os sprites de uma categoria de uma vez, com opções de formato (PNG, spritesheet) e naming convention configurável. + +**Status:** Design definido, implementação pendente + +--- + +## 📋 Planejado (backlog) + +| Funcionalidade | Prioridade | Notas | +|---------------|-----------|-------| +| Importação em lote de sprites | Alta | Dependente da escrita DAT/SPR | +| Validação de OTB contra DAT | Média | Detectar inconsistências | +| Modo comparação de versões DAT | Média | Útil para atualizações de cliente | +| Plugin system | Baixa | Extensibilidade via scripts | +| Exportação para formato OBD | Baixa | Compatibilidade com Object Builder | +| Interface em português | Alta | UI do app em pt-BR | +| Dark/light mode toggle | Baixa | Já é dark-only | + +--- + +## ✅ Concluído recentemente + +| Versão | Funcionalidade | +|--------|---------------| +| v1.0.0-preview | Visualizador de DAT/SPR | +| v1.0.0-preview | Leitor de OTB | +| v1.0.0-preview | Visualizador de OTBM | +| v1.0.0-preview | Build cross-platform (6 plataformas) | +| v1.0.0-preview | Checksums SHA-256 nos releases | +| v1.0.0-preview | CI/CD com CodeQL | + +--- + +## 💬 Quer contribuir? + +Qualquer ajuda é bem-vinda! Veja o [guia de contribuição](https://github.com/DistTopic/assets-and-map-editor/blob/main/CONTRIBUTING.md) e entre no [Discord](https://discord.gg/NrzbcBhh66) para discutir. diff --git a/docs/projects/index.md b/docs/projects/index.md index 6845fcf..0ae2c04 100644 --- a/docs/projects/index.md +++ b/docs/projects/index.md @@ -11,7 +11,7 @@ Open source tools built and maintained by the DistTopic organization. | Project | Status | Platform | License | |---------|--------|----------|---------| -| [Assets And Map Editor](assets-and-map-editor.md) | ![Release](https://img.shields.io/github/v/release/DistTopic/assets-and-map-editor?include_prereleases&label=version&color=2f81f7) | Windows, macOS, Linux | GPL-3.0 | +| [Assets And Map Editor](assets-and-map-editor/index.md) | ![Release](https://img.shields.io/github/v/release/DistTopic/assets-and-map-editor?include_prereleases&label=version&color=2f81f7) | Windows, macOS, Linux | GPL-3.0 | --- diff --git a/mkdocs.yml b/mkdocs.yml index 3c3db39..8c45a81 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -1,7 +1,7 @@ site_name: DistTopic site_description: >- - Open source tools for game development — building cross-platform editors - and servers for the Tibia community. + Ferramentas open source para desenvolvimento de jogos — editores cross-platform + e servidores para a comunidade Tibia. site_url: https://disttopic.github.io repo_url: https://github.com/DistTopic/disttopic.github.io @@ -13,20 +13,20 @@ theme: custom_dir: overrides logo: assets/images/logo.svg favicon: assets/images/favicon.svg - language: en + language: pt-BR palette: - - scheme: slate - primary: custom - accent: custom + - scheme: default + primary: indigo + accent: indigo - font: false # Use system fonts — no Google Fonts (keeps CSP strict) + font: false # Usa system fonts — sem Google Fonts (mantém CSP estrita) features: - navigation.tabs - navigation.tabs.sticky - - navigation.sections - navigation.indexes + - navigation.expand - navigation.top - search.highlight - search.suggest @@ -37,9 +37,64 @@ theme: plugins: - search: separator: '[\s\-\._]+' + lang: + - pt + - en + - es + - i18n: + docs_structure: suffix + fallback_to_default: true + reconfigure_material: true + reconfigure_search: true + languages: + - locale: pt-BR + name: Português (BR) + build: true + default: true + - locale: en + name: English + build: true + nav_translations: + Início: Home + Projetos: Projects + Documentação: Documentation + Visão Geral: Overview + Funcionalidades: Features + Sprites e Animações: Sprites & Animations + Itens e OTB: Items & OTB + Mapas OTBM: OTBM Maps + Interface: Interface + Versões Compatíveis: Compatible Versions + Requisitos de Sistema: System Requirements + Em Desenvolvimento: Work in Progress + Galeria: Gallery + Guias: Guides + Sobre: About + - locale: es + name: Español + build: true + nav_translations: + Início: Inicio + Projetos: Proyectos + Documentação: Documentación + Visão Geral: Descripción General + Funcionalidades: Características + Sprites e Animações: Sprites y Animaciones + Itens e OTB: Ítems y OTB + Mapas OTBM: Mapas OTBM + Interface: Interfaz + Versões Compatíveis: Versiones Compatibles + Requisitos de Sistema: Requisitos del Sistema + Em Desenvolvimento: En Desarrollo + Galeria: Galería + Guias: Guías + Sobre: Acerca de extra_css: - - assets/css/github-dark.css + - assets/css/custom.css + +extra_javascript: + - assets/js/lightbox.js markdown_extensions: - admonition @@ -62,23 +117,37 @@ markdown_extensions: permalink: true nav: - - Home: index.md - - Projects: + - Início: index.md + - Projetos: - projects/index.md - - Assets And Map Editor: projects/assets-and-map-editor.md - - Guides: + - Assets And Map Editor: + - Visão Geral: projects/assets-and-map-editor/index.md + - Funcionalidades: + - projects/assets-and-map-editor/features.md + - Sprites e Animações: projects/assets-and-map-editor/features-sprites.md + - Itens e OTB: projects/assets-and-map-editor/features-items.md + - Mapas OTBM: projects/assets-and-map-editor/features-maps.md + - Interface: projects/assets-and-map-editor/features-interface.md + - Versões Compatíveis: projects/assets-and-map-editor/formats.md + - Requisitos de Sistema: projects/assets-and-map-editor/requirements.md + - Em Desenvolvimento: projects/assets-and-map-editor/wip.md + - Galeria: projects/assets-and-map-editor/gallery.md + - Guias: - guides/index.md - - Adding & Editing Pages: guides/adding-pages.md - - Security Practices: guides/security.md - - About: about.md + - Adicionando Páginas: guides/adding-pages.md + - Segurança: guides/security.md + - Sobre: about.md extra: social: + - icon: fontawesome/brands/discord + link: https://discord.gg/NrzbcBhh66 + name: DistTopic no Discord - icon: fontawesome/brands/github link: https://github.com/DistTopic - name: DistTopic on GitHub + name: DistTopic no GitHub generator: false copyright: >- © 2026 DistTopic — - MIT License + Licença MIT diff --git a/requirements.txt b/requirements.txt index d14bca3..c5cae2b 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1 +1,3 @@ mkdocs-material>=9.5,<10 +mkdocs-static-i18n>=1.3,<2 +