Commands

Commands

In ServerGuard, there are two different ways of using commands to administrate your server. The first way is through the graphical interface by opening the menu, viewing the player list tab, and doing the respective actions there. You can also use the chat to administrate your server as well. Using the chat can be quicker than navigating through the menus, but it all comes down to your personal preference on which way you want to execute commands. If you don't know what kind of commands you can execute, you can consult the in-game list by clicking on the `Command list` category in the menu.

Command Menu

If you like looking at an eye-pleasing interface to do your administration, then we've got you covered. Hit the bound key for opening the menu that was mentioned earlier, and scroll through the categories on the left-hand side of the window until you see a category that is labelled `Manage players`. This category lists all the players that are currently connected to the server, and some information about them - such as their name, rank, Steam ID, etc. If you click on the row that contains the player you wish to administrate, a list of options should pop up. These options are the various things that you can do to the player. Clicking on the option will run the command and you'll be able to see the feedback in the chat.

Chat Commands

If you're all about the old style of administration, then you're in luck! All of the commands available in ServerGuard are able to be ran via the graphical interface, or using the standard chat commands! To do this, simply type the name of the command prefixed with an exclamation mark. So if you wanted to open the menu, you would open up the chat and type in "!menu". Commands that accept arguments can also be used in the chat. For example, the "kick" command. If you wanted to ban a person with the name Rain with the reason "Spamming grave stones, ruining roleplay", you would simply type in the command, the name of the player, the length of the ban in minutes, and then the reason: "!ban rain Spamming grave stones, ruining roleplay".

Notice that we didn't even type the name of the player exactly? ServerGuard tries to match a players with the most similar name to the one you typed. If there is a duplication, i.e: you specifying the name "bot" and there are two players on the server with the names "Bot01" and "Bot02", ServerGuard will run the command on all of the players that fit that search criteria. Some commands don't allow you to run them on more than one person. In that case, ServerGuard will notify you that there was more than one player found with that name. When this happens, try making your search term more specific. Like typing "bot01" instead of just "bot" as the name or even pasting in the user's Steam ID/IP Address/Community ID/etc. When the command successfully executes on the player(s) that you specified, there will be a message in the chat that is visible to everyone saying that you've done so and so to that player.

You can also use special identifiers to describe a group of people to run your command on. Specifying `^` as the name of your target will specify only yourself. It's just a shorthand way of writing your own name in the command. So you'd go ahead and type `!hp ^ 100` to set your health to 100. As well, you can use `*` to specify everyone, or use the `#` symbol and then the unique ID of a rank - like "administrator" to specify everyone that has the "administrator" rank (i.e `!hp #administrator 100`). You can also use `!` to negate any one special identifier. `!^` would be everyone but yourself and `!#administrator` would be everyone that doesn't have the administrator rank. You can use `!*` to specify nobody but that would be pretty redundant!

Silent Commands

Sometimes you need to execute a command without having the feedback message show up in the chat for everyone to see. We're not going to ask why, but it's there if you need to. Please note that you are unable to execute a command silently through the graphical interface; you have to use the chat. To execute a command silently, change the prefix that you insert for commands to an at symbol (`~`). For example, if you want to slap that pesky bot silently, you would type in `~slap bot`, instead of typing `!slap bot`. It's important to also note that your commands will still show up in the console and/or the logs. Silent commands aren't made to completely hide the fact you ran a command, only removing the feedback message in the chat.