Version 1.1.1
1 download
When a Tool Cupboard is destroyed, this plugin notifies admins immediately and enforces eviction by kicking all authorized players.
Optional features include TC authorization limits, blacklisting, and the ability for players to avoid eviction by re-authorizing on another cupboard giving admins better oversight and control of gameplay.
***Note:
By default, evictions are final. Optionally, you can allow players to avoid eviction by re-authorizing on another TC or enable the automatic blacklist to block evicted players from rejoining until you manually remove them or the list is cleared on wipe.
Features:
Admin Notifications: Instantly alerts all online admins in chat and logs events to the console when a TC is destroyed, including attacker, owner, location, and affected players.
Kick Countdown: Configurable eviction delay with visible chat countdown messages so players know exactly how long they have before being kicked.
TC Authorization Limits (Optional): Restrict how many cupboards a player can be authorized on at once, with automatic enforcement.
Re-Auth Support (Optional): Allow players to avoid eviction by authorizing on another TC before the countdown expires. (pending optional limit count)
Admin Bypass: Optionally ignore TC destructions by admins to avoid unnecessary alerts.
Blacklist System (Optional): Automatically prevent evicted players from reconnecting until they are removed or the list is cleared (configurable).
Manual Admin Controls: Commands to cancel evictions, manage the blacklist, or view queued players provide full oversight.
Discord Integration: Sends destruction and eviction details directly to Discord via webhook for real-time visibility.
Optimized Performance: Maintains a cached cupboard registry for efficient tracking, avoiding heavy entity scans on large servers.
Persistent Data: Eviction records and blacklist entries survive restarts and reset automatically on wipe.
Permission:
evictionnotice.admin – Grants access to plugin commands and notifications.
Note: This permission is automatically granted to AuthLevel 1 and 2 on connect, so server owners don’t need to manually assign it.
Chat Commands:
/evicted – Shows the list of players queued for eviction.
/ecancel <steamid64> – Cancels the eviction countdown or offline eviction for the specified player.
/eblacklisted – Displays the list of currently blacklisted players.
/eblacklist <steamid64> – Manually adds a player to the blacklist.
/eunblacklist <steamid64> – Removes a player from the blacklist.
Console Commands:
evicted – Prints the list of players queued for eviction to the server console.
ecancel <steamid64> – Cancels the eviction countdown or offline eviction for the specified player.
eclearalldata – Clears all plugin data (queued evictions, blacklist, cupboards, TC auth counts). Console only.
Default Config:
{
"Ignore admin:": false,
"Chat Prefix": "<color=#32CD32>Eviction Notice: </color>",
"Discord Prefix": "Eviction Notice: ",
"Discord WebHook": "https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks",
"Your time zone hours from UTC (example: -4 or 4)": -4,
"Delay in seconds before kicking authorized players after TC destruction": 30,
"Allow Re-Auth Before Kick": false,
"Enable Blacklist After Eviction": false,
"Enable TC Limit": false,
"Max TCs Per Player": 3
}