> For the complete documentation index, see [llms.txt](https://docs.rainmad.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rainmad.com/resources/watch-admin-menu/features/mutes-community-service-whitelist-and-appeals.md).

# Mutes community service whitelist and appeals

Mute and community service are two more kinds of the [punishment dialog](https://docs.rainmad.com/resources/watch-admin-menu/features/punishments). The rest live on the **Moderation** tab of the menu and the Moderation pages of the web panel (Appeals, Mutes, Community service, Whitelist, Blacklist).

## Mute

Pick **Mute** in the punishment dialog, then what to mute and for how long.

| What           | How it works                                                                                                                  |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| Chat           | Chat messages are dropped before anyone sees them. The player is told how long is left.                                       |
| Voice          | The server's voice mute, the same one pma-voice's `/muteply` uses. Offered while pma-voice runs (or with `voice = 'mumble'`). |
| Chat and voice | Both.                                                                                                                         |

* A mute runs on the clock, also while the player is offline, and is put back on every join.
* It ends by itself, or early with **Unmute** (Mutes list, the player's Moderation tab, or the web player card).
* A mute placed by a higher rank can only be lifted by that rank or above.
* Chat mutes need the standard `chat` resource, or one that still fires `chatMessage`. Commands from other scripts (`/ooc`, `/me`, a phone) are not chat messages: those scripts can ask `exports.rm_watch:isMuted(source, 'chat')` and refuse them. See [Exports and events](https://docs.rainmad.com/resources/watch-admin-menu/reference/exports-and-events).

```lua
cfg.mute = {
    maxMinutes = 43200,  -- longest mute, 30 days
    voice = 'auto',      -- 'auto' (pma-voice when it runs), 'mumble', 'off'
}
```

## Community service

Pick **Service** in the punishment dialog, a number of tasks and a zone.

* The player is taken to the zone. A marker and a map route show the next spot. At the spot they press **E** and do the task (sweeping, for example) for its length. Each spot done counts one task.
* A task only counts when the player stays at the spot for its whole length.
* Leaving the zone puts them back and adds `escapePenalty` tasks. Weapons are off while serving (`disableWeapons`).
* It survives a relog and a restart. When the last task is done they go to the zone's `release` point. Staff can end it early.
* A jailed player cannot get community service until released.

```lua
cfg.commserv = {
    maxTasks = 100,
    escapePenalty = 2,       -- tasks added each time they leave the zone; 0 = none
    disableWeapons = true,
    zones = {
        {
            label = 'Legion Square',
            center = vector3(195.2, -933.8, 30.7),
            radius = 45.0,
            spots = { vector3(181.9, -950.4, 30.1), vector3(213.6, -941.9, 30.7) },
            tasks = { 'sweep', 'garden' },   -- leave out for every task type
            release = vector4(428.2, -984.6, 30.7, 90.0),
        },
    },
    taskTypes = {
        sweep = { label = 'Sweep the ground', scenario = 'WORLD_HUMAN_JANITOR', seconds = 10 },
        garden = { label = 'Tend the plants', scenario = 'WORLD_HUMAN_GARDENER_PLANT', seconds = 12 },
        clean = { label = 'Clean up', scenario = 'WORLD_HUMAN_MAID_CLEAN', seconds = 8 },
    },
}
```

{% hint style="warning" %}
The default spots are placed by hand and are close, not exact. Walk the zone once after installing and move any spot that sits in a wall or a road.
{% endhint %}

Presets go in `cfg.admin.punish.mute` (with `duration`) and `cfg.admin.punish.commserv` (with `tasks`), see [Punishments](https://docs.rainmad.com/resources/watch-admin-menu/features/punishments#reason-presets).

## Whitelist

Checked when a player connects, after the ban check and before the queue. Staff always get in.

| Mode    | Who can join                                                                                                                    |
| ------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Off     | Anyone not banned or blacklisted.                                                                                               |
| On      | Identifiers on the list.                                                                                                        |
| Discord | The list, plus anyone holding one of `cfg.whitelist.discordRoles` in `cfg.admin.discord.guild`. Needs `rm_watch_discord_token`. |

* Add a license (`license:...`) or a Discord account (`discord:...` or the bare id), in the menu or on the web panel.
* **Tried to join** lists the players the whitelist turned away, with **Let them in**.
* Changing the mode is owner only. The mode picked in the menu or on the web is stored and wins over `cfg.lua`. Nobody online is kicked when you switch it on.
* A refused player reads your message, the apply link when set, and their own license so they can send it to you.

```lua
cfg.whitelist = {
    mode = 'off',          -- 'off' | 'on' | 'discord'
    discordRoles = {},     -- role ids that let a player in (mode 'discord')
    message = '',          -- '' = the default text
    applyUrl = '',         -- where they can apply
}
```

## Blacklist

Identifiers and hardware tokens that are always refused, whether the server ever saw them or not. Separate from bans: no expiry, no record, no appeal. Admin and up.

* Add one identifier or token, or tick **a player the server knows** to add every identifier and token they ever connected with.
* Anyone online under an added value is dropped at once.

## Ban appeals

Players appeal on your server's own page on fivemad.com. The ban screen carries the link (with the ban id filled in) and the player's license. Needs `rm_watch_key`.

1. The player opens the page, types the ban id and their license or logs in with Discord, and writes the appeal.
2. Your server checks it: the ban must exist, be active and carry that license or Discord account. An appeal that does not match never reaches staff.
3. Staff get a notice in game and a line in the `bans` webhook, and the appeal shows on the **Appeals** page of the web panel.
4. Staff **accept** (the ban is lifted, which needs the right to unban), **deny** with a reason, or **ask a question**. The player sees the answer on the same page and can reply.

One open appeal per ban. After a denial a new one has to wait seven days. Every decision is in the staff log.

```lua
cfg.appeals = {
    enabled = true,
    url = '',            -- '' = your page on fivemad.com
    showLicense = true,  -- print the license under the link on the ban screen
}
```

## Offline warning

On the profile of someone who is not on the server there is a **Warn while offline** box. The warning goes on their record; it does not pop up on their screen. The web panel has the same on its offline player card.

## Permissions

All in the **Moderation** category.

| Action                                           | Default   | What it is                                                  |
| ------------------------------------------------ | --------- | ----------------------------------------------------------- |
| `mute`, `unmute`, `mutes`                        | moderator | Mute, lift a mute, read the list                            |
| `commserv`, `commserv:end`, `commservs`          | moderator | Give, end and list community service                        |
| `mod:status`                                     | moderator | A player's mute and service on the profile and the web card |
| `whitelist`, `whitelist:add`, `whitelist:remove` | moderator | Read and edit the whitelist                                 |
| `whitelist:mode`                                 | owner     | Switch the whitelist mode                                   |
| `blacklist`, `blacklist:add`, `blacklist:remove` | admin     | Read and edit the blacklist                                 |
| `appeal:decide`                                  | moderator | Handle appeals (accepting also needs `unban`)               |

{% hint style="info" %}
**RedM:** community service runs on Valentine main street with RDR2 tasks (sweeping, raking, weeding, pitching hay). Those spots are approximate: check them in game before you use them. Voice mutes need pma-voice.
{% endhint %}
