Moderator Features - miawara/modmod GitHub Wiki

Aliases

  • /mv (/mod vanish)

Player Tracking

Use /track <player_name> to add a player to the tracker list, and use /track clear to clear the tracker list. Clicking on reports also automatically adds them to the tracker, sends you to their server and teleports you to them as well as alt checking their account.

Tracked players are drawn with an outline on your HUD, as well as a hit range indicator that shows their entity interaction range and turns green if any player is within their range.
(Note: this should be used only as a guide to determining if someone is reaching because it doesn't take into account ping or lag, and certain timings for attacking will appear to be outside of the players range even though its legitimate)

Screenshot from 2026-03-23 11-59-00

Punish Shortcut Screen

The default keybind for opening the moderator shortcut screen is [X], and opens a menu that lets you execute non-case-specific punishments (ie: stuff like inappropriate plot content that requires the duration to be determined on a case-by-case basis) with the punishment duration being automatically determined based on the player's punishment history. Press [Shift] to execute commands silently.

Player history is determined by matching certain keywords and regex patterns with a player's /history, which may not always be accurate as punishment reasons are not always consistent. Punishment entries that contain special formatting or characters like newline characters, or punishments given to yourself are discarded.

NOTE: The following punishments are not counted for punishment severity after 30 days:

  • Spamming [SPAMMING]
  • Plot Ad Misuse [PLOT_AD]
  • Filter Bypass [FILTER_BYPASS]

modscreenshowcase

Report Screen

The default keybind for opening the moderator shortcut screen is [O], and opens a menu that shows all recent reports while you have been connected to the server. Clicking on the report automatically runs the following commands and adds them to the player tracker:

  • /alts <name>
  • /history <name> 9999
  • /server <node>
  • /tp <name>

Additionally clicking on a report sets its status to HANDLED. If you have report_msg_hash enabled, clicking on a report will send handling report ID=$HASH where $HASH is a hash of the report data. If you recieve this message in modchat the report matching that hash will be set to handled.

Screenshot from 2026-03-29 19-41-52

⚠️ **GitHub.com Fallback** ⚠️