Gate Doctor — Setup Guide
=========================

INVITE GATE DOCTOR TO YOUR SERVER
---------------------------------
Use this link to add the bot (you must have Manage Server permission):

  https://discord.com/oauth2/authorize?client_id=1495810163867914340&permissions=2550221826&integration_type=0&scope=bot+applications.commands


BEFORE YOU START
----------------
Make sure these roles and channels exist in your server before running the wizard.
Gate Doctor works with any names — nothing needs to match exactly.

Roles
  - Member      — assigned after approval
  - Pending     — assigned while awaiting approval
  - Approver(s) — one or more staff roles that can approve or deny requests

Channels
  - request-access — visible to new members, where the entry button lives
  - welcome        — where approved members receive their welcome message
  - intake-log     — private staff channel where approval requests appear
  - server-log     — typically admin-only, where all actions are recorded


STEP 1 — ENABLE DEVELOPER MODE
-------------------------------
You'll need this to copy Role and Channel IDs if the wizard doesn't show what you need.

  1. Open Discord Settings
  2. Go to Advanced
  3. Toggle Developer Mode on


STEP 2 — RUN THE SETUP WIZARD
------------------------------
In your server run: /gatedoctor config wizard

This walks you through 8 steps — alliance name, roles, and channels.
Each step uses a dropdown selector.

Don't see the role or channel you need in the list?
That's okay. Pick any option to continue, then use the individual update
commands after the wizard to correct it with the exact ID. See Step 3.


STEP 3 — COPY A ROLE OR CHANNEL ID
------------------------------------
To copy a Role ID
  1. Go to Server Settings > Roles
  2. Find the role and click the ... menu
  3. Click Copy Role ID

To copy a Channel ID
  1. Right-click the channel in the sidebar
  2. Click Copy Channel ID

Then run:
  /gatedoctor config set-role     — to update a role
  /gatedoctor config set-channel  — to update a channel

You'll be prompted to paste the ID.


STEP 4 — VERIFY PERMISSIONS
----------------------------
Run: /gatedoctor verify

Checks role hierarchy, Manage Roles, Kick Members, Manage Nicknames,
and per-channel access. Fix anything flagged before continuing.

  ! Role hierarchy is the most common issue.
    Go to Server Settings > Roles and drag the Gate Doctor bot role
    above your Member and Pending roles. Discord silently fails role
    assignment if the bot role is too low.


STEP 5 — POST THE WELCOME EMBED
--------------------------------
Run: /gatedoctor setup

Posts the entry button to your request-access channel.
Re-run any time to update the banner or repost the embed.


YOU'RE LIVE
-----------
  1. New member clicks Request Entry and submits their in-game name
  2. intake-log gets pinged with their profile and two buttons
  3. An Approver taps Grant Access or Turn Away
  4. Gate Doctor handles roles, nickname, welcome message, and audit log


COMMANDS
--------
Setup — run in this order on a fresh server

  /gatedoctor config wizard    Run the 8-step setup wizard
  /gatedoctor verify           Check permissions and role hierarchy
  /gatedoctor setup            Post the welcome embed
  /gatedoctor status           Check trial days remaining or license status

Configuration — update individual settings

  /gatedoctor activate             Activate a license key to unlock Gate Doctor
  /gatedoctor config view          View current configuration
  /gatedoctor config reset         Reset an in-progress wizard session
  /gatedoctor config set-channel   Update a single channel
  /gatedoctor config set-role      Update a single role or approver list
  /gatedoctor config set-alliance  Update the alliance name
  /gatedoctor config auto-approve  Toggle automatic entry approval on or off


---
Gate Doctor — Not affiliated with Discord Inc.