Role templates

A role template stores a package of data: one or more embed definitions (titles, colors, bodies, optional images, fields, and similar) and matching reaction-role rows (role name, colour, reaction icon per role). Templates are edited in the dashboard, then executed so Antidote can create Discord roles, register embeds on your server, and attach role menus to messages.

Library → server copy

1. Open Templates library and inspect a row (view).
2. Copy to server creates a server-specific row under My templates (same name/description payload as returned by the copy API).
3. The new row can be edited, executed, or deleted independently of the library entry.

Deleting a server template removes only the saved configuration in Antidote; it does not remove Discord roles or channel messages already created by an earlier run.

Editing a server template (role-templates/edit)

The editor rebuilds one card per embed with:

• Embed name — Label for that block.
• Colour, title, description — Standard embed presentation.
• Author / footer / images / thumbnail / timestamp / fields — Optional layout pieces (same shape as the server embed editor).
• Roles under that embed — Each role: display name, hex colour, icon (emoji used later on the reaction menu).

Validation enforced in the UI before save:

• Every role row must have an icon (reaction emoji).
• Within each embed, two roles cannot share the same icon (duplicate reaction detection).

Executing a template (role-templates/execute)

• Select channel — Required. Embeds and role-menu messages are created there.
• Anchor role — Optional. New Discord roles are positioned relative to this role in the list.
• Execute — Calls the execute API; on success the UI summarizes created roles, saved embeds, and menus (exact labels depend on API response).

Execution may create many roles and posts in one go. If a role name already exists, Antidote reuses or adjusts that role so the template can still apply (see the on-screen warning before confirming).

The account running the flow needs dashboard access to the server; the bot needs Manage roles and a role above the roles it creates.

Optional: Discord template command

For administrators working in a channel, the bot exposes template <template_id> (see your server’s prefix and help). It loads the same server template payload, creates missing roles, posts embeds, and registers collectors. The numeric template_id is the identifier shown for the server template in the dashboard.

Use Execute template when you want explicit channel and anchor role choices without typing IDs by hand.

Related

• Role menus — behavior of standalone menus, groups, DMs, and rolemenu create / rolemenu clear.