WolfAdmin

On this page you find an overview of WolfAdmin's features and how to use them.

Table of contents
  1. Installation modes added in 1.2.0
  2. Access control lists standalone added in 1.2.0
  3. Commands
    1. Chat
      1. Information commands
      2. Player commands
      3. Team commands
      4. Match commands
      5. Voting commands
      6. Bot commands
      7. Server commands
    2. Console
    3. Server
  4. Voting
    1. New options
    2. Restrictions
    3. Menu

Support & bugs

In case you run into trouble and need support for WolfAdmin, check out the #wolfadmin IRC channel on Quakenet. You may also contact me via mail or via one of the communities where I usually hang around.

For bug reports or feature requests, please use the bug tracker.

Installation modes added in 1.2.0

Most of the frequently used mods have built-in support for Lua modules such as WolfAdmin. However, some of these mods also have an administration system called shrubbot that is enabled by default. In this case, WolfAdmin is able to run in two modes: standalone or add-on. In standalone mode, WolfAdmin will take care of all the administration; while in add-on mode, WolfAdmin will add to the features that shrubbot already offers.

Starting with version 1.2.0, it is possible to run WolfAdmin without shrubbot as well. Due to the addition of the access control lists system, levels and admins are not being tracked by shrubbot, but instead by WolfAdmin itself. In addition to this, many of shrubbot's commands are rewritten in Lua.

Because some functionality is only available in standalone mode (and some only in add-on mode), blue labels are added in the documentation for the sake of readability. standalone and add-on denote functionality that is available in standalone mode and add-on mode, respectively.

For more information on enabling or disabling standalone mode, see the relevant section on the setup page.

Access control lists standalone added in 1.2.0

WolfAdmin improves on shrubbot by entirely replacing the flags system. Rather than editing a configuration file, all levels and administrators are now stored in a database in so-called access control lists (ACLs). Each command or feature is associated to a role (e.g. !help requires the role help) rather than a shrubbot flag. ACLs are basically feature permissions grouped together in a list (level).

Anyone with access to the acl command is able to read and modify the ACLs that are available on a server, for example to create new roles (for custom features) or to add/remove roles from a certain level.

For more information on configuring ACLs, see the relevant section on the configuration page.

This system is only enabled in standalone mode.

Commands

The set of commands which is offered by the most used mods is usually just not enough. For this reason, WolfAdmin contains another set of commands on top of those. These behave exactly the same as the commands you are used to: they have their own shrubbot flags, the usual syntax and they can be used from (fire)team chat and console. Additionally, it is also possible to easily add your own Lua commands.

Chat

The following commands can be executed in the chat or through a client's console.

Information commands

!help
display commands available to you or help on a specific command
syntax: !help (command)
flag: h
role: help

!admintest standalone
display your current admin level
syntax: !admintest
flag: a
role: admintest

!greeting
display your personal greeting, if you have one
syntax: !greeting
flag: Q
role: greeting

!rules
display the rules on the server
syntax: !rules (rule)
flag: C
role: listrules

!stats
display the statistics for a specific player
syntax: !stats [name|slot #]
flag: I
role: liststats

!sprees
display the current spree records
syntax: !sprees
flag: I
role: listsprees

!listmaps
display the maps in the rotation
syntax: !listmaps
flag: I
role: listmaps

!time
displays the local time
syntax: !time
flag: C
role: time

Player commands

!listplayers standalone
display a list of connected players, their slot numbers as well as their admin levels
syntax: !listplayers
flag: i
role: listplayers

!finger standalone
gives specific information about a player
syntax: !finger [name|slot #]
flag: f
role: finger

!listaliases
display all known aliases for a player
syntax: !listaliases [name|slot #] (offset)
flag: f
role: listaliases

!listlevels removed in 1.2.0
list a player's level history
syntax: !listlevels [name|slot #] (offset)
flag: s

!showwarns
display warnings for a specific player
syntax: !showwarns [name|slot #] (offset)
flag: R
role:

!showhistory added in 1.2.0
display history for a specific player
syntax: !showhistory [name|slot #] (offset)
flag: f
role:

!dewarn removed 1.2.0
remove a warning for a certain player
syntax: !dewarn [name|slot #] [warn #]
flag: R

!showbans standalone
display a (partial) list of active bans
syntax: !showbans (start at ban#) ((banner) (banner's name)) ((find) (banned player)) ((reason) (reason for ban))
flag: B
role: listbans

!warn standalone
warns a player by displaying the reason
syntax: !warn [name|slot #] (reason)
flag: R
role: warn

!put standalone
locks a player to a specific team
syntax: !put [name|slot #]
flag: p
role: put

!mute standalone
mutes a player (text and voice chat)
syntax: !mute [name|slot #]
flag: m
role: mute

!unmute standalone
unmutes a player (text and voice chat)
syntax: !unmute [name|slot #]
flag: m
role: mute

!vmute
mutes a player (voice chat only)
syntax: !vmute [name|slot #]
flag: m
role: mute

!vunmute
unmutes a player (voice chat only)
syntax: !vunmute [name|slot #]
flag: m
role: mute

!plock
locks a player to a specific team
syntax: !plock [name|slot #]
flag: K
role: lockplayer

!punlock
unlocks a player
syntax: !punlock [name|slot #]
flag: K
role: lockplayer

!kick standalone
kick a player with an optional reason
syntax: !kick [name|slot#] (reason)
flag: k
role: kick

!ban standalone
ban a player with an optional duration and reason
syntax: !ban [name|slot#] (duration) (reason)
flag: b
role: ban

!unban standalone
unbans a player specified ban number as seen in !showbans
syntax: !ban [ban#]
flag: b
role: ban

!slap standalone
give a player a specified amount of damage for a specified reason
syntax: !slap [name|slot#] (damage) (reason)
flag: A
role: slap

!gib standalone
instantly gibs a player
syntax: !gib [name|slot#]
flag: g
role: gib

!setlevel standalone
sets the admin level of a player
syntax: !setlevel [name|slot#] [level]
flag: s
role: setlevel

!incognito
fakes your level to guest (no aka)
syntax: !incognito
flag: s
role: incognito

Team commands

!balance
either asks the players to even up or evens them by moving or shuffling players
syntax: !balance (enable|disable|force) 1.1.0+
syntax: !balance (force) 1.0.0-1.1.0
flag: p
role: balance

!lock standalone
lock one or all of the teams from players joining
syntax: !lock [r|b|s|all]
flag: L
role: lockteam

!unlock standalone
unlock one or all locked teams
syntax: !unlock [r|b|s|all]
flag: L
role: lockteam

!shuffle standalone
shuffle the teams by XP to try and even them
syntax: !shuffle
flag: S
role: shuffle

!shufflesr standalone legacy
shuffle the teams by Skill Rating to try and even them
syntax: !shufflesr
flag: S
role: shuffle

!spec999 standalone
moves 999 pingers to the spectator team
syntax: !spec999
flag: P
role: spec999

!swap standalone
swap teams
syntax: !swap
flag: w
role: swap

Match commands

!cointoss standalone
flips a coin
syntax: !cointoss
flag: q
role: cointoss

!nextmap standalone
loads the next map
syntax: !nextmap
flag: n
role: nextmap

!pause standalone
pauses the game for all players
syntax: !pause
flag: Z
role: pause

!unpause standalone
unpauses the game for all players
syntax: !unpause
flag: Z
role: pause

!reset standalone
resets the current match
syntax: !reset
flag: r
role: restart

!restart standalone
restarts the current map
syntax: !restart
flag: r
role: restart

Voting commands

!enablevote
enables next map voting
syntax: !enablevote
flag: c
role: enablevote

Bot commands

!needbots
adds bots to the game
syntax: !needbots
flag: O
role: botadmin

!kickbots
kicks all bots from the game
syntax: !kickbots
flag: O
role: botadmin

!putbots
puts all bots into a specific team
syntax: !putbots [r|b|s]
flag: p
role: botadmin

Server commands

!readconfig standalone
reloads the config file
syntax: !readconfig
flag: G
role: readconfig

!listlevels removed in 1.2.0
display all levels on the server
syntax: !listlevels
flag: s

!resetsprees
resets the spree records of the current map, or all maps if desired
syntax: !resetsprees (all) 1.0.1+
syntax: !resetsprees 1.0.0-1.0.1
flag: G
role: readconfig

For a full list of shrubbot flags, see the shrubbot flags section.

Console

The following commands can only be executed through a client's console.

/wolfadmin
display information about WolfAdmin
syntax: /about
flag: (none)

/r added in 1.0.1
reply to a private message
syntax: /r [message]
flag: (none)

/adminchat (shortcut /ac)
send a message to all admins online (players who can use admin chat)
syntax: /adminchat (text)
flag: ~

For a full list of shrubbot flags, see the shrubbot flags section.

Server

These commands can be executed on the server's console or through a remote console (RCON) connection.

acl standalone added in 1.2.0
modify the access control lists on the server, see the relevant section on the configuration page for more details.
syntax: acl [action]

Voting

WolfAdmin provides you with a new set of voting options. This allows players to adjust the game's settings, for example when there are no administrators online.

New options

/callvote poll enable bots
enable bots on the server

/callvote poll disable bots
disable bots on the server

/callvote poll put bots [axis|allies]
put bots to the selected team

/callvote poll set bot difficulty [poorest|very poor|poor|easy frag|standard|professional|uber] 1.2.0+
/callvote poll set bot difficulty [normal|hard|epic] 1.0.0-1.1.x
set the difficulty of the bots

Restrictions

It is now possible to restrict votes to a certain group of players. Only players who have the % flag will be allowed to call the votes specified in g_restrictedVotes. Currently it is only possible to restrict the default voting options - the above options by WolfAdmin are not yet supported.

Menu

Together with WolfAdmin comes a custom menu for the newly added voting options. This is provided via the wolfadmin.pk3. However, if your server already has such a menu, it may not work. To fix this, please add the following line in your own menu (in /ui/menus.txt):

// WolfAdmin
loadMenu { "ui/ingame_vote_wolfadmin.menu")