Collection of Brood War data and functions used to help interpret replay and map files.
This library recently got rewritten and I haven't documented the new interface yet.
See src/lib/index.ts for the user facing functions you'll want to import.
Colors work quite inconsistently in StarCraft. There are two sets of color codes: one for briefing messages (and map names), and one for in-game chat messages. These each have their quirks that are different between Brood War (v1.16.1 and below) and Remastered.
Here's a list of all colors:
| Briefing text colors | |||||
|---|---|---|---|---|---|
| Name | Hex value | Code | Slug | ||
| Pale blue |  |
#a4b4f8 | 0x02 | bt_pale_blue | |
| Green |  |
#4cc428 | 0x03 | bt_green | |
| Light green |  |
#b4fc74 | 0x04 | br_light_green | |
| Gray† |  |
#585858 | 0x05 | bt_gray | |
| White |  |
#ffffff | 0x06 | bt_white | |
| Red |  |
#fc0000 | 0x07 | bt_red | |
| In-game text colors | |||||
| Name/slot ID‡ | Hex value | Code | Slug | ||
| Pale blue |  |
#b8b8e8 | 0x02 | ig_pale_blue | |
| Yellow |  |
#dcdc3c | 0x03 | ig_yellow | |
| White |  |
#ffffff | 0x04 | ig_white | |
| Red |  |
#c81818 | 0x06 | ig_red | |
| Green |  |
#10fc18 | 0x07 | ig_green | |
| Gray† |  |
#847474 | 0x05 | ig_gray | |
| Red | 0 |  |
#f40404 | 0x08 | red |
| Blue | 1 |  |
#0c48cc | 0x0e | blue |
| Teal | 2 |  |
#2cb494 | 0x0f | teal |
| Purple | 3 |  |
#88409c | 0x10 | purple |
| Orange | 4 |  |
#f88c14 | 0x11 | orange |
| Brown | 5 |  |
#703014 | 0x15 | brown |
| White | 6 |  |
#cce0d0 | 0x16 | white |
| Yellow | 7 |  |
#fcfc38 | 0x17 | yellow |
| Green | 8 |  |
#088008 | 0x18 | green |
| Pale yellow | 9 |  |
#fcfc7c | 0x19 | yellow |
| Tan | 10 |  |
#ecc4b0 | 0x1b | tan |
| Cerulean | 11 |  |
#4068d4 | 0x1c | cerulean |
| Pale green | 12 |  |
#74a47c | 0x1d | pale_green |
| Bluish gray | 13 |  |
#9090b8 | 0x1e | bluish_gray |
| Turquoise | 15 |  |
#00e4fc | 0x1f | turquoise |
| Pink | 16 |  |
#ffc4e4 | – | pink |
| Olive | 17 |  |
#787800 | – | olive |
| Lime | 18 |  |
#d2f53c | – | lime |
| Navy | 19 |  |
#0000e6 | – | navy |
| Magenta | 21 |  |
#f032e6 | – | magenta |
| Gray | 22 |  |
#808080 | – | gray |
| Black | 23 |  |
#3c3c3c | – | black |
†: In StarCraft, gray is buggy: when it's used in a map name in Brood War, the rest of the name becomes gray as well—this was fixed in Remastered. In in-game text messages, gray will take over the entire rest of the line, both in Brood War and Remastered. This buggy behavior is not completely implemented in this library, and more research is needed to determine every edge case.
‡: Slot IDs 11, 14, 15 and 20 are not selectable as player colors (the color for 11 is used for the neutral player, however). 11 and 15 are still usable as text color. 14 and 20 are duplicates of Pale Yellow and Cerulean.
The following are all available tileset types.
A few of the aforementioned player colors are not pickable on certain tilesets (due to bad contrast).
| Tileset name | Internal name | ID | Disallowed colors | |
|---|---|---|---|---|
| Ash World |  |
ashworld | 3 | Gray, Black |
| Badlands |  |
badlands | 0 | – |
| Desert |  |
desert | 5 | Orange |
| Ice† |  |
ice | 6 | White |
| Installation‡ |  |
install | 2 | Blue, Navy, Bluish gray |
| Jungle World |  |
jungle | 4 | – |
| Space Platform |  |
platform | 1 | Gray, Black |
| Twilight |  |
twilight | 7 | Bluish gray |
†: Also called "Arctic" in the community.
‡: The Installation tileset is only used in the campaign and does not support regular custom games.
The internal names are the names used by the game files themselves, whereas the proper names are taken from the original Brood War map editor.
Number of milliseconds per game frame for each game speed.
E.g. for "Fastest", there are approximately 1000 / 42 = ~23.81 frames in a second. This is used to convert the number of game frames into real time.
| Name | ㎳/frame | Frames/second | % of "Fastest" |
|---|---|---|---|
| Fastest | 42 | 23.810 | 100.0% |
| Faster | 48 | 20.833 | 87.5% |
| Fast | 56 | 17.857 | 75.0% |
| Normal | 67 | 14.925 | 62.7% |
| Slow | 83 | 12.048 | 50.6% |
| Slower | 111 | 9.009 | 37.8% |
| Slowest | 167 | 5.988 | 25.1% |
By far most replays use "Fastest" as the speed, but this table can be used for the rare cases that aren't. In the very old days of StarCraft, the ladder speed setting was "Fast" by default, but this got changed to "Fastest" relatively early on.
MIT licensed.