Info • AutoModGPT

# AutoModGPT Owner Guide

This guide is for **guild owners**.  
It explains how to set up AutoModGPT and what the most important `/` commands do.

## 1. Quick Setup (Recommended)

1. Invite the bot to your server.
2. Open the dashboard: `https://automodgpt.com/dashboard`
3. Open your guild.
4. Use **Setup Wizard + Community Presets**.
5. Pick your preset and click **Setup Now With Preset**.
6. Read the warning carefully: preset setup now clears all existing channels and categories before rebuilding the server layout.
7. Create an **owner password** if the guild does not have one yet, or enter the existing guild owner password when asked.
8. Review and save your settings.

## 2. Setup Through Discord Commands

If you prefer setup from Discord:

1. Run `/setup`
2. Follow the preset flow.
3. Enter or confirm the guild owner password in the modal when prompted.
4. Confirm the destructive warning first: `/setup` clears existing channels and categories before rebuilding the preset layout.
5. Confirm created channels/roles/panels.
6. Run `/helpgpt` if you want command help inside Discord.

## 3. Manual Setup (If You Build Everything Yourself)

Create these roles:

- `AutoModGPT Staff`
- `Quarantine`
- `Verified`
- `Unverified`
- `Member`

Create these channels:

- `automod-log`
- `welcome`
- `announcements`
- `tickets`
- `verify`
- `rules-accept`
- `rules`
- `🤖⎰ai-chat` (public member AI channel)

Then bind your setup with:

- `/serverlog`
- `/welcomechannel`
- `/announcementchannel`
- `/verifiedrole`
- `/unverifiedrole`
- `/memberrole`
- `/quarantinerole`
- `/ticketcategory`
- `/aichatchannel`
- `/manualsetup`

Post setup panels:

- `/verify`
- `/postrules`
- `/postrulesref`
- `/ticketpanel`

## 4. Core Commands (Owner/Admin)

### Setup + Safety
- `/setup` - runs setup flow, sets or verifies the guild owner password, clears all existing channels/categories, and rebuilds the preset layout.
- `/startup` - reposts startup panels/messages.
- `/manualsetup` - applies permission overwrites for your configured channels/roles.
- `/featuretoggle` - enable or disable major features.
- `/invitesafety` - block unsafe invite behavior.

### Channel + Role Binds
- `/welcomechannel` - set welcome channel.
- `/announcementchannel` - set announcements channel.
- `/serverlog` - set moderation log channel.
- `/giveawaychannel` - set giveaway channel.
- `/ticketcategory` - set ticket category.
- `/chatcategory` - set AI chat category.
- `/aichatchannel` - set public member AI chat channel.
- `/staffrole` - set staff role.
- `/pingrole` - set role mentioned for mod queue.
- `/verifiedrole` - set verified role.
- `/unverifiedrole` - set unverified role.
- `/memberrole` - set member role.
- `/quarantinerole` - set quarantine role.

### Verification + Rules
- `/verify` - post verification panel.
- `/ruleschannel` - bind rules info channel.
- `/rulesacceptchannel` - bind rules accept channel.
- `/postrules` - post rules accept panel.
- `/postrulesref` - post rules reference panel.

### AI Chat
- `/chatprompt` - set AI system prompt for owner AI chat.
- `/prefix` - set prefix for text commands.
- `/prefixreply` - create custom prefix replies.

### Moderation + Utility
- `/purge` - clones a channel, deletes the original, and rebinds stored channel IDs. Optional `channel` lets you target a different channel instead of the current one.
- `/clean` - bulk delete messages.
- `/logs` - read recent bot logs.
- `/ownerauth` - owner authentication for sensitive actions.
- `/ignore` - ignore user/role from specific moderation logic.

### Tickets, Giveaways, Polls
- `/ticketpanel` - post ticket panel.
- `/giveaway` - create giveaway.
- `/giveawayreroll` - reroll giveaway winner(s).
- `/poll` - create timed poll with reactions.

### Leveling
- `/levelingconfig` - configure leveling system.
- `/levelreward` - set role rewards by level.
- `/setlevel` - manually set a user level/xp.

## 5. Member Commands

