How to Connect Trello to Adonis

[Z3phrz]

This guide will show you how you can connect your Trello board to Adonis. You can then use Trello to manage admins, commands, bans, and more.

Please note that Trello is not designed to be used as a database, and it is NOT recommended to use the Trello integration in games with lots of players or servers. If your game has a high player/server count, please look into implementing your own external database with something like Google's Firebase or MongoDB. If you end up sending too many requests to Trello from your Roblox game, Trello will rate limit you and there is a chance of your Trello account being moderated.

We are not responsible for your misuse of any APIs connected with Adonis.

Create a Trello Board

1. If you do not have a Trello account, make one now at trello.com
2. Create a new board
   
3. Choose from the list below and create a new list for each setting you wish to manage. The names of the lists must match EXACTLY to the ones below:

Moderators		- Card Format: Same as settings.Moderators
Admins			- Card Format: Same as settings.Admins
HeadAdmins		- Card Format: Same as settings.HeadAdmins
Creators		- Card Format: Same as settings.Creators
Banlist			- Card Format: Same as settings.Banned
Mutelist		- Card Format: Same as settings.Muted
Blacklist		- Card Format: Same as settings.Blacklist
Whitelist		- Card Format: Same as settings.Whitelist
Permissions		- Card Format: Same as settings.Permissions
Music			- Card Format: SongName:AudioID
Commands		- Card Format: Command  (eg. :ff bob)

4. Your board should now look something like this. Check your Adonis settings script in studio to see what formats you can use.
   

Configure the Adonis - Trello Integration

1. Head over to Roblox studio
2. Go to the home tab > game settings > security and enable "Allow HTTP Requests"
3. Now open up your Adonis settings script and scroll down to "HTTP/TRELLO SETTINGS"
4. Keep settings.HttpWait = 60 - going lower than 60 will increase the chance of you hitting rate limits
5. Set settings.Trello_Enabled = true
6. settings.Trello_Primary = "BOARD_ID_HERE" - enter your board ID (https://trello.com/b/COPY_ID_FROM_HERE/adonis-test-board)
   
7. Head over to trello.com/app-key - copy the "personal key" and put it in settings.Trello_AppKey = ""
   
8. Go to the following link. Make sure to replace "YOUR_APP_KEY_HERE" at the end of the URL with the key you copied in the previous step: https://trello.com/1/connect?name=Trello_API_Module&response_type=token&expires=never&scope=read,write&key=YOUR_APP_KEY_HERE
9. You should be prompted to allow the API connection. Once you login and approve this, copy the token and put it in settings.Trello_Token = ""
   
   

Verify Connection in-game

1. Save & publish your game and test the Trello integration out
2. If you run the :admins command, you should see the Trello admins (assuming you chose to add this list to your board)
   
3. You can also run :viewlist [listname] to see what is in your Trello list from in-game
   
4. For more functionality, take a look at the following commands:

:makelist
:trelloban
:viewlist

[Z3phrz]

For further support, join our discord: https://dvr.cx/epix_discord_invite