🏆

Alchemy Bot Guide

💡

Welcome, adventurer! The purpose of this guide is to help Discord servers install the Alchemy game bot and run their own PvP tournaments in Alchemy: Battle for Ankhos. If you’re looking for tips on competing in tournaments, we encourage you to tag the gold-named members of our home server and ask for PvP advice!

⚠️

At this time, only collaborating servers who have been granted access to our game bot may install and run tournaments. To apply for collaboration, simply open a Collaboration ticket in our home server: https://discord.com/channels/992102063704129616/1127013521796890674 Home server invite: https://discord.gg/playalchemy

CONTENTS

Installing the Game Bot
Creating a Tournament
Choosing a Tournament Type
Choosing Places in the Money
Optional Customization
Start Time
Tournament Name
Gating by Role or Asset ID
Custom Ruleset
Minimum Player Count
Maximum Player Count
Begin Match Time
Required Wins (Best of X)
Additional Required Player Info
Editing a Tournament
Preparing for a Tournament
Creating an Event
Making an Announcement
Running a Tournament
Starting Gameplay
Seeding the Bracket
Finding and Spectating Matches
Match Conclusion
Tournament Completion
Troubleshooting

Installing the Game Bot

Any Discord community approved as a collaborator can install and run Alchemy: Battle for Ankhos from within their own servers. Once approved, they will be provided with a bot install link.

📌

All game data will be shared across servers, so any Descendants created, quests completed, or tournaments run will be accessible and visible from any other server that has installed our game bot.

Install our game bot in a few easy steps:

Click the provided installation link and approve all requested permissions for the bot.
Create two text channels, one for the primary Play menu and one for managing Tournaments.

Our recommended text for these channels:

┇🎮・play-alchemy

┇🏆・alchemy-tournaments

📌

We highly recommend making these two channels publicly viewable so players from other communities can visit your server. This increases the visibility of your community to our players and may help you grow organically, especially if you plan to run public tournaments.

Ensure the bot has full permissions to chat, create threads, and embed links in the Play and Tournament channels you created.

⚠️

If you have auto-moderation enabled by any bots such as Mee6, the game bot may be throttled or blocked from its normal functionality. Make sure there are no automatic moderation features affecting our game bot.

Use the slash command /prepare in the Play channel. If the game was prepared successfully, you should see a play menu resembling the following:

⚠️

We recommend you disable user messages in the Play channel but enable them in threads. This way, nobody can move the main menu after it has been posted.

🎉 You can now play Alchemy: Battle for Ankhos from your own server!

Creating a Tournament

Once you have successfully installed the game bot, you can run an Alchemy PvP tournament in your own server using a single slash command in the Tournament channel: /t_open

⚠️

Once you have created a tournament, it immediately becomes open for registration! Make sure you have selected all of your intended rules before completing the command.

After typing /t_open in your Tournament channel, click the matching command that populates above the text box.

Choosing a Tournament Type

You will next be asked if you want to run a Single or Double Elimination tournament.

Single elimination tournaments will eliminate players as soon as they have lost their first match.

Double elimination tournaments will eliminate players after they have lost their second match. The undefeated finalist (upper bracket) will fight the once-defeated finalist (lower bracket) in the final round. Whoever wins the final match will win the entire tournament. The lower bracket finalist does not have to win twice.

Choosing Places in the Money

Next, you must choose how many players will be awarded a portion of the prize pool.

⚠️

Only use this function if you intend to use our automatic payout feature. Otherwise, select 0.

Selecting 0 will allow you to manually pay out your prize winners.

Selecting 1 will send 100% of the prize pool to the 1st place player.

Selecting 2 will send 65% of the prize pool to the 1st place player and 35% to the 2nd place player.

Selecting 4 will send 50% of the prize pool to the 1st place player, 30% to 2nd, and 10% to both 3rd and 4th. There will not be a match for 3rd and 4th as the prize pools are the same.

Optional Customization

All of the next steps are optional. Each of these features will allow further customization of your tournament, if desired.

Continue reading to understand how each of these functions will modify your tournament.

Start Time

If you would like your tournament to begin automatically, select time_start and enter the numeric value of the universal time code for your start time.

Universal time codes can be found using this tool: https://r.3v.fi/discord-timestamps/

⚠️

Only enter the number value of your universal time code in the slash command! For example: 1691438400

⚠️

If you choose not to use an automatic starting time, you will need to start the tournament yourself using the t_start slash command.

Tournament Name

Selecting tournament_name will allow you to add a custom name to the tournament.

📌

We highly recommend using the name of your community in the tournament name as it will appear in the list of open tournaments from any other server that has installed Alchemy.

Gating by Role or Asset ID

