Admin Toolbox

$24.95

Sold by: Zombie Land

Complete suite of useful tools and modifications for server admins.  This plugin is in constant development and has been run on all 7 of our servers for many years now.  As we discover new features we need for administering our servers we add them to this toolbox.

(Note:  Video demo of all features coming soon.)

Complete write-up of plugin can be found here -> zombieland.io/plugins/admin-toolbox/

(Will get that full write up ported and formatted to this page.  As you can see the write up is quite extensive.  I had hoped a copy paste from our write up webpage would retain formatting but it clearly did not.  This plugin was initially designed to not be released to the public but we have received so many requests for it we have released it.  This is why the write up is on our site as we have run this plugin for years now and the page is for our admins to reference)

Some functions do require other plugins.  Each function that requires another plugin has the ability to be toggled on/off and clearly states the name of the plugin required (ie. Kits plugin for the give kits functions, Server Rewards for give RP, Clans for identification functions to include clan name, etc.)

Description

Admin Toolbox

This is a full collection of “Utilities” used in assisting the administration team in running PVE type servers.   Can be used in PVP servers but some features will be obsolete.  All of these features are developed with performance impact as the top priority.  Some implementations might seem “restricted” in functionality, this was done for the sole purpose of preserving server performance.

Commands:

<arg> = required | [arg] = optional
Note: You can keybind chat commands via bind [key] chat.say “/command arg arg”

Give Line of Sight

/at.givelos <quantity> <itemShortname> [SkinID] [CustomName] – Chat command version
This command will give any item, including custom items, to the target you are looking at.   Also contains the functionality for currency from other plugins such as RP, XP, Zeds, etc.  Custom name is to only be used with skinned items or plugin currencies.  For virtual plugin currency items, type the currency in place of the name.  The plugin will recognize an invalid item name and revert to checking custom currency configuration for a match.

Examples:
at.givelos 1 pants – Gives one pants to the target
at.givelos 1 door.hinged.toptier 3456345 – Gives one skinned armored door
at.givelos 1 rock 2345234 “Purple Infinity Stone” – Gives a rock with a skin and custom name
at.givelos 500 Dollars – Gives 500 of the custom ShopyStock currency “Dollars” straight to target’s ‘bank’

at.givelos 1000 RP – Gives 1,000 of the custom currency “RP” from ServerRewards straight to target’s ‘bank’
at.givelos 10000 XP – Gives 10,000 XP from SkillTree plugin to the target

Give Kit Line of Sight

/at.kit <KitName> – Gives the kit, from the Kits plugin, to the target you are looking at.

– Automatically checks player inventory for free slots
– Attempts to move all wear/belt slot items into the main inventory so the given kit can be equipped
– Upon running out of room the plugin will then check the configuration list of “trash items” and delete those to make more room (ie. torch, rock, etc.)
– The trash items will never destroy a custom item or a skinned item.  So for example a special skinned rock will not get deleted but a plain rock will.
– After trash clean up if there is still not enough room the plugin will dump the remaining items on the ground in front of the player from eye level and notify them.
– (to-do: use the Redeem Storage plugin to catch the extra items)

Give Shoppystock Currency

at.givess <SteamID> [ShopName] <Quantity>  – Gives the player shoppy stock currency for the specified shop.

– Can be called remotely from RCON or through in game console.  Can also be used as a chat command with a / in front.  Requires permission admintoolbox.give

Phonebooth

at.phonebooth <KitName> – Stash current inventory and equip Kit
at.phonebooth restore – Restore inventory and get rid of the kit
This command is designed for admins to swap into their admin gear with the press of a hotkey, preserving their inventory for safe keeping, and then swap back when their duties are completed.
– Items are kept in their original state (eg. They will not lose any properties or custom attributes)
– Does NOT survive server restart or plugin reload so be sure to change back
– Will not allow another kit to be swapped until original inventory is restored (to prevent abuse)
– Memorizes position of inventory to restore back to the same container (wear, belt, main, etc.)
– Restore only gets rid of the swapped kit, any item acquired will not be removed when using restore

