• Java 21

Use the same configs as in ICPC Live Overlay v3. That's all!

Examples:

• CLICS format (ICPC WF)
• Codeforces

Also you can customize data received from test system. We support all options from ICPC Live, but you most likely need to:

• set balloon colors for each problem
• put custom-fields.csv in the config directory with columns team_id,hall,place
  • place will be displayed near the team name so you'll be able to find the team at the contest floor
  • if you run distributed contest (or just have many rooms in the same building), you’ll be able to filter teams by their hall

When using ZIP release, you can use provided scripts:

./balloons.sh  # Unix-like systems
balloons.bat   # Windows

Also you can just launch it manually:

java -jar balloons.jar -c path/to/config

You can customize a few options:

• By default, port is 8001, but you can set another one via --port=1234.

• By default, registration is enabled (but you still need to approve everyone), you can block self-registration using --disable-registration.

In Shell/Batch scripts those variables are changed inside the script.

Then navigate in your browser to http://{ip}:{port}/ (by default and from the same machine, http://localhost:8001/). If this service is exposed to the internet, it's strictly recommended to use some reverse proxy like nginx. See config example.

Don't forget to add admin user (see below).

We create H2 database that contains a few files. They are created in config directory and start with h2, e.g. h2.trace.db. Read more about database files.

You may want to .gitignore them if you're committing configs to some repository.

Replace ./balloons.sh with balloons.bat or java -jar balloons.jar -c path/to/config depending on your setup.

# Create a volunteer
./balloons.sh volunteer create login password

# Create an admin
./balloons.sh volunteer create --admin login password

# Make the volunteer an admin
./balloons.sh volunteer update login --manage=true

# Change password
./balloons.sh volunteer update login --new-password=password

# Delete volunteer (only if they did not take any balloons)
./balloons.sh volunteer delete login

# Drop all balloons: useful between practice and main contest. All users remain.
./balloons.sh reset-contest

# Database SQL shell
./balloons.sh h2shell

You can launch frontend in development mode:

cd frontend/
pnpm run dev

It will start at port 5173. To avoid CORS-tricks, it proxies /api/ to http://localhost:8001. If backend is located somewhere else, set BACKEND_URL environment variable. See vite.config.ts for details.

This task should do the trick.

gradle shadowJar

ZIP archive is generated using

gradle release

1. Add frontend/src/i18n/<your-lang-code>.ts file. Use the same structure as other localization files.
2. Add your language in src/main/kotlin/org/icpclive/balloons/BalloonOptions.kt.

Voilà! I'm waiting for your pull requests.

You may use this repository code according to The MIT License terms.

This project is inspired by previous versions — neerc/balloons and nikkirche/balloons-reborn.

All of this wouldn't work without ICPC Live tools.

• Store time of run and delivery and show it in interface
• Tests