Skip to content

SpecChecker Plugin

Kicks idle spectators when the server is busy to free up player slots.

Plugin name: speccheckerRequires: iourt43 parser

Behavior

  • Tracks how long each player has been in spectator mode
  • Warns spectators at intervals before kicking
  • Only enforces when min_players are connected
  • Players at or above immune_level are exempt

Settings

toml
[[plugins]]
name = "specchecker"
enabled = true

[plugins.settings]
max_spec_time = 300
min_players = 8
warn_interval = 60
immune_level = 20
SettingTypeDefaultDescription
max_spec_timeinteger300Max spectate time in seconds (5 min)
min_playersinteger8Minimum connected players before enforcement
warn_intervalinteger60Warning interval in seconds
immune_levelinteger20Level at which players are immune (Mod+)

Events

EVT_CLIENT_TEAM_CHANGE, EVT_CLIENT_TEAM_CHANGE2, EVT_CLIENT_JOIN, EVT_CLIENT_AUTH, EVT_CLIENT_DISCONNECT, EVT_GAME_ROUND_START, EVT_GAME_ROUND_END

Released under the GPL-2.0 License.