Setup Guide — Ammonite

Adding Ammonite to Your Server

1Invite the Bot

Use the official invite link to add Ammonite. You must have the Manage Server permission in the target server.

2Grant the Right Permissions

When invited, Ammonite will request the permissions it needs. For full functionality, grant Administrator, or at minimum:

Manage Roles, Manage Channels, Manage Messages
Ban Members, Kick Members, Moderate Members
View Audit Log, Read Message History
Send Messages, Embed Links, Attach Files
Use External Emojis, Add Reactions

See the Permissions page for details on the internal node permission system.

3Run the Auto-Config Wizard

Once the bot is in your server, run /autoconfig to launch the setup wizard. It will walk you through everything automatically.

Using Commands

Ammonite supports both slash commands (recommended) and prefix commands.

Slash Commands (Recommended)

Type / in any channel to see all available slash commands. All bot functions are accessible this way.

Prefix Commands

You can also use prefix commands by typing the server's configured prefix (default: !) followed by a command name. For example:

!help — Open the help menu
!ping — Check bot latency
!balance — Check your economy balance
!avatar — View your avatar
!autoproxy — Toggle autoproxy
!globalchat list — List your global chat channels

Prefix commands silently ignore unknown commands — no error messages shown. Configure the prefix with /prefix slash command.

Use px; to access proxy-related commands (e.g. px; list, px; autoproxy).

First Steps After Setup

Auto-Config Wizard

The fastest way to configure your server is the auto-config wizard. Run /autoconfig and it will walk you through setting up:

Moderation log channel
Message log channel
Join/leave log channel
Suspicious account notifications
Feature toggles (economy, leveling, etc.)

Manual Configuration

Alternatively, configure individual features with these commands:

/settings — general server settings (includes economy, leveling, logging, muted role, log channel, and announcement channel)
/logging — configure log channels
/levels enable — enable the leveling system
/points enable — enable the economy system
/automod config — configure auto-moderation
/welcome — set up welcome messages
/permissions — configure permissions

Announcement Channels

Server admins can set an announcement channel via the /settings panel (📢 Announce Ch button). When set, the bot owner can broadcast announcements to all configured channels using the /announce command.

Setting Up Permissions

By default, only basic utility commands are available to all users. To grant moderation access to your staff:

# Give moderators all moderation permissions
/permissions role-set @Moderator mod.* true

# Give admins full config access
/permissions role-set @Admin admin.* true

# Enable economy for everyone
/permissions everyone-set economy.* true

See the Permissions page for the full node reference.