# Warnings

Warn members, keep a record, and time out, kick or ban repeat offenders automatically.

Source: https://noxyrbot.com/docs/warnings

## How it works

A warning is a saved note about a member, with the reason and who gave it. Staff can read a member's warnings at any time, so a moderator on the next shift knows what happened.

Add punishment steps and Noxyr does the rest: when a member reaches that exact number of warnings, it runs the timeout, kick or ban for you.

## Set it up

1. Open Safety, then Warnings on the dashboard, or use /warn settings in Discord.
2. Pick a log channel so staff see every warning.
3. Add steps, such as a 1 hour timeout at 3 warnings and a kick at 5.
4. Check that the bot's role is above your members and that it has Timeout Members, Kick Members and Ban Members for the steps you use.

## Commands

- **/warn add member:<member> reason:<text>**: Warn a member and run any step they reach.
- **/warn list member:<member>**: See a member's warnings, with the date and who gave each one.
- **/warn remove member:<member> warning:<warning>**: Delete one warning.
- **/warn clear member:<member>**: Delete all of a member's warnings.
- **/warn settings**: Set the member DM, the log channel and the expiry. Needs Manage Server.
- **/warn step count:<number> action:<action>**: Add or change a step. Pick None to remove it. Needs Manage Server.

## Good to know

- **Who can warn**: Anyone with Timeout Members, but only members below their own top role. The server owner can warn anyone except bots. The dashboard page is for server admins.
- **Direct messages**: The member gets the reason in a DM if their DMs are open. You can switch this off. If it cannot be delivered, the warning is still saved.
- **Expiry**: Set a number of days and older warnings stop counting. They stay on record. 0 means they never expire.
- **Exact counts**: A step runs when a member reaches its number, not again after it. Deleting a warning lowers the count, so the next warning can run that step again.
- **Failed punishments**: If the bot cannot punish someone, the warning is still saved and the person who warned them is told why.

## Frequently asked questions

**How do I warn someone on Discord with Noxyr?**

Run /warn add, pick the member and write a reason. You can also warn from Safety, then Warnings on the dashboard. The warning is saved, and the member gets the reason in a DM if their DMs are open.

**Can Noxyr punish members automatically after several warnings?**

Yes. Add punishment steps on the dashboard or with /warn step. Each step runs a timeout, kick or ban when a member reaches that exact number of warnings.

**Do warnings expire?**

Only if you set an expiry in days. Expired warnings stay on record but stop counting towards punishment steps.

**Who can warn members?**

Anyone with Timeout Members can use /warn, but only on members below their own top role. Nobody can warn themselves, a bot or the server owner.

**Why did the punishment not run?**

The bot needs Timeout Members, Kick Members or Ban Members, and its role must be above the member. The warning is still saved, and whoever warned them is told what failed.