Inventory

at.strip
at.strip <SteamID>
at.strip target
/at.strip
/at.strip <SteamID>
/at.strip target
Completely clears the inventory of yourself (no arguments), of another player (SteamID), or from your line of sight target (target).

at.invlos
/at.invlos
Open the inventory of the target player using line of sight (Requires Inventory Viewer)

at.backpacklos
/at.backpacklos
Open the backpack (Plugin Backpacks) of the target player using line of sight

Deployables

/at.deployblock SteamID Shortname
Prevents that player from deploying the item specified anymore.
/at.deployblock SteamID list
Lists all items this player is blocked from deploying.
/at.deployblock SteamID remove Shortname

Removes the item from the list of things this player is blocked from deploying.

/at.deployblock
This is a line of sight command that reads the SteamID and Shortname from the item you are aiming at and is the equivalent of using the /at.deployblock SteamID Shortname command.  Be sure of what you are aiming at and who owns it.  Highly suggest using /at.identify first or some other plugin that shows item and owner.

/at.deploydelete
This is a line of sight command that reads the SteamID and Shortname from the item you are aiming at and removes every item of this type that is owned by this specific player on the entire server.  This is done slowly in batches of 5 at a time so as not to cause lag.  This cannot be undone.  It is used for malicious players spamming items all over your server.

Chat

/JLtoggle
Command any player can type to toggle on/off seeing join and leave messages in chat

Pseudo Commands / Timed Commands

/atx.[CommandName]

Misc

at.ejectsleepers
Performs the eject sleepers function (from configuration).  Typically used by a remote RCON tool with scheduling ability of commands (ie. Battlemetrics)

at.wipeperm <permission>
Completely removes the permission from every player on the server (useful for cleaning up old permissions)

/at.colors
Prints a sample paragraph to chat displaying all of the current color settings for the plugin chat feedback.  These colors can currently be edited in the top of the .cs file and will be moved to the config in future updates.

/at.homes <PlayerName|PartialName|SteamID>
Prints a list of the current homes (TeleportGU plugin) for the player

/at.homes <Number>
Teleports you to the home from the list of homes.
(The query will reset itself after 30s or upon the next query)

at.identify
/at.identify
Prints detailed information/attributes for the object you are looking at

at.negative
/at.negative
Prints detailed information about all negative scaled prefabs in your map.  Even includes custom prefab names if those entities are found within a custom prefab.  Also prints a set of coordinates to each negative scaled entity.  This is useful for map makers to eliminate all of the yellow error spam when a user logs into a map with negative scaled entities.

at.admintime ##
/at.admintime ##
Allows the player to set the specific time of day for their client only (is not seen by other players).  Use two digit number for the hour in 24 hour format.
Use -1 to turn this feature off and revert to normal server time.

/notate <Note>
Adds a note to the target player’s Battlemetrics profile using line of sight.

/at.sphere <meters> [duration] [color]
Draws a sphere with a radius <meters> around your current position for [duration] with the [color].
Useful as a measuring tool to gauge distance in game
/at.sphere help
Prints to chat the correct usage of the sphere command along with the valid colors.

at.logplayers
Sends the player count to a log file with date time stamps.  Useful for exporting to spreadsheets.  No built in timer for performance preservation.  To be called from a 3rd party schedular RCON tool such as Battlemetrics.

/diceroll <max>
Rolls a <max> sided dice and prints the results to global chat.

at.msg <SteamID> <message>
Sends a direct message to the player either in chat or via pop up (configurable)
Optionally (configurable) plays a special effect to get their attention

at.greet
Requires Battlemetrics integration.  This feature was designed for use by developers own servers
Uses line of sight targeting to log a “greet” for the admin using the command.  Contains logic to know if the player has already been greeted by another admin, or if the player is not considered “new” to the server to prevent double greetings or admins greeting players that are not new.
– Logs all greetings to a file for auditing.  Includes admin name and SteamID, Date/Time, target player name and SteamID, coordinates, and grid.
– Removes the “New Player” flag from the target in Battlemetrics
– Adds the “Greeted” flag to the player in Battlemetrics
– Adds a note to the player’s profile with Date/Time and the admin that greeted them
– Awards the admin with the configured reward

