# Welcome to Guilda Bot!
## Welcome to the GuildaBot Documentation
Welcome to the official documentation for [**GuildaBot**](https://guildabot.com)**,** your all-in-one solution for creating dynamic, intelligent, and customizable Discord bots with ease.
Whether you're a server owner looking to enhance your community, a developer integrating advanced features, or a curious user exploring what GuildaBot has to offer, you're in the right place.
***
### What is GuildaBot?
**GuildaBot** is a powerful Discord bot platform designed to give you full control over your server’s automation, moderation, engagement, and integrations. Built with scalability and simplicity in mind, GuildaBot supports everything from custom commands to advanced event handling and API integrations, no coding required.
***
### What You’ll Find Here
This documentation is your complete guide to getting started with GuildaBot, managing your bot, and unlocking its full potential. Here’s a quick overview of what’s inside:
* **Getting Started**\
Step-by-step instructions to create and configure your bot.
* **Bot Dashboard**\
Learn how to use the Guilda Dashboard to manage commands, permissions, and settings.
* **Commands & Features**\
A comprehensive list of commands and features available out of the box.
* **Advanced Configuration**\
Tips for customizing bot behavior, webhooks, OAuth2, and more.
* **Troubleshooting & FAQs**\
Solutions to common issues and helpful tips from the community.
* **Developer API (Coming Soon)**\
Documentation for developers to integrate with GuildaBot’s backend services.
***
### Need Help?
We're here for you! If you run into any problems or have questions not covered in this documentation, feel free to reach out:
* Join our [Discord Support Server](https://discord.gg/dMUWwfha)
***
### Let’s Get Started!
Start your journey by heading to the Customer Guides, where we walk you through creating your Discord application and connecting your bot to the Guilda platform.
Thank you for choosing **GuildaBot,** we’re excited to help you build something great!
# Customer Guides
# Installation Guide
# Create Discord App
To begin linking your Discord bot to **Guilda**, you need to create a Discord application.
1. Navigate to the [Discord Developer Portal](https://discord.com/developers/applications).
2. In the top right corner, click the **"New Application"** button.
3. In the pop-up window, enter a name for your application, accept the TOS, then click **"Create"** and complete the Captcha.
Next, you’ll need to create a bot user for your application:
4. On the left-hand sidebar, click the **"Bot"** tab.
5. Click the **"Reset Token"** button to generate a new secret token for your bot.
* **Note**: If you have Two-Factor Authentication (2FA) enabled, you will be prompted to enter a verification code.
5. After the token is generated, copy it to your clipboard (Click Copy button). You’ll need this in the next step.
* **Important**: Keep your bot token secure and **never share it** publicly. (You can save it in a Password Manager App, secret doc, etc).
*
```
```
Click **Next Step** below to proceed
# Bot Token & Intents
Now that you’ve copied your bot’s token, head over to the [**Guilda Dashboard Login**](https://app.guildabot.com/) and do the following:
1. Go to the **Guilda Dashboard**, then click the **"Settings"** tab in the sidebar.
2. Paste your bot token into the **"Bot Token"** field and click **Save**.
Next, return to the Discord Developer Portal to configure the bot’s visibility and enable required gateway intents:
3. Enable the following **Privileged Gateway Intents**:
* **Presence Intent**
* **Server Members Intent**
* **Message Content Intent**
These intents are necessary for the bot to function properly on your server.
Click **Next Step** below to continue.
# OAuth2 and Invite
Now it's time to set up OAuth2 scopes and permissions so your bot can be invited to your Discord server.
1. In the Developer Portal, click the **"OAuth2"** tab in the sidebar.
2. In the URL Generator, under **Scopes**, select:
* `bot`
* `applications.commands`
3. Under **Bot Permissions**, select:
* `Administrator`\
(This gives the bot full control over your server, only assign it if you trust the bot and its code.)
4. Copy the **generated invite URL** to your clipboard.
Final step:
5. Paste the invite URL into your browser.
6. Choose the Discord server (guild) where you want to add the bot.
7. Click **Continue** and follow the prompts to authorize the bot.
***
That’s it! You’ve successfully created and invited your bot.
To start the
# Guilda Bot (Free Version)
## Guilda Bot (Free Version)
A free and open-source Discord bot built with Oceanic.js and Prisma.
### Features
{% columns %}
{% column %}
* Bot Customizer
* Advanced Logging System
* Welcome Module
* Application Modules
* Self Role Module
{% endcolumn %}
{% column %}
* Role Request Module
* Birthdays Module
* Suggestions Module
* Giveaway Module
* Polls Module
{% endcolumn %}
{% endcolumns %}
### Prerequisites
* Node.js v16.x
* MySQL database
* Docker (optional, for containerized deployment)
### Traditional Setup
{% stepper %}
{% step %}
### **Clone the repository**
```
git clone https://github.com/yourusername/slothybot-free.git
cd slothybot-free
```
{% endstep %}
{% step %}
### **Install dependencies**
```
npm install
```
{% endstep %}
{% step %}
### **Create a `.env` file in the root directory**
```
TOKEN="your-discord-bot-token"
ACTIVITY_NAME="Testing"
ACTIVITY_TYPE=0
PRODUCTION=0
BOT_DATABASE_URL="mysql://username:password@localhost:3306/your_database"
TEST_GUILD_ID=""
```
{% endstep %}
{% step %}
### **Set up the database**
```
npm run ready
```
{% endstep %}
{% step %}
### **Start the bot**
```
npm start
```
```
npm run build
npm run start:prod
```
{% endstep %}
{% endstepper %}
### Docker Setup
{% stepper %}
{% step %}
### **Clone the repository and navigate into it**
```
git clone https://github.com/yourusername/slothybot-free.git
cd slothybot-free
```
{% endstep %}
{% step %}
### **Create a `.env` file as described above**
```
npm install
```
{% endstep %}
{% step %}
### **Build and run using Docker**
```
docker build -t slothybot .
docker run -d --env-file .env slothybot
```
{% endstep %}
{% endstepper %}
### Environment Variables
* TOKEN: Your Discord bot token
* ACTIVITY\_NAME: Bot's activity status text
* ACTIVITY\_TYPE: Activity type (0 = Playing, 1 = Streaming, etc.)
* PRODUCTION: Production mode flag (0 = development, 1 = production)
* BOT\_DATABASE\_URL: MySQL database connection URL
* TEST\_GUILD\_ID: Discord server ID for testing commands in development mode
### Important Notes
* This project uses older dependencies and is specifically tested with Node.js v16.x
* Required system dependencies for image processing:
* build-base
* g++
* cairo-dev
* jpeg-dev
* pango-dev
* imagemagick
* giflib-dev
* librsvg-dev
### Database Migrations
To update the database schema:
```
npm run prisma-migrate
```
To regenerate the Prisma client:
```
npm run prisma-generate
```
# Bot Usage
# Bot Branch
# General Bot Settings
Configure general settings for your bot. This will update in real-time when you add to it
Global configuration options include:
* Common Log Channel
* Default Embed Color
* Success Embed Color
* Error (Danger) Embed Color
* Role Recovery On Rejoin
# Moderation Branch
# Advanced Logs
Set up advanced logs module. This will update in real-time when you add to it
Enhanced logging capabilities for all activities, including separate logs for text and voice interactions. \
\
The configurable options are as follows:
* Text Logs
* Voice Logs
* Invisible Roles - Ignore all logs from this role
* Invisible Channels - Ignore all logs from this channel
# Alt Prevention
Set up alt prevention this will update in real-time when you add to it
Verifies the account creation date of users on Discord and removes them from your server based on their account age, in days, along with a personalized direct message.
# Anti-Tagging
Set up anti-tag this will update in real-time when you add to it
The "Anti-Tag Module" is designed for Discord servers to automatically enforce rules regarding the tagging (mentioning) of specific user roles, such as the "Staff Team."
# Captcha Verification
Enabling Captcha verification for your server.
# Discord Guild Stats
Provides a configurable options that you can display on your server for all of your current config found below:
* Member Count
* Channel Count
* Role Count
You can also setup custom stats based on your require panels.
# Moderator Tools
Provides a configurable options that you can display on your server for all of your current config found below:
This section here is where you will go to setup the Modeartor Module each little thing you see here explains what it does
You will click on the drop menu and it will provide more things that you can use with the moderator tools.
With the new features that guilda has gotten you can now manage it through your guilda dashboard
In your guild moderation you can configure moderation settings for your guild
# Level Up Leaderboard
# Welcome Message
You can setup a welcome message when new members joines you discord server\
\
The first thing that you will need to do is setup the welcome message
Make sure that you make a welcome channel in your discord server \
\
Just make sure that you follow each of the steps so you don't miss anything
Once it's complete you will get a nice welcome message that will post in your discord server\
# Engagement & Fun Branch
# Birthdays
# Reviews
# Snippets
# Suggestions
Do you want to give your discord members a place where they can let your members put suggestions in for discord or anything that you will use your suggestions\
\
The first step that you have to setup a channel in your discord
Once you get all of that setup you can let you members know on how to use the suggestions in your discord server
you will have your discord. members use the command /suggestions once you put your suggestion in it will go to the channel that you setup in your discord server\
Once your members put their suggestions it will be pending waiting for you to approved or reject their suggestion
# Utilities Branch
# Giveaway
The Giveaway Module can be accessed by first using the /assemble command and selecting the Utilities Branch. Once assembled, you will find the Giveaway Module among the available options, allowing you to manage and host giveaways efficiently within your Discord server.
To set up who can create giveaways using the Giveaway Module, you need to specify the allowed roles. This requires providing the Discord Role ID for each role you want to grant permission.
{% hint style="success" %}
To obtain a Role ID, right-click on the desired role within your Discord server. Note that you must have Developer Mode enabled in Discord to access Role IDs. To enable Developer Mode, go to User Settings > Advanced > Developer Mode, and toggle it on. Once enabled, right-clicking the role will display the option to copy its ID, which can then be used in the Giveaway Module configuration.
{% endhint %}
After configuring the allowed roles, you can create a giveaway by using the /giveaway create command. This command allows you to set various parameters to customize your giveaway, including:
* **Duration**: The length of time the giveaway will run.
* **Units of Time**: The units for the duration (e.g., seconds, minutes, hours, days).
* **Message**: The message that will be displayed for the giveaway.
* **tag\_role**: An optional role to mention in the giveaway message.
* **join\_roles**: Roles that participants must have to join the giveaway.
By specifying these parameters, you can tailor the giveaway to fit your server's needs.
After executing the /giveaway create command, a "Create a Giveaway" popup will appear. Within this interface, you can customize your giveaway by entering the following details:
* **Title**: The name or headline of the giveaway.
* **Description**: An optional message providing additional information about the giveaway.
* **Hex Color**: The hex color code that will define the visual theme of the giveaway message.
* **Number of Winners**: The total count of winners you wish to select at the end of the giveaway.
* **Prize**: A description of the prize being offered to the winners.
Filling out these fields allows you to set up your giveaway with clear and attractive details before launching it.
Once all the giveaway details are completed, the giveaway will be posted in the designated channel. Members can participate by clicking on the attached emoji, which acts as their entry into the giveaway. This interactive process makes it easy for members to join and for you to manage the giveaway efficiently.
{% hint style="info" %}
The /giveaway command offers additional functionalities to help you manage your giveaways effectively. These include:
* **/giveaway view-participants**: Allows you to see the list of members who have joined the giveaway.
* **/giveaway end**: Manually ends an active giveaway before its scheduled end time.
* **/giveaway reroll**: Selects new winners if you wish to rerun or redraw the giveaway.
These options provide greater control and flexibility in managing your giveaways within your Discord server.
{% endhint %}
# Applications
Applications provides a set of configurable options that you can display on your server, allowing members to submit applications for roles or opportunities. All available configuration settings for Applications can be found within the Utilities Branch after assembling the module. This enables you to customize the application process and showcase it to your server members effectively.\
Once you reach this screen in the application module, click on **Create Panel** to begin setting up your application for your Discord server. These applications can be customized for any purpose or role within your server, allowing you to gather information or manage applications efficiently.
After you create your application panel, the next step is to click on **Post App Embed**. This will generate and post the application embed in your server, making it accessible for members to view and submit their applications.
{% hint style="info" %}
Make sure in the Panels area you write the name of the panel as you named it in the previous step. This is case sensitive.
{% endhint %}
Once you click **Submit**, the application panel will be displayed in your Discord server, allowing members to view and submit their applications.
If you want to restrict certain roles from applying for a specific application, you can set up a **blacklisted role**. Members with this role will be prevented from applying while they retain their current roles in your server. This helps you control who can submit applications for particular roles or positions.
# Applications Ver. 2
Applications V2 is now available on your dashboard! To utilize this new feature, follow these steps:
1. Update your bot directly from the dashboard.
2. Create and manage your applications through the Applications V2 interface on the dashboard.
3. Post and configure applications using the Applications V2 Utilities Branch within the /assemble module.
This update enhances your ability to create, customize, and manage applications more efficiently within Guilda Bot.
# Custom Commands
To create a custom command, go to the **Custom Command** option in the Utilities Branch. From there, select **Add Command** in the dropdown menu. You'll need to have the **message ID** of the message you want the command to display ready beforehand. After setting up the command, you'll be able to use it in your server.
If you want to remove a custom command later on, simply select **Remove Command** from the dropdown menu.
{% hint style="warning" %}
When creating a new custom command, it’s recommended to include a special character such as "!" at the beginning of the command name. This helps prevent accidental triggers and ensures your command functions smoothly without interfering with other commands or messages in your server.
{% endhint %}
# Forms
Provides a configurable options that you can display on your server for all of your current config found below:\
Once you get to this screen here in the application module you will click on create panel to start making your application for your discord. These application can be created for anything in your discord server.
After you create your panel for your application you will click on the Post App Embed
Once your click submit it will now show that panel in your discord server
If you don't want a role to be able to apply for a application that you created you can setup a black listed role. If the person has the blacklisted role they will not be allowed to apply while they have the role that they have in your discord
# Role Requests
You can have your Discord members requests different types of roles that you have in your discord server.
The first thing that you have to do is setup the Role requests module, just follow the stpes that you see in your role request module.
Once you have all of that setup than you can make a channel called in your discord server called like Role request then your members in your discord will know that's the rigiht channel to request the roles.\
This what it looks like when you people request roles in your discord
you have two options when a member is requesting a role that you can approve or deny there request
This is what it look like whwen you denied an request
This is what it looks like when you approved the requests
# Self Role
# Tickets
Provides a configurable options that you can display on your server for all of your current config found below:
Once you get here to the ticket module it's going to give you 3 different button that it's going to give you. The first step
When you choose the set channel name format
You can choose the fromat that you want it to be set for your tickets. Make sure that you copy how it's bening show like the picture is shwoing.
Once you get everything setup for your tickets you will post all of the information here and once you click submit it will get posted to the channel that you want to go to.
# Embeds
Build and send custom Discord embeds directly from the dashboard!
### Configuration
{% stepper %}
{% step %}
### Enter Embed Builder Configuration Menu
On the **Guilda Dashboard**, go to the **Utilities Branch** and enter the **Embed Builder Menu**, then select **Configuration**
{% endstep %}
{% step %}
### Configure Guild and Role Access
Select the
{% endstep %}
{% endstepper %}
# Server Config Branch
# Temporary Voice Channels
# Invites
# Social Branch
# Twitch
# Youtube
# Available Commands
All available commands.
Here is the corrected version with your specifications applied:
* /assemble: Time to start setting up your bot.
* /avatar: View the avatar of a member.
* /ban: Ban a member from the server.
* /changelog: Create a changelog embed.
* /embed: Starts the creation process for an embed.
* /gban: Ban a member globally.
* /giveaway create: Creates a giveaway.
* /giveaway end: Ends a giveaway.
* /giveaway reroll: Rerolls a giveaway.
* /giveaway view-participants: View participants of a giveaway.
* /gunban: Unban a user globally.
* /kick: Kick a member from this server.
* /leaderboard: View the server leaderboard.
* /nickname: Update the server nickname.
* /poll: Creates a poll.
* /profile set-birthday: Sets your birthday.
* /profile view: View your profile.
* /purge: Purges messages in a channel.
* /rank: View your rank or someone else's.
* /remind: Remind me something.
* /requestrole: Request a role from the server staff.
* /review: Create a new review.
* /slowmode: Enables/disables slowmode in a channel.
* /snippet: Submit a code snippet.
* /sticky add-message: Create a ticket message.
* /sticky list-messages: List sticky messages in the server.
* /suggest: Suggest something to the server staff.
* /temprole: Assign a temporary role to a member.
* /ticket add-members: Add members to a support ticket.
* /ticket claim: Claims the support ticket.
* /ticket close: Close the support ticket.
* /ticket remove-members: Remove members from this support ticket.
* /ticket rename: Rename this support ticket.
* /ticket transfer-members: Transfer members from this support ticket to a different one.
* /timeout: Timeout a member for a specific amount of time.
* /transcript: Generate a transcript of messages in a channel.
* /unbanall: Removes all bans from the server.
* /user: View information about a member.
* /warn: Warn a member in the server.
# Guilda Terms of Service
**Effective Date:** 05/12/2025\
**Last Updated:** 05/12/2025
Welcome to GuildaBot. These Terms of Service ("Terms") govern your use of the GuildaBot Discord bot ("the Bot"), provided by \[Your Name or Company] ("we", "us", or "our"). By inviting, using, or interacting with the Bot, you agree to these Terms. If you do not agree, do not use the Bot.
### 1. Acceptance of Terms
By using GuildaBot, you:
* Confirm that you are at least 13 years old (or the minimum legal age in your jurisdiction to use Discord).
* Have the authority to accept these Terms on behalf of the server or community using the Bot.
* Agree to follow these Terms and all applicable laws, including Discord's Terms of Service and Developer Policies.
### 2. Description of the Service
GuildaBot is a multifunctional Discord bot offering features such as moderation tools, ticketing, giveaways, logging, and other community utilities. The Bot is offered "as is" and may be updated, modified, or discontinued at any time without notice.
### 3. Acceptable Use Policy
You agree not to misuse the Bot or allow others to do so. Prohibited activities include:
* Using the Bot for unlawful, abusive, or harassing purposes.
* Circumventing or attempting to disable security features.
* Reverse engineering, copying, or modifying the Bot.
* Using the Bot for spam or unsolicited advertising.
* Abusing any commands or features (e.g., giveaway rigging, message flooding, or automated abuse).
* Violating Discord’s Community Guidelines or Terms of Service.
GuildaBot is not responsible for any content users create or manage through the Bot.
### 4. Data Collection and Privacy
GuildaBot collects minimal data necessary to function effectively. This may include:
* Discord user IDs and server IDs
* Messages related to moderation logs, tickets, or automated features
* Channel and role configurations
We do not store or access private DMs or sensitive personal information. Data is kept secure and is never sold or shared, except as required by law.
See our Privacy Policy for more information.
### 5. GDPR and CCPA Compliance
We comply with the General Data Protection Regulation (GDPR) and California Consumer Privacy Act (CCPA). You have the right to:
* Access the data we store about you
* Request corrections or deletion of your data
* Withdraw consent to data collection at any time
We will respond to requests within 30 days, as required by law.
### 6. Premium Features and Subscription Terms
Some features of GuildaBot may be available only through a paid Premium subscription.
* Payments are processed through \[Stripe / Patreon / Ko-fi / Insert Provider].
* Subscriptions are billed monthly or annually and auto-renew unless canceled.
* You may cancel at any time through the platform where you subscribed.
* Refunds are not guaranteed and are handled on a case-by-case basis.
* We reserve the right to revoke access for non-payment or abuse of Premium features.
### 7. Termination and Removal
We may suspend or terminate access to GuildaBot without notice if:
* You violate these Terms or Discord’s policies
* Abuse or misuse of the Bot is detected
* Fraudulent or malicious activity is identified
You may remove GuildaBot from your server at any time by removing it from the server’s integrations.
### 8. Limitation of Liability
GuildaBot is provided "as is" without warranties of any kind. To the fullest extent permitted by law:
* We are not liable for data loss, service interruptions, moderation issues, or Discord enforcement actions.
* We are not responsible for damages, direct or indirect, resulting from the use of the Bot.
### 9. Indemnification
You agree to indemnify and hold harmless GuildaBot, its developers, and affiliates from any claims or liabilities arising from:
* Your use or misuse of the Bot
* Your violation of these Terms or applicable laws
* Any content you generate or manage using the Bot
### 10. Changes to These Terms
We may update these Terms at any time. When we do:
* The “Last Updated” date will be changed
* A notice may be posted in the GuildaBot support server or on the website
Continued use of the Bot after changes are published means you accept the new Terms.
### 11. Contact Information
If you have questions or concerns about these Terms, you may contact us at:\
**Email:** \
**Website:** \[]
