DewralMapEditor

KO | EN

gitlite — search

#nodejs #css #cross-platform #json #macos #open-source #windows #codex #dotnet #machine-learning

DewralMapEditor

(★ 9)

Map Editor For Tibia

파일 탐색기

ZIP 다운로드

- - nightly.yml
- CreateChecksums.cmake
- CreateReleasePackage.cmake
- CreateSourcePackage.cmake
- DeployQtRuntime.cmake
- - brushes.json
  - creatures.xml
  - items.xml
  - tilesets.json
- - brushes.json
  - creatures.xml
  - items.xml
  - tilesets.json
- - brushes.json
  - creatures.xml
  - items.xml
  - tilesets.json
- - brushes.json
  - creatures.xml
  - items.xml
  - tilesets.json
- - brushes.json
  - creatures.xml
  - items.xml
  - tilesets.json
- - brushes.json
  - creature_palette.xml
  - creatures.xml
  - items.xml
  - tilesets.json
- - brushes.json
  - creature_palette.xml
  - creatures.xml
  - items.xml
  - tilesets.json
- - brushes.json
  - creatures.xml
  - items.xml
  - tilesets.json
- - brushes.json
  - creatures.xml
  - items.xml
  - tilesets.json
- - brushes.json
  - creatures.xml
  - items.xml
  - tilesets.json
- - brushes.json
  - creatures.xml
  - items.xml
  - tilesets.json
- - brushes.json
  - creatures.xml
  - items.xml
  - tilesets.json
- - brushes.json
  - creatures.xml
  - items.xml
  - tilesets.json
- - brushes.json
  - creatures.xml
  - items.xml
  - tilesets.json
- - brushes.json
  - creatures.xml
  - items.xml
  - tilesets.json
- - brushes.json
  - creatures.xml
  - items.xml
  - tilesets.json
- - brushes.json
  - creatures.xml
  - items.xml
  - tilesets.json
- - brushes.json
  - creatures.xml
  - items.xml
  - tilesets.json
- - brushes.json
  - creatures.xml
  - items.xml
  - tilesets.json
- - brushes.json
  - creatures.xml
  - items.xml
  - tilesets.json
- - brushes.json
  - creatures.xml
  - items.xml
  - tilesets.json
- - brushes.json
  - creatures.xml
  - items.xml
  - tilesets.json
- - brushes.json
  - creatures.xml
  - items.xml
  - tilesets.json
- RME_SOURCE.md
- - browse-field.gif
  - brush-editor.png
  - classic-interface.png
  - editor-overview.png
  - ground-brush.png
  - ingame-preview.gif
  - listview.png
  - preferences_menu.png
  - startup-client-profile.png
  - town_dialog.png
  - updater.png
- otland-development-update.txt
- - aimapassistant.cpp
  - aimapassistant.h
  - backend.cpp
  - backend.h
  - brushstore.cpp
  - brushstore.h
  - creaturefilter.cpp
  - creaturefilter.h
  - creaturestore.cpp
  - creaturestore.h
  - documentmanager.cpp
  - documentmanager.h
  - filetools.cpp
  - filetools.h
  - palettefilter.cpp
  - palettefilter.h
  - paletteimageprovider.cpp
  - paletteimageprovider.h
  - tilesetstore.cpp
  - tilesetstore.h
  - uitheme.cpp
  - uitheme.h
  - updateservice.cpp
  - updateservice.h
  - updateversion.cpp
  - updateversion.h
  - worktimerservice.cpp
  - worktimerservice.h
- - mapatlasservice.h
  - mapbrushcontroller.h
  - mapchunkstore.h
  - mapdungeongenerator.cpp
  - mapdungeongenerator.h
  - mapeditcontroller.h
  - mapglview.cpp
  - mapglview.h
  - mapitemcontroller.h
  - mapminimapservice.h
  - mapnavigationcontroller.h
  - mappathbuilder.cpp
  - mappathbuilder.h
  - mapselectioncontroller.h
  - mapservices.cpp
  - mapservices.h
  - mapspawnindexservice.h
  - mapterraingenerator.cpp
  - mapterraingenerator.h
  - mapterrainprofile.cpp
  - mapterrainprofile.h
  - maptypes.h
  - mapview.cpp
  - mapview.h
  - mapview_atlas.cpp
  - mapview_brush_core.cpp
  - mapview_brush_ground.cpp
  - mapview_brush_types.cpp
  - mapview_chunks.cpp
  - mapview_dungeon.cpp
  - mapview_edit.cpp
  - mapview_gl.cpp
  - mapview_input.cpp
  - mapview_item_context.cpp
  - mapview_item_properties.cpp
  - mapview_p.h
  - mapview_path.cpp
  - mapview_query.cpp
  - mapview_selection.cpp
  - mapview_terrain.cpp
  - minimapview.cpp
  - minimapview.h
