Appearance
First steps
This page takes you from nothing to a car that drives by your own program. It uses a city for you alone, so you can try things in peace.
1. Sign in
Open the game and press Sign in. You are sent to simgit.io, where you sign in with your GitHub account, and then you come back. There is one sign-in for every simgit game.
2. Create a city for yourself
On your home page, press Create a city and choose Solo city. Leave every other option as it is.
A solo city has no lobby. It starts at once, and nobody else can join it.
A solo city is yours to throw away. You can reset it, which starts it again from the beginning, or delete it. Both also delete your program's memory for that city. A shared city cannot be reset by one of its players.
3. Connect a repository
Your program lives in a repository on GitHub. Every company needs one, and one repository serves one company.
Schema — Connect a repository
LanguagePython · Go
RepositoryCreate one from the starter Pick one I have
Access for toolsCreate an access key Only needed for the CLI, an AI assistant or the VS Code extension.
The easy way is Create one from the starter. A starter is a small repository with the smallest program that does something. You get your own copy with one click.
The repository may also be empty. You can control your company with the CLI or through MCP and add a program later.
4. Look at your city
The city page opens. Your company has:
- some starting cash;
- one car, with a full tank;
- one driver, who sits in that car.
If you used the starter, the car already moves. The starter's program does one thing: when a car is free, it writes a line into the log and sends the car to the nearest storage.
5. Make the car deliver
Open main.py in your repository. This program takes the best paid order that fits into the car, and keeps the tank from running dry:
python
from delivery import on, me, orders, city
@on.idle
def next_job(event):
car = me.cars[event.car]
if car.fuel < car.tank // 4:
station = city.nearest(car.place, kind="fuel_station")
if car.place == station.place:
car.refuel(reason="tank under a quarter")
else:
car.go_to(station.place, reason="tank under a quarter")
return
if car.orders: # the car has taken an order
order = car.orders[0]
if car.has_all(order):
if car.place == order.shop.place:
car.deliver(order)
else:
car.go_to(order.shop.place, reason=f"deliver order {order.id}")
else:
storage = order.next_storage(car)
if car.place == storage.place:
car.load(order)
else:
car.go_to(storage.place, reason=f"collect goods for order {order.id}")
return
free = [o for o in orders if o.can_be_taken and o.weight <= car.free_capacity]
if free:
best = max(free, key=lambda o: o.fee)
storage = best.next_storage(car)
if car.place == storage.place:
car.load(best, reason=f"order {best.id} pays {best.fee}") # this takes it
else:
car.go_to(storage.place, reason=f"order {best.id} pays {best.fee}")What happens here:
@on.idlemarks the function that runs whenever one of your cars is free.- The function looks at the car and decides one thing for it to do.
- Every command can carry a
reason. The reason shows up later in the history of your decisions, so you can see why your program did something.
Writing code explains every part of this.
6. Push
Commit the file and push it to the main branch of your repository. The game is told about the push, checks your code, and starts it. Your city keeps running the whole time.
The top bar of the city page shows which version of your code runs. If a push was refused, it says so and gives the reason, and the last good version keeps running.
7. Watch, and find out why
Now watch the map. When your car does something you did not expect, open the Decisions panel. It shows what your program was told, what it decided, the reason it gave, and what came of it. See When something goes wrong.