Custom Lua bot scripts for Dota 2, built on a snapshot of OpenHyperAI (OHA) and developed independently from that point on.

Mission: instead of being "okay at 127 heroes", make a small pool of 10-15 heroes play clearly better than the default bots — measurably, via batch A/B win-rate testing — and ship the result to the Steam Workshop as a one-click-subscribe bot script. (The project has no final name yet; Workshop naming is an open TODO.)

• A polished, focused bot script. The full OHA hero coverage (127 heroes, Patch 7.41/7.41a) is inherited and kept working, but deep polish effort goes into a small set of focus heroes.
• First-batch focus heroes: Axe, Zeus, Wraith King (skeleton_king), Lion, Crystal Maiden.
• Candidate pool for later expansion: Luna, Sniper, Death Prophet, Tidehunter, Dragon Knight, Witch Doctor, Lich, Warlock.
• Data-driven iteration. Every hero-logic change must pass static analysis, unit tests, and batch A/B win-rate validation before it merges. Gut feeling doesn't ship; win rates do.
• Independent since the fork. This project started from an OHA snapshot at patch 7.41/7.41a and evolves on its own; merging from upstream is not planned. Future Dota patches are handled by our own runbook (docs/PATCH_UPDATE_GUIDE.md).

The canonical statement of goals, hero pool rationale, testing methodology, and roadmap lives in docs/PROJECT.md.

This repo began as a fork of forest0xia/dota2bot-OpenHyperAI, the most feature-rich community bot script for Dota 2. All of the shared machinery — laning, farming, pushing, item purchasing, FretBots difficulty mode, game-mode support — is OHA's work and that of the bot-script lineages before it (see Credits). We are grateful for it; without that foundation a project like this would take years, not weeks.

The fork point is a permanent departure: we do not track or merge upstream. What we add on top is focus-hero polish plus a development/verification infrastructure (linting, unit tests, CI, headless batch A/B testing) that the upstream project does not have.

bots/            The deliverable: pure Lua bot scripts (this is all that ships to the Workshop)
  BotLib/          Per-hero logic (hero_<internal_name>.lua — names dictated by the Dota bot API)
  FunLib/          Core shared libraries (items, skills, roles, positioning, chat)
  FretBots/        Enhanced-difficulty mode (dynamic bonuses, neutral items, chatbot)
  Customize/       User-editable settings (picks, bans, names, difficulty)
game/            Valve default setup + permanent-customization location
docs/            Documentation (project statement, architecture, patch runbook, Bot API reference)

-- Dev-only, never ships to the Workshop: --
tests/           Unit + smoke tests under a mock Bot API (lua5.1)
tools/batch_test/  Headless batch match runner, same-match A/B dispatch, AWS on-demand runbook
typescript/      TS sources for the TS-generated Lua files (inherited OHA toolchain)
.github/         CI (luacheck + unit tests on every push)

Note: the layout and file naming under bots/ are dictated by the Dota 2 bot scripting API (the game loads bots/hero_selection.lua, bots/BotLib/hero_<name>.lua, etc. by path). Do not rename or move Lua files there.

Run before every push (CI enforces the first two):

luacheck bots game --formatter plain   # static analysis; must be 0 warnings
lua5.1 tests/run_tests.lua             # unit tests under mock Bot API

Hero-logic changes additionally require batch A/B validation with tools/batch_test/ (win rate / GPM / XPM deltas over dozens of headless matches; see tools/batch_test/README.md and docs/PROJECT.md for the full test-tier methodology).

The Dota bot VM is Lua 5.1: no goto, no table.unpack (use unpack).

The script is not on the Workshop yet. To run it from a local checkout:

1. Link or copy bots/ into your Dota 2 scripts folder: <Steam>/steamapps/common/dota 2 beta/game/dota/scripts/vscripts/bots (The helper scripts in bots/Install-to-vscript/ automate the symlink; they are inherited from OHA and reference the upstream Workshop ID, but the symlink mechanics apply to any checkout.)
2. Create a Custom Lobby and select Local Host as the server location.
3. Start the game — bots auto-pick and play. Correctly loaded bots have names ending in ".OHA" (inherited naming; will change when we brand the project).

Lobby slot order = position assignment: pos 1 + 5 safe lane, pos 2 mid, pos 3 + 4 offlane.

Permanent customization (survives updates): copy the Customize folder to <Steam>/steamapps/common/dota 2 beta/game/dota/scripts/vscripts/game/Customize.

Dota 2 bot scripts use internal code names for heroes, items, and abilities — different from in-game display names. Always verify against authoritative sources:

This project stands on the shoulders of the community bot-script lineage. The foundation is:

• Open Hyper AI (OHA) by forest0xia and contributors — the codebase this project forked from (upstream Workshop page)

OHA itself builds on Valve's default bots plus contributions from many talented authors:

• New Beginner AI (dota2jmz@163.com)
• Tinkering About (ryndrb)
• Ranked Matchmaking AI (adamqqq)
• fretbots (fretmute)
• BOT Experiment (Furiospuppy)
• ExtremePush (insraq)
• And all other contributors who made bot games better

Licensed under the MIT License, same as upstream.