A BWAPI bot launcher for human vs bot games.
Clone or download

README.md

DropLauncher

Version 0.5.24a has been released!

Description

DropLauncher is designed to be a simple tool to aid players in setting up and playing 1v1 StarCraft: Brood War games against any BWAPI bot using Local Area Network (UDP) as the connection type. Optional/Recommended: Make a copy of your StarCraft directory and let DropLauncher use that copy for the BWAPI bot.

Licenses

Supported Software

  • Windows 7 and higher
  • StarCraft: Brood War version 1.16.1
  • BWAPI versions 3.7.4 to 4.2.0
  • BWAPI bot types: module (*.dll), client (*.exe, *.jar)

Features

  • No installation of DropLauncher required (just extract to any directory)
  • No installation of BWAPI required (BWAPI-related files will be auto-extracted to the StarCraft directory)
  • 1v1 (Human vs Bot) Melee Mode played over LAN UDP
  • Drag-n-drop bot file loading (also allows ZIP files)
  • Auto-eject bot after game has ended
  • Auto-connect bot to game lobby after eject

Third-party Libraries/Applications

DropLauncher uses the following third-party libraries and applications:

Name Type Description
bwheadless.exe Binary Starts a separate StarCraft instance and injects BWAPI
AdakiteLibrary Library Useful general utilities
commons-io-2.5.jar Library Assists with developing IO functionality
zip4j_1.3.2.jar Library ZIP file support

FAQ

Q: How do I install DropLauncher?
A: There is no installation required. Download the latest *.zip file on the releases page and extract it to any directory.

Q: What do I need to install besides DropLauncher?
A: Nothing. DropLauncher is designed to include all required runtime files excluding StarCraft: Brood War.

Q: How do I launch StarCraft before playing against a bot?
A: As long as you can create a Melee game over LAN UDP, you can launch StarCraft using any launcher (e.g. mca64launcher, Chaoslauncher) or no launcher at all.

Q: How do I use DropLauncher to play against a bot?
A: After you've downloaded and extracted DropLauncher:

  1. Create a Melee game over Local Area Network (UDP) in StarCraft.
  2. Run DropLauncher.exe.
  3. Load a bot by dragging all bot files into DropLauncher or by using the File > Select bot files... menu option. Bot files may appear as *.dll, *.exe, *.jar, *.txt, *.json, etc. files.
  4. Press the Start button in DropLauncher and the bot should connect to your game.
  5. More detailed instructions about running and downloading bots are accessible via the Help > DropLauncher Help menu option.

Q: Why does the bot freeze when the game starts?
A: Some bots use the BWTA library which is a terrain analyzer. This library allows the bot to read map information before the game starts. Depending on the size of the map and the speed of the computer, this may take up to a few minutes to generate a cache file for the currently selected map. If a cache file for the map is already present, the bot will load the map data almost instantaneously and should not freeze at the start of the game. These cache files are saved to StarCraft/bwapi-data/BWTA/ and/or StarCraft/bwapi-data/BWTA2/.

Screenshots

alt tag

alt tag