An AI-powered map editor and assistant for OpenTibia. The classic Remere's Map Editor workflow, rebuilt with semantic planning, visual validation and RME visual parity.
- ๐ What is RME Alpha AI?
- โจ Key features
- ๐พ Creatures, NPCs & spawns
- ๐งญ RME parity highlights
- ๐บ๏ธ Supported client versions
- ๐ค The AI Planner
- ๐ Material Sync system
- ๐ MCP servers
- ๐ก Live
- ๐ก๏ธ Privacy
- ๐ฅ House Creator โ Extension
- ๐ What's new in v1.0.3-alpha
- ๐ฅ๏ธ Requirements
- โฌ๏ธ Download & verify
- ๐งญ Getting started
- ๐ Project status
- ๐ค Creator
- ๐ License
An early-stage map editor for OpenTibia that merges the power of RME with artificial intelligence. Its goal is to evolve the classic mapping workflow by adding:
- ๐ค AI assistant to generate and validate structures.
- ๐ง Semantic planner that understands biomes, houses, spawns and quests.
- โ Automatic validation of maps (OTBM) and visual error detection.
- ๐จ Smart brush system with auto-bordering.
This alpha is built for testing, feedback and continuous improvement. Every update brings generated-map quality closer to that of an expert human mapper.
| Icon | Feature |
|---|---|
| ๐งฉ | Semantic planning of biomes, houses, spawns, NPCs and quests. |
| ๐ค | AI Planner with support for Ollama, OpenRouter and PaxSenix. |
| ๐ | OTBM validation and automatic error correction. |
| ๐๏ธ | Smart brushes and material-based auto-bordering. |
| ๐ | Knowledge base (SQLite) for learning and recommendations. |
| ๐ฏ | Multi-model consensus for better decisions. |
| ๐ฅ๏ธ | Modern, responsive GUI built with PySide6 (Qt). |
| ๐พ | True creature rendering โ official looktype registry + your server's Lua, readable NPC labels, spawn icons. |
| ๐ | RME-style dialogs โ Jump, Search, Replace and Map Properties with the Remere layout. |
| ๐ | House gallery by official name with live sprite previews and mini-viewport. |
| ๐ก | RME-parity lighting with Light Control HUD (intensity, shadow, collision-aware occlusion). |
| ๐๏ธ | Canary-faithful animations with frame cache, preview toggle and speed control. |
| ๐ฑ๏ธ | Creature context menu โ Select Npc/Monster plus Npc/Monster Properties dialogs. |
| โก | Frame-cached viewport with progressive chunk rendering for large maps. |
| ๐ก๏ธ | Privacy HUD (About โบ Privacidad) with local-first guarantees. |
| ๐ | Local MCP bridge (STDIO) with certified, validated operations only. |
Monsters and NPCs render exactly where RME puts them โ with outfits resolved from the bundled official registry (1834 monsters + 1080 NPCs), falling back to your server's monster/ + npc/ Lua directories from Preferences:
+ File sidecars (<map>-monster.xml / <map>-npc.xml) load with upstream RME discard rules
+ Indexed OTBM chunks propagate creatures AND spawns into every tile (no more black squares)
+ Unknown looks fall back to outfit 197 (the Carl-bot tribute, upstream BlitCreature parity)
+ NPC labels: OTClient-blue bold + HP bar + soft plate, anchored to the real sprite head
+ Spawn centers: custom 16 px semi-transparent icons on their own layer, always under the creature
+ Right-click: Select Npc / Select Monster + Npc/Monster Properties (name, spawn time, direction)Tip
Spawns stay visible without covering creatures, and per-kind toggles (Show monsters / NPCs / monster spawns / NPC spawns) work independently.
| Area | Parity delivered |
|---|---|
| ๐ Dialogs | Jump to Item (Ctrl+J), Search for Item (Ctrl+F), Replace Items (Ctrl+Shift+F), Map Properties (Ctrl+P) โ 4-column Remere layout, 32 px icons, real names |
| ๐ Houses | Official names from world-house.xml, real sprite previews, floor โ/+, 2D rotation, live mini-viewport |
| ๐บ๏ธ Minimap | Floor buttons that always respond |
| ๐ก Light | Single scene-level pass from item flags; View > Lights > Light Controlโฆ (Shift+Alt+L): 0โ100% light/shadow, wall occlusion via the client's own unsight flag |
| ๐๏ธ Animation | appearances.proto loop types, per-phase timing, sync + random-start clocks, static-base/animated-overlay fast path |
| ๐๏ธ Brushes | Ground/wall/door/carpet/table/doodad + flag tools with real flags; kind-checked creature erasers |
| ๐งฑ Viewport | Progressive chunks, LRU pixmap caches, deadline-ordered animation refresh |
| ๐ก๏ธ Safety | OTBM gate (magic, 512 MiB cap, rate limiting), guarded XML parsing everywhere |
Client packs are fingerprinted by their appearances-*.dat hash โ the editor always resolves materials, brushes and IDs against the pack you actually loaded. Unknown packs report hash + counts instead of being guessed.
| Version | Status |
|---|---|
| 15.24 Targuna | โ Base materials, fallback for every version |
| 15.30 (Summer 2026) | โ
Dedicated data-15.30 tree + items overlay |
| 15.33 (CipSoft) | โ
Dedicated data-15.33 tree + items overlay |
| 15.33.b21348 (live) | โ
Fingerprinted live build, full data-15.33 inheritance |
| Dudantas OTClient 13.20โ15.25 | โ Hybrid filter (10 tags, no hashes invented) |
Note
Supported versions lists every registered asset profile as active / registered / missing, plus unidentified rows for new packs. AI proposals carry the active-client context so models only cite IDs present in your pack.
The Planner connects to different AI providers to assist with map generation and review:
- Ollama (local)
- OpenRouter (multi-model, cloud)
- PaxSenix (specialized service)
With automatic selection and multi-model consensus modes to:
- Review building proposals.
- Detect visual and density errors.
- Tune biomes and structures.
- Improve generation logic.
โ ๏ธ Important: models never write item IDs directly. Every proposal goes through material catalogs, certified brush engines, OTBM validation and visual QA. This keeps generated maps compatible and playable.
The Planner is 100% hybrid: it works against any appearances-*.dat (curated, dudantas or future), exposing only brushes visible in the active pack.
The Sync Materials HUD updates the versioned trees from your active Tibia client folder:
- Targets:
items_xmlยทtilesets(~100 files) ยทbrushs(16 files) ยทborders - Read-only-first: Scan reports
dead_refsvsnew_idsโ nothing writes without a confirmed diff, every write keeps a.bakbackup - Safety rules: client folder is read-only,
resources/materials(15.24 base) is untouchable, fluid OTB IDs 1โ20 excluded - AI-assisted curation (free models only, key in memory/env only) with valid/rejected accounting
Local STDIO bridge (mcp_server.py) proxied to the running Qt process over authenticated local IPC:
- Semantic operations only โ models never get a raw tile/OTBM write primitive
- Tools:
rme_open_mapยทrme_planner_queryยทrme_create_proposalยท previews ยท block approval (confirm=true+RME_MCP_ALLOW_APPROVAL=1) ยท validated CLI batch specs - Multi-client safety: proposals carry an owner โ a second client can't touch another client's proposal (fail-closed)
Top-level Live menu (Ctrl+Shift+L) with a floating HUD: local session handshake, peers, cursor sharing and chat โ packet types verbatim from RME's live_packets.h, honestly labeled while networking lands.
About โบ ๐ Privacidad opens an animated floating HUD with our guarantees:
| Guarantee | Meaning |
|---|---|
| ๐ 100% local | Maps, preferences and knowledge live on your PC โ no accounts, no user-data storage |
| ๐ซ Zero third parties | No telemetry, no tracking, no analytics |
| ๐ค Memory-less AI | Models never store your maps, prompts or keys |
| ๐ Keys stay safe | API keys only in memory / env vars / OS secret store โ audited by secret_guard.py on every package |
| ๐ฆ Clean distribution | Binaries only via GitHub Releases with SHA-256; the repo never receives builds (95 MiB gate) |
Important
The in-product House Creator is removed in v1.0.3-alpha โ not cut, graduated. Inside RME Alpha AI it was hitting its limits; as a dedicated extension it has far greater potential.
| ๐๏ธ Coming in the extension | โจ |
|---|---|
| ๐ House blueprints | Design real plans first, then materialize |
| ๐จ Designs & decorations | Curated presets + smart decoration passes |
| ๐ข Sublevels | Basements, upper floors, split levels |
| ๐ Roofs | Pitched, flat and Tibia-style roofs |
| ๐ฟ Patios & balconies | Terraces, railings and access |
| ๐งฉ More combos | Wider tile / ground / wall choice per style |
Your existing houses and maps are 100% safe. The extension will be announced here. ๐
- โฌ Black squares on NPCs/monsters fixed โ spawn tiles crashed rendering; every visible creature now composes (explicit marker if its outfit is missing).
- ๐ท๏ธ Readable NPC names โ OTClient-blue bold + soft plate + HP bar.
- ๐๏ธ Spawn icons under creatures โ custom 16 px semi-transparent icons on their own layer.
- ๐ฑ๏ธ Creature right-click โ
Select Npc/Select Monster+Npc/Monster Properties(name, spawn time 1โ3600, direction). - ๐ฆ Client 15.33.b21348 support โ fingerprinted,
data-15.33active. - ๐ก๏ธ Privacy HUD โ animated floating panel under
About. - ๐๏ธ Removed: legacy spawn rings (superseded by icons) ยท in-product House Creator (โ extension, above).
๐ Full history lives in ReleaseNotes.md (rev. 1 โ rev. 12).
| Requirement | Details |
|---|---|
| ๐ช OS | Windows 10/11, 64-bit |
| ๐ฎ Client assets | A Tibia client /assets folder with appearances-*.dat + catalog-content.json (asked for on first launch; not bundled for legal reasons) |
| ๐จ GPU | Recommended for the accelerated viewport (software fallback included) |
| ๐พ RAM | 4 GB minimum, 8 GB recommended for large maps |
| ๐ Source runs only | Python 3.10+ and pip install PySide6, then python main.py |
- Ollama: local AI processing, installed separately.
- OpenRouter: API key for cloud multi-model access.
- PaxSenix: API key for the specialized service.
- Internet: required for cloud providers only โ the editor itself is fully offline.
| File | Use |
|---|---|
RME.Alpha.AI.zip |
๐ฆ User install for the GitHub Release |
RME.Alpha.AI.zip.sha256 |
๐ Verification hash (hash filename format) |
Get-FileHash "RME.Alpha.AI.zip" -Algorithm SHA256Warning
The unzipped product is ~400 MiB (EXE + _internal/). It ships as a local folder โ never through Git.
- Download the latest release.
- Run the portable executable (keep
RME_Alpha_AI.exenext to_internal/). - Point it at your assets folder when asked.
- Explore the editor and try the AI Planner.
This version ships a User Manual โ please read it before starting:
MANUAL_USUARIO.md
| Status | Description |
|---|---|
| ๐งช Alpha | Under active development, stable for testing. |
| ๐ Updates | Regular, driven by feedback. |
| ๐ Bugs | Expected โ reports are welcome. |
| ๐บ๏ธ Compatibility | Progressing with RME/Canary and OpenTibia standards. |
This project is Open Source and every contribution is welcome.
Developed by @ricker72 Passionate about OpenTibia, AI and creative tooling.
This project is under the MIT license. See LICENSE for details.
Thank you for your interest! ๐ Your support and feedback are key to making RME Alpha AI the definitive map-creation tool for OpenTibia. ๐บ๏ธโจ

