MurphyBan — Full Documentation
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
INSTALLATION
1. Download MurphyBan-1.0.0.jar from the resource page
2. Place it in your server's plugins/ folder
3. Start the server once — config.yml and messages.yml are generated automatically
4. Edit plugins/MurphyBan/config.yml to configure your database and policies
5. Run /murphyban reload or restart to apply changes
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
DATABASE SETUP
SQLite (default)
No setup needed. A data.db file is created automatically at plugins/MurphyBan/data.db.
MySQL
Set database.type to mysql in config.yml and fill in your credentials:
database:
type: mysql
host: your.host.net
port: 3306
name: murphyban
username: user
password: password
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
COMMANDS & PERMISSIONS
/ban <player> [duration] [reason] — murphyban.ban
/ipban <player|ip> [duration] [reason] — murphyban.ipban
/mute <player> [duration] [reason] — murphyban.mute
/kick <player> [reason] — murphyban.kick
/warn <player> [reason] — murphyban.warn
/unban <player> — murphyban.unban
/unbanip <player|ip> — murphyban.ipban
/unmute <player> — murphyban.unmute
/unwarn <player> [id] — murphyban.unwarn
/check <player> — murphyban.history
/history <player> — murphyban.history
/blame <player> — murphyban.history
/staffhistory <staff> — murphyban.history
/alts <player> — murphyban.alts
/murphyban about — no permission required
/murphyban reload — murphyban.admin
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
DURATION FORMAT
s = seconds (30s)
m = minutes (30m)
h = hours (12h)
d = days (7d)
w = weeks (2w)
mo = months (1mo)
permanent or perm = never expires
Combine units freely: 1d12h, 2w3d, 1mo15d
Omitting duration defaults to permanent.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CONFIGURATION
debug: false
Enable verbose logging. Toggle live via /murphyban reload.
database.type: sqlite or mysql
mute.command-whitelist
Commands muted players can still run. Default: register, login
alts.auto-ban: false
Automatically ban alts of banned players on join.
alts.notify-staff: true
Alert staff when an alt of a banned player joins.
warns.threshold: 3
Number of warnings before auto-punish triggers.
warns.auto-punish: mute or ban
Punishment applied when threshold is hit.
warns.auto-punish-duration: 1d
Duration of the auto-punish.
warns.expire-after: 30d
Warns older than this stop counting toward the threshold. Set to 0 to disable.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ALT DETECTION
MurphyBan records every IP a player connects from. On each login the incoming IP is checked against all banned accounts. If a match is found, all online staff with murphyban.alerts are notified immediately.
If alts.auto-ban is true, the joining player is automatically banned with reason "Alt account of <banned>" and the same expiry as the original ban.
Note: false positives are possible on shared networks (households, CG-NAT). auto-ban is disabled by default for this reason.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PLACEHOLDERAPI
%murphyban_banned% — true or false
%murphyban_banned_reason% — reason or empty
%murphyban_banned_expires% — expiry or empty
%murphyban_muted% — true or false
%murphyban_muted_reason% — reason or empty
%murphyban_muted_expires% — expiry or empty
%murphyban_warns% — active warn count
%murphyban_total_banned% — global active ban count
%murphyban_total_muted% — global active mute count
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SOURCE CODE
Full source code available on GitHub:
https://github.com/Murphycasto/MurphyBan