The following features were removed and packaged as a standalone plugin:
/at.reskin <SkinID>
Reskins the currently active item on the player toolbar with the new skinID
/at.reskin los <SkinID>
Reskins the deployable being looked at with the SkinID
/at.reskin los <BuildingSkin>
Reskins the building block being looked at to the building skin (ie. adobe, brutalist, etc.)

Configuration:

NOTE:  A lot of functions have enable/disable due to hook subscriptions.  Everything you do not use should always be set to false to preserve server performance.  The plugin will automatically use your settings to subscribe or unsubscribe to the appropriate hooks.

General Config

Enable Debug Output – Enables integrated debugging output throughout the entire plugin
Enable logging all commands used – Logs all command usage to a file.  This includes the command used, arguments passed with the command, date/time, admin name that used it, coordinates of use, and grid.  All of this data is written to file when the server saves to preserve performance.
Chat SteamID – ID used to determine the avatar for chat messages from this plugin
Range in meters of at.id command – Meters that the identify command should look for an object in your line of sight
Cooldown for players using /diceroll (seconds) – Slows players down from spamming this command

Player Settings

Eject Sleepers Enabled – Enables the ejection of sleepers from a specific area (good for Town or other points of interest)
Use RandomSpawns plugin for random eject destinations? – RandomSpawns (chaoscode) provides an API of random generated valid points all over the map.  If used, players are ejected to a random spot.  If false, players will be ejected to the nearest ‘edge’ of a radius around the ejection area and can build up sleepers on heavy pop servers.
Prefabs to eject sleepers away from (use full prefab path) – The prefab that we are ejection players away from (mainly a feature for custom maps.  Can place an invisible prefab to be used)
Radius to eject sleepers around prefab – Any player within this many meters of the above prefab will be ejected when the command is used
Enable limit of supply signal throwing – Enables the a supply signal throwing rate limit to prevent plane or chat spam
Prevent throwing supply signals from cargo ship (will be refunded) – Prevent braindead players from using supply signals on cargo ship
Maximum number allowed per cooldown period – If supply signal rate limit is enabled, how many can they throw in the period of time configured below
Cooldown for throwing more (seconds) – Time period to allow the above quantity of signals to be thrown
Track firework usage by printing to console – Print the player name, steamID, and coords when players launch fireworks.  Used for logging and investigatory purposes.
Send Pattern Boomers to Discord Webhook (must enable track firework usage) – Create an image of the pattern firework a player launches.  Sends the image to a Discord channel along with server name and player that launched it (good for investigating who launched offensive images)
Discord Webhook URL – Webhook for the Discord feature for pattern boomers

Building and Deploying

Base Settings
Use permission for immunity – Allow players to be immune to base build settings via permission (currently not in use)
Permission for build immunity – Define the permission name to be used for immunity (currently not in use)

Deploy Settings
Enable global blocking of deployables listed – Globally block players from deploying items in list below
Permission for deploy immunity
 – Allow players to be immune to all deployable settings via permission
Shortnames not allowed to be deployed globally (except immune) – List of deployables not permitted to be deployed
Enable player specific blocking of deployables – Enable player specific deployable blocking and limiting features
Permission to administer block list – Permission to use in game player specific deployable restriction commands
Enable global deployable quantity limits – Globally limit players to a specific number of specific deployables (except immune)
Global deployable quantity limits (uses contains for word search) – Specific deployable limits and quantities.  Uses “contains” wildcard style matching (ie. “planter” covers all shortnames that contain ‘planter’)

Farm Settings
Block planting seeds outside of planters – Stops players from planting seeds out in the wild
Block planting seeds in planters – Stops players from planting seeds in planters

Refund the ob if blocked – Refunds the seed when blocked

