Skip to content
Alpha version. These pages describe a game that is not built yet. Everything here can still change, and in the alpha every city can be reset at any time.

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.idle marks 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.

What to try next ​

  • Read the rules to learn what a service station is for, before your car breaks down.
  • Try your program on your own machine first, with the CLI.
  • Join a lobby and play against other people.

Delivery is part of simgit.io. This is an alpha version.