> For the complete documentation index, see [llms.txt](https://docs.mantic.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mantic.dev/server-bot/modules.md).

# Modules

Install, enable, update and safely remove optional Server Bot modules.

Modules add optional features to the main bot. The available set can change by product release and licence. Common modules include:

| Module                | Adds                                                          |
| --------------------- | ------------------------------------------------------------- |
| Applications          | Application forms, panels and staff review tools              |
| Music                 | Radio stations, queues, playlists and voice controls          |
| Auto Voice Channels   | Temporary voice channels created from a lobby                 |
| Minecraft integration | Optional Minecraft server and player features                 |
| AI assistant          | AI-powered commands when configured with a supported provider |

Built-in features such as tickets, polls, suggestions, invites, levels, moderation, logging and server backups are part of the core bot or other listed modules; use **Configuration** to see what is available on this installation.

## Install an official module

1. Open **Modules → Add module** in the hosted Control Panel.
2. Review the catalog entry, version and description.
3. Choose install, then enable the module after download completes.
4. Check the Console page or host log if it fails to load.

Official downloads use signed release metadata and are checked before installation. The launcher and runtime need outbound HTTPS to `handler.mantic.dev` for official distribution.

## Upload a module

The Modules page may allow uploading a community module JAR. A module is executable Java code and runs on the same host with the bot process's permissions. Only install code from a developer you trust. Review the source and compatibility before enabling it. Keep one JAR for each module.

## Build your own module

Start with [ExampleBotModule](https://github.com/Mantic-Development/ExampleBotModule). It includes a slash command, a Discord listener and an editable YAML setting.

1. With Java 17 or newer installed, run `mvn package` in the example repository. Maven resolves `me.fullpage:serverbot-api:3.0` from `https://repo.mantic.dev/public`.
2. On a test bot, upload the JAR from `target/` in **Modules → Add module**, then enable **ExampleModule**.
3. Run `/example` in Discord to check that the module loaded.

### Add build dependencies

Server Bot supplies its API and JDA at runtime. Use Maven’s `provided` scope or Gradle’s `compileOnly` configuration so these libraries stay out of your module JAR. JDA is listed separately because the Server Bot API artifact does not declare it as a transitive dependency.

#### Maven

Add the repository and dependencies to your `pom.xml`. If it already has a `<repositories>` or `<dependencies>` block, add the entries inside the existing block.

```xml
<repositories>
    <repository>
        <id>mantic-public</id>
        <url>https://repo.mantic.dev/public</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>me.fullpage</groupId>
        <artifactId>serverbot-api</artifactId>
        <version>3.0</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>net.dv8tion</groupId>
        <artifactId>JDA</artifactId>
        <version>6.7.0</version>
        <scope>provided</scope>
    </dependency>
</dependencies>
```

#### Gradle

This snippet works in both `build.gradle` (Groovy) and `build.gradle.kts` (Kotlin) in a project that applies the Java plugin. If your project declares repositories centrally in `settings.gradle` or `settings.gradle.kts`, put the repository entries in its `dependencyResolutionManagement.repositories` block.

```kotlin
repositories {
    mavenCentral()
    maven {
        url = uri("https://repo.mantic.dev/public")
    }
}

dependencies {
    compileOnly("me.fullpage:serverbot-api:3.0")
    compileOnly("net.dv8tion:JDA:6.7.0")
}
```

## Configure and remove

Once enabled, a module's settings appear in **Configuration** and `/settings` when supported. Disable modules from the Modules page before replacing or removing their JAR. Keep `bot/features/` and the module's data with the bot; deleting a JAR does not delete its saved configuration or records.

For application workflows, see [Configuration and features](https://docs.mantic.dev/server-bot/configuration-and-features.md). Music setup is described above under the Music module.
