Banlist

⭐ This plugin is private! Can be purchased on our Discord Marketplace.

It serves as an addon for the 3 most used Admin System plugins. Used to display the latest bans, mutes or gags. You can also view a player's penalties/punishment history, such as bans, mutes and gags. You can search for player penalties by name, steamid or Discord account.

Supported Admin Systems:

How to view a banlist or player's history:

  1. Using the slash command for banlist or punishments

  2. Using the button in the Servers Status module (Displays total banlist)

  3. Using the button in the Report/Calladmin module (Displays player penalties)

⚠️You only need to have this plugin installed on one server! Do not upload this plugin to multiple servers if you use the same BOT on each server!

Config Preview

For SimpleAdmin plugin
{
  "Date Time Format": "yyyy-MM-dd HH:mm:ss",
  "Database Connection": {
    "Host": "",
    "Port": 3306,
    "User": "",
    "Database": "",
    "Password": ""
  },
  "Banlist Command": {
    "Enabled": true,
    "Required Roles": [],
    "Command Name": "banlist",
    "Command Description": "View all players punishments"
  },
  "Punishments Command": {
    "Enabled": true,
    "Required Roles": [],
    "Command Name": "punishments",
    "Command Description": "Search a player's punishments",
    "Search By Name Option": {
      "Enabled": true,
      "PlayerName Option Name": "name",
      "PlayerName Option Description": "Player's name"
    },
    "Search By SteamID Option": {
      "Enabled": true,
      "PlayerSteamID Option Name": "steamid",
      "PlayerSteamID Option Description": "Player's SteamID"
    },
    "Search By Discord User Option": {
      "Enabled": true,
      "DiscordUser Option Name": "user",
      "DiscordUser Option Description": "Player's Discord Name"
    }
  },
  "Response Embeds": {
    "Display Ban Data": {
      "Content": "",
      "Title": "Ban Info",
      "Description": "> 👤 Player: **{BAN_PLAYERNAME}** `{BAN_PLAYERSTEAMID}`
> 📝 Reason: `{BAN_REASON}`

",
      "Fields": "🛡️ Admin;[`{BAN_ADMINNAME}`](http://steamcommunity.com/profiles/{BAN_ADMINSTEAMID});true|🕒 Duration;`{BAN_DURATION}`;true|Created;`{BAN_CREATED}`;false|Ends;`{BAN_ENDS}`;true|Status;`{BAN_STATUS}` {BAN_STATUSEMOJI};true",
      "Thumbnail": "",
      "Image": "",
      "HEX Color": "#ff5050",
      "Footer": "",
      "Footer Timestamp": false
    },
    "Display Mute Data": {
      "Content": "",
      "Title": "Mute Info",
      "Description": "> 👤 Player: **{MUTE_PLAYERNAME}** `{MUTE_PLAYERSTEAMID}`
> 📝 Reason: `{MUTE_REASON}`
> 🔍 Type: `{MUTE_TYPE}` {MUTE_TYPEEMOJI}

",
      "Fields": "🛡️ Admin;[`{MUTE_ADMINNAME}`](http://steamcommunity.com/profiles/{MUTE_ADMINSTEAMID});true|🕒 Duration;`{MUTE_DURATION}`;true|Created;`{MUTE_CREATED}`;false|Ends;`{MUTE_ENDS}`;true|Status;`{MUTE_STATUS}` {MUTE_STATUSEMOJI};true",
      "Thumbnail": "",
      "Image": "",
      "HEX Color": "#ffa366",
      "Footer": "",
      "Footer Timestamp": false
    },
    "Last Punishments": {
      "Content": "",
      "Title": "⛔ Banlist",
      "Description": "> Total Bans: `{TOTALBANS}`
> Total Mutes & Gags: `{TOTALMUTES}`",
      "Fields": "",
      "Thumbnail": "",
      "Image": "",
      "HEX Color": "#66ccff",
      "Footer": "",
      "Footer Timestamp": false,
      "Bans Menu": {
        "Label": "{BAN_PLAYERNAME} (Created: {BAN_CREATED})",
        "Description": "Duration: {BAN_DURATION} ({BAN_STATUS})"
      },
      "Mutes Menu": {
        "Label": "{MUTE_PLAYERNAME} (Created: {MUTE_CREATED})",
        "Description": "Duration: {MUTE_DURATION} ({MUTE_STATUS}) | Type: {MUTE_TYPE}"
      }
    },
    "Player Punishments": {
      "Content": "",
      "Title": "⛔ Banlist • Player Punishments",
      "Description": "> SteamID: `{STEAMID}`
> Total Bans: `{PLAYERBANS}`
> Total Mutes & Gags: `{PLAYERMUTES}`
> Discord: `{DiscordUser.DisplayName}` (<@{DiscordUser.ID}>)",
      "Fields": "",
      "Thumbnail": "",
      "Image": "",
      "HEX Color": "#ff4d4d",
      "Footer": "",
      "Footer Timestamp": false,
      "Bans Menu": {
        "Label": "{BAN_PLAYERNAME} (Created: {BAN_CREATED})",
        "Description": "Duration: {BAN_DURATION} ({BAN_STATUS})"
      },
      "Mutes Menu": {
        "Label": "{MUTE_PLAYERNAME} (Created: {MUTE_CREATED})",
        "Description": "Duration: {MUTE_DURATION} ({MUTE_STATUS}) | Type: {MUTE_TYPE}"
      }
    },
    "Player Has No Punishments": {
      "Content": "",
      "Title": "",
      "Description": "> Player with SteamID `{STEAMID}` has no punishments",
      "Fields": "",
      "Thumbnail": "",
      "Image": "",
      "HEX Color": "#ff0066",
      "Footer": "",
      "Footer Timestamp": false
    },
    "Results Found": {
      "Content": "",
      "Title": "",
      "Description": "> Multiple results were found for `{VALUE}` (Results: {TOTALRESULTS})

> ⬇️ Select a player from the list below ⬇️",
      "Fields": "",
      "Thumbnail": "",
      "Image": "",
      "HEX Color": "#ffcc00",
      "Footer": "",
      "Footer Timestamp": false
    },
    "No Results Found": {
      "Content": "",
      "Title": "",
      "Description": "> No results found for `{VALUE}`",
      "Fields": "",
      "Thumbnail": "",
      "Image": "",
      "HEX Color": "#ff0000",
      "Footer": "",
      "Footer Timestamp": false
    },
    "Missing Permissions": {
      "Content": "",
      "Title": "",
      "Description": "> You do not have permissions for this command!",
      "Fields": "",
      "Thumbnail": "",
      "Image": "",
      "HEX Color": "#ff4d4d",
      "Footer": "",
      "Footer Timestamp": false
    },
    "Player Is Not Linked": {
      "Content": "",
      "Title": "",
      "Description": "> User <@{DiscordUser.ID}> does not have an account linked to steam!",
      "Fields": "",
      "Thumbnail": "",
      "Image": "",
      "HEX Color": "#ff6666",
      "Footer": "",
      "Footer Timestamp": false
    },
    "Invalid Format": {
      "Content": "",
      "Title": "",
      "Description": "> Invalid Format! You must complete one of the options!",
      "Fields": "",
      "Thumbnail": "",
      "Image": "",
      "HEX Color": "#ff6666",
      "Footer": "",
      "Footer Timestamp": false
    }
  },
  "Menu Translations": {
    "Select Ban": "Select a ban",
    "Select Mute": "Select a mute",
    "Select Player": "Select a player",
    "Permanent": "PERMANENT",
    "Player Name Not Found": "NULL",
    "Player SteamID Not Found": "NULL",
    "Player IP Not Found": "NULL",
    "Minutes": "Minutes",
    "Hours": "Hour/s",
    "Days": "Day/s",
    "Active": "Active",
    "Expired": "Expired",
    "Unbanned": "Unbanned",
    "Gag": "GAG",
    "Mute": "MUTE",
    "Silence": "SILENCE"
  },
  "Status Emoji": {
    "Active": ":red_circle:",
    "Expired": ":green_circle:",
    "Unbanned": ":yellow_circle:"
  },
  "Mute Type Emoji": {
    "Gag": ":pencil2:",
    "Mute": ":microphone2:",
    "Silence": ":headphones:"
  },
  "ConfigVersion": 1
}
For Iks Admin and Pisex Bans
{
  "Date Time Format": "yyyy-MM-dd HH:mm:ss",
  "Database Connection": {
    "Host": "",
    "Port": 3306,
    "User": "",
    "Database": "",
    "Password": ""
  },
  "Banlist Command": {
    "Enabled": true,
    "Required Roles": [],
    "Command Name": "banlist",
    "Command Description": "View all players punishments"
  },
  "Punishments Command": {
    "Enabled": true,
    "Required Roles": [],
    "Command Name": "punishments",
    "Command Description": "Search a player's punishments",
    "Search By Name Option": {
      "Enabled": true,
      "PlayerName Option Name": "name",
      "PlayerName Option Description": "Player's name"
    },
    "Search By SteamID Option": {
      "Enabled": true,
      "PlayerSteamID Option Name": "steamid",
      "PlayerSteamID Option Description": "Player's SteamID"
    },
    "Search By Discord User Option": {
      "Enabled": true,
      "DiscordUser Option Name": "user",
      "DiscordUser Option Description": "Player's Discord Name"
    }
  },
  "Response Embeds": {
    "Display Ban Data": {
      "Content": "",
      "Title": "Ban Info",
      "Description": "> 👤 Player: **{BAN_PLAYERNAME}** `{BAN_PLAYERSTEAMID}`
> 📝 Reason: `{BAN_REASON}`",
      "Fields": "🛡️ Admin;[`{BAN_ADMINNAME}`](http://steamcommunity.com/profiles/{BAN_ADMINSTEAMID});true|🕒 Duration;`{BAN_DURATION}`;true|Created;`{BAN_CREATED}`;false|Ends;`{BAN_ENDS}`;true|Status;`{BAN_STATUS}` {BAN_STATUSEMOJI};true",
      "Thumbnail": "",
      "Image": "",
      "HEX Color": "#ff5050",
      "Footer": "",
      "Footer Timestamp": false
    },
    "Display Mute Data": {
      "Content": "",
      "Title": "Mute Info",
      "Description": "> 👤 Player: **{MUTE_PLAYERNAME}** `{MUTE_PLAYERSTEAMID}`
> 📝 Reason: `{MUTE_REASON}`",
      "Fields": "🛡️ Admin;[`{MUTE_ADMINNAME}`](http://steamcommunity.com/profiles/{MUTE_ADMINSTEAMID});true|🕒 Duration;`{MUTE_DURATION}`;true|Created;`{MUTE_CREATED}`;false|Ends;`{MUTE_ENDS}`;true|Status;`{MUTE_STATUS}` {MUTE_STATUSEMOJI};true",
      "Thumbnail": "",
      "Image": "",
      "HEX Color": "#ffa366",
      "Footer": "",
      "Footer Timestamp": false
    },
    "Display Gag Data": {
      "Content": "",
      "Title": "Gag Info",
      "Description": "> 👤 Player: **{GAG_PLAYERNAME}** `{GAG_PLAYERSTEAMID}`
> 📝 Reason: `{GAG_REASON}`",
      "Fields": "🛡️ Admin;[`{GAG_ADMINNAME}`](http://steamcommunity.com/profiles/{GAG_ADMINSTEAMID});true|🕒 Duration;`{GAG_DURATION}`;true|Created;`{GAG_CREATED}`;false|Ends;`{GAG_ENDS}`;true|Status;`{GAG_STATUS}` {GAG_STATUSEMOJI};true",
      "Thumbnail": "",
      "Image": "",
      "HEX Color": "#ffa366",
      "Footer": "",
      "Footer Timestamp": false
    },
    "Last Punishments": {
      "Content": "",
      "Title": "⛔ Banlist",
      "Description": "> Total Bans: `{TOTALBANS}`
> Total Mutes & Gags: `{TOTALMUTES}`",
      "Fields": "",
      "Thumbnail": "",
      "Image": "",
      "HEX Color": "#66ccff",
      "Footer": "",
      "Footer Timestamp": false,
      "Bans Menu": {
        "Label": "{BAN_PLAYERNAME} (Created: {BAN_CREATED})",
        "Description": "Duration: {BAN_DURATION} ({BAN_STATUS})"
      },
      "Mutes Menu": {
        "Label": "{MUTE_PLAYERNAME} (Created: {MUTE_CREATED})",
        "Description": "Duration: {MUTE_DURATION} ({MUTE_STATUS})"
      },
      "Gags Menu": {
        "Label": "{GAG_PLAYERNAME} (Created: {GAG_CREATED})",
        "Description": "Duration: {GAG_DURATION} ({GAG_STATUS})"
      }
    },
    "Player Punishments": {
      "Content": "",
      "Title": "⛔ Banlist • Player Punishments",
      "Description": "> SteamID: `{STEAMID}`
> Total Bans: `{PLAYERBANS}`
> Total Mutes `{PLAYERMUTES}`
> Total Gags `{PLAYERGAGS}`
> Discord: `{DiscordUser.DisplayName}` (<@{DiscordUser.ID}>)",
      "Fields": "",
      "Thumbnail": "",
      "Image": "",
      "HEX Color": "#ff4d4d",
      "Footer": "",
      "Footer Timestamp": false,
      "Bans Menu": {
        "Label": "{BAN_PLAYERNAME} (Created: {BAN_CREATED})",
        "Description": "Duration: {BAN_DURATION} ({BAN_STATUS})"
      },
      "Mutes Menu": {
        "Label": "{MUTE_PLAYERNAME} (Created: {MUTE_CREATED})",
        "Description": "Duration: {MUTE_DURATION} ({MUTE_STATUS})"
      },
      "Gags Menu": {
        "Label": "{GAG_PLAYERNAME} (Created: {GAG_CREATED})",
        "Description": "Duration: {GAG_DURATION} ({GAG_STATUS})"
      }
    },
    "Player Has No Punishments": {
      "Content": "",
      "Title": "",
      "Description": "> Player with SteamID `{STEAMID}` has no punishments",
      "Fields": "",
      "Thumbnail": "",
      "Image": "",
      "HEX Color": "#ff0066",
      "Footer": "",
      "Footer Timestamp": false
    },
    "Results Found": {
      "Content": "",
      "Title": "",
      "Description": "> Multiple results were found for `{VALUE}` (Results: {TOTALRESULTS})

> ⬇️ Select a player from the list below ⬇️",
      "Fields": "",
      "Thumbnail": "",
      "Image": "",
      "HEX Color": "#ffcc00",
      "Footer": "",
      "Footer Timestamp": false
    },
    "No Results Found": {
      "Content": "",
      "Title": "",
      "Description": "> No results found for `{VALUE}`",
      "Fields": "",
      "Thumbnail": "",
      "Image": "",
      "HEX Color": "#ff0000",
      "Footer": "",
      "Footer Timestamp": false
    },
    "Missing Permissions": {
      "Content": "",
      "Title": "",
      "Description": "> You do not have permissions for this command!",
      "Fields": "",
      "Thumbnail": "",
      "Image": "",
      "HEX Color": "#ff4d4d",
      "Footer": "",
      "Footer Timestamp": false
    },
    "Player Is Not Linked": {
      "Content": "",
      "Title": "",
      "Description": "> User <@{DiscordUser.ID}> does not have an account linked to steam!",
      "Fields": "",
      "Thumbnail": "",
      "Image": "",
      "HEX Color": "#ff6666",
      "Footer": "",
      "Footer Timestamp": false
    },
    "Invalid Format": {
      "Content": "",
      "Title": "",
      "Description": "> Invalid Format! You must complete one of the options!",
      "Fields": "",
      "Thumbnail": "",
      "Image": "",
      "HEX Color": "#ff6666",
      "Footer": "",
      "Footer Timestamp": false
    }
  },
  "Menu Translations": {
    "Select Ban": "Select a ban",
    "Select Mute": "Select a mute",
    "Select Player": "Select a player",
    "Permanent": "PERMANENT",
    "Player Name Not Found": "NULL",
    "Player SteamID Not Found": "NULL",
    "Player IP Not Found": "NULL",
    "Minutes": "Minutes",
    "Hours": "Hour/s",
    "Days": "Day/s",
    "Active": "Active",
    "Expired": "Expired",
    "Unbanned": "Unbanned"
  },
  "Status Emoji": {
    "Active": ":red_circle:",
    "Expired": ":green_circle:",
    "Unbanned": ":yellow_circle:"
  },
  "ConfigVersion": 1
}

