Folders and files
| Name | Name | Last commit date | ||
|---|---|---|---|---|
Modular Tibia bot for OTClientV8 and OTCR. Auto-detects client at startup.
- Copy nExBot/ into your client's bot/ directory
- Open client, press Ctrl+B, select nExBot, click Enable
- Configure HealBot (healing), TargetBot (creatures), CaveBot (route)
Install paths:
- vBot: %APPDATA%/OTClientV8/<ServerName>/bot/nExBot
- OTCR: ~/.local/share/<otcr-data>/<ServerName>/bot/nExBot
| 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 |
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
| 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 |
See CONTRIBUTING.md. Run make check before submitting. Follow existing Lua style (2-space indentation).