FH2 Admin Manual

Chat commands

Just like you're used to, you can send certain !bang commands in the game chat

When supplying a player name, partial names will work as well. (the line !warn oz will probably resolve to !warn pozzo). If there are multiple name matches, it will tell you that

“Reason” Shortcuts

Some commands like !report also can have abbreviations, so !report poz fc will be printed as !report pozzo Fighting Commander. See the current list:

"afk": "Being AFK",
"fc": "Fighting Commander",
"ftk": "Forcing Teamkills",
"gp": "Disrupting Gameplay",
"lang": "Offensive Language",
"locked": "Locked squad",
"name": "Bad Nickname",
"nazi": "Nazi bullshit",
"spam": "Spamming",
"steal": "Asset stealing",
"tk": "Teamkilling",
"troll": "Trolling",

History Shortcuts

Shortcuts reusing command history are also available:

• !!: repeat entire input
• !0: repeat command
• !@: repeat all arguments
• !$: repeat last argument

Example:

[Chat]: !warn pozzo afk
!! -> "!warn pozzo afk"
!0 -> "!warn"
!@ -> "pozzo afk"
!$ -> "afk"

Command Summary

Map Shortnames

Some maps have short abbreviations defined (see the map table ), so you can

!setnext sfakia

instead of typing out

!setnext the_battle_for_sfakia

Currently there is no partial name match, so you CANNOT !setnext sfa!

Setup

Plugin System

Plugins are enabled by default, see game/gameplayPlugin.py:

plugins_admin = [
    'BangBang',  # chat commands
    'IdleTracker',  # kick afk players
    'PlayerLogger',  # log player IDs
    'SteamRoller',  # balance and swap/shuffle
    'TeamKillLogger',  # log teamkills
    'Greeter',  # message on first spawn
    'Announcer',  # messages at regular intervals
    'VoteChat',  # messages at regular intervals
]
plugins_admin_nobots = [
    'Carousel',  # map rotation
]

plugins_admin_linux = [
    'NameChecker',  # purge nazi names
]
plugins_admin_beta = [
    'CamSetup',  # enable chasecams
]

On linux servers, you can check for squad names and playernames, if they match a (nazi) badlist.

On betatest servers, chasecams are enabled.

On servers with bots (singleplayer and coop), randomized map rotation is not available.

Map Randomizer

Maps are picked randomly from the server maplist. It will avoid running the same map twice in a row, and it will avoid running two maps of the same theatre (e.g. africa) back to back.

For randomized map rotation to work, all maps need to have a meta.toml metadata file in the level basedir (outside of the .zip files). See example for Arad:

layers = [ 16, 32, 64,]
intervals = [ [ 0, 22,], [ 23, 44,], [ 45, 100,],]
front = [ "east",]
date = "1944-09-14"
teams = [ "Germany", "Russia",]
version_added = "2.56"
authors = [ "hitm4k3r",]

“layers” is all the existing layers that a map has – if a map is missing layers in your installation (or they are WIP), remove those! You can remove them from the maplist, too, of course.

“intervals” means on 0-22 players it will pick 16p layer next, on 23-44 it will pick 32p layer, etc. these can be adjusted per map. E.g. if the last layer is [45, 75], the map will not get picked on a full (100 ppl) server.

Admin Rights

In the admins.toml file, add the admins_high, _low, and _mid lists to the [users] section, with the hashes of the admins. Example below:

[users]
# if the admin arrays are empty, 
# defaults to "everything is allowed"
admins_high = [
    "d722905f13f2e89553837ab9bbe42302",  # user a
]
admins_mid = [
    "732753cd11d331e64867057cfdc7ecd5",  # who this?
    "74598b621924620609b37a12a2473819",  # another
]
admins_low = [
    "45d8218d92cd1c3de9508ad5133a1693",  # some mod
]

Nazi Word Blacklist

Define forbidden words for usernames/squads in the badnames.toml: if anyone joins with e.g. “adolf” in the name, they get auto-banned. If you make a squad named “1488”, you get auto-kicked.

