forest0xia / dota2bot-OpenHyperAI

# Open Hyper AI (OHA) - Dota 2 Bot Scripts
**The most feature-rich custom bot script for Dota 2.** Play against bots that actually fight, farm, push, and use items intelligently.
> **To play:** Create a **Custom Lobby** and select **Local Host** as the server location. Bots should have names ending with **".OHA"** when installed correctly.
Steam Workshop | GitHub | Feature Requests
---
## What Makes This Different
- **127 heroes supported** on Patch 7.41/7.41a - including Largo, Kez, Ringmaster, Invoker, Techies, Meepo, Lone Druid, and more
- **Bots actually play the game** - they lane, gank, push towers, defend, farm jungle, take Roshan, and use active items
- **Dynamic difficulty (FretBots mode)** - bots get unfair bonuses that scale with difficulty for a real challenge
- **Bots communicate** - they announce pushes, defends, Roshan, and respond to your pings with "On my way!" (in 4 languages)
- **10+ Game modes supported** - All pick, Turbo, All random, Captain mode, 1v1 mid, All Random Deathmatch, etc.
- **Customizable everything** - bot names, roles, hero picks, bans, item builds, skill builds, and more
- **AI Chatbot** - bots chat like real (toxic) players (requires FretBots mode)
- **All roles supported** - deterministic position 1-5 lane assignment
---
## Quick Start
1. Subscribe on Steam Workshop
2. Create a **Custom Lobby** with **Local Host** server
3. Start the game - bots auto-pick and play
For **FretBots mode** (harder bots, neutral items, chatbot): Manual installation guide
---
## In-Game Commands
| Command | Description |
|---|---|
| `!pos X` | Swap your role with a bot (e.g., `!pos 2` for mid) |
| `!Xpos Y` | Reassign bot positions (e.g., `!3pos 5` = 3rd bot plays pos 5) |
| `!pick HERO` | Pick a hero (`!pick sniper`, or `/all !pick sniper` for enemy) |
| `!ban HERO` | Ban a hero from being picked |
| `!sp XX` | Set bot language (`en`, `zh`, `ru`, `ja`) |
Use internal hero names if short names overlap (e.g., `!pick npc_dota_hero_keeper_of_the_light`). Batch commands work too: `!pick io; !ban sniper`.
---
## Bot Roles & Positioning
Lobby slot order = position assignment (1-5):
| Position | Lane |
|---|---|
| Pos 1 (Carry) + Pos 5 (Hard Support) | Safe Lane |
| Pos 2 (Mid) | Mid Lane |
| Pos 3 (Offlane) + Pos 4 (Soft Support) | Offlane |
Customize picks, bans, and roles in Customize/general.lua.
---
## Customization
| What | Where |
|---|---|
| General settings (picks, bans, names, roles) | Customize/general.lua |
| Per-hero settings (items, skills) | Customize/hero/viper.lua |
| FretBots difficulty tuning | FretBots/SettingsDefault.lua |
**Permanent customization** (survives Workshop updates): Copy the `Customize` folder to ` `.
---
## Game Modes
Supports most game modes (10+) . See full compatibility discussion.
---
## Offline / LAN Play
You can start a bot game directly from the console without network or clicking UI buttons — useful for offline play, LAN parties, or quick testing. See play offline setup guide.
---
## Developer D