A high-performance automation bot for OTClientV8 (vBot) and OpenTibiaBR (OTCR) with AI-powered combat, real-time analytics, and intelligent navigation.

nExBot is a modular Tibia bot that automates hunting, healing, navigation, and analytics. It runs on both vBot (OTClientV8) and OTCR (OpenTibiaBR) — the client is auto-detected at startup, no configuration needed.

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.

1. Open the client, log in, press Ctrl+B.
2. Select nExBot from the bot dropdown and click Enable.
3. You should see Main, Cave, and Target tabs.

1. HealBot — Set healing spells and potions (Main tab → Healing).
2. TargetBot — Add monsters to fight (Target tab → +).
3. CaveBot — Load a pre-built config or record waypoints (Cave tab → Show Editor).
4. AttackBot — Set attack spell rotation (Main tab → AttackBot).

Enable CaveBot and TargetBot, press Start (Ctrl+Z), and monitor progress in Hunt Analyzer.

• 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 v3.2 — floor-change prevention, chunked walks, field handling, keyboard fallback
• 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

• Auto-detects vBot vs. OTCR at startup
• Unified ClientService API for all game operations
• OTCR-exclusive features (imbuing, stash, forge, prey, market) 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

See CONTRIBUTING.md for guidelines. Small, focused PRs preferred. Follow existing Lua style (2-space indentation). Test on multiple servers. Update docs for notable changes.

MIT License