CoachAI

KO | EN

gitlite — search

#javascript #typescript #golang #android #machine-learning #docker #nodejs #windows #cli #kubernetes #vue #pytorch #security #openai

(★ 28)

BWAPI AI that helps you play/analyze StarCraft v1.16 game/replay with more eyes/ears/brains, get ready for a 3rd eye/ear and a 2nd brain operation !

CoachAI 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![GitHub top language](https://img.shields.io/github/languages/top/captain-majid/CoachAI?style=flat-square) or see the red line on the side bar, 
[![Hits](https://hits.sh/github.com/captain-majid/CoachAI.svg?view=today-total&label=Hits%3A%20today%2Ftotal)](https://hits.sh/github.com/captain-majid/CoachAI/)
[![](https://repository-images.githubusercontent.com/137318521/615f44cc-5216-4e47-9b54-3999ac41b34b)](https://www.youtube.com/watch?v=GhJ0zlsOEyo)

_**This BWAPI-AI/UDAI (User-defined AI) works as an in-game helper and also as an online replay analyzer.
It can help the players at-all-levels to improve, also to test and sense and remember things that weren't easy/possible before.**_
<details><summary>Note:</summary>

> * CoachAI works only with StarCraft v1.16.1 using ChaosLauncher.
> * When playing in ICCUP, the game is logged and you'll get the win/lose points, this won't happen if one of the players is Computer.
> * In multiplayer matches (ICCUP/Lan), CoachAI will auto send message every 10s (for the 1st 2m) to each human enemy until they all acknowledge/accept that CoachAI-player has multiple advantages (cheats), so nobody can use it as a hack/deceiving/cheat tool. Also the non-CoachAI-player can send a messsage “noCoachAI” during the 1st 2m, to force the CoachAI-player to leave. (in team matches, messages sent automatically to allies, press Shift+Enter to send to all, or the CoachAI-player won't get it), I also made this topic in [Blizzard official forums to end this horrible fake accusation forever, which btw was only said by trolls or very short-sighted people](https://us.forums.blizzard.com/en/starcraft/t/can-a-topic-about-this-be-closedremoved).
> * The CoachAI can run on Windows XP starting from BWAPI v4.4.
</details>

# Features in-game & in-replay: :video_game: :movie_camera:
- A RealTime measure for _**Macro = spent minerals + spent gas**_ (Terran repairs not accounted), many players still measure it just by the used supplies at specific time or by inaccurate replay analysis tools, in-replay you can know @any second who is the best Macro player (same as the score screen you see at the end of game/replay).
- Want to know how many unit/building has been lost in-game/in-replay ?, just select one of the same type.
- The # of units/buildings and also the ones in-progress, and the remaining build time for each one in progress, also the remaining time for each Tech/Upgrade in progress.
- Buildings that has Rally Point will draw a line to the RP.
- Displaying the number of the assigned mineral workers on each Nexus/CC/Hatchery.
- WorkersCut measure, counts the time that Nexus/CC has been idle, if you have 2 bases the counter will be doubled, 3 -> tripled, etc.., it works for P & T, not Z.
- Idle Workers measure displays the number of idle workers, and the total lost time (as with Workers Cut, this increase when there is more Idle Workers).
- MineralsAbove measure for the time being above certain amount of minerals, see _**mineralsAboveLog**_ for customization in-game.
- Detecting the game speed, by just looking at the FPS value: 24=Fastest, 21=Faster, 18=Fast, 15=Normal, etc..
- Showing if a map is 2p/3p/4p on game/replay (just counting the start locations on it).

# Features in-game: :video_game:
- The # of Minerals/Gas workers from all bases.
- The # of idle production buildings (for Zerg, only the number of Larvae displayed), also the buildings IdleTime + Shield Battery remaining energy for Protoss.
- The # of idle of idle fighting units (only non-worker units that canAttackMove: HT, Siege-Mode Tank, Lurker cannot, Medics can !).
- The # of all killed enemies during the game.
- The # of all current enemies, their supplies, Minerals/Gas, upgrades, in-progress things and you can even see the enemies while they move in the dark/fog.
- MacroLog: Logs all build/train/upgrade actions and its time during the game (Tech/Upgrade logged only when its finished, unlike the reply Bo recorder).
- **_Hotkeys tracker/counter_**: Tracks how much you press a specific hotkey.
- The total time of WorkersCut and the number of lost workers due to that.
- **_WorkersCut log_** (only 2+ seconds cut is calculated): to see when exactly in the game you've stopped making workers and for how long (I personally record my screen to see what I was doing, because replay is not always an option).
- **_MineralsAbove log_**: logs the time when you're above certain amount of minerals, and for how long that was, to see when exactly you forgot to Macro.
- Customizable notification sound and period when WorkersCut happens (5s), idle worker exist (5s) or you've missed multitasking (30s/20s).
- **_Screen-Multitasking_**:
A counter for each screen you step into, with total jumps during the game, the average stay @1 screen, the total stay on each screen for above 5s (customizable live, by editing totalTimeOnScreenOrSelectionAbove) and finally, a customizable notification sound when you stay @1 screen for above 30s (customizable live, by editing sameScreenWarningEvery).
- **_Selection-Multitasking_**:
A counter for each selection you select, with total switches during the game, the average focus @1 selection, the total focus on each selection for above 5s (customizable live, by editing totalTimeOnScreenOrSelectionAbove) and finally, a customizable notification sound when you focus @1 selection for above 20s (customizable live, by editing sameSelectionWarningEvery).
- **_The TimedBo_**: all of us forget 1 or more things that was planned before the game, so a written Bo and tips on the game screen that dynamically highlights "What now/next?" while alerting with sound and pronouncing the current step in English JIT and allowing for more step-details to be shown/pronounced out of the succinct Bo form, will accelerate the familiarity with a specific build remarkably.

# Features in-replay: :movie_camera:
- Showing the # of units/buildings & the types of tech/upgrade for each player (just select any player's unit to display the infos).
- Showing the replay duration beforehand, and also the replay name, date/time in UTC (+/- your own Time Zone), game title, game type and the map used.
- Showing each unit order and drawing a line to the order target if there is a target.
- Recording each player Bo. Only the 6th worker is logged for each player to see his split skill, for more info see replayLogUnitsFor/replayLogSupplyFor in the json file.
- Easily distinguishing which players against which on team replays, (even SC:R doesn't has this !, maybe time to write some code lazy Blizzard ?)
- During team replays showing JIT if playerX allied with playerY, and if playerY also did the same.
- Automatic highlighting of idle workers.
- Recording the max number of idle workers of each player, and when that happened.
- The screen will automatically move to where a Nuclear launch is positioned (Comsat scan or Storm autoMove is disabled by default).
- An intuitive/easier way to toggle vision of the selected player (and his allies) by pressing F7 (SC:R requires that you blind ALL other players individually to get the vision of 1 player which is not smart, here we just need to select a player/or 1 of his allies to see the required vision).
- Displaying live score of produced/killed/lost units/buildings, to get the current state of players, this is about unit/building control (more close to micro, same as the score screen you see at the end of game/replay).

# AnyRace_CoachAI.json: :wrench:
This config file allows the player to modify/disable/enable many values:
- _**autoTrainWorkers (default=false)**_: trains 1 worker @time from each base until "maxWorkers" number reached (for Zerg only 1 Hatchery is used for producing).
- **_maxWorkers (default=50)_**: only works if autoTrainWorkers = true
- _**autoMine (default=false)**_: makes workers gather Minerals/Gas automatically like in SC2, so there is no idle worker.
- **_autoBuildSuppliesBeforeBlocked (default=-200)_**: if you set it to 6, the AI will try to build supply units when its 24/30 (for Zerg only 1 Hatchery is used for building)
- **_maxProductionBuildingQueue (default=2)_**: prevent the player from queuing more workers/units from the same production building.
- **_workerCutWarningEvery (default=5)_**: in seconds
- **_idleWorkerWarningEvery (default=5)_**: ^
- **_idleProductionBuildingWarningEvery (default=10)_**: ^
- **_idleFightingUnitWarningEvery (default=20)_**: ^
- **_totalTimeOnScreenOrSelectionAbove (default=5)_**: see Multitasking above
- **_sameScreenWarningEvery (default=30)_**: see Multitasking above
- **_sameSelectionWarningEvery (default=20)_**: see Multitasking above
- **_logSupplyProduction (default=false)_**: include Pylons, Overloads, etc.. in the MacroLog.
- **_logUnitsProduction (default=true)_**: include Dragoons/Zealots, etc.. in the MacroLog.
- **_showMultitaskStats (default=false)_**: show Screen-Multitasking/Selection-Multitasking measures.

- **_workersCutCalculationPeriod (default=540)_**: affects both game/replay, calculates WorkersCut for the specified 1st minutes in the game/replay.
- **_replayLogUnitsFor (default=420)_**: in-replay Bo recorder, for how long to log units production. (until 7:00)
- **_replayLogSupplyFor (default=40)_**: in-replay Bo recorder, for how long to log the supply units & the supply indicator. (like 12,Nexus --> until 40/?)
- **_dontDrift (default=-1)_**: initiates a custom CountDownTimer, just like seen in some missions, but you can use it in any map to practice/polish specific task/timing, when the timer ends the game will too, you can set it in seconds, it works whether its a game start or a saved game, when it reaches 00:15, visual/sound warning will start (this helped me remembering to save the game-state @lets say 6:00), in order to master the game-phases/tasks partially 1st, then as a whole.
- **_workerCutLimit (default=3600)_**: you can set this to 120 (as a goal/target), this will end the game immediately if you intermittently/cumulatively cut workers for 2 minutes in the default 1st 9 minutes.
- **_workerCutLimitForOnce (default=-1)_**: same as above but a 1 time continuous cut with this value (lets say 20s) will end the game. 
- **_spend_more_minerals_WarningFor (default=900)_**: minerals sound warning "Spend more minerals", if minerals 500-750 its every 3s, if > 750 its every 1s, until the default 15 minutes, that doesn't happen in the [SC1 Multitask maps or MacroAlone map](https://cutt.ly/sc1_multitask), because it has it already.
- **_mineralsAboveLog (default=750)_**: logs the time when you're above certain amount of minerals, and for how long that was, to see when exactly you forgot to Macro.
- **_stickyScreen (default=1)_**: which screen to display by default ?, 1 = TimedBo, 2 = WorkersCut log & MineralsAbove log, 3 = Idle Production & Fighting units & Multitasking.
- **_autoGameSpeed (default=true)_**: auto revert to 24 FPS if speed goes lower than that (**_Note_**: some values could be inaccurate if game speed isn't Fastest=24 FPS, like mine > 750 time).
- **_replayAutoMoveToScanOrStorm (default=false)_**: set it to true if you don't want to miss any action !
- **_TimedBo1_**: an editable dynamic build order that appear on-game screen, it highlights/pronounces what should be done now JIT. **To move** any extra step-details out of the succinct Bo form, make it after ";". **To highlight** an important TimedBo step/word/phrase (that you keep forgetting), just make it like this: “04:00 |!gascut| end”. **To comment** extra text (that won't be pronounced by the TTS engine) do that: //extra or /\*extra\*/. **To change game speed** of a certain TimedBo step add "!FPS:30" to it, speed will be changed until overridden by another step or the user, if you want it to be < 24, make sure autoGameSpeed: false. **To change the pronunciation speed/person** (like Cortana or whatever), please modify TTSspeed/TTSname.
- **_TimedBo1 Tips_**: a block of text that appear below a specific TimedBo, you can use "\n" to move to a new line, you can also use ';' here.
- **_Tips1_**: an editable custom tips that appear on-game screen when pressing **_F7_**, you can use "\n" to move to a new line.
  
# Message shortcuts: :pencil:
The player can input some text the UDAI can understand:

**_c1_**="show me the money", **_c2_**="black sheep wall", **_c3_**="operation cwal", **_c4_**="power overwhelming", **_c5_**="staying alive", **_c6_**="there is no cow level".

# Hotkeys: :key:
**_F5_**=Toggle between the display of the MacroLog (**_Up,Down_**=Scroll through the MacroLog when more than one page exists) & the Hotkeys tracker. When on the Hotkeys tracker screen, you can briefly see other screens by pressing _**Ctrl or Shift**_ , Ctrl/Shift last time pressed appear in gameplay, which allow stepping back to see a specific statistic when the screen is recorded, pressing _**Shift**_ will also show the game type. (in-replay **_F5_** switches between different screens).

**_F6 (also in-replay)_**=Toggle the display mode of in-progress units/buildings.

**_F7_**=Switches between the preset custom tips.(in-replay **_F7_** toggles the vision of the selected player)

**_F8_**=Switches between all players infos (press Ctrl for more), this is useful while observing games and will draw the selected player's army/orders/destinations even while moving in the dark/fog, pressing Ctrl+Shift toggles the in-progress mode.
**_F8 in-replay_**=Shows total actions and the eAPM of all players sorted by the highest eAPM.

**_F9_**=Finds the idle workers (like in SC2).
**_F9 in-replay_**=Shows who wins (just the time of players that type gg and leave the game), also shows replay origin and the game creator (host).

**_F11_**=Toggle CoachAI's sounds & notifications on/off.

**_F12 (also in-replay)_**=Hide/show the CoachAI's drawing/text.

**_Ctrl+F1,F2,F3_**=Switches between the TimedBos.

**_PgUp_**=increase game speed, **_PgDown_**=decrease game speed, **_End_**=/speed 0 will run EXTREMELY fast, **_Home_**=reset speed to Fastest (24 FPS) **_Remember_**: speed will auto revert to 24 FPS only if its lower than 24 FPS and **_"autoGameSpeed: true"_**.

**_Left Alt + Space_**=While busy you can press this hotkey to pronounce the next step in the TimedBo.

**_Right Alt + Space_**=Pause/resume the pronunciation of the TimedBo steps.

**_Comma|Period + #_**=Pronounce a specific step in the TimedBo up to 19 (ie: for step3 press ", + 3", step13= ". + 3"), also ',' or '.' alone will display the details of the TimedBo steps.

**_Tilde (~) (also in-replay)_**=Displays buildings gaps values and ground units sizes, for quick and easy reference to better walling, also makes TimedBo background black for easy reading.

**_Ctrl+Down (in-gameplay)_**=If the completed units/buildings list is full, to view the rest of items.

**_Shift|Ctrl + F12_**= Pause|resume the game, when paused you can only move the screen during a multiplayer match.
With some trick this allows pausing a multiplayer game for more than 3 times, which gives the player enough time to comprehend a complex situation and analyse the game-state quickly.
  
# To re-build this project: :hammer:
* Setup Visual Studio 2017 choosing the following components:
![requirements](https://github.com/captain-majid/CoachAI/blob/master/c%2B%2B%20BWAPI%20requirements.png)
# Not done yet, wanna do it ? :tokyo_tower:
* GUI for native Custom Hotkeys like in SCR.
* GUI for more automated intutive Human vs AI scenarios, using BWAPI Revamped.
* GUI for the CoachAI .json/config file.
* Integrate CoachAI TimedBo .json/text format with external bo formats, like with SC2's Spawning Tool & SALT .
* Integrate Voice Recognition tools like VoiceAttack/VoiceBot that make [the AI do game actions just by voice](https://www.youtube.com/watch?v=dOwL2rJ0uEo).

# Known issues: :space_invader:
- The hotkey tracker is buggy when adding units using shift, also when a unit is lost it still shows as an existing one.
- Cancelled unit/building/upgrade/tech appears in ReplayBo/MacroLog, for a cancelled upgrade/tech you'll additionally get a 'None' item below it.
# Screenshots: :camera:
in-game:

![CoachAI](https://i.ibb.co/qxhVVKY/Low-ground-bug.gif)

in-replay:

![replay1](https://i.ibb.co/zf6Gkgd/replay.png)
![replay2](https://i.ibb.co/zNbZg67/replay-bo.png)
# Installation/Download: :rocket:
CoachAI is already included in [BWAPI Revamped](https://github.com/captain-majid/BWAPI-Revamped) or from [here](https://gitea.com/Moataz/BWAPI-Revamped).

# Videos: :movie_camera:
[![CoachAI](https://img.youtube.com/vi/NEqF2v-uiWU/maxresdefault.jpg)](http://www.youtube.com/watch?v=NEqF2v-uiWU)
[![CoachAI](https://img.youtube.com/vi/pjUetaN4z9s/maxresdefault.jpg)](http://www.youtube.com/watch?v=pjUetaN4z9s)

# Chat with someone now ? :speech_balloon:
- [![Discord Banner 3](https://discordapp.com/api/guilds/629001720336482324/widget.png?style=banner3)](https://discord.gg/F3Ds69M)
- https://www.reddit.com/r/CoachAI
- https://us.forums.blizzard.com/en/starcraft/t/coachai-has-arrived

# Spread it to the world ? :globe_with_meridians:
***Strangely***, this is one of [**the most underrated projects in the history of SC1 & SC2**](https://www.reddit.com/r/broodwar/comments/si07k2), even SC2 players are deprived from something like CoachAI in gameplay mode or replay mode, and they're ready to pay good money if that's even possible as some1 mentioned [here](https://www.reddit.com/r/coachai/comments/rakb9i/a_new_starcraft1_coachai_has_arrived/hnyi7hz). So, if you think this real-time practice tool & real-time replay analyzer is useful or phenomenal in the scene of StarCraft, then plz show ur support:
- [x] Stream your live gameplay with it on Twitch/Youtube (vs another BWAPI-AI/human or even computer or maybe just re-visiting the campaign with it, doesn’t have to be a high-level play), showing the benefits of that to you, and your audience.
- [x] Analyze/cast a replay in a smarter/deeper way than SCR replay system, showing what features save innocent lives in CoachAI replay system.
- [x] Design a new Bo using the [TimedBo](https://www.reddit.com/r/broodwar/comments/s7sls6), or make a variant of an existing one, post it somewhere, and tell us how the AI is helping to memorize that.
- [x] Publish it in social media (Twitter, Reddit, TL.net, Discord, etc..) by writing an article or review or just talk about it with friends mentioning any of its features from your own experience.
- [x] :star: this C++ open-source project.
- [ ] Make me rich & donate to my Bitcoin wallet address :moneybag:: **12JGXAVNktYEdjsMPWTpRCSY9DKXrspMiK**

[![Never give up](https://img.youtube.com/vi/NEsQfb4xWY0/maxresdefault.jpg)](http://www.youtube.com/watch?v=NEsQfb4xWY0)

CoachAI

CoachAI 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

CoachAI

CoachAI 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README