HostModeration

Host Moderation

Fully server-side mod that enhances server moderation:

• Adds additional chat commands for facilitating moderation duties
• Adds SteamID, ConnID and name variants for moderation commands
• Allows hosts to assign operator roles to trusted users; operators can then moderate the server on their own

Operators

Operators are users that are allowed to perform moderation on the host's behalf.

As a rule, hosts are also operators, and cannot be promoted or demoted.

The commands included in this mod can only be used by operators. Additionally, moderation commands targeting operators can only be performed by the host.

Command parameters

Some commands accept either a Steam ID, connection ID or player name to match.

The connection ID is an unique identifier assigned to each connected client, and is unique per connection within a session. This is also used by vanilla Atlyss for identifying clients.

Each client also has a Steam ID assigned to it. Steam IDs are unique per player, and commands that accept Steam IDs can be used even when the target player is not connected.

Some commands also accept player name queries. In that case, the closest matching player will be selected by the command. In the case where there are multiple close matches found, you will have to use a more accurate query, or use the Steam ID or connection ID variant of that command.

Host Console

The commands are usable from the vanilla Host Console, however commands that take more than one parameter won't work correctly due to vanilla game quirks.

Prefer using the chat commands if possible.

Utility commands

Paginated list commands accept an optional page number parameter and a page size parameter.

If not specified, page number defaults to 1, and page size defaults to 7.

Page size can be between 5 and 100 elements.

/hm-help [page number] [page size]

Displays a paginated list of available commands.

/hm-clients [page number] [page size]

Displays a paginated list of currently connected clients (nickname, Steam ID and connection ID).

/hm-operators [page number] [page size]

Displays a paginated list of operators (nickname and Steam ID).

/hm-bans [page number] [page size]

Displays a paginated list of banned clients (nickname and Steam ID).

/hm-find-name

Searches for a player based on the search query and returns the closest match.

Usage example:

Player list:

• Coboa the First
• Coboa the Second
• ALLCAPSCHANG

/hm-find-name Coboa

=> Coboa the First, ConnID 0, SteamID 12345

/hm-find-name Coboa the First

=> Coboa the First, ConnID 0, SteamID 12345

/hm-find-name Coboa the First and Best

=> [No player match]

/hm-find-name the Second

=> Coboa the Second, ConnID 3, SteamID 23456

/hm-find-name allcaps

=> ALLCAPSCHANG, ConnID 16, SteamID 12043

/hm-find-name WhoTheHellIsThisGuy

=> [No player match]

Operator assignment commands

Only the host can promote and demote operators.

/hm-op

/hm-op-steam

/hm-op-conn

Promotes a client to operator by their connection ID, Steam ID or name.

If a client is banned, they need to be unbanned before promoting them to operator.

/hm-deop

/hm-deop-steam

/hm-deop-conn

Demotes a client from operator by their connection ID, Steam ID or name.

You can use /hm-operators to see which clients are operators.

Moderation commands

Operators (including the host) will be notified whenever another operator takes action against a client.

/hm-ban

/hm-ban-steam

/hm-ban-conn

Bans a client from the server by their connection ID, Steam ID or name. If they were an operator, they will also be demoted.

/hm-unban-steam

/hm-unban-id

Unbans a client from the server by their Steam ID, or by their ID (index) in the ban list.

You can use /hm-bans to see which Steam IDs were banned, and their ban index.

/hm-kick

/hm-kick-steam

/hm-kick-conn

Kicks a client from the server by their connection ID, Steam ID or name.

Unlike bans, kicking will not automatically demote operators.

/hm-warn-steam

/hm-warn-conn

Sends a warni