Docs & Help

Step-by-step guides for Tickets, Gavel, and Host.

Tickets — Support Bot

Tickets is your dedicated support desk for Discord. It handles private support channels, staff workflows, and logs so you can focus on helping your community.

1. Inviting Tickets to your server

Use the invite link provided after purchase or from our Discord support server.
Select the server you want to add Tickets to.
Grant the requested permissions (Manage Channels, Manage Roles, View Channels, Send Messages, Read Message History).
Click Authorize and complete any verification.

Once added, make sure Tickets has permission to see the category where you want tickets to be created.

2. Basic configuration

Run the base setup command in a staff channel:

/tickets setup

You’ll be guided through:

Support role — who should see and reply to tickets.
Ticket category — where ticket channels are created.
Transcript channel (optional) — where closed ticket logs are sent.

3. Creating ticket panels

Panels are the messages your users click to open a ticket (buttons, dropdowns, or emoji).

Go to the channel where you want the panel.
Run:
```
/tickets panel create
```
Choose a panel style (buttons or select menu).
Configure:
- Title — what the panel is called.
- Description — short explanation for users.
- Category — which category new tickets should use.
- Button label & emoji — e.g. “Create Ticket” with 🎫.

Tickets will send a panel embed with your buttons. When a user clicks, a private channel is created that only staff and the user can see.

4. Ticket workflow

Inside a ticket channel you’ll typically use:

/ticket claim — mark the ticket as taken by a staff member.
/ticket add <user> — add additional members to the ticket.
/ticket remove <user> — remove a member from the ticket.
/ticket rename <name> — rename the ticket channel.
/ticket close — close the ticket and optionally send a transcript.

5. Categories & departments

Use categories to route different types of requests:

/tickets category create — add a new category (e.g. “Billing”, “Appeals”, “Partnerships”).
/tickets category edit — change staff role, default transcripts, or naming scheme.
/tickets category delete — remove a category you no longer use.

Each category can have its own staff role and panel, so tickets always go to the right team.

6. Logging & transcripts

When a ticket is closed, Tickets can generate a transcript and send it to a log channel.

Set a global log channel with /tickets logs set.
Enable or disable transcripts per category with /tickets category edit.
Staff can re-open or re-send a transcript if needed.

7. Permissions checklist

If something isn’t working, check:

Tickets has Manage Channels and View Channels.
Tickets can see the ticket category and the panel channel.
Your staff role is selected in the Tickets configuration.

8. Billing, upgrades, and support

Billing is handled through Stripe. Subscriptions renew monthly and you can cancel anytime via your Stripe customer portal (link in your receipt).

For help, join our Discord support server or email kojinstudios@gmail.com.

Gavel — Moderation Bot

Gavel is your moderation backbone: warnings, mutes, bans, cases, and detailed logging for serious servers.

1. Inviting Gavel

Use the invite link provided after purchase or in our Discord support server, then:

Select your server and grant the requested permissions (Manage Members, Manage Roles, Ban Members, Kick Members, View Channels, Send Messages).
Place Gavel’s role above the roles you want it to manage.

2. Core moderation commands

/warn <user> <reason> — create a warning and case entry.
/mute <user> [duration] [reason] — temporary or permanent text mute.
/kick <user> [reason] — remove a member from the server.
/ban <user> [reason] — ban a member and log the case.
/cases <user> — view a user’s full moderation history.

3. Auto-moderation

Configure your automod rules to match your community:

/gavel automod enable — turn automod on.
/gavel automod spam — configure raid/spam thresholds.
/gavel automod filters — word filters, links, media, and more.
/gavel automod logs — pick which channel to use for automod logs.

4. Case management & appeals

/case view <id> — show a single case with full context.
/case edit <id> — update the reason or notes.
/case delete <id> — remove a case (owner-only, for mistakes).
Connect Gavel to your appeals flow by sending case links in a private appeals channel so staff can review decisions quickly.

5. Logging & audit trail

Set a dedicated moderation log channel:

/gavel logs set

Gavel can log:

Warnings, mutes, kicks, bans, and unbans.
Edited and deleted messages (with configurable sensitivity).
Join/leave events and nickname changes.

6. Customization & branding

/gavel config embeds — choose colors and footer style.
/gavel config locale — select language or tone of messages.
/gavel config dm — decide when users get DM notifications.

Host — Engagement Bot

Host powers events, reaction roles, utilities, and small quality-of-life features that make your server feel alive.

1. Inviting Host

Invite Host with the link you receive after purchase or from our Discord support server, then grant the default “bot” permissions (Manage Roles for reaction roles, View Channels, Send Messages, Read Message History, Use Application Commands).

2. Reaction roles

Go to the channel where you want the reaction roles message.
Run:
```
/host reactionroles create
```
Add each role/emoji pair (for example: 🎮 → @Gamer, 📢 → @Announcements).
Save and let Host post the message.

Members can now click to self-assign or remove roles.

3. Events

/host event create — create an event with title, date, and description.
/host event announce — send an embed with RSVP buttons.
/host event list — view active upcoming events.
/host event cancel — cancel or archive an event.

4. Utility commands

/weather <location> — quick weather lookups.
/server — basic server stats.
/avatar <user> — show a user’s avatar.

5. XP & leveling

Host can optionally track message activity and reward members with levels and roles.

/host levels enable — turn leveling on.
/host levels rewards — configure role rewards per level.
/rank — show a member’s level card.