Skip to content

About

This is the official workspace for the Core Rme AI Agent. This version is still in the alpha phase; please report any errors so they can be resolved. https://github.com/ricker72/agente_rme

Topics

Resources

Stars

7 stars

Watchers

1 watching

Forks

Repository files navigation

๐Ÿ—บ๏ธ RME Alpha AI

Version License Python PySide6 Status Client Privacy

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.

Rme01


๐Ÿ“‘ Contents


๐Ÿš€ What is RME Alpha AI?

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.

Watch video

Screenshot_1

โœจ Key features

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.

๐Ÿ‘พ Creatures, NPCs & spawns

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.


๐Ÿงญ RME parity highlights

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

๐Ÿ—บ๏ธ Supported client versions

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 AI Planner

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.


๐Ÿ”„ Material Sync system

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_refs vs new_ids โ€” nothing writes without a confirmed diff, every write keeps a .bak backup
  • 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

๐Ÿ”Œ MCP servers

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)

๐Ÿ“ก Live

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.


๐Ÿ›ก๏ธ Privacy

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)

๐Ÿ”ฅ Big news: House Creator becomes an extension

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. ๐Ÿ””


๐Ÿ†• What's new in v1.0.3-alpha

  • โฌ› 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.33 active.
  • ๐Ÿ›ก๏ธ 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).

Screenshot_2


๐Ÿ–ฅ๏ธ Requirements

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

AI providers (optional but recommended)

  • 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.

โฌ‡๏ธ Download & verify

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 SHA256

Warning

The unzipped product is ~400 MiB (EXE + _internal/). It ships as a local folder โ€” never through Git.


๐Ÿงญ Getting started

  1. Download the latest release.
  2. Run the portable executable (keep RME_Alpha_AI.exe next to _internal/).
  3. Point it at your assets folder when asked.
  4. Explore the editor and try the AI Planner.

This version ships a User Manual โ€” please read it before starting: MANUAL_USUARIO.md

Screenshot_3

๐Ÿ“Š Project status

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.


๐Ÿ‘ค Creator

Developed by @ricker72 Passionate about OpenTibia, AI and creative tooling.


๐Ÿ“„ License

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. ๐Ÿ—บ๏ธโœจ

About

This is the official workspace for the Core Rme AI Agent. This version is still in the alpha phase; please report any errors so they can be resolved. https://github.com/ricker72/agente_rme

Topics

Resources

Stars

7 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages