RUST Admin Hammer Plugin (How to Install, Configure & Use)

What is the Admin Hammer plugin?

Admin Hammer (AH) is a RUST plugin that allows RUST admins (or anyone with adequate permissions) to uncover and display owner information about a given entity. The plugin is patched and supported by mvrb. AH is a free-to-use plugin available for download on uMod and a favorite amongst the RUST admin community due to its ongoing utility as an information-gathering tool, considerably cutting down on having to issue redundant commands to display in-game player data.

Potential reasons to use the Admin Hammer plugin

Admin Hammer is an absolute must-have for anyone moderating a large population server. For servers that remove player grief, need to establish a base’s ownership, or want to see who placed offensive material in-game, finding entity owner identities is as easy as a right-click with an equipped hammer. 

Additional features (permissions pending) include;

• The ability to view the contents of boxes without opening them
• Capacity to display code lock information to the admin team
• Real-time original owner information at a click, with a SteamID link
• Console readouts for administrative logging
• Check-auth functions for team limit servers on entities such as doors and TCs

Installing the Admin Hammer plugin

As with all uMod plugins, the server you intend to install them on requires uMod (Oxide) to be installed to facilitate their function. For a step-by-step perspective on how to install this plugin, please reference the following list:

1. First, you must have uMod/Oxide installed on your server. Use our Installing uMod (Oxide) on Your RUST server guide if you need help; otherwise, if you use a third-party hosting, their user interface will have instructions on how to get started. It may be tooled explicitly to their platform, so reach out to your host for details.
2. Acquire the latest version of the plugin from uMod’s Admin Hammer page, or download the CS file directly.
3. Locate the downloaded AdminHammer.cs file and install the plugin on your RUST server, or follow your host-specific instructions.
4. Once you’ve installed Admin Hammer in the plugins folder, and if the server is actively running, uMod will immediately create an alternate AdminHammer.json file in your config folder. You will make all configuration changes to the .json file in the config folder.

Additional dependencies

Like many other uMod plugins, Admin Hammer may work as a standalone mod or in conjunction with other select mods. Such mods include:

• Discord Logger
• Rustcord

Permissions

As with all uMod plugins, they will each have a small list of plugin-specific permissions. Make sure you reference our uMod Permissions Guide to better understand the oxide.grant permission system.

 Specific permission command lines for Admin Hammer include:

Activation steps

Once installed and permitted to use the mod, players MUST activate it in-game via a simple /adminhammer command in chat. It will not function until this command is issued per user. 

Recommended plugin configurations

By default, the configuration of the AdminHammer.json file should be adequate for most server owners’ purposes. To better understand potential option changes, this guide will go through the configuration file line by line as it pertains to the most commonly changed settings.

This is an example configuration file for the RUST Admin Hammer plugin. It has been altered slightly to explain setting change impact better – DO NOT copy and paste this example into your configuration.

{
  "ChatCommand": "b",
  "CommandToRun (Leave blank for no command)": "box",
  "LogAdminInfo": true, - toggling false disables citing admin use information during logging
  "LogToConsole": true, - toggling false disables printing to console on use
  "PerformanceMode": false,
  "ShowBoxContents": true, - toggling false disables printout box contents on use
  "ShowCode": true,
  "ShowSphere": false,
  "ToolDistance": 200.0,
  "ToolUsed": "hammer" - can be toggled to alternate handheld entity types, not advised
}

How to update the Admin Hammer plugin

Updating the RUST Admin Hammer plugin is simple and quick.

1. Visit the uMod Admin Hammer plugin page
2. Download the latest version of the Admin Hammer plugin
3. Overwrite the existing AdminHammer.cs file in your Oxide plugins folder.

It is best practice not to uninstall the mod, as you do not need to alter the JSON file. It will remain with your existing settings (unless the developer otherwise suggests a complete reinstall).

How to remove the Admin Hammer plugin

As the Admin Hammer plugin doesn’t impact player experience or game features necessary to run processes in the game itself, removing the plugin is as simple as deleting AdminHammer.cs from your plugins folder. 

A more thorough approach for removing Admin Hammer is to:

1. Prepare and properly shut down the RUST server
2. Open the Oxide plugins folder in your server directory
3. Locate and delete the AdminHammer.cs file
4. Open the Oxide config folder in your server directory
5. Locate and delete the AdminHammer.json configuration file
6. Restart the RUST server

Suppose you want to disable the Admin Hammer plugin for a short period. You can use the oxide.unload AdminHammer command, which you may also run in the F1 console, RCON, or Web Console. 

Disclaimer and seeking assistance

Corrosion Hour does not maintain the RUST Admin Hammer plugin, nor do we assist with modifying the plugin outside the config scope. Visit the plugin’s uMod page to support the plugin creators, report bugs, or propose feature requests. Please get in touch with an admin in our Discord community for help with the steps and instructions in this guide.