- - ingamepreviewcontroller.cpp
  - ingamepreviewcontroller.h
  - README.md
- - Main.qml
  - PalettePanel.qml
  - StartupWindow.qml
- - actionbar_background.png
  - borderbottomline.png
  - borderleftline.png
  - borderrightline.png
  - borders.png
  - bordertopline.png
  - button_active.png
  - button_normal.png
  - buttons.png
  - chat_channel_background_bar_1.png
  - chat_channel_background_bar_2.png
  - chat_channel_deselected_1.png
  - chat_channel_deselected_2.png
  - chat_channel_selected_1.png
  - chat_channel_selected_2.png
  - chat_Console_border.png
  - chat_volume.png
  - checkbox_2.png
  - checkbox_3.png
  - checkbox_off.png
  - checkbox_on.png
  - close_open_help_messages_blank_ignore.png
  - colorbox-border.png
  - colorbox.png
  - combo_bg.png
  - combo_btn.png
  - combobox_hover.png
  - combobox_normal.png
  - combobox_open.png
  - combobox_popup_bg.png
  - combobox_square.png
  - compass.png
  - conditionPanel.png
  - conditions.png
  - conditions_bar.png
  - console.png
  - container_controls.png
  - controls.png
  - dark_background.png
  - discord.png
  - fade.png
  - graph_background.png
  - help.png
  - hotkeys.png
  - ignore.png
  - inventory_maximise.png
  - left_right_buttons.png
  - lightOFF.png
  - lightON.png
  - longbutton_2.png
  - longbutton_3.png
  - longbutton_4.png
  - menubox.png
  - Midhem.png
  - minimap_controls.png
  - minipanel.png
  - miniwindow.png
  - miniwindow_buttons.png
  - options_mini.png
  - panel1.png
  - panel2.png
  - panel3.png
  - panel_bottom.png
  - panel_bottom2.png
  - panel_container.png
  - panel_content.png
  - panel_flat.png
  - panel_lightflat.png
  - panel_map.png
  - panel_side.png
  - panel_top_4.png
  - panel_top_5.png
  - popupwindow.png
  - popupwindow_tall.png
  - scrollarea.png
  - scrollbar.png
  - scrollbar_arrow_down.png
  - scrollbar_arrow_down_hover.png
  - scrollbar_arrow_up.png
  - scrollbar_arrow_up_hover.png
  - scrollbar_controls.png
  - scrollbar_thumb.png
  - scrollbar_track.png
  - select_color.png
  - separator_horizontal.png
  - separator_vertical.png
  - shortbutton.png
  - slot_background.png
  - slots.png
  - soul_cap_background.png
  - soul_cap_background_minimised.png
  - spinbox_down.png
  - spinbox_down_hover.png
  - spinbox_down_idle.png
  - spinbox_down_pressed.png
  - spinbox_up.png
  - spinbox_up_hover.png
  - spinbox_up_idle.png
  - spinbox_up_pressed.png
  - splitter_5.png
  - splitter_6.png
  - tab_checked.png
  - tab_hover.png
  - tab_normal.png
  - tabbutton_rounded_2.png
  - tabbutton_rounded_3.png
  - tabbutton_square.png
  - tabsq_checked.png
  - tabsq_hover.png
  - tabsq_normal.png
  - textedit.png
  - texture.png
  - thick_buttons.png
  - window.png
- - main.cpp
- - DME.ico
  - DME.rc
