> For the complete documentation index, see [llms.txt](https://docs.cozycrafters.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cozycrafters.net/plugin-docs/litebans-punishments.md).

# LiteBans (Punishments)

## LiteBans Staff Guide

This guide is for Cozy Crafters staff using LiteBans moderation commands.

Use it as a quick command reference during normal moderation. Follow Cozy Crafters staff policy for when to warn, mute, kick, ban, or escalate a case.

### Staff Workflow

1. Check the player first when possible.
2. Choose the least severe action that fits the situation.
3. Include a clear reason.
4. Use a duration for temporary punishments.
5. Use silent mode only when staff need to avoid public attention.
6. Review history before escalating repeat behavior.
7. Remove or adjust punishments if they were made in error.

### Basic Command Format

```
/ban <user> [flags] [duration] [server:*] [template] [reason]
```

LiteBans accepts several target formats:

<table><thead><tr><th width="208.046875">Target Type</th><th>Example</th></tr></thead><tbody><tr><td>Player name</td><td><code>PlayerName</code></td></tr><tr><td>UUID</td><td><code>00000000-0000-0000-0000-000000000000</code></td></tr><tr><td>IP address</td><td><code>192.168.1.10</code></td></tr><tr><td>Wildcard IP</td><td><code>192.168.1.*</code></td></tr><tr><td>Punishment ID</td><td><code>1234</code></td></tr></tbody></table>

Punishment IDs can be used with commands like `/unban`, `/unmute`, `/unwarn`, `/checkban`, `/checkmute`, and `/checkwarn`.

### Common Staff Commands

| Command                                  | Use                                                     |
| ---------------------------------------- | ------------------------------------------------------- |
| `/warn <player> [reason]`                | Warn a player.                                          |
| `/mute <player> [duration] [reason]`     | Stop a player from chatting or using muted commands.    |
| `/tempmute <player> <duration> [reason]` | Temporarily mute a player. Duration is required.        |
| `/kick <player> [reason]`                | Remove a player from the server without banning them.   |
| `/ban <player> [duration] [reason]`      | Ban a player from joining.                              |
| `/tempban <player> <duration> [reason]`  | Temporarily ban a player. Duration is required.         |
| `/ipban <player> [duration] [reason]`    | Ban a player by account and IP address. Use carefully.  |
| `/ipmute <player> [duration] [reason]`   | Mute a player by account and IP address. Use carefully. |
| `/unban <player or punishment ID>`       | Remove an active ban.                                   |
| `/unmute <player or punishment ID>`      | Remove an active mute.                                  |
| `/unwarn <player or punishment ID>`      | Remove an active warning.                               |

### Check Before Acting

<table><thead><tr><th width="286.71875">Command</th><th>Use</th></tr></thead><tbody><tr><td><code>/history &#x3C;player> [type]</code></td><td>View a player's punishment history. Alias: <code>/hist</code>.</td></tr><tr><td><code>/warnings [player]</code></td><td>View active warnings for a player, or for yourself if no player is given.</td></tr><tr><td><code>/checkban &#x3C;player></code></td><td>Check whether a player is banned and view active ban details.</td></tr><tr><td><code>/checkmute &#x3C;player></code></td><td>Check whether a player is muted and view active mute details.</td></tr><tr><td><code>/checkwarn &#x3C;player></code></td><td>Check whether a player has active warnings.</td></tr><tr><td><code>/staffhistory &#x3C;staff> [type]</code></td><td>View punishments issued by a staff member. Alias: <code>/staffhist</code>.</td></tr><tr><td><code>/banlist [page]</code></td><td>View active bans.</td></tr><tr><td><code>/mutelist [page]</code></td><td>View active mutes.</td></tr><tr><td><code>/warnlist [page]</code></td><td>View active warnings.</td></tr></tbody></table>

### Account and IP Review

Use these commands when investigating alternate accounts, ban evasion, or suspicious account links.

<table><thead><tr><th width="280.890625">Command</th><th>Use</th></tr></thead><tbody><tr><td><code>/dupeip &#x3C;player or IP></code></td><td>Show associated accounts for a player or IP. Aliases: <code>/alts</code>, <code>/checkalts</code>.</td></tr><tr><td><code>/ipreport</code></td><td>Show associated accounts for online players.</td></tr><tr><td><code>/iphistory &#x3C;player or IP></code></td><td>Show associated accounts and IP addresses. LiteBans documents this as console-only by default.</td></tr><tr><td><code>/geoip &#x3C;player or IP></code></td><td>Show a user's country.</td></tr><tr><td><code>/lastuuid &#x3C;player></code></td><td>Show a user's UUID.</td></tr><tr><td><code>/namehistory &#x3C;player></code></td><td>Show previous usernames.</td></tr></tbody></table>

### Useful Flags

Flags are added inside the command after the player name.

<table><thead><tr><th width="180.77734375">Flag</th><th>Use</th></tr></thead><tbody><tr><td><code>-s</code></td><td>Silent punishment. Suppresses the normal broadcast.</td></tr><tr><td><code>-S</code></td><td>Extra silent punishment. Only console sees the broadcast.</td></tr><tr><td><code>-p</code></td><td>Public punishment. Useful if silent punishments are enabled by default.</td></tr><tr><td><code>-g</code></td><td>Global punishment shortcut for <code>server:global</code>.</td></tr><tr><td><code>-I</code></td><td>Make a ban, mute, or warning IP-based.</td></tr><tr><td><code>-m</code> or <code>--modify</code></td><td>Modify an existing punishment instead of creating a new one.</td></tr><tr><td><code>-d</code> or <code>--delete</code></td><td>Delete a specific entry and revert template progress.</td></tr><tr><td><code>--confirm</code></td><td>Confirm commands that require extra confirmation.</td></tr><tr><td><code>--</code></td><td>Treat anything after this as normal text instead of flags. Useful when the reason starts with a dash.</td></tr></tbody></table>

### Durations

LiteBans supports whole numbers and decimals.

<table><thead><tr><th width="144.15234375">Unit</th><th width="192.046875">Short Form</th><th>Example</th></tr></thead><tbody><tr><td>Seconds</td><td><code>s</code></td><td><code>30s</code></td></tr><tr><td>Minutes</td><td><code>m</code></td><td><code>15m</code></td></tr><tr><td>Hours</td><td><code>h</code></td><td><code>2h</code></td></tr><tr><td>Days</td><td><code>d</code></td><td><code>7d</code></td></tr><tr><td>Weeks</td><td><code>w</code></td><td><code>2w</code></td></tr><tr><td>Months</td><td><code>mo</code></td><td><code>1mo</code></td></tr><tr><td>Years</td><td><code>y</code></td><td><code>1y</code></td></tr><tr><td>Permanent</td><td><code>duration:permanent</code></td><td><code>duration:permanent</code></td></tr></tbody></table>

Examples:

```
/tempmute PlayerName 30m Spamming chat
/tempban PlayerName 7d Griefing
/ban PlayerName duration:permanent Severe rule violation
```

### CozyCrafters Examples

Use clear, plain reasons. Avoid vague reasons like `bad`, `stop`, or `rules`.

```
/warn PlayerName Please keep chat respectful
/tempmute PlayerName 15m Continued chat spam after warning
/kick PlayerName Please relog and stop bypassing chat filter
/tempban PlayerName 3d Griefing another player's build
/history PlayerName
/checkban PlayerName
/unmute PlayerName
```

Silent example:

```
/tempban PlayerName -s 7d Suspected ban evasion under staff review
```

Global example:

```
/ban PlayerName -g duration:permanent Chargeback fraud
```

### Staff Safety Notes

* Always include a reason so other staff can understand the action later.
* Use `/history` before increasing punishment severity.
* Use IP-based commands only when account/IP evidence supports it.
* Use `/staffrollback` only for correcting staff-issued punishments in bulk.
* Use `/litebans reset-database` only from console and only with owner-level approval. It can remove punishment data.
* If a command affects all linked servers, treat it as a network-level action.

### Admin and Maintenance Commands

These are not normal moderation commands. Reserve them for trusted admins.

<table><thead><tr><th width="305.65234375">Command</th><th>Use</th></tr></thead><tbody><tr><td><code>/lockdown [server:local] [end]</code></td><td>Toggle lockdown. Players need the LiteBans lockdown bypass permission to join during lockdown.</td></tr><tr><td><code>/prunehistory &#x3C;user> [duration]</code></td><td>Remove inactive punishments from a player's history.</td></tr><tr><td><code>/staffrollback &#x3C;user> [duration]</code></td><td>Roll back punishments issued by a staff member. Console can be targeted as <code>[CONSOLE]</code>.</td></tr><tr><td><code>/litebans reload</code></td><td>Reload LiteBans config, messages, templates, webhooks, and database connection.</td></tr><tr><td><code>/litebans info</code></td><td>Show database pool information.</td></tr><tr><td><code>/litebans servers</code></td><td>Show servers connected to the same LiteBans database.</td></tr><tr><td><code>/litebans reveal &#x3C;ID></code></td><td>Convert a randomized punishment ID into a regular punishment ID.</td></tr><tr><td><code>/litebans broadcast &#x3C;message></code></td><td>Send a LiteBans broadcast to users with the related LiteBans notify permission.</td></tr><tr><td><code>/litebans timezone [timezone]</code></td><td>View or set LiteBans timezone behavior.</td></tr><tr><td><code>/litebans reset-database [server:*] [mode:delete] [exclude:type]</code></td><td>Clear punishment data. Requires confirmation and can only be run by console.</td></tr><tr><td><code>/litebans reset-templates</code></td><td>Clear templates from existing punishments.</td></tr><tr><td><code>/litebans add-login &#x3C;name> &#x3C;UUID> &#x3C;IP></code></td><td>Add login records directly.</td></tr><tr><td><code>/litebans add-login &#x3C;user1>[,user2,user3,...]</code></td><td>Add login records for existing users.</td></tr><tr><td><code>/litebans accept</code></td><td>Accept the automatic-ban disclaimer after reading console output.</td></tr><tr><td><code>/litebans license</code></td><td>Show license information.</td></tr><tr><td><code>/litebans upgrade</code></td><td>Force a complete database upgrade.</td></tr></tbody></table>

### Other Aliases

<table><thead><tr><th width="347.03125">Command</th><th>Aliases</th></tr></thead><tbody><tr><td><code>/tempipban</code></td><td><code>/tempbanip</code></td></tr><tr><td><code>/tempipmute</code></td><td><code>/tempmuteip</code></td></tr><tr><td><code>/ipban</code></td><td><code>/banip</code>, <code>/ban-ip</code></td></tr><tr><td><code>/ipmute</code></td><td><code>/muteip</code></td></tr><tr><td><code>/dupeip</code></td><td><code>/alts</code>, <code>/checkalts</code></td></tr><tr><td><code>/history</code></td><td><code>/hist</code></td></tr><tr><td><code>/staffhistory</code></td><td><code>/staffhist</code></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cozycrafters.net/plugin-docs/litebans-punishments.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.