WarnSystem

WarnSystem lets ARK staff warn players, keep a full record per player, and auto mute repeat trouble makers, so your server stays calm without extra tools.

WarnSystem is a staff moderation tool for ARK Survival Ascended servers. It tracks every warning per player, mutes on its own once a player hits your limit, and can raise the mute time for repeat offenders. The mute is built in, so you need no extra plugin, and every action can post to a staff Discord channel.

Supported Features

• Warning record: I keep a full history of every warning for each player, with the reason, who gave it, and the date.
• Auto mute: once a player hits your warning limit, I mute them on my own. Set the limit with AutoMuteAt.
• Escalating mute: with EscalateMute on, each warning past the limit mutes for longer, up to a cap you set.
• Built in mute: I watch chat and drop a muted player's messages myself, so you do not need any other plugin for the mute to work.
• Manual mute and unmute: staff can /mute a player for any number of minutes and /unmute them any time.
• Warnings that expire: set ExpireDays so old warnings stop counting toward the auto mute. They still show in the history.
• Target online or offline: name a player who is online, or paste their EOS id to warn someone who is offline.
• Commands can still work while muted: leave MuteBlocksCommands off so a muted player can still use slash commands like /back, and only their normal chat is blocked.
• Private warning notice: with TellPlayer on, the warned player gets a private message with the reason.
• Player self check: any player can run /mywarnings to see their own record.
• Discord logging: post every warning, mute, and unmute to a staff webhook. Off by default, turn it on when you want it.
• Live config reload: change the config and reload it with no restart.

Console & RCON Commands

Player Commands

Command names live in config.json, so you can rename them or turn one off. The first five are staff only. The last one is for any player.

Permissions

The staff commands are fail closed. When the Permissions plugin is not installed, or a player does not hold WarnSystem.Use, the staff commands do nothing, so they can not be abused. A mute that is already set still works. The player command /mywarnings needs no permission.

Config

To see every configuration option, visit our docs. To edit your config files the easy way, open our configuration editor.

Requirements

• AsaApi v2.01 or newer.
• A Windows ARK Survival Ascended dedicated server.
• Permissions plugin, needed for the staff chat commands (they are fail closed without it).
• Discord webhook, optional, works without it.

Installation

1. Unzip the WarnSystem folder into ArkApi/Plugins/ so the folder name matches the DLL.
2. Open config.json and set your AutoMuteAt, MuteMinutes, and command names.
3. Give your mod and admin groups the WarnSystem.Use permission node.
4. To log to Discord, set Discord.Enabled to true and paste your WebhookURL.
5. Restart the server.
6. Watch ArkApi.log for the line that says WarnSystem is ready.

Support & Help

Need a hand or hit a snag? Join the Discord and I will help you get it running: https://discord.gg/8GGaEzWk9p

Frequently Asked Questions

What does WarnSystem do? WarnSystem is a staff moderation plugin for ARK Survival Ascended. It lets staff warn players, keeps a full warning record for each player, and can auto mute a player once they hit your warning limit. Staff can also mute and unmute by hand, and every action can log to Discord.

Does WarnSystem need any other plugin to mute players? No. The mute is built in. WarnSystem watches chat and drops a muted player's messages on its own, so you do not need any extra chat or mute plugin for the mute to work.

Does WarnSystem work without the Permissions plugin? The staff commands need the Permissions plugin and the WarnSystem.Use node. This is on purpose and fail closed, so nobody can warn or mute without the right permission. A mute that is already set keeps working, and any player can still use /mywarnings.

How do I install WarnSystem? Drop the WarnSystem folder into ArkApi/Plugins/, edit config.json to set your warning limit and mute times, give your staff groups the WarnSystem.Use node, then restart the server. Check ArkApi.log to confirm it loaded.

Can I warn a player who is offline? Yes. Name a player who is online, or paste their EOS id to warn someone who is offline. The EOS id works any time, which is handy when the player has already left.

WarnSystem v0.0.1