- main.cpp
- qtquickcontrols2.conf
- resources.qrc
- - binaryreader.cpp
  - binaryreader.h
  - canonicalflags.h
  - compactqstring.h
  - compactvector.h
  - datreader.cpp
  - datreader.h
  - dmedatadir.h
  - itemsxmlreader.cpp
  - itemsxmlreader.h
  - itemtype.h
  - nodefilereader.cpp
  - nodefilereader.h
  - otbmreader.cpp
  - otbmreader.h
  - otbreader.cpp
  - otbreader.h
  - otfireader.cpp
  - otfireader.h
  - sprreader.cpp
  - sprreader.h
  - tilepositionindex.h
- build-release.ps1
- import-rme-data.py
- atlas_background_build_test.cpp
- creature_store_test.cpp
- document_recovery_test.cpp
- map_dungeon_generator_test.cpp
- map_path_builder_test.cpp
- map_terrain_generator_test.cpp
- map_terrain_profile_test.cpp
- otbm_background_load_test.cpp
- otbm_compact_storage_test.cpp
- otbm_editing_storage_test.cpp
- tile_position_index_test.cpp
- update_version_test.cpp
- x64-windows-release.cmake
.gitattributes
.gitignore
build-release.bat
CMakeLists.txt
CMakePresets.json
LICENSE
NOTICE
README.md
restart-codex.ps1
vcpkg.json

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Dewral Map Editor (DME) is a desktop OpenTibia map editor for OTBM maps. It
uses a Qt 6/QML interface and a custom OpenGL renderer designed for large,
multi-floor Tibia maps.

> **Development note:** This project was developed primarily with assistance
> from Claude Code Fable 5, Claude Opus 4.8, and ChatGPT 5.6 Sol.

> Client assets are not included. DME requires your own `Tibia.dat`,
> `Tibia.spr`, and `items.otb` files. These files are copyrighted by CipSoft
> and must not be committed to this repository or included in a release.

