https://github.com/laurarozier/playeradministration

Allows server admins to moderate users using a GUI from within the game
https://github.com/laurarozier/playeradministration

oxide oxide-plugins player-administration plugin rust umod

Last synced: 9 months ago
JSON representation

Allows server admins to moderate users using a GUI from within the game

• Host: GitHub
• URL: https://github.com/laurarozier/playeradministration
• Owner: LauraRozier
• License: mit
• Created: 2018-09-06T15:27:05.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2023-10-02T20:41:05.000Z (over 2 years ago)
• Last Synced: 2025-07-01T01:11:26.446Z (11 months ago)
• Topics: oxide, oxide-plugins, player-administration, plugin, rust, umod
• Language: C#
• Homepage: https://umod.org/plugins/player-administration
• Size: 446 KB
• Stars: 6
• Watchers: 3
• Forks: 8
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

          
*Player Administration* provides a simple-to-use GUI that helps admins moderate users.

## Features

- Banning/unbanning users

- Kicking users

- Killing users

- Muting/unmuting a player

- Clearing the user's inventory

- Resetting a user's blueprints

- Resetting a user's metabolism (Identical to how a respawn sets a random metabolism)

- Recover a user's metabolism (Gives the user a healthy metabolic state by filling their hunger, thirst, oxygen, and removing bleeding and radiation.)

- Hurting a user

- Healing a user

- Teleporting yourself to a user

- Teleporting a player to yourself

- Spectating a player **WARNING: This kills your player and makes you like a "ghost", respawn to exit spectate.**

- The ability to see a user's vitals, status and steamID64

- Use of Economics plugin to show player's current balance

- Use of ServerRewards plugin to show player's current reward points

- Use of Freeze plugin to freeze/unfreeze user position (Only for English language users, Freeze uses localized commands!!!)

- Use of PermissionsManager plugin to edit Oxide user permissions on a user

- Use of DiscordMessages plugin to send a fancy message to Discord for each ban and kick

- Use of BetterChatMute plugin to mute players in an improved manner

- Use of Backpacks to view a players backpack

- Use of Inventory Viewer to view a players inventory

- Use of Godmode to enable/disable godmode for players

- Filtering through users via the "search" function (Case insensitive and selects both names and IDs that contain the text written in the input)

## Permissions

Hint: To easily add all protections use the RCON command: `oxide.grant {user  | group } playeradministration.protect.*`

- **playeradministration.access.show** -- Required to be able to use the `/padmin` command and plugin

- **playeradministration.access.kick** -- Allows the user to kick any player

- **playeradministration.access.ban** -- Allows the user to ban and unban any player

- **playeradministration.access.kill** -- Allows the user to kill any player

- **playeradministration.access.clearinventory** -- Allows the user to clear any player's inventory

- **playeradministration.access.resetblueprint** -- Allows the user to reset any player's blueprints

- **playeradministration.access.resetmetabolism** -- Allows the user to reset any player's metabolism

- **playeradministration.access.recovermetabolism** -- Allows the user to give any player a healthy metabolic state

- **playeradministration.access.hurt** -- Allows the user to hurt any player

- **playeradministration.access.heal** -- Allows the user to heal any player

- **playeradministration.access.mute** -- Allows the user to mute/unmute any player

- **playeradministration.access.perms** -- Allows the user to use the "Permissions" button for any player

- **playeradministration.access.allowfreeze** -- Allows the user to freeze and unfreeze any player

- **playeradministration.access.teleport** -- Allows the user to teleport to any player

- **playeradministration.access.spectate** -- Allows the user to spectate any player

- **playeradministration.access.detailedinfo** -- Allows the user to see more detailed player information

- **playeradministration.protect.ban** -- Protect the user against banning through the panel

- **playeradministration.protect.hurt** -- Protect the user against hurting through the panel

- **playeradministration.protect.kick** -- Protect the user against kicking through the panel

- **playeradministration.protect.kill** -- Protect the user against killing through the panel

- **playeradministration.protect.reset** -- Protect the user against stat/BP/inventory resetting/clearing through the panel

## Chat Commands

Binding keys and saving the keybinds:  

 `bind p chat.say 0 /padmin`  

or:  

 `bind p "chat.say 0 /padmin"`  

Then to save it:  

 `writecfg`

