PaulCLI logoPaulCLI

Setup

Configure join roles and reaction-role panels.

Open /dashboard/<guildId>/autoroles. The dashboard loads non-managed roles and text channels, then talks to /api/autoroles/[guildId] for join roles and /api/autoroles/[guildId]/panels for button panels.

  1. 1

    Add roles on join

    Select a role and click Add. The API validates that the role belongs to the server and rejects duplicates for the same guild.

  2. 2

    Pick a panel channel

    Choose the text channel where the button panel should be posted. Editing an existing panel keeps it in its original channel.

  3. 3

    Write panel text

    Panel content must be 1–2000 characters. The schema default is Pick your roles below!.

  4. 4

    Add buttons

    Each panel needs 1–25 buttons. A button needs a 1–80 character label, optional emoji up to 64 characters, style, and role.

  5. 5

    Publish or save changes

    Publishing posts a Discord message with buttons. Editing PATCHes the existing Discord message in place, then replaces the stored buttons atomically.

Required bot permissions

Join roles and button toggles need Manage Roles and correct role ordering. Publishing panels needs the bot token configured on the server plus View Channel and Send Messages in the panel channel. Editing or deleting panel messages also requires access to that original channel.