# usernames/squadnames that get you autokicked
words = [
  "adolf", "sieg heil", "siegheil",
  "waffen_ss", 
]

Main Configuration

Configuration is done in the config.toml config file.

Set debug (for more aggressive logs/warnings), and beta (to enable beta commands)

[general]
debug = true
beta = true

Messages

Configure which messages are shown.

The welcome line is displayed when you first spawn.

The rules message is displayed when someone uses the ingame !rules command.

The announce message list is a set of messages which are displayed every announce_interval seconds.

The show_disconnect setting decides whether to print a line when a player disconnects.

The show_connect setting decides whether to print a line FOR ADMINS when a player connects.

[messages]
# displayed on first spawn after join
# the <PLAYER> token will be replaced 
# with the actual player name
# if you want to disable this, put `welcome = ""`

welcome = "Welcome <PLAYER> to the FH2 Test Server!"

# short line pointing to server rules website
rules = "For Rules visit XXX"

# those will be displayed regularly 
# if you want to disable these, put `announce = []`
announce = [
  "Join us on FH2 Discord",
  "Check out fhmod.org for news",
  "We love you all <3",
  "Jean a une longue mustache honhonhon",
  "New CMP campaign is now open!",
  "Join the CMP campaign at cmp-gaming.com",
]

# if using announce, this is the interval in seconds
announce_interval = 300

# display message on disconnect. 
# recommended to only disable this if another
# "X has disconnected" print script is active in parallel
show_disconnect = true
show_connect = true

Bans and (AFK) Kicks

In this setting, configure the AFK autokicker and ban/kick related things.

The ban_duration setting configures how long a temporary ban is. Usually set at two weeks.

The AFK tracker checks every idle_check_interval seconds if a player has been active. Otherwise it kicks them. On the default settings, below a certain number of players however, players don’t get kicked but autobalanced instead, so that the server is not emptied too much.

[janitor]
# don't start kicking AFKs unless at least X players online
min_players_for_kick = 50

# if min_players_for_kick has not been reached, 
# at least balance the AFKs?
balance_afks_before_minplayers = true

# seconds until you get kicked/balanced
max_idle_time = 600
idle_check_interval = 30
idle_yaw_threshold = 0.5

# bantime in seconds
# good default is two weeks: 1209600 = 60 * 60 * 24 * 14
ban_duration = 1209600

Map Rotation

How many maps to remember when avoiding duplications. n_last_played defines how many rounds to wait until a map can be played again.

n_last_categories sets how many maps to wait until a map category (winter, urban, eastfront, africa) can repeat itself. These are setup in the per-map configuration. NOTE: it is recommended to make this at least 2 smaller than the number of available fronts!

The favorites list defines maps which maps will appear in the rotation much more frequently, e.g. newly released ones.

[maps]
# favorite maps that should 
# appear more often in the rotation
# e.g. newly released maps; 
#   favorites = ['stonne', 'flavion']
favorites = []    

# don't repeat maps
n_last_played = 12

# don't repeat theatres (africa, winter, urban, ...)
n_last_fronts = 1

Autobalancer

The SteamRoller plugin handles both auto-balancing players during the round, and swaps the teams just before round start. It’s possible to exclude certain players from being affected by autobalance:

[balance]
swap_on_start = true
protect_commander = true
protect_squadmembers = true
protect_squadleader = true
protect_admins = false

smb_difference = 1

The smb_difference tells how big the difference between teams needs to be to trigger balancing.

HUD

FH2.6 introduces a new message system, where admin/gameplay messages are no longer buried in the killfeed. Important messages are also localized. If you would like the old behavior, or are running this on a pre-2.6 server, disable this.

[hud]
use_new_format = true

Stats API

Config for the stats API that the PlayFH2 server uses (contact them for questions)

[stats_api]
enabled = true
backend_url = ""
token = ""

Voting

You can start votes to reroll the next map, or run the nextmap. To cast a vote, write !yes or !no in chat.

[voting]
vote_runnext_allowed = true
vote_reroll_allowed = true

# vote duration and time between notifications (all seconds)
notify_period = 14
vote_duration = 60