A high-performance automation bot for OTClientV8 (vBot) and OpenTibiaBR (OTCR) with AI-powered combat, real-time analytics, and intelligent navigation.
Note
nExBot runs on both vBot (OTClientV8) and OTCR (OpenTibiaBR) — the client is auto-detected at startup, no manual configuration needed.
nExBot is a modular Tibia bot that automates hunting, healing, navigation, and analytics.
| Module | What it does |
|---|---|
| HealBot | Ultra-fast healing (75 ms response) with spells, potions, support buffs, and condition curing |
| AttackBot | Automated attack spells and runes with AoE optimization and cooldown management |
| CaveBot | Waypoint navigation with floor-change safety, field handling, supply refills, and 50+ pre-built routes |
| TargetBot | AI combat with 9-stage priority scoring, behavior learning, wave prediction, and movement coordination |
| Hunt Analyzer | Real-time session analytics — kills/hour, XP/hour, profit, Hunt Score, efficiency insights |
| Containers | Auto-open, quiver management, and container role assignments |
| Extras | Anti-RS, alarms, equipment swapping, conditions, combo system, push max |
Copy the nExBot folder into your client's bot directory:
vBot (OTClientV8 — Windows):
%APPDATA%/OTClientV8/<ServerName>/bot/nExBot
OTCR (OpenTibiaBR — Linux):
~/.local/share/<otcr-data>/<ServerName>/bot/nExBot
See the full Installing guide for step-by-step instructions.
- Open the client, log in, press Ctrl+B.
- Select nExBot from the bot dropdown and click Enable.
- You should see Main, Cave, and Target tabs.
- HealBot — Set healing spells and potions (Main tab → Healing).
- TargetBot — Add monsters to fight (Target tab → +).
- CaveBot — Load a pre-built config or record waypoints (Cave tab → Show Editor).
- AttackBot — Set attack spell rotation (Main tab → AttackBot).
Tip
Load a pre-built config from cavebot_configs/ for the fastest setup — 50+ routes are included for popular hunting spots.
Enable CaveBot and TargetBot, press Start (Ctrl+Z), and monitor progress in Hunt Analyzer.
Caution
Do NOT place nExBot inside a mods/ folder or custom mod directory. The auto-updater requires write access to the user-data bot/ path — mod folders are read-only at runtime, so updates will fail silently.
👉 See the Installing guide — Auto-Updater section for the full explanation and correct folder setup.
- AttackStateMachine — sole attack issuer, eliminates attack-once-then-stop bugs
- 9-stage TBI priority — distance, health, danger, wave prediction, adaptive weights
- Monster Insights — 12 SRP modules that learn monster behavior in real-time
- Movement coordination — intent-based voting resolves wave avoidance, keep-distance, AoE positioning, and chase
- Walking engine v4.0 — smooth autoWalk pipelining (5+ tiles), step pipelining (2-step lookahead), PathCursor preservation, adaptive recovery with path validation and exponential-decay blacklists
- 15+ waypoint types — goto, label, action, buy, sell, lure, standLure, depositor, travel, imbuing, tasker, withdraw
- 50+ pre-built configs — Asura, Banuta, Demons, Dragons, Hydras, Nagas, and more
- 75 ms response — event-driven, cached health data, zero-allocation casting
- Cascading priority — multiple spells and potions at different HP/MP thresholds
- Condition handling — auto-cure poison, paralyze, burn
Important
The ACL auto-detects vBot vs. OTCR at startup — all game operations use a unified ClientService API. OTCR-exclusive features (imbuing, stash, forge, prey, market) are enabled automatically.
_Loader.lua (entry point)
├── ACL (client detection + adapter)
├── EventBus (event-driven communication)
├── UnifiedTick (single 50ms master timer)
├── UnifiedStorage (per-character JSON persistence)
│
├── HealBot ←──── player:health events
├── AttackBot ←── TargetBot decisions
├── CaveBot ←──── 250ms waypoint engine
├── TargetBot ←── creature events + Monster AI
│ ├── AttackStateMachine (sole attack issuer)
│ ├── Monster Insights (12 AI modules)
│ └── MovementCoordinator (intent voting)
│
└── Hunt Analyzer ←── passive analytics
| Pattern | Where |
|---|---|
| Event-Driven | EventBus, HealBot, TargetBot |
| State Machine | AttackStateMachine, CaveBot WaypointEngine (NORMAL↔RECOVERING) |
| Intent Voting | MovementCoordinator |
| LRU Cache | Creature configs, pathfinding (4-entry), FC tile cache |
| PathCursor Preservation | Walking engine — cursor survives across ticks for same destination |
| Step Pipelining | Keyboard walking — 2-step lookahead dispatch |
| One-time Backend Detection | PathStrategy resolves pathfinder API once at init |
| Adaptive Blacklist Decay | Recovery — exponential TTL replaces permanent blacklists |
| EWMA | Monster tracking, cooldowns |
| BFS Traversal | ContainerOpener, Looting |
| Burst Detection | Z-change protection |
| Guide | Description |
|---|---|
| 📥 Installing | Installation for vBot and OTCR |
| 💚 HealBot | Healing spells, potions, conditions |
| ⚔️ AttackBot | Attack spells, runes, AoE optimization |
| 🧭 CaveBot | Navigation, waypoints, supply management |
| 🎯 TargetBot | Combat AI, Monster Insights, movement |
| 📦 Containers | Container management, quiver system |
| 📊 Hunt Analyzer | Session analytics and insights (SmartHunt) |
| 🛠️ Extras & Tools | Safety, equipment, utilities |
| 🏗️ Architecture | Technical design and internals |
| ⚡ Performance | Optimization and tuning |
| ❓ FAQ | Troubleshooting and common questions |
See CONTRIBUTING.md for guidelines.
Warning
Always test your changes on multiple servers before submitting a PR. Follow existing Lua style (2-space indentation) and update docs for notable changes.
MIT License — see LICENSE file for details.