Embed Variables for individual Admin Systems:

Simple Admin - Embed Variables

For Bans: - {BAN_ID} - {BAN_PLAYERNAME} - {BAN_PLAYERSTEAMID} - {BAN_PLAYERIP} - {BAN_ADMINNAME} - {BAN_ADMINSTEAMID} - {BAN_DURATION} - {BAN_CREATED} - {BAN_ENDS} - {BAN_REASON} - {BAN_SERVERNAME} - {BAN_UNBANID} - {BAN_STATUS} - {BAN_STATUSEMOJI} For Mutes: - {MUTE_ID} - {MUTE_PLAYERNAME} - {MUTE_PLAYERSTEAMID} - {MUTE_ADMINNAME} - {MUTE_ADMINSTEAMID} - {MUTE_DURATION} - {MUTE_CREATED} - {MUTE_ENDS} - {MUTE_REASON} - {MUTE_SERVERNAME} - {MUTE_UNMUTEID} - {MUTE_STATUS} - {MUTE_STATUSEMOJI} - {MUTE_TYPE} - {MUTE_TYPEEMOJI}

Iks Admin - Embed Variables

For Bans: - {BAN_ID} - {BAN_PLAYERNAME} - {BAN_PLAYERSTEAMID} - {BAN_PLAYERIP} - {BAN_ADMINNAME} - {BAN_ADMINSTEAMID} - {BAN_DURATION} - {BAN_CREATED} - {BAN_ENDS} - {BAN_REASON} - {BAN_STATUS} - {BAN_STATUSEMOJI} For Mutes: - {MUTE_ID} - {MUTE_PLAYERNAME} - {MUTE_PLAYERSTEAMID} - {MUTE_ADMINNAME} - {MUTE_ADMINSTEAMID} - {MUTE_DURATION} - {MUTE_CREATED} - {MUTE_ENDS} - {MUTE_REASON} - {MUTE_STATUS} - {MUTE_STATUSEMOJI} - {MUTE_SERVERID} For Gags: - {GAG_ID} - {GAG_PLAYERNAME} - {GAG_PLAYERSTEAMID} - {GAG_ADMINNAME} - {GAG_ADMINSTEAMID} - {GAG_DURATION} - {GAG_CREATED} - {GAG_ENDS} - {GAG_REASON} - {GAG_STATUS} - {GAG_STATUSEMOJI} - {GAG_SERVERID}

Pisex Bans - Embed Variables

For Bans: - {BAN_ID} - {BAN_PLAYERNAME} - {BAN_PLAYERSTEAMID} - {BAN_ADMINNAME} - {BAN_ADMINSTEAMID} - {BAN_DURATION} - {BAN_CREATED} - {BAN_ENDS} - {BAN_REASON} - {BAN_STATUS} - {BAN_STATUSEMOJI} For Mutes: - {MUTE_ID} - {MUTE_PLAYERNAME} - {MUTE_PLAYERSTEAMID} - {MUTE_ADMINNAME} - {MUTE_ADMINSTEAMID} - {MUTE_DURATION} - {MUTE_CREATED} - {MUTE_ENDS} - {MUTE_REASON} - {MUTE_STATUS} - {MUTE_STATUSEMOJI} For Gags: - {GAG_ID} - {GAG_PLAYERNAME} - {GAG_PLAYERSTEAMID} - {GAG_ADMINNAME} - {GAG_ADMINSTEAMID} - {GAG_DURATION} - {GAG_CREATED} - {GAG_ENDS} - {GAG_REASON} - {GAG_STATUS} - {GAG_STATUSEMOJI}

Last updated