abstreet/docs/INSTRUCTIONS.md

70 lines
2.7 KiB
Markdown
Raw Normal View History

# 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
2019-12-15 22:46:01 +03:00
<dabreegster@gmail.com> or
[file a Github issue](https://github.com/dabreegster/abstreet/issues/) if you
hit problems.
## Installing the game
2019-12-15 22:46:01 +03:00
Grab a pre-built binary release -- updated every Sunday, announced at
[r/abstreet](http://old.reddit.com/r/abstreet):
- Windows:
2020-03-30 05:05:05 +03:00
https://github.com/dabreegster/abstreet/releases/download/v0.1.34/abstreet_windows_v0_1_34.zip
2019-11-11 06:08:35 +03:00
- Mac:
2020-03-30 05:05:05 +03:00
https://github.com/dabreegster/abstreet/releases/download/v0.1.34/abstreet_mac_v0_1_34.zip
2019-11-10 22:38:39 +03:00
- Linux:
2020-03-30 05:05:05 +03:00
https://github.com/dabreegster/abstreet/releases/download/v0.1.34/abstreet_linux_v0_1_34.zip
2019-04-18 00:49:51 +03:00
2019-11-10 22:38:39 +03:00
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.
2019-10-22 22:27:47 +03:00
Or you can [build from source](/docs/dev.md).
2019-11-10 22:38:39 +03:00
## Playing the game
2019-10-22 22:27:47 +03:00
General controls:
- Click and drag to move
- Scroll wheel or touchpad to zoom
2020-01-20 01:39:46 +03:00
- Click an object to see more actions
- The bottom bar shows key shortcuts
2019-10-22 22:27:47 +03:00
Things to try:
2020-01-26 20:37:16 +03:00
- The tutorial introduces many controls and mechanics.
2020-01-20 01:39:46 +03:00
- 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.
2019-12-15 22:46:01 +03:00
- 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.
2019-10-22 22:27:47 +03:00
## Data source licensing
A/B Street binary releases contain pre-built maps that combine data from:
- OpenStreetMap (https://www.openstreetmap.org/copyright)
- King County metro
(https://www.kingcounty.gov/depts/transportation/metro/travel-options/bus/app-center/terms-of-use.aspx)
- City of Seattle GIS program
(https://www.opendatacommons.org/licenses/pddl/1.0/)
- https://github.com/seattleio/seattle-boundaries-data
(https://creativecommons.org/publicdomain/zero/1.0/)
- Puget Sound Regional Council
(https://www.psrc.org/activity-based-travel-model-soundcast)
- USGS SRTM
2019-11-29 21:17:14 +03:00
Other binary data bundled in:
- Overpass font (https://fonts.google.com/specimen/Overpass, Open Font License)
2020-03-27 01:42:37 +03:00
- Bungee fonts (https://fonts.google.com/specimen/Bungee, Open Font License)