- **/padmin** -- Show the player administration menu ***(requires `playeradministration.access.show` permission)***

## Console Commands

- **playeradministration.closeui** -- Close the player administration menu

- **playeradministration.switchui ** -- Switch the UI to a different page (Check the code to see the types of UIPage) ***(requires `playeradministration.show` permission)***

- **playeradministration.kickuser ** -- Kick a player ***(requires `playeradministration.access.kick` permission)***

- **playeradministration.banuser ** -- Ban a player ***(requires `playeradministration.access.ban` permission)***

- **playeradministration.mainpagebanbyid** -- Ban a player ***(requires `playeradministration.access.ban` permission AND only works from the UI due to the text input field)***

- **playeradministration.unbanuser ** -- Unban a player ***(requires `playeradministration.access.ban` permission)***

- **playeradministration.perms ** -- Open the perms UI for a player ***(requires `playeradministration.access.perms` permission)***

- **playeradministration.vmuteuser ** -- Mute voice for a player ***(requires `playeradministration.access.voicemute` permission)***

- **playeradministration.vunmuteuser ** -- Unmute voice for a player ***(requires `playeradministration.access.voicemute` permission)***

- **playeradministration.cmuteuser ** -- Mute chat for a player ***(requires `playeradministration.access.chatmute` permission)***

- **playeradministration.cunmuteuser ** -- Unmute chat for a player ***(requires `playeradministration.access.chatmute` permission)***

- **playeradministration.freeze ** -- Freeze a player ***(requires `playeradministration.access.allowfreeze` permission)***

- **playeradministration.unfreeze ** -- Unfreeze a player ***(requires `playeradministration.access.allowfreeze` permission)***

- **playeradministration.clearuserinventory ** -- Clear the inventory of a player ***(requires `playeradministration.access.clearinventory` permission)***

- **playeradministration.resetuserblueprints ** -- Completely reset the BPs of a player ***(requires `playeradministration.access.resetblueprint` permission)***

- **playeradministration.resetusermetabolism ** -- Reset the metabolism of a player to fresh spawn state ***(requires `playeradministration.access.resetmetabolism` permission)***

- **playeradministration.recoverusermetabolism ** -- Recover the metabolism of a player to 100% ***(requires `playeradministration.access.recovermetabolism` permission)***

- **playeradministration.hurtuser  ** -- Hurt a player for a certain amount ***(requires `playeradministration.access.hurt` permission)***

- **playeradministration.killuser ** -- Kill a player ***(requires `playeradministration.access.kill` permission)***

- **playeradministration.healuser  ** -- Heal a player for a certain amount ***(requires `playeradministration.access.heal` permission)***

- **playeradministration.tptouser ** -- Teleport to a player ***(requires `playeradministration.access.teleport` permission)***

- **playeradministration.tpuser ** -- Teleport a player to you ***(requires `playeradministration.access.teleport` permission)***

- **playeradministration.spectateuser ** -- Spectate a player ***(requires `playeradministration.access.spectate` permission)*** **Note: This will kill your character by the game's design!**

- **playeradministration.viewbackpack ** -- View the backpack of a player ***(requires `backpacks.admin` permission)***

- **playeradministration.viewinventory ** -- View the inventory of a player ***(requires `inventoryviewer.allowed` permission)***

- **playeradministration.godmode ** -- Enable Godmode for a player ***(requires `godmode.admin` permission)***

- **playeradministration.ungodmode ** -- Disable Godmode for a player ***(requires `godmode.admin` permission)***

## Configuration

- **Use Permission System** -- When set to `false` the users with the `playeradministration.access.show` permission can use all actions

```json

{

  "Use Permission System": true,

  "Discord Webhook url for ban messages": "",

  "Discord Webhook url for kick messages": "",

  "Broadcast Kicks": true,

  "Broadcast Bans": true

}

```

## Localization

