![](https://i.imgur.com/0o0rruV.png) # BanHammer Simple, customisable punishment utility mod for Fabric. Allows moderators to permanently/temporary ban, mute or kick players. Supports [Fabric Permissions API](https://github.com/lucko/fabric-permissions-api) used by LuckPerms and PlayerRoles. Every user facing message is configurable with support of [advanced formatting](https://github.com/Patbox/FabricPlaceholderAPI/blob/1.17/TEXT_FORMATTING.md) It has build in support for SQLite and MySQL databases. ## Commands and permissions | Command | Permission | Description | | ------------------ | ------------------------ | --------------------------------- | | /banhammer | banhammer.commands.main (default) | Sends information about banhammer | | /banhammer reload | banhammer.commands.reload (op 4) | Reloads mods config | | /banhammer import \ \[\\] | banhammer.commands.import (op 4) | Imports bans from other sources (and removes them from it, if remove is set to true) | /ban \ \[\] | banhammer.punish.ban (op 3/config) | Bans player | | /tempban \ \ \[\] | banhammer.punish.tempban (op 3/config) | Bans player for provided time | | /ban-ip \ \[\] | banhammer.punish.banip (op 3/config) | Bans player (by ip) | | /tempban-ip \ \ \[\] | banhammer.punish.tempbanip (op 3/config) | Bans player (by ip) for provided time | | /mute \ \[\] | banhammer.punish.mute (op 3/config) | Mutes player | | /tempmute \ \ \[\] | banhammer.punish.tempmute (op 1) | Mutes player for provided time | | /kick \ \[\] | banhammer.punish.kick (op 3/config) | Kicks player from server | | /unban \ | banhammer.unpunish.unban (op 3/config) | Removes player's (temp)bans | | /unban-ip \ | banhammer.unpunish.unbanip (op 3/config) | Removes player's (temp)ip bans | | /unmutes \ | banhammer.unpunish.unmute (op 3/config) | Removes player's (temp)mute | | /pardon \ | banhammer.unpunish.pardon (op 3/config) | Removes all of player's punishments | Additionally you can add `-s` Before reason, if you want to make that punishment silent. Duration can be expressed in seconds (`15`/`15s`), minutes (`3m`), hours (`24h`), days (`7d`), years (`1y`) or any combination of these (`5y3d9h3m8s`). ## Configuration ```json5 { "CONFIG_VERSION_DONT_TOUCH_THIS": 1, "punishmentsAreSilent": false, // Makes all punishments silent "storeAllPunishmentsInHistory": true, // Stores all punishments in additional database table "muteBlockedCommands": [ // List of commands blocked to muted players "msg", "me" ], "standardBanPlayersWithBannedIps": false, // Gives users standard bans, when they are ip banned "autoBansFromIpBansAreSilent": true, // Makes autobans from ip ban silent "defaultTempPunishmentDurationLimit": "-1",// Sets limit for duration of temporary punishments. -1 = no limit "permissionTempLimit": { // Allows to change duration limit of punishment with `banhammer.duration.` permission "example": "31d" }, "databaseType": "sqlite", // Changes database type ("sqlite" or "mysql") "sqliteDatabaseLocation": "banhammer-sqlite.db", // sqlite databases location (from server's directory) "mysqlDatabaseAddress": "", // Address of mysql database "mysqlDatabaseName": "", // Name of mysql database "mysqlDatabaseUsername": "", // Username of mysql user "mysqlDatabasePassword": "" // Password of mysql user } ```