🏠 The Art of CORE

🤗 Welcome to the Official CORE Documentation 📚

Read it carefully, there are many helpful tidbits hidden in here.

Especially the tips & tricks section down below and the tip boxes in the Core Library Pages can be incredibly helpful.

Reading the documentation sucks, but it was handwritten to be as helpful as possible and is worth a skim. If there was a question that the documentation didn't answer, please let us know so we can tell you and improve the documentation.

👾 What is CORE?

CORE GAME is a programming competition where you can write a bot and compete against the bots made by other people. Each of you has a base on the map called your core, which is the place you need to protect as if it is destroyed you lose.

You don't have any direct access to the game while its playing, like in a classic game. Instead you create a program that executes your strategy and dynamically adapts to any situation thrown at it. Later, your bot can play against the bots the other event participants wrote.

To avoid being defeated, you can spawn a variety of units to defend and attack your opponent. These all have different stats, abilities and drawbacks. To spawn them, you need gems. To have a look at what units are available, look at the config.

You can receive gems by having your units attack the gem deposits on the map or via idle income which you get automatically. Good resource management is critical to creating a successful bot.

🚀 Getting Started with Your Own CORE Bot

To start building your own CORE bot, ensure you've completed the following prerequisites:

Prerequisites

1. Be a Registered CORE Participant/Team ✨

   • Visit our website, COREGAME.de, sign up, and add your team members.

2. Clone Your CORE Repository 📧

   • You will find an invite link to your dedicated CORE repository on GitHub on your teams page.

3. Follow the README in the repository 📧

   • Basically, run make devcontainer, and then you can get started! Compile using make, visualizer to view the games is under localhost:4000, everything in src/ will be compiled into your bot.

🎉 You are now ready to start coding! 😎

4. Push some code! 🔝
   • The code you pushed will be used to execute games in the queue and in the final tournament. So make sure to push your code regularly and use to queue to test your bot against other participants!

📝 Example Code

In the my-core-bot/src/ folder there will already be a little example bot that does basic actions.

🔎 Get into Core Game!

Look at all the different Core Game Library Info Pages in the sidebar to get sense of how things work! This wiki is your key to the trophy. 🏆

Play and test against other Teams 🎮

Once the default test bot is too boring and you always win, feel free to share your compiled bot with other teams and play against them. You can do this via the queue feature on the website or locally. Of course, you can't force them but it might benefit both of you to see your bots in real action.

🏆 To win the event

Don't overcomplicate things! Simple but well-balanced bots may often reign over overcomplicated but ineffective bots.

Play against other players as often as possible!

Have fun! Don't take things too seriously & be nice to each other. Embrace the good vibes in a friendly competition! ⚡️

Good luck from the CORE team! 🚀🎸🔥💥🗿