# Banlist

{% hint style="danger" %}
⭐ This plugin is private! Can be purchased on our [Discord Marketplace](https://discord.com/invite/Tzmq98gwqF).
{% endhint %}

{% hint style="info" %}
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.<br>

#### Supported Admin Systems:

* [SimpleAdmin](https://github.com/daffyyyy/CS2-SimpleAdmin) (by Daffy)
* [Iks Admin](https://github.com/Iksix/Iks_Admin) (by Iks)
* [cs2-bans](https://github.com/Pisex/cs2-bans) (by Pisex)

#### 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)\ <br>

⚠️<mark style="color:yellow;">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!</mark>
{% endhint %}

### Config Preview

<details>

<summary>For <a href="https://github.com/daffyyyy/CS2-SimpleAdmin">SimpleAdmin</a> plugin</summary>

```
{
  "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
}
```

</details>

<details>

<summary>For <a href="https://github.com/Iksix/Iks_Admin">Iks Admin</a> and <a href="https://github.com/Pisex/cs2-bans">Pisex Bans</a></summary>

```
{
  "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
}
```

</details>

{% embed url="<https://www.youtube.com/watch?v=j9qe8a-KTSo>" %}

<div><figure><img src="https://799349702-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrczaiIR8LCIvnID1U1Ty%2Fuploads%2Fq4hL7SimK3Q7kWUDku2F%2FBanlist_ban.png?alt=media&#x26;token=fec78726-87f3-404f-b5b8-a82a37748cd2" alt=""><figcaption></figcaption></figure> <figure><img src="https://799349702-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrczaiIR8LCIvnID1U1Ty%2Fuploads%2F8iKkAWzeeIGqCnHSSjbQ%2FBanlist_mute.png?alt=media&#x26;token=e5ddb8ab-abca-44e8-868a-cdd9bf2895ca" alt=""><figcaption></figcaption></figure> <figure><img src="https://799349702-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrczaiIR8LCIvnID1U1Ty%2Fuploads%2FOpyRMiAOhGT4WkQ7ouBO%2FBanlist_player.png?alt=media&#x26;token=362c030b-17e7-4479-a2d0-a500390156ac" alt=""><figcaption></figcaption></figure></div>

### Embed Variables for individual Admin Systems:

<details>

<summary>Simple Admin - Embed Variables</summary>

**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}

</details>

<details>

<summary>Iks Admin - Embed Variables</summary>

**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}

</details>

<details>

<summary>Pisex Bans - Embed Variables</summary>

**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}

</details>