abstreet/docs/INSTRUCTIONS.md
Dustin Carlino 5a2986d6c9 new release
2020-03-15 20:06:05 -07:00

2.6 KiB

A/B Street Instructions

General disclaimer: This is a very rough demo. The user interface is clunky, and gameplay is not cohesively tied together yet. Please email dabreegster@gmail.com or file a Github issue if you hit problems.

Installing the game

Grab a pre-built binary release -- updated every Sunday, announced at r/abstreet:

Unzip the folder, then run play_abstreet.sh or play_abstreet.bat. On Windows, you'll probably get a warning about running software from an unknown publisher.

Or you can build from source.

Playing the game

General controls:

  • Click and drag to move
  • Scroll wheel or touchpad to zoom
  • Click an object to see more actions
  • The bottom bar shows key shortcuts

Things to try:

  • The tutorial introduces many controls and mechanics.
  • In sandbox mode, select an intersection, and spawn agents.
  • Change the default "random" traffic in sandbox mode to "weekday" to see realistic trips over a full weekday.
    • The weekday traffic scenario should complete successfully on the small montlake map. On other maps, it currently gridlocks or crashes. Most of these are known issues.
  • Go to edit mode (note this will reset the simulation). Select a lane type at the top, then hover over a lane and press space to change it. Deselect the lane tool, then click an intersection to edit stop signs or traffic signals.
  • Go back to the main menu and pick a challenge. Eventually these will be very self-guided, but there are various problems with all of them right now.

Data source licensing

A/B Street binary releases contain pre-built maps that combine data from:

Other binary data bundled in: