nExBot

Modular Tibia bot for OTClientV8 and OTCR. Auto-detects client at startup.

Quick Start

1. Copy nExBot/ into your client's bot/ directory
2. Open client, press Ctrl+B, select nExBot, click Enable
3. Configure HealBot (healing), TargetBot (creatures), CaveBot (route)

Install paths:

• vBot: %APPDATA%/OTClientV8/<ServerName>/bot/nExBot
• OTCR: ~/.local/share/<otcr-data>/<ServerName>/bot/nExBot

Modules

Module	Function
HealBot	Spell/potion healing at configurable HP thresholds. 75ms response.
AttackBot	Attack spell/rune rotation with AoE optimization
CaveBot	Waypoint navigation, floor-change safety, supply refills, 50+ pre-built routes
TargetBot	9-stage priority targeting, Monster Insights AI, movement coordination
Hunt Analyzer	Session analytics — kills/hr, XP/hr, profit, Hunt Score
Containers	Event-driven BFS, O(1) operations, generation tracking, quiver management 🎒
Follow Player	Party hunt — stays near leader while attacking
Extras	Anti-RS, alarms, equipment swap, combo system, push max

Architecture

 Loader.lua (entry)
├── ACL (vBot/OTCR detection + adapter)
├── EventBus (event-driven communication)
├── UnifiedTick (single 50ms master timer)
├── UnifiedStorage (per-character JSON persistence)
│
├── Containers 🎒
│   ├── identity (physical container identity)
│   ├── queue (head/tail FIFO, O(1) dequeue)
│   ├── state_machine (13 states, generation tracking)
│   ├── registry (O(1) lookups, incremental item index)
│   ├── bfs (event-driven traversal)
│   ├── scheduler (UnifiedTick integration)
│   ├── readiness (derived snapshots)
│   ├── quiver (paladin ownership)
│   └── discovery (orchestrator)
│
├── HealBot ←── player:health events
│   └── spell_resolver (conversion functions)
├── AttackBot ←─ TargetBot decisions
│   ├── attack_data (pure data tables)
│   └── attack_analytics (recording functions)
├── 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

Documentation

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
Follow Player	Party hunt companion
Containers	Container management, quiver system
Hunt Analyzer	Session analytics
Extras	Safety, equipment, utilities
Architecture	Technical design
Performance	Optimization and tuning
FAQ	Troubleshooting

Contributing

See CONTRIBUTING.md. Run make check before submitting. Follow existing Lua style (2-space indentation).

License

MIT License