IO Settings
Turn off IO when player logs out? – Specific list of IO entities that will be forcefully shut off when player logs out.  Helps IO performance and teaches players to learn to use switches and turn things off when logging out.  Only works on IO entities placed when this plugin is running.
Entities to be Shutdown on player logout – List of electrical things to track and shut off.  Feel free to normalize them (remove the . from their name) the plugin will do so anyways
(NOTE:  This feature is only a few days old.  There are more things in store for it.  Also know, this uses the core function Shutdown() which will cut the wire to the deployable if it was left powered when the player logged out.)
To-Do:
– Implement a grace period timer in config so players that disconnect are not counted if they log back in soon

PVE Server Utilities

Disable Jackhammer Raiding if TruePVE absent – Prevents jackhammer raiding if TruePVE is not detected (useful in No Durability situations)
Block players from authorizing or looting NPC auto turrets in custom maps – Custom maps can then utilize auto turrets in monuments
Block Gibs/Fire from destroyed player copters – Stop player copters from leaving fire or gibs when destroyed
Force ‘Extra Pockets’ (SkillTree) to drop in PVP Raidable Bases – Can leave them set to not drop by default but this forces them to drop in PVP Raidable Bases
Block all damage to/from Safe Zones – Nothing can harm from or into a safe zone.  Good to prevent players exploiting safe zones in PVE
Allow NPC Turrets to damage from Safe Zones – Lets turrets still damage from safe zones
Block Scrap Copters from harming players – Prevent players from squishing other players under a copter
Allow players to destroy campfires – Ignore TruePVE and let campfires be destroyed by players (good for entity cleanup)
Allow players to destroy sleeping bags – Ignore TruePVE and let sleeping bags be destroyed by players (good for entity cleanup)

Give Config

Play a special effect over the target upon success – In game sound effect upon successful give
Effect prefab path – Path to the asset effect to use
Use ShoppyStock – Use a shoppy stock currency as one of the custom currencies
Shoppy Stock Shop Name – Name of the shop to be used as the custom currency
Use ServerRewards (RP) – Enable RP as one of the custom currencies
Use Economics (Eco) – Enable Economics as one of the custom currencies
Use SkillTree (XP) – Enable XP as one of the custom currencies

RESKIN Config

REMOVED: – The reskinning of building blocks was removed and packaged as a standalone plugin

Kits Config

Play a special effect over the target upon success – In game sound effect upon successful giving a kit
Effect prefab path – Path to the asset effect to use
Enable use of at.kit command – Enable those with permission to use the kit command
Item shortnames to be deleted when giving/swapping kits – List of “trash items” that are permitted to be deleted if the receiving player does not have enough room for the kit

Phonebooth Config

Play a special effect over the target upon success – In game sound effect upon successful swap
Effect prefab path – Path to the asset effect to use
Enable use of at.phonebooth command – Enable those with permission to use the phonebooth command
Kits allowed via Phonebooth (leave empty for no restrictions) – List of kits allowed to be used with phonebooth command

Vehicle Config

Block spawning of vehicles from VehicleLicense plugin in specific map topologies – Blocks players spawning personal vehicles on listed topologies
Block recalling of vehicles from VehicleLicense plugin in specific map topologies – Blocks players recalling personal vehicles on listed topologies
List of those topologies – List of topologies to block them in (ie. monument, building, ocean, etc.)

Destroy any glitched Tug Boats found at 0,0,0 – Some situations cause decayed tugboats to collect at 0,0,0.  This is an attempt to brute remove them.  (Note: This was a major issue around release of tugs but have not seen it lately.  Might be safe now to not bother with this)

Messaging Settings

Use Prefix in at.msg – Automatically add prefix text to the front of all msg usage.  Good for server branding etc.
Message Prefix – The text to use in the above setting.  HTML color codes are accepted if using chat feedback
Send message in a popup rather than chat – Use a pop up in the middle of the screen rather than chat text

