Features
Moderation and reports
Network-wide sanctions, warning thresholds, blacklist, history, related accounts and the report workflow in sofyCore.
The moderation module stores sanctions, history, the blacklist, report categories and the warning policy in the selected database. It has no YAML file: settings are changed with /punish config and propagated to every server. Only translations live in lang/moderation/.
Sanctions
| Type | Scope |
|---|---|
| Ban | Account, network-wide, temporary or permanent |
| IP ban | That exact IP address |
| Mute | Chat and private messages, network-wide |
| Warning | Always expires; counts toward thresholds |
| Kick | The confirmed connection |
| Blacklist | Permanent literal name or IP |
A new sanction replaces an active sanction of the same type and keeps the history.
Warning thresholds
Initial policy: warnings last seven days. Reaching three active warnings mutes for 10 minutes, and reaching five bans for one hour. Expired warnings stay in the history but no longer count. Change it with /punish config warn-duration and /punish config threshold.
An automatic consequence cannot replace a sanction issued by a higher staff member: the whole warning is refused in that case.
Hierarchy
Staff permissions default to false. A command permission is not enough: actions also require STAFF authority and a strictly higher rank than the target. Removing or replacing a sanction also checks its issuer; console-issued sanctions can only be removed by the console. Blacklist changes and module settings require OWNER or console.
History and related accounts
/history shows every sanction of a player, IP or literal name, including expired, replaced and removed ones. /staffhistory shows what a staff member did. /ips lists up to 16 recent IPs of an account and /related the accounts seen on an IP.
Reports
Players report online players with /report <player> <type> [details]. Default types are killaura, reach, fly, speed, antiknockback, xray, autoclicker and other. There is a 60-second cooldown per reporter, and the same reporter cannot report the same target again until the previous report is closed. Staff use /reports to take, release, resolve or dismiss reports; closed reports stay in history.
Helpop
/helpop <message> reaches staff with sofycore.helpop.notify on every server and the console, with a 30-second cooldown kept in Redis.
Placeholders
%sofycore_mod_banned%, %sofycore_mod_muted%, %sofycore_mod_warns_active%, %sofycore_mod_reports_open% and more. See Placeholders.