- `/rank` - shows user rank card.
- `/level` - shows current level and XP.
- `/leaderboard` - shows server XP leaderboard.
- `/vote` - voting + reward flow.
- `/refer` - referral system + rewards.
- `/invite` - alias of `/refer invite`.
- `/stats` - public bot stats.
- `/serverstats` - private server stats for the current guild.

Referral rewards:
- `2` credits -> `7 days Pro`
- `5` credits -> `14 days Premium`
- `10` credits -> `30 days Premium` (`/refer action:redeem tier:premium_extended`)

## 6. Tips

- Keep your owner password private.
- Treat setup presets as destructive: they remove current channels and categories before rebuilding.
- Use the dashboard for most settings (easier and safer).
- Re-run `/startup` after major channel changes.
- Use health/security pages in dashboard to catch config mistakes.

## 7. Need Help?

- Community server: `https://discord.gg/XtrPmeQ2D6`
- Dashboard: `https://automodgpt.com/dashboard`

## 8. Billing + Legal Docs

- Architecture notes: `docs/ARCHITECTURE.md`
- PostgreSQL target schema: `db/postgres/schema.sql`
- Terms of Service: `https://automodgpt.com/terms`
- Privacy Policy: `https://automodgpt.com/privacy`
- Cookie Policy: `https://automodgpt.com/cookies`
- Refund Policy: `https://automodgpt.com/refunds`

# Codex AI Chat — Owner Ops

This file lists the **Guild Owner Codex operations** available inside the AutoModGPT AI chat channel.
Use these commands in your AI chat channel (no need to prefix with `codex`, but it also works).

## How It Works
- Commands are tier-gated and can be restricted per tier.
- These commands run in AutoModGPT AI chat channels only.
- Most changes require a `confirm` reply before execution.
- Destructive and bulk operations also require confirmation when using the explicit `codex` prefix. Read the warning, then reply `confirm` in the same channel within two minutes, or `cancel`. Confirmation is bound to the requesting user and server and is consumed once.
- Some actions (like `leave`) require the owner password modal.
- Channel purge updates references only in that server's settings. Deleting a channel also deletes its message history; a settings backup cannot restore messages.

## Moderation Actions
- `warn @user reason: <text>`
- `unwarn @user`
- `mute @user <duration> reason: <text>`
- `unmute @user`
- `strike @user reason: <text>`
- `unstrike @user`
- `tempban @user <duration> reason: <text>`
- `quarantine @user reason: <text>`
- `unquarantine @user`
- `ban @user reason: <text>`
- `unban @user`
- `softban @user reason: <text>`
- `kick @user reason: <text>`
- `timeout @user <duration> reason: <text>`
- `untimeout @user`
- `purge channel [channel-id]`
- `purge <count> [in channel-id]`
- `clear <count> [in channel-id]`
- `slowmode <seconds> [in channel-id]`
- `lock [channel-id]`
- `unlock [channel-id]`
- `lockdown`
- `unlockdown`

## Role & User Actions
- `nickname @user = "New Name"`
- `addrole @user <role-id>`
- `give @user <role-id>`
- `give members <role-id>`
- `removerole @user <role-id>`
- `ban role <role-id> reason: <text>`
- `kick role <role-id> reason: <text>`
- `remove role members <role-id>`
- `create role <name>`
- `delete role <role-id>`
- `rename role <role-id> = <name>`
- `set role color <role-id> = #RRGGBB`
- `set role mentionable <role-id> = true|false`
- `set role hoist <role-id> = true|false`
- `set role permissions <role-id> = perm1, perm2`
- `timeout role <role-id> <duration> reason: <text>`
- `untimeout role <role-id>`
- `clear nickname <user-id>`
- `reset nickname role <role-id>`
- `prune role <role-id> reason: <text>`
- `verify @user`
- `unverify @user`

## Blacklist / Whitelist / Filters
- `blacklist @user reason: <text>`
- `unblacklist @user`
- `whitelist @user reason: <text>`
- `unwhitelist @user`
- `filter <text>`
- `unfilter <text>`

## Logs & Cases
- `report @user reason: <text>`
- `appeal @user reason: <text>`
- `case <id>`
- `logs`

## Announcements / Embeds / Stickies