Get target attention by playing special effect upon msg sent – In game sound effect at player position upon successful message to get their attention
Effect prefab path – Path to the asset effect to use

Welcome Msg Config
Enable Welcoming Players – Print a personalized welcome to global chat when a player joins
Enable Goodbye to Players – Print a personalized welcome to global chat when a player leaves
Use OpenAI API for Welcome/Goodbye Statements – Process the welcome/leave messages through ChatGPT for more random creative messages.

Random Chat Message Settings
Use this feature (plugin will not load the data if false) – Use the random chat message feature (reads from your data file)
Use internal plugin timer to trigger – Use internal plugin timer for these messages (false allows you to rely on an Rcon tool automation sending the console command.  Saves on performance)
Time Interval (seconds) – Time interval if using internal timer (in seconds).

Announce to chat when a player throws a supply signal – Print to global chat when someone throws a supply signal

HUD Configurations

Show a PVP warning to players when PVE plugin unloaded – Automatically show a UI indicator that PVP is active by checking if PVE plugin is loaded
PVE Plugin name (Case sensitive and must be exact without the .cs) – The plugin that we watch for to know if it is PVP mode or not
Message to display on the PVP indicator – What message we want to display in the indicator (ie. “PVP Day!”). No HTML color codes

Background color of the UI box – RGBA color for the indicator box
Font color of the message – RGBA color for text in the box
Font size of the message – Font size of that text
AnchorMin for UI position – Starting bounds of the box (how you adjust the size and position)
AnchorMax for UI position – Final bounds of the box (how you adjust the size and position)

OpenAI  API Settings

Frequency Penalty – Penalize GPT for repetitive answers
Max Tokens – The most tokens allowed to be used in the response
GPT Model – For cost, highly suggest GPT-3.5 Turbo

Presence Penalty – Control GPT coming up with new content
Temperature – Higher number means more creative answers.  Value range 0.0-2.0
OpenAI API Key – You are required to have an API Key
API URL – https://api.openai.com/v1/chat/completions  (do not change unless ChatGPT requires it)

ZL  Settings

These are specific functions designed for the servers run by the developer of this plugin.  Some may be found to be useful, some will make no sense to other servers.  All of these features are enable/disable and will not affect your servers if disabled.  We were advised to remove this if releasing this plugin so as not to give away some of our proprietary functionality but decided to leave them in.  Use at your own free will and risk.  No features in this specific section will be supported or altered/fixed/etc.  These are not meant for public.

Force Horde Zombie corpse/bag to despawn upon interaction – Used to stop players from exploiting loot quests
Time after interaction for the corpse/bag to destroy – Timer for the above setting
Show feedback when Horde Zombie corpse/bag dissolves? – Alert the player to the corpse despawning

Use native ‘toast popup’? – Use built in rust pop up or just use chat for corpse despawn notification
List Zombie Horde names from config loadouts – What dictates which NPCs are considered horde zombies

Enable limit of supply signal throwing? – True/False.  Configurable amount of supply signals that can be thrown in X period of time to prevent spamming.
Block throwing supply signals on Cargo ship – If enabled will refund the supply signal and tell the player why

Enable Cleanup – Enable automatic deletion of items dropped on the ground (list below)
Items ‘Shortname:SkinID’ or no SkinID for all of that type – Items in this list will be auto deleted when dropped

The following commands will be unaccessible to authlevel 1 without the ‘admintoolbox.serveredit’ permission – By default anyone with auth level 1 (moderator) can access a large variety of server convars directly from F1 menu.  This is a list of commands you want to block those moderators from being able to edit.   The permission ‘serveredit’ bypasses this block.  Auth level 2 is not affected by this.

Battlemetrics Integration

BaseURL – The base API url for BM
BM API Token – Your org BM token
New Player Flag ID – ID of your BM new player flag

Greeted Player Flag ID – ID of your BM greeted player flag
Player Note Text – Text note added when greeted
Organization ID – BM org ID

Permissions:

admintoolbox.use – To use most plugin features.  Also the default permission if specific permission does not exist in most cases

