Eco Discord Alerts & Admin Tools (AdminsPlease)

Let players quickly alert admins by typing keywords in chat.

When a keyword is detected, players are prompted to confirm whether they want to send an alert. Alerts are sent via webhooks, allowing for flexible integrations.

 

Discord Integration:

This mod is designed with Discord in mind. When combined with DiscordLink, you can sync in-game chat to Discord and use alert timestamps to review what was happening at the time.

With DiscordLink's synced chat, admins can even respond directly from Discord without logging into Eco.

 

Configuration & Behavior:

• Alerts are rate-limited to prevent spam (30 minutes by default)
• Custom message prefixes can add context (e.g. pinging a Discord role or including server name)
• Compatible with any system that supports webhooks

 

<table class="table-auto"> <tbody> <tr> <td>

Who Is This Mod For

</td> <td>

Server Admins

</td> </tr> <tr> <td>

Built On Eco Version

</td> <td>

12.0.6

</td> </tr> <tr> <td>

Mod Features

</td> <td>

• Allows players to notify admins without requiring them to join another Discord server

• Customizable keywords

• Custom alert prefixes (useful to ping a Discord role or mention the server name)

• Alerts are rate-limited (prevent spamming)

• Compatible with any system that supports webhooks

</td> </tr> <tr> <td>

Commands Added

</td> <td>

(None)

</td> </tr> </tbody> </table>

 

---

Installation

1. Download the latest version of AdminsPlease
2. Extract the archive
3. Locate AdminsPlease.dll
4. Move it to:
   .../Eco/Eco_Data/Server/Mods/UserCode
5. Create a new file at:
   .../Eco/Eco_Data/Server/Configs/AdminsPlease.eco
6. Put this text inside of that file:
   <pre>{ "ServerName": "", "WebhookUrl": "<url>", "AlertPrefix": "", "Keywords": "admin", "TimeoutMinutes": 30 }</pre>
7. Replace <url> with the webhook url
   Note: you need to leave the " around the url

   1. For Discord see: Discord - Intro to Webhooks
   2. Follow the Making A Webhook section
   3. Once done, click the Copy Webhook URL button in Discord
   4. Use that url to make the replacement

8. Optionally, you can supply a message prefix to ping a role.
   Note: It must be the full role ID.

   1. Go to your Discord server.
   2. Type into any chat \@RoleName.
   3. The message will not say @RoleName, but look something like <@&1128342307708608582>.
   4. Use that as the AlertPrefix in the config. 
      Example: "AlertPrefix": "<@&1128342307708608582>".

9. Optionally, set the server name.
   Example: "ServerName": "Copper Village"
10. Change the keywords or timeout in the config.
    Note: TimeoutMinutes doesn't need the quotes around it.
11. Restart the server.

Most of these settings can be changed in the Server GUI under the Mods tab with the name AdminsPlease.AdminsPleasePlugin.

 

---

Commands

<table class="table-auto"> <tbody> <tr> <td>Command</td> <td>Short Command</td> <td>Description</td> </tr> <tr> <td>/adminsplease version</td> <td> </td> <td>

Not added yet.

</td> </tr> </tbody> </table>

 

---

Walk-through

1. The player sends a message with a keyword in it. Is the admin on?
2. That message shows up in-game chat.
3. The player is asked if they need help. A yes/no popup shows up on their screen (just like when you try to exit the game)
4. If they hit no, nothing happens.
5. If they hit yes, a message is sent to Discord. @Admins -- CitizenName might need help on the EcoServerName server. They said 'Is the admin on?'.
6. A timer is started for that player. They must wait 30 minutes (default value, but customizable) before they are able to trigger this alert again.

---

About the Author

I have 1750+ hours in Eco and help run a public server called Copper Village.

Check out Copper Village to see this mod in action, or explore more of my mods at mod.io (WugWugg).

Part of a growing set of lightweight server tools designed to keep Eco feeling vanilla, just a bit more comfortable and predictable.