Docs

Overview

Jailer System Detention (JSD) is a Discord moderation bot for temporary member detention. Moderators jail a member for a set time (or forever). Roles are snapshotted and stripped. When time is up, or staff releases them, roles restore and the case stays in the audit log.

Jailed members can open a private appeal. A background sweeper auto-releases expired cases even if the bot restarted mid-sentence.

How it works

01
Detain
A jail moderator runs /jail with duration, reason, and category. JSD DMs the member and posts to the mod log.
02
Contain
The member only sees #jsd-jail-chat (and their appeal channel if opened). Other channels deny the jail role.
03
Appeal (optional)
They run /appeal. Staff get Release, Close (Deny), and Ban controls in a private channel.
04
Release
The timer expires (sweeper) or a moderator runs /release. Roles restore. The case closes as expired, released, or overturned.

Invite the bot

Use the invite button on this site (requires your Discord application client ID), or generate an invite in the Discord Developer Portal.

Invite with Administrator so the bot can apply roles and channel restrictions without extra permission wizardry.

Administrator (grants everything, including Manage Roles, Manage Channels, Ban Members)

After inviting, drag the bot role above the jail role and above any roles it must strip. Discord will not allow the bot to manage roles at or above its highest role.

Invite bot

Server setup

The bot does nothing useful until an administrator runs /setup. The wizard walks through:

Jail role - pick one or create Jailed
Jail mod role - who can jail, release, view cases, and act on appeals (admins always can)
Channel structure - build JSD categories or point at your own channels
Timezone - IANA name for timestamps

Use Quick setup on the first screen to build everything in one press. The summary screen edits the jail DM template with tokens {user}, {guild}, {reason}, {duration}, and {case_id}.

Channel structure

JSD Info      #jsd-info        public, read-only - how detention works
              #jsd-mod-log     mods only - audit log
JSD Appeal    (private appeal channels, one per case)
JSD Jail      #jsd-jail-chat   jailed members + mods only

The jail role is denied view and send everywhere else, so detained members only reach jail chat and their appeal channel. Re-running structure only creates what is missing.

Commands

Command	Who	What it does
/setup	Admins	Wizard for roles, channels, timezone, and DM template
/jail	Jail mods	Detain a member with duration, reason, and category
/release	Jail mods	Release by case ID or user
/case	Jail mods	Show the full case record
/jsd-case	Jail mods	Look up a case by ID or member
/jsd-config	Jail mods	Read-only summary of the current setup and escalation
/jsd-notes	Jail mods	Append a note to any case
/jsd-history	Jail mods	Full jail + infraction history for a member
/warn	Jail mods	Formal warning that feeds the auto-jail threshold
/mute	Jail mods	Timeout a member (also feeds the threshold)
/report	Anyone	File a report so staff can review it
/jsd-categories	Admins	Add, remove, and list custom offence categories
/my-jsd-case	Anyone	Check your own active case and appeal status
/appeal	Jailed member	Open a private appeal channel
/jsd-help	Anyone	In-Discord help browser
/jsd-support	Anyone	Get an invite to the official support server
/rework-jsd	Admins	Wipe JSD structure and config (keeps case history)

Durations

/jail takes an amount plus a unit: seconds, minutes, hours, days, weeks, months, years, or Forever for an indefinite jail with no automatic release (the amount is ignored for Forever).

The sweeper checks expired cases on an interval (default 30 seconds) and once at startup. Releases use a conditional database update so the sweeper and /release never double-release the same case.

Escalation

JSD offers a staff-facing ladder below full detention. /warn and /mute add points to a member's record within a rolling window (default 30 days). When the score reaches the configured auto-jail threshold, the member is jailed automatically for 24 hours with category Other.

Members can file /reports directly. Each one lands in the mod log and in /jsd-history for staff review, but member reports never trigger an auto-jail on their own — only staff-issued warns and mutes do.

Admins set the threshold and window on the web dashboard (Server → Settings → Escalation). Staff see the current score next to every warn or mute, and a mod-log embed records when an auto-jail fires.

Appeals

While jailed, a member runs /appeal. JSD opens a private channel under the appeal category. Staff can:

Release - free the member and restore roles
Close (Deny) - keep them jailed and close the appeal
Ban - ban them from the server

On Pro, the same queue is available from the web dashboard for that server.

Web dashboard

Members - jail status, countdown, history, and appeal state
Owners and mods - setup health and config; Pro adds categories, live jails, appeal queue, and analytics

The site and bot share the same Turso database. File uploads (Cloudflare R2) are planned for a later version.

Free and Pro

Free includes the full Discord jail loop and basic member web status. Pro unlocks custom categories, web moderation, and analytics — billing is still work in progress. Extra servers need their own Pro seat.

Full pricing

Permissions and role tips

The bot role must sit above the jail role and any roles it strips
Managed roles (Nitro boost, integrations) may not be strippable. JSD warns and does not fail the jail
Roles deleted while a member is jailed are skipped on release
Failed DMs never abort a jail or release. They are noted in the mod log

Starting over

/rework-jsd (admins) deletes JSD-created categories, channels, and roles, and clears guild config so /setup can run fresh. Channels and roles you created yourself are only unlinked. Case history is kept.

Troubleshooting

Commands do not appear: Global commands can take up to an hour. For testing, set a dev guild ID so commands register instantly. Restart the bot after config changes.
Cannot strip or restore roles: Raise the bot role above the jail role and target roles. Check that Manage Roles is granted.
Member still sees channels while jailed: Re-run channel structure in /setup. Confirm jail role overwrites on non-JSD channels.
Auto-release did not fire: Check that the bot is online. The sweeper runs on an interval and at startup. Forever jails never auto-release.
Bot left the server: The guild may be on the operator blacklist (JSD Control). Contact support if that was unexpected.

In Discord, run /jsd-help for the interactive help browser.

Support

Stuck, found a bug, or have a feature request? Run /jsd-support in Discord for an invite, or join directly below.

Join the JSD Discord