Welcome to ACM AI's Winter 2023 competition, Element.AI!

We highly encourage you to read the following instructions!

To check the current leadeboard, go to http://ai.acmucsd.com/competitions/Element.AI/leaderboard

Usage

If you are participating in the competition in the basement labs, please refer to documentation/lab_setup.md to set up your lab machine.

Otherwise, please make dure you have the following installed on your system:

Python                  Suggested 3.9.16
Conda                   Suggested 22.11.1
Java                    Suggested 19.0.2
Apache Maven            Suggested 3.9.0

Then, in the root directory of the competiiton, you must run:

conda env create -f environment.yml

Then, you can run the following to start your first game!

python main.py ./kits/python/main.py ./kits/java/main.py -o replay --render

The args are as follows:

• pargs: path to the main.py file in your bot(s). Enter the bots in order of player 0 to player 3
• -l # of iterations in the game. The games will run for 500 iterations during evaluation.
• -o The desired name of the replay file. Note: the .json extension will be added by default.
• -v Verbose Level (0 = silent, 1 = errors, 2 = warnings, 3 = info)
• -s Seeds the environment. Useful for testing edge cases.
• --render Turns on simple rendering. NOTE: purposefully slows down running so that the user can keep up visually.

Replays

Instructions on generating simple video replays (similar to the Pygame window from --render are available in the replay directory).

If you'd like nicer video replays, please check out https://github.com/jonahsoong/Element.AI-Visualizer. We will incorporate this Visualizer into this repo soon.

Evaluation

During the competition when submissions are open, we will run a live, trueskill ranked leaderboard that uses every team's latest verified submission. After 6:30PM we will use the leaderboard to seed a double elimination knockout bracket and crown winners based on the results of that. See ./documentation/submission.md for specific details.

Make sure to submit your agent to the leaderboard early to test it! Any agent that fails to run will automatically lose their games, including in the knockout rounds. There are no exceptions.

Documentation

• The Graphic Documentation contains explanations of the game rules.
• obs_and_act.md) contains detailed explanation of the observation and action spaces.
• The Submission Portal Documentation contains an explanation on how to upload submissions.
• The root directory, the replay directory, and the kits each have README.md's which the player should read.

Development Kits

The Java and Python kits are located in the kits directory.

We will be adding select player submissions as example bots shortly.

Prizes

• 1st place: $1500
• 2nd place: $1000
• 3rd place: $750
• 4th place: $450
• 5th place: $300
• 6-10th place: $150

In addition, all participants are eligible for a $250 raffle!