![Dewral Map Editor with an OTBM map open](https://raw.githubusercontent.com/dewral/DewralMapEditor/main/docs/screenshots/editor-overview.png)

## Highlights

- Opens and saves OTBM maps for Tibia 7.60 through 10.98+ client profiles.
- Supports custom client profiles and remembers a separate asset directory for
  each profile.
- Uses an instanced OpenGL renderer with chunk caching, smooth pan and zoom,
  multiple visible floors, lighting preview, and optional item animations.
- Provides terrain, doodad, item, creature, house, and custom palettes.
- Includes ground brushes, automatic borders, wall brushes, doodad variants,
  zone tools, spawns, creatures, houses, and towns.
- Supports selection, multi-floor selection, moving items between floors,
  cut/copy/paste, undo/redo, item properties, search, and replacement tools.
- Includes a configurable In-game Preview window. [ WIP ]
- Loads maps even when optional house and spawn sidecar files are absent.
- Lets you switch between the modern GitHub-inspired interface and the
  Tibia-inspired Classic UI from the theme settings.
- Produces a self-contained Windows release folder and ZIP archive.

## Screenshots

### Client profiles

Configure a built-in client version or point a custom profile at your own
client assets.

![DME startup window with a configured custom client profile](https://raw.githubusercontent.com/dewral/DewralMapEditor/main/docs/screenshots/startup-client-profile.png)

### Brush Editor

Create and organize custom brushes directly in the editor.

![Creating and editing a brush in the DME Brush Editor](https://raw.githubusercontent.com/dewral/DewralMapEditor/main/docs/screenshots/brush-editor.png)

### Classic UI

The interface can be changed at any time in the theme settings. Choose the
modern GitHub-inspired layout or the textured, Tibia-inspired Classic UI.

![Dewral Map Editor using the Tibia-inspired Classic UI](https://raw.githubusercontent.com/dewral/DewralMapEditor/main/docs/screenshots/classic-interface.png)

## Download and run

1. Download `DewralMapEditor-windows-x64.zip` from the
   [GitHub Releases page](https://github.com/dewral/DewralMapEditor/releases).
2. Extract the complete archive. Do not move `DME.exe` away from the DLL and
   `qml` folders shipped next to it.
3. Run `DME.exe`.
4. Select a client version or create a custom profile.
5. Point the profile at a directory containing:

```text
   Tibia.dat
   Tibia.spr
   items.otb
   ```

6. Open an OTBM map.

House and spawn XML sidecar files are optional. When present, DME loads them
with the map. When absent, the map still opens normally.

### Release files

Each release provides two independent archives:

- `DewralMapEditor-windows-x64.zip` — ready-to-run Windows application with
  `DME.exe`, the required Qt runtime, built-in editor data, licenses, and
  documentation. Users do not need Qt Creator or a compiler.
- `DewralMapEditor-source.zip` — complete source package without executables,
  DLLs, build output, or client assets. It contains the CMake/vcpkg build files
  and the generated RME material profiles.

## Updates

DME checks for updates whenever the start window opens. That window shows the
current status and, when a newer build is available, a **Download & install** button.
Update channels follow the installed build:

- **Stable builds** download normal published GitHub releases.
- **Development builds** follow successful nightly builds of the `main` branch.

The nightly package is built and published automatically after each push. DME
downloads the portable ZIP, verifies its SHA-256 digest, and hands installation
to the separate `DMEUpdater.exe`. Modified maps must be saved before restarting;
user settings, custom client profiles, and recovery files are not stored in the
application folder and are not replaced.

Do not download only `DME.exe`. The executable requires the DLL and QML files
that are shipped beside it in the ready-to-run archive.

## Build on Windows without Qt Creator

The supported release build uses Visual Studio 2022, CMake, and a pinned vcpkg
manifest. Qt Creator and a separately installed Qt SDK are not required.

### Requirements

- Windows 10 or Windows 11, x64
- [Git for Windows](https://git-scm.com/download/win)
- [CMake 3.24 or newer](https://cmake.org/download/)
- Visual Studio 2022 Community or Build Tools 2022 with the
  **Desktop development with C++** workload
- An internet connection for the first dependency build

The first build downloads vcpkg and builds Qt 6.10.2. This can take a long time
and use significant disk space. Later builds reuse the local vcpkg binary
cache.

### One-command build

Clone the repository and run:

```powershell
.\build-release.bat
```

The script:

1. verifies Git, CMake, Visual Studio, and the MSVC C++ toolchain;
2. downloads the pinned vcpkg release into `.tools/vcpkg`;
3. installs the dependencies declared in `vcpkg.json`;
4. configures the `windows-vcpkg` CMake preset;
5. builds the Release configuration;
6. deploys only the required Qt runtime;
7. creates the ready-to-run and source folders and ZIP archives.

Build output:

Local custom profiles and client binaries are removed from the release
package automatically.

### Build from PowerShell

The batch file is only a convenient launcher. The same build can be started
directly:

```powershell
.\scripts\build-release.ps1
```

After vcpkg has been bootstrapped, the underlying commands are:

```powershell
$env:VCPKG_ROOT = "$PWD\.tools\vcpkg"
cmake --preset windows-vcpkg
cmake --build --preset windows-release
```

### Build with an existing Qt installation

Developers who already have a compatible Qt 6 SDK may use it directly:

```powershell
cmake -S . -B build/local-release -G Ninja `
  -DCMAKE_BUILD_TYPE=Release `
  -DCMAKE_PREFIX_PATH=C:/Qt/6.10.2/mingw_64

cmake --build build/local-release --target package_release --parallel
```

Use a compiler matching the selected Qt SDK. For example, a MinGW Qt package
must be built with the corresponding MinGW toolchain.

## Dependencies

The vcpkg manifest pins its registry baseline for repeatable dependency
resolution and installs:

- `qtbase`
- `qtdeclarative`
- `qtsvg`

The `qtbase` feature set is limited to the GUI, network, OpenGL, and PNG
components used by DME. The pinned port set provides Qt 6.10.2.

The official Windows preset uses the release-only `x64-windows-release`
triplet to avoid compiling and storing an unused Debug copy of Qt. It targets
Visual Studio 2022. vcpkg manifest mode is activated through the CMake
toolchain specified in `CMakePresets.json`.

## Updating the built-in RME data

Built-in brushes, doodads, item groups, and RAW/terrain tilesets are generated
from the text material definitions in
[OTAcademy/RME](https://github.com/OTAcademy/RME). Client binaries are never
copied.

After cloning RME, regenerate every supported profile with:

```powershell
python scripts/import-rme-data.py --rme C:\path\to\RME
```

The importer writes `brushes.json`, `tilesets.json`, `items.xml`, and
`creatures.xml` for the built-in profiles. RME does not provide separate
material directories for Tibia 7.72, 7.80, or 7.92, so those profiles use the
conservative RME 7.60 material set. All other profiles use their matching RME
directory.

## Useful controls

| Action | Control |
|---|---|
| Toggle draw/select mode | `Space` |
| Change floor | `+` / `-` or `Ctrl` + mouse wheel |
| Zoom | Mouse wheel |
| Pan | Middle mouse button or arrow keys |
| Fast keyboard pan | `Shift` + arrow keys |
| Undo / redo | `Ctrl+Z` / `Ctrl+Shift+Z` |
| Copy / cut / paste | `Ctrl+C` / `Ctrl+X` / `Ctrl+V` |
| Rotate doodad variant | `R` |
| Go to position | `Ctrl+G` |

While dragging an item, changing floors keeps the item attached to the cursor
and drops it on the active floor.

## AI Map Assistant

The experimental AI Map Assistant can plan ground terrain inside a selection.
It sends the selected tile coordinates, current ground brush names, and the
available ground brushes to the OpenAI Responses API. The API key is read only
from the process environment and is never stored in a map or project file.

Start DME from PowerShell with:

```powershell
$env:OPENAI_API_KEY = "your-api-key"
.\dist\DME.exe
```

Optionally set `OPENAI_MODEL`; the default is `gpt-5.6-luna`. In DME, select up
to 1024 tiles on the current floor and choose **Edit > AI Map Assistant**. The
assistant creates a validated plan first and changes the map only after
**Apply** is pressed. The complete change is one undo step.

## Project structure

```text
DewralMapEditor/
|-- CMakeLists.txt             application and package targets
|-- CMakePresets.json          shareable Windows/vcpkg presets
|-- vcpkg.json                 pinned C++ dependency manifest
|-- build-release.bat          double-click release build
|-- scripts/
|   `-- build-release.ps1      validated command-line build
|-- cmake/                     Qt deployment and release packaging
|-- data/                      built-in brushes and palette definitions
|-- editor/
|   |-- core/                  application services and models
|   |-- map/                   editing, input, chunk cache, and renderer bridge
|   |-- qml/                   windows, components, controllers, and dialogs
|   `-- ui/                    bundled UI textures and icons
|-- libs/
|   `-- otformats/             DAT, SPR, OTB, OTFI, and OTBM readers
`-- docs/
    `-- screenshots/           README images supplied by the maintainer
```

## Troubleshooting

### Visual Studio C++ tools were not found

Open Visual Studio Installer, modify Visual Studio or Build Tools 2022, and
enable **Desktop development with C++**.

### CMake cannot find the vcpkg toolchain

Use `build-release.bat`, or set `VCPKG_ROOT` before configuring:

```powershell
$env:VCPKG_ROOT = "C:\path\to\vcpkg"
cmake --preset windows-vcpkg
```

### The first build appears to be stuck

Qt is being compiled by vcpkg. The first build is substantially slower than
normal DME rebuilds. Check CPU and disk activity before stopping it.

### Windows shows an old or missing application icon

Windows may cache executable icons. Refresh Explorer, rename the extracted
folder, or clear the Windows icon cache. The release executable contains a
native multi-size Windows icon.

## Data and credits

- DME is inspired by
  [Remere's Map Editor](https://github.com/hampusborgos/rme).
- Portions of the binary-format I/O implementation are derived from
  [Tibia ImGui Map Editor](https://github.com/Open-Tibia-Tools/tibia-imgui-map-editor),
  which is licensed under the GNU Affero General Public License v3.0.
- Lighting and in-game visualization ideas were also informed by Tibia ImGui
  Map Editor.
- Some brush, border, tileset, and creature definitions are derived from
  OpenTibia/RME-compatible data.
- Tibia is a trademark of CipSoft GmbH. Client data and artwork are not
  distributed with DME.

## License

Dewral Map Editor is free software licensed under the
[GNU Affero General Public License v3.0](LICENSE). See [NOTICE](NOTICE) for
third-party attribution.

Release binaries must be accompanied by access to the complete corresponding
source code for the same version. Tibia client files and artwork are not part
of this project and are not covered by this license.

DewralMapEditor

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

Download README