admintoolbox.dice – Use of /diceroll command

admintoolbox.bckpcklos – Use of line of sight backpack viewing

admintoolbox.invlos – Use of line of sight inventory viewing

admintoolbox.give – Use of the give functions

admintoolbox.homes – To view the /sethome list of others

admintoolbox.kits – Use of the kits functions

admintoolbox.greet – To log greets and be rewarded

admintoolbox.phonebooth – Use of phonebooth command

admintoolbox.admintime – Allow non admins to use admintime

admintoolbox.serveredit – Allow editing of server convars in F1 menu if not auth2

admintoolbox.authall – Use of authall command

admintoolbox.strip.self – Use strip command on self

admintoolbox.strip.other – Use strip command on other player

admintoolbox.strip.target – Use of line of sight strip command

admintoolbox.ignore.joinleave – Use for users or groups you do not want join/leave messages for (ie. admins)
admintoolbox.mute.joinleave – Use for users or groups you do not want seeing join/leave chat spam
admintoolbox.rndmsgs.ignore – Use for users or groups you do not want seeing the random chat messages from that feature in this plugin

 

admintoolbox.deploydelete – Allow use of the deploydelete commands (dangerous, should only be admins)

admintoolbox.IOimmune – Immunity to all IO enforcement.  Does not even track their entities

admintoolbox.[custom] – Building restriction immune, deployable restriction immune, and deployable admin permissions are all configured in the config.

Reviews

There are no reviews yet.


Only logged in customers who have purchased this product may leave a review.

Version 0.1.49 | Updated February 27, 2025
  • Updated Moved list of IO entities to be tracked over to the config rather than hard coding.

Discussions

There are no discussions yet.

Leave a reply

Your email address will not be published. Required fields are marked *

Plugin FAQ – How do I use this .zip/.7z file I just purchased on my server?

• First, you want to unzip the file. You can do so by just double-clicking it to open, then drag the contents to the desired location (you may need to install an external unzipping software if you don’t already have one such as 7zip or winrar)
• Next you will find either a structure of folders or just the .cs file itself (it’s the actual plugin file itself).
• After that just install the .cs (plugin file) into your …/oxide/plugins/ folder where you will install plugins you ever need to.

Additionally, here’s a great video that easily covers adding a plugin to your server if you need! https://youtu.be/yWC_p97FhQA

• Installation is not included with any products on the site, however, if needed we may assist if you reach out to our support.

Currently all products on Lone.Design will be contained within a zipped file which is the .7z or .zip that you see. I believe windows 10 and up can unzip on its own without 3rd party tools, but in that case, if you’re unfamiliar with zipped files here are 2 programs I recommend to easily unzip zipped files.

Video On How to Zip and Unzip: https://youtu.be/Ep-L3PjBPCk (TechInsider Youtube Channel)

Zipping/Unzipping Tools
Winrar https://www.rarlab.com (I used to use for years, but works great!)
7zip https://www.7-zip.org/a/7z2107-x64.exe (the one I use currently)

How do I set up these Tools/Utilities I just purchased for my server?

• All tools/utilities are to include installations steps in the description or within the product download themselves, however, if you need assistance whilst setting them up please reach out to us on Discord. Please follow the installation steps found in the description or attached within your downloaded file.

• Installation is not included with any products on the site, however, if needed we may assist if you reach out to our support.

Currently all products on Lone.Design will be contained within a zipped file which is the .7z or .zip that you see. I believe windows 10 and up can unzip on its own without 3rd party tools, but in that case, if you’re unfamiliar with zipped files here are 2 programs I recommend to easily unzip zipped files.

Video On How to Zip and Unzip: https://youtu.be/Ep-L3PjBPCk (TechInsider Youtube Channel)

Zipping/Unzipping Tools
Winrar https://www.rarlab.com (I used to use for years, but works great!)
7zip https://www.7-zip.org/a/7z2107-x64.exe (the one I use currently)

Product Enquiry

Please Login to make enquiry about this product