```json

{

  "Permission Error Text": "You do not have the required permissions to use this command.",

  "Permission Error Log Text": "{0}: Tried to execute a command requiring the '{1}' permission",

  "Kick Reason Message Text": "Administrative decision",

  "Ban Reason Message Text": "Administrative decision",

  "Protection Active Text": "Unable to perform this action, protection is enabled for this user",

  "Dead Player Error Text": "Unable to perform this action, the target player is dead",

  "Kick Broadcast Message Format": "Player {0} has been kicked: {1}",

  "Ban Broadcast Message Format": "Player {0} has been banned: {1}",

  "Never Label Text": "Never",

  "Banned Label Text": " (Banned)",

  "Dev Label Text": " (Developer)",

  "Connected Label Text": "Connected",

  "Disconnected Label Text": "Disconnected",

  "Sleeping Label Text": "Sleeping",

  "Awake Label Text": "Awake",

  "Alive Label Text": "Alive",

  "Dead Label Text": "Dead",

  "Flying Label Text": " Flying",

  "Mounted Label Text": " Mounted",

  "User Button Page Title Text": "Click a username to go to the player's control page",

  "User Page Title Format": "Control page for player '{0}'{1}",

  "Ban By ID Title Text": "Ban a user by ID",

  "Ban By ID Label Text": "User ID:",

  "Search Label Text": "Search:",

  "Player Info Label Text": "Player information:",

  "Player Actions Label Text": "Player actions:",

  "Id Label Format": "ID: {0}{1}",

  "Auth Level Label Format": "Auth level: {0}",

  "Connection Label Format": "Connection: {0}",

  "Status Label Format": "Status: {0} and {1}",

  "Flags Label Format": "Flags:{0}{1}",

  "Position Label Format": "Position: {0}",

  "Rotation Label Format": "Rotation: {0}",

  "Last Admin Cheat Label Format": "Last admin cheat: {0}",

  "Idle Time Label Format": "Idle time: {0} seconds",

  "Economics Balance Label Format": "Balance: {0} coins",

  "ServerRewards Points Label Format": "Reward points: {0}",

  "Health Label Format": "Health: {0}",

  "Calories Label Format": "Calories: {0}",

  "Hydration Label Format": "Hydration: {0}",

  "Temp Label Format": "Temperature: {0}",

  "Wetness Label Format": "Wetness: {0}",

  "Comfort Label Format": "Comfort: {0}",

  "Bleeding Label Format": "Bleeding: {0}",

  "Radiation Label Format": "Radiation: {0}",

  "Radiation Protection Label Format": "Protection: {0}",

  "Godmode Status Label Format": "Godmode active: {0}",

  "Main Tab Text": "Main",

  "Online Player Tab Text": "Online Players",

  "Offline Player Tab Text": "Offline Players",

  "Banned Player Tab Text": "Banned Players",

  "Go Button Text": "Go",

  "Unban Button Text": "Unban",

  "Ban Button Text": "Ban",

  "Kick Button Text": "Kick",

  "Reason Input Label Text": "Reason:",

  "Unmute Button Text": "Unmute",

  "Mute Button Text": "Mute",

  "Mute Button Text 15": "Mute 15 Min",

  "Mute Button Text 30": "Mute 30 Min",

  "Mute Button Text 60": "Mute 60 Min",

  "UnFreeze Button Text": "UnFreeze",

  "Freeze Button Text": "Freeze",

  "Freeze Not Installed Button Text": "Freeze Not Installed",

  "Clear Inventory Button Text": "Clear Inventory",

  "Reset Blueprints Button Text": "Reset Blueprints",

  "Reset Metabolism Button Text": "Reset Metabolism",

  "Recover Metabolism Button Text": "Recover Metabolism",

  "Teleport To Player Button Text": "Teleport To Player",

  "Teleport Player Button Text": "Teleport Player",

  "Spectate Player Button Text": "Spectate Player",

  "Perms Button Text": "Permissions",

  "Perms Not Installed Button Text": "Perms Not Installed",

  "Godmode Not Installed Button Text": "Godmode Not Installed",

  "UnGodmode Button Text": "Disable Godmode",

  "Godmode Button Text": "Enable Godmode",

  "Hurt 25 Button Text": "Hurt 25",

  "Hurt 50 Button Text": "Hurt 50",

  "Hurt 75 Button Text": "Hurt 75",

  "Hurt 100 Button Text": "Hurt 100",

  "Kill Button Text": "Kill",

  "Heal 25 Button Text": "Heal 25",

  "Heal 50 Button Text": "Heal 50",

  "Heal 75 Button Text": "Heal 75",

  "Heal 100 Button Text": "Heal 100",

  "Heal Wounds Button Text": "Heal Wounds"

}

```