If you would like to role- or token-gate registration for your tournament, select gate_by_role_or_holder and then enter the ID of the role, token, or collection you wish to gate with.

To find a role’s ID, you must first enter Developer Mode on your Discord account. Next, right-click the desired role in your server and select Copy Role ID. Paste the ID next to gate_by_role_or_holder in your slash command.

Custom Ruleset

Select custom_ruleset to add special tournament rules. New rulesets will become available over time!

adjusted_level will adjust the level of all Descendants entered into the tournament by standardizing their stats to the desired level (1-5). For example, adjusted_level3 will adjust all Descendant teams entered into the tournament to level 3.

Minimum Player Count

Selecting minimum_players will allow you to change the minimum number of registered players required for the tournament to take place.

If this minimum is not reached by the tournament’s start time, the bracket will not be seeded and the tournament will be cancelled.

Maximum Player Count

Selecting maximum_players will set a maximum for the number of players who can register for the tournament.

If a player attempts to register for the tournament after the maximum has been reached, they will fail to register.

Begin Match Time

Select begin_match_minutes to change the number of minutes each player will have to start their tournament matches.

If the set time runs out and only one player has readied, the other player will automatically forfeit.

If the set time runs out and neither player has readied, a coin will be flipped to determine who forfeits and who moves onto the next match in the bracket.

Required Wins (Best of X)

Selecting req_wins will change the number of wins required in a series of matches between two opponents.

For example, if you want each round of a tournament to be best of one match, choose 1. If you want best of three, choose 3.

Additional Required Player Info

If you need more information from each of the players who register in your tournament, use required_infos to designate what information you require. Upon registering, players will have a chance to provide the information to you.

Editing a Tournament

If you made a mistake while creating the tournament and players are already registered, you can reach out to our team and request an edit.

Preparing for a Tournament

After you have created your tournament, we highly recommend taking a few additional steps to help your players prepare.

Creating an Event

Events will help players get notification reminders about the start of the tournament before it begins.

📌

Our bot will also tag all registered players ~10-15 minutes before gameplay begins.

We recommend making the location of the event the Play channel, as that is where players will be able to register for the tournament (Play → Tournaments).

To link your Play text channel as your event location, first make sure your Discord account is in Developer Mode. Then, copy the Channel ID of your Play channel by right clicking it and selecting Copy Channel ID.

Create a New Event, and then choose Somewhere Else for the location. Paste this ID in the following format: <#CHANNELID>

Making an Announcement

It’s important that your members understand registration for the new tournament is open. If they are new to Alchemy, you may also have to write some instructional information in the announcement.

You can use the following template:

Registration is now open for our Alchemy: Battle for Ankhos PvP tournament! Gameplay begins <tournament start date and time> To register, head to <your play channel> and select the Tournaments button, then find our tournament called <your tournament name>. *Make sure you have the right team selected before registering!* <prize pool info> <tournament details> 🜂🜄🜁🜃 Alchemy: Battle for Ankhos is a turn-based RPG played entirely in Discord. Create your own teams of Descendants to go on quests, earn loot, and fight against other players! To get started → <your play channel> 🜂🜄🜁🜃 Get a reminder about the tournament by RSVPing to our event: <your event link>

We recommend posting the announcement in either your Tournament channel or in your own Announcements channel.

Running a Tournament

Starting Gameplay

If you selected a start time for your tournament, the bracket will be seeded automatically.

If not, you can start the tournament at any time by using the t_start slash command in your Tournament channel.

Seeding the Bracket

Once the tournament begins, our game bot will automatically seed players into match threads and post a picture of the bracket, all within your Tournament channel.

Finding and Spectating Matches

Players will be tagged in their individual match threads, where they will have a certain amount of time to check in before the match begins. If a player does not check in before time expires, they will automatically forfeit the match.

Any other Discord user with access to the Tournament channel can spectate player matches by clicking on the match threads.

Match Conclusion

As each match concludes, the result will be posted and the bracket will be updated.

To force a win, you may use the command t_force_win to choose a winner of an active match.

Tournament Completion

Once a winner has been crowned, the tournament will be completed and winners will be listed.

If you chose to fund the prize pool and pay out winners automatically, our bot will send all transactions on your behalf.

If there are additional prizes you wish to offer that were not sent automatically, you will have to manually request the wallet addresses of the players who won.

Troubleshooting

If you are experiencing any unusual or blocked functionality while playing the game or running a tournament from your own server, please tell us and we will be glad to help you troubleshoot the issue.

The best way to get in touch with us is by opening a support ticket in our home server: https://discord.com/channels/992102063704129616/1127013521796890674

Server invite: https://discord.gg/playalchemy