Admin Essentials 2.0.1

AdminEssentials is a powerful and easy-to-use toolkit for Rust server administrators. It provides a comprehensive suite of moderation, management, and utility commands to help you run your server smoothly.


Features

• Teleportation tools: Teleport to players or coordinates, teleport back to previous locations, and teleport to placed map markers.
• Player moderation: Kick players, ban players (with timed durations and reasons), and unban players via simple commands.
• Player management: Heal players to full health, kill players instantly, and toggle special modes like God mode and Creative mode for yourself or others.
• Inventory and items: Give items to players, clear a player’s inventory, repair items, and view any player’s inventory contents in real time.
• Item Trash Can: Includes a personal Trash Can UI for safely destroying items.
• Server controls: Change the server time, set a personal “admin time”, instantly clear all weather effects, and reload server plugins in-game.
• Communication: Send private messages to players and reply quickly to the last message. Display a list of all online players and get detailed information on any player with a WhoIs lookup command.
• Automated messages: Optionally broadcast welcome messages to joining players and goodbye messages on disconnect. Configure periodic auto-messages that broadcast to the server at set intervals.
• Logging and customization: All admin actions can be logged to the server console/RCON and/or to a Discord webhook (configurable per command). Customize the chat prefix and icon for AdminEssentials messages to suit your server’s style.

Commands
(Use these commands in chat with the "/" prefix. All commands require the user to have the appropriate permission as listed in the Permissions section.)

Teleportation Commands

• /goto – Teleport yourself to a player or to specific coordinates. (You can also teleport one player to another by specifying two player names.)
• /tpm – Toggle “teleport to marker” mode. When enabled, placing a map marker will instantly teleport you to that location. Use /tpm again to disable this mode.
• /back – Teleport back to your last saved location. Typically this returns you to where you teleported from (or your death location, if applicable).
• /spectate – Spectate the target player. Puts you into spectate mode attached to that player. Use the command again (or the on-screen UI button) to exit spectating and return to your original position.

Moderation Commands

• /kick [reason] – Kick a player from the server. You may provide an optional reason which will be shown to the player.
• /ban [duration] [reason] – Ban a player. Optionally specify a duration (e.g. “30m”, “2h”, “7d”) and/or a reason. If no duration is given, a default (1 day) ban is applied.
• /unban – Unban a player. You can use either the player’s name or Steam ID.

Player Management Commands

• /heal [player] – Fully heal yourself (no name) or the specified player (if a name is given). Restores health and vital stats to maximum.
• /kill [player] – Instantly kill yourself or the specified player.
• /god [player] – Toggle god mode (invincibility) on yourself or on another player. A player in god mode will not take damage or die until god mode is toggled off.
• /creative [player] – Toggle Rust’s creative mode on yourself or on another player. Creative mode allows building and crafting without restrictions.
• /creativeall – Toggle creative mode for all players on the server at once.

Inventory Commands

• /give [amount] [skinId] [name] – Give an item to a player. You must specify the target player and item short name (or Item ID). You can optionally specify an amount (default 1), a skin ID, and a custom item name.
• /clear [player] – Clear your own inventory (no name given) or another player’s inventory (if a player name is provided). This completely empties the inventory of the target.
• /repair [player] – Repair the currently held item to full condition. If a player name is given, repair that player’s held item instead.
• /repairall [player] – Repair all items in your inventory. If a player name is given, repair all items in that player’s inventory instead.
• /viewinv – View the specified player’s inventory. This opens the target player’s inventory containers (main, belt, wear) for you, allowing you to see and/or move items.
• /trash – Open your personal trash can UI. This provides a special container (default 18 slots) where you can place items to destroy. Closing the trash UI with items inside will delete those items (after you confirm via the Delete button).

Server Management Commands

• /time <0-24> – Change the server time to the specified hour (0–24). For example, “/time 12” sets in-game time to noon.
• /admintime [0-24] – Set your personal time of day. This overrides the server time for you only (useful for admins who want daylight while it’s night on the server). Specify an hour (0–24) to lock your time, or use no argument to reset back to normal server time. If you run it with no number or with -1 it will disable admintime.
• /clearweather – Instantly clear all weather effects on the server. This will stop rain, fog, and thunderstorms, returning to clear weather.
• /reload [plugin] – Reload an Oxide/Umod plugin. By default (no name given), this will reload the AdminEssentials plugin itself. You can specify another plugin name to reload that plugin instead.

Communication Commands

• /pm <player> <message> – Send a private message to a player. The target player will receive your message privately.
• /r <message> – Reply to the last private message you received. This sends a PM back to whoever last messaged you (equivalent to a “reply” function).

Information Commands

• /whois [player] – Display detailed information about a player. With no name, it will show your own info. The info can include the player’s name, Steam ID, position coordinates, connection status, health and vitals, and flags (admin, godmode, etc.). (The amount of detail shown depends on your permissions; see Permissions.)
• /players – Show a list of all online players on the server. By default this will list the player names (and possibly IDs) in chat.

Utility Commands

• /essentials – Display the AdminEssentials help list. This command prints a list of all available AdminEssentials commands (the same commands listed above) with brief descriptions, to your chat. Only users with permission can use this.

Permissions
(Each permission can be granted to server staff or groups to allow use of the corresponding commands. All permission strings begin with adminessentials. as shown.)

• adminessentials.goto – Required to use the /goto command.
• adminessentials.back – Required to use the /back command.
• adminessentials.tpm – Required to use the /tpm teleport-to-marker command.
• adminessentials.spectate – Required to use /spectate.
• adminessentials.kick – Required for the /kick command.
• adminessentials.ban – Required for the /ban command.
• adminessentials.unban – Required for the /unban command.
• adminessentials.heal – Allows use of /heal.
• adminessentials.kill – Allows use of /kill.
• adminessentials.god – Allows use of /god mode toggle.
• adminessentials.creative – Allows use of /creative mode toggle.
• adminessentials.creativeall – Allows use of /creativeall (creative mode for all players).
• adminessentials.give – Required for /give item command.
• adminessentials.clear – Required for /clear inventory command.
• adminessentials.repair – Required for /repair command (repair held item).
• adminessentials.repairall – Required for /repairall command (repair all items).
• adminessentials.viewinv – Required for /viewinv (view player inventory).
• adminessentials.trash – Required for /trash (open personal trash can).
• adminessentials.time – Allows use of /time to set server time.
• adminessentials.admintime – Allows use of /admintime for personal time setting.
• adminessentials.clearweather – Allows use of /clearweather.
• adminessentials.reload – Allows use of /reload command to reload plugins.
• adminessentials.pm – Required for /pm and /r (private messaging commands).
• WhoIs Information Permissions: (The /whois command output is divided into sections; each section requires a specific permission. Granting all will show full info.)
  • adminessentials.whois.info – Allows the /whois command to show basic info: player name, Steam ID, and position.
  • adminessentials.whois.status – Allows /whois to show connection status (online/offline), life status (alive or dead), sleeping or wounded state.
  • adminessentials.whois.stats – Allows /whois to show the player’s stats: health, calories, hydration, temperature, radiation, bleeding, wetness.
  • adminessentials.whois.flags – Allows /whois to show player flags: whether the player is admin, in creative mode, developer mode, flying, or in god mode.
• adminessentials.players – Required for the /players list command.
• adminessentials.help – Required for the /essentials help command (to view the in-game command list).