This is a Furcadia bot based on the skeleton provided by FurgieV in kiwi-bot https://github.com/FergieV/kiwi-bot. Most of this code is still the original Kiwi-bot, all credit for it goes to FurgieV, thank you!.
- Integrate with discord and alert when a new arrival enters your dream
- Create a character to be the actor for your bot, bots are just like any other character on your account.
- Add DS to your dream to emit a message whenever a furre joins
Something like:
(0:9) When a furre arrives in the dream,
(5:204) emitloud message {[FURRE] has arrived!} to everyone on the map.
You're free to look into the code and modify the shape of the message the bot is looking for, but by default, havarti will notice when an emit ends with 'has arrived!'.
- Set up a webhook in your discord server
Go into your Discord server settings, and select the integrations tab. Then click 'Create Webhook'
This will create one with a randomized name. Open it, give it a fun name and copy the url. (Note, this url is a secret, you shouldn't share it with anyone)
I like to make a specific channel in my discord server for bots to post their messages. This way people can easily mute them if they don't want to see the notifications.
- Download the Havarti bot package
https://github.com/JamieMouse/havarti/tree/main
If you're not comfortable with git, you can use the download zip button! Just remember to extract the files.
- Configure the bot
Now you have everything you need to configure your bot! In the files you downloaded earlier, you should find one labelled bot.conf. This is where you'll configure all the information related to your bot!
Use the email associated with the character you made earlier, as well as the password. Fill in the character name, if it has a space in it, use a | instead. Like... 'Havarti|Dreams' instead of 'Havarti Dreams'. Colors and desc are asthetic only, but fill them in if you like! The owner allows you to assign a character as the bot owner, who can issue it commands.
Very importantly, the webhookurl is the url you copied earlier while creating your webhook. The bot won't know where to send the notifications if you don't fill this in.
In the directory you extracted havarti into, open command prompt or terminal Start the bot with the command py kiwibot.py
Your bot should log in to wherever you last logged out of it, now when the text {'furre name} has arrived!' appears in the dream your bot is in, it'll call the discord webhook and forward the notification to discord!
You'll need to install the requests module, use the command pip3 install requests