`announce` sends a cyan announcement embed with a timestamp. The message can contain up to 4,096 characters; longer messages are rejected without posting. Use `embed` when you want a custom title. Announcement mentions follow the server settings and appear outside the embed; they stay off unless enabled. The bot needs permission to send messages and embed links in the target channel.

- `announce content: <text>`
- `announce in <channel-id> content: <text>`
- `embed title: <text> content: <text>`
- `embed title: <text> content: <text> in <channel-id>`
- `sticky content: <text>`
- `sticky content: <text> in <channel-id>`
- `unsticky`
- `unsticky in <channel-id>`

## Threads & Channels
- `thread <name>`
- `thread <name> in <channel-id>`
- `unthread <thread-id>`
- `create category <name>`
- `create channel <name>`
- `create channel <name> in <category-id>`
- `delete channel <channel-id>`
- `rename channel <channel-id> = <name>`
- `delete category <category-id>`
- `rename category <category-id> = <name>`
- `add role <role-id>` (adds empty overwrites on all channels)
- `clone channel <channel-id> [name]`
- `move channel <channel-id> to <category-id|root>`
- `move channel <channel-id> position <number>`
- `move category <category-id> position <number>`
- `archive thread <thread-id>`
- `unarchive thread <thread-id>`
- `sync channel perms <channel-id>`

## Emojis & Stickers
- `list emojis`
- `add emoji <name> <url or attach>` (or attach an image)
- `delete emoji <emoji-id>`
- `rename emoji <emoji-id> = <name>`
- `list stickers`
- `add sticker <name> <description> <emoji> (attach file)`
- `delete sticker <sticker-id>`
- `rename sticker <sticker-id> = <name>`

## Invites
- `list invites`
- `create invite <channel-id> [maxuses N] [maxage SECONDS]`
- `delete invite <code>`
- `invite info <code>`
- `invitesafety on|off [purge]`

## Permissions
- `grant <role-or-user-id> <permission> in <channel-id>`
- `revoke <role-or-user-id> <permission> in <channel-id>`
- `remove <role-id> from <channel-id>`
- `delete <role-id> from <channel-id>`
- `permissions <channel-id>`

## Voice
- `deafen @user`
- `undeafen @user`
- `disconnect @user`
- `move @user <voice-channel-id>`
- `voice <name>`
- `voice <name> in <category-id>`
- `voicechat <name>`
- `movevoice @user <voice-channel-id>`
- `clearvoice <voice-channel-id>`

## Utilities
- `list <topic>`
  Topics: `filters`, `xp leaderboard`, `joined guilds`, `blacklist`, `whitelist`, `warnings @user`, `members @role` (or no role), `bans`, `emojis`, `stickers`
- `ping @user in <channel-id>`
- `scan <channel-id> reason: <text>`
- `dm <user-id> content: <text>`
- `send <channel-id> content: <text>`

## Owner Controls
- `set guild <dot.path> = <json>`
- `set bot <dot.path> = <json>`
- `leave [guild-id]` (owner password required)
- `set rules channel <channel-id>`
- `set rules accept channel <channel-id>`
- `set public ai chat channel <channel-id>`
- `set giveaway channel <channel-id>`

## Server Settings & Automation
- `set server name = "New Name"`
- `set server icon <url or attach>`
- `set server banner <url or attach>`
- `set server splash <url or attach>`
- `set verification level <none|low|medium|high|very_high>`
- `set notifications <all|mentions>`
- `set explicit filter <disabled|members_without_roles|all_members>`
- `set afk channel <channel-id>`
- `set afk timeout <seconds>`
- `set system channel <channel-id>`
- `set locale <locale>`
- `automod enable|disable`
- `prune <days>`
- `purge user <user-id> <count> in <channel-id>`
- `audit <count>`
- `timeout members <duration>`
- `untimeout members`

## Webhooks
- `list webhooks`
- `create webhook <name> in <channel-id>`
- `delete webhook <webhook-id>`
- `rename webhook <webhook-id> = <name>`

## Notes
- Dev-only commands (file overrides, dev join, password resets) are intentionally not listed here.
- Codex `warn` DMs the target user with an embed.
- User DM delivery still respects DM opt-out policy.
- Enterprise backup and deleted-guild recovery are managed from the website dashboard at `/guild/<id>/backup-recovery`.