Advanced Axolkin Setup

For most small server owners, you do not need to do anything other than installing the bot on your server.

If you are a large server owner and wish to configure notifications from the bot, or run tournament events, please read on.

Notifications

By default, the bot will send no recurring notifications within the server.

A server admin needs to tell the bot where to send notifications.

Quick Setup

The fastest way to get going is /setup quickstart - it points every notification type at a single channel.

Pick (or create) a channel for bot notifications - something like #axolkin or #bot-notifications.
Run the command:
```
/setup quickstart channel:#axolkin
```
This sets all notification types (breeding, world time, general, bot status) to that channel.
Verify with /setup show - you should see every row pointing at the channel you chose.

That’s it - you’re live! Players can start using /catch, /farm, /profile, and everything else immediately.

Customizing Channels

If you’d rather split notifications across different channels, use /setup channel to configure each type individually:

Type	What it sends
Breeding notifications	Egg laid, egg ready to hatch, scarecrow expired
World time / season	Season and time-of-day change announcements
General announcements	General Axolkin news and announcements
Bot status	Online / offline notifications
Welcome messages	Greeting when a new member joins

Example - send breeding alerts to a dedicated channel:

/setup channel channel_type:Breeding notifications channel:#breeding

To disable a notification type entirely, run the command without a channel:

/setup channel channel_type:Bot status

Notification Settings

Pings

By default, notifications do not ping the relevant player (e.g. “@Player, your egg is ready!”). Server owners can turn this on:

/setup pings enabled:True

The notification will still send even if off - it just won’t ping anyone.

Quiet Mode

Need to silence all scheduled notifications? Quiet mode suppresses every tick-based message without changing your channel configuration:

/setup quiet enabled:True

Player-initiated commands (/catch, /farm harvest, /profile, etc.) still respond normally. When you’re ready to resume notifications:

/setup quiet enabled:False

Notifications pick back up on the next tick cycle.

Review Your Configuration

Run /setup show at any time to see your current setup at a glance - configured channels, ping status, and quiet mode.

Tournaments

Tournaments are catching competitions where your members compete to find the best Axol by a specific measurement over a set time period.

They’re a great way to drive engagement and give your community a shared goal to rally around.

How They Work

When a tournament is active, every Axol a player catches or hatches is automatically checked against their current entry. If the new Axol beats their previous best, it replaces it - no extra commands needed from the player. At the end, results are announced automatically.

Players can view the live leaderboard at any time with /tournament.

Getting Started

Once enabled, any server member with Manage Server permission can create and manage tournaments.

Create your first tournament:

/tournament-admin create type:heaviest duration_hours:48

This starts a 48-hour competition for the heaviest catch. The bot announces the tournament in your configured general channel.

Tournament Types

Type	Goal
Heaviest	Catch the heaviest Axol
Tallest	Catch the tallest Axol
Lightest	Catch the lightest Axol
Shortest	Catch the shortest Axol

Optional: Rarity Filter

Restrict entries to a single rarity for themed tournaments:

/tournament-admin create type:heaviest duration_hours:24 rarity:legendary

Only Legendary Axols can enter - makes for a more competitive event.

Optional: Divisions

Split your players into groups (2-5) for fairer competition or team-based events:

/tournament-admin create type:tallest duration_hours:168 divisions:"Beginners,Intermediate,Advanced"

The first division will be the default for all users. Users can self assign division using /tournament-join.

Each division has its own leaderboard. You can also force assign a user to a division.

/tournament-admin assign user:@player division:Beginners

You can also modify divisions mid-tournament:

/tournament-admin set-divisions divisions:"Team A,Team B"

Managing Tournaments

Only one tournament can be active per server at a time. To cancel an active tournament without posting results:

/tournament-admin cancel

Results

When a tournament ends, the bot automatically posts the final leaderboard to your general announcements channel. Make sure you have a general channel configured via /setup channel - otherwise results won’t be posted.

Prizes are not automatically awarded, it’s up to you to decide what you want your awards to be!