Description
Have you ever had players on your server that you feel are being annoying but you don't want to kick or ban them. Have you ever wished you knew if a player had been in trouble with other moderators while you were offline?
With AWarn2, all of this is as easy as opening a single VGUI panel. AWarn2 allows you to give warnings to a player.
The addon will them log that warning and any admin (or person who has access if using ULX/Evolve) will be able
to easily see every warning the player has ever received.
With a few configurations (all done inside of the VGUI Menu) the addon can also kick and/or ban players for receiving too many warnings.

Features

• Advanced script that allows administrators to warn players on their server.
• Warnings for players are stored on the server's SQLite databse.
• Administrators can easily view and track all warnings for all players connected to the server.
• NEW as of version 3.1 : Allows you to customize punishment options. This means you can have as many levels of kicking and banning as you want. Example: Kick after 3 warnings, ban for 30 minutes after 5 warnings, and ban permanently after 7 warnings. You can add as many levels as you like.
• NEW as of version 3.2.2: You can add users and groups to a blacklist. Players and groups that are blacklisted can not be warned. Period. This can be used to prevent abuse or potential abuse of AWarn2 to kick admins or to give special users or groups immunity. The blacklists are located in the awarn_settings.lua file.
• Configuration option to allow a player's active warnings to decay over time. All warnings are still logged and can be viewed.
• Stand-Alone but can be used with ULX/Evolve/Maestro to allow servers to give access of this script to non-admin groups/players (explained below)
• Hook callbacks for integration into your own scripts. Please do NOT redistribute AWarn2.
• Built in logging so you can see/monitor warnings and awarn related actions. (off by default)
• Support for language translations. See instructions in the sh_localization.lua file! Please send me any translations you do!

ULX/Evolve/Maestro/ServerGuard Compatibility
If you are using ULX/Evolve/Maestro, this addon will automatically detect that and adjust its permissions accordingly. By default admins and superadmins have access to use this addon. If you want to assign other usergroups access to this addon, just give them the following access flags.

awarn_view - This allows a player to view other players' warnings. (Defaults to Admin)
awarn_warn - This allows a player to warn other players. (Defaults to Admin)
awarn_remove - This allows a player to decrease another player's active warnings. (Defaults to Admin)
awarn_delete - This allows a player to delete all warnings for a player. (Defaults to Superadmin)
awarn_options - This allows a player to view and change the configurations for this script. (Defaults to Superadmin)

I have all of these access flags registered in XGUI so you can add the permissions right from the XGUI menu. They are under the AWarn category.
If you would rather do it manually, you can use:
ulx groupallow <group> <access flag> (example: ulx groupallow "member" "awarn_warn")
ulx userallow <group> <access flag> (example: ulx userallow "Mr.President" "awarn_warn")

If you are running Maestro you can use the following command to add the above permission flags to your groups.
ms rankflag admin awarn_view true
ms rankflag admin awarn_warn true
ms rankflag admin awarn_remove true
ms rankflag admin awarn_delete true
ms rankflag admin awarn_options true
Change out admin with the group name you are assigning the permissions to.

If you are using Evolve Admin Mod you will need to give the Privledges to whatever group or player you want to have access to AWarn functionality.
I am not familiar enough with Evolve to tell you how to give privledges using Evolve. If you need help doing that, contact the developers of Evolve or if someone would like to tell me, I will update this post.

If you are using ServerGuard, here is a handy tutorial on how to integrate AWarn2 into the ServerGuard permissions. Thanks to the author of this guide for writing it.

[HOW TO] Set Awarn2 Permissions

Chat Commands

• !warn - Opens the AWarn VGUI Menu.
• !warn <player> <reason> - Warns a player with a given reason.

Console Commands (All accessible from within the AWarn VGUI Menu)

• awarn_warn <player/steamid> <reason> - Warns a player with a given reason.
• awarn_removewarn <player/steamid> - Removes a single active warning from a player.
• awarn_deletewarnings <player/steamid> - Deletes all warnings from a player. CAUTION: This removes all history of warnings from a player.
• awarn_menu - Opens the AWarn VGUI Menu.
• awarn_options - Opens the AWarn VGUI Options menu.

All of these commands, except the last two (obviously) can be access through your server's console ie: HLSW.

Server ConVARS (Add these to your server.cfg to override settings)

• awarn_kick - Allow AWarn to kick players who reach the kick threshold. 1=Enabled 0=Disabled
• awarn_ban - Allow AWarn to ban players who reach the ban threshold. 1=Enabled 0=Disabled
• awarn_decay - If enabled, active warning acount will decay over time. 1=Enabled 0=Disabled
• awarn_reasonrequired - If enabled, admins must supply a reason when warning someone. 1=Enabled 0=Disabled
• awarn_decay_rate - Time (in minutes) a player needs to play for an active warning to decay (in enabled).
• awarn_reset_warnings_after_ban - If enabled, active warning count is cleared after a player is banned by awarn. 1=Enabled 0=Disabled
• awarn_logging - If enabled, AWarn will log actions to a data file. 1=Enabled 0=Disabled
• awarn_allow_warnadmin - Disable to disallow the warning of other admins. 1=Enabled 0=Disabled

Hook Callbacks

• AWarnPlayerWarned( Player target_ply, Player ply, String reason )
• • target_ply - Player being warned
• • ply - Warning Admin
• • reason - Reason for warning
• AWarnPlayerIDWarned( String tarid, Player ply, String reason )
• • tarid- 64bit SteamID of player being warned.
• • ply - Warning Admin
• • reason - Reason for warning
• AWarnLimitKick( Player target_ply )
• • target_ply - Player being kicked for passing the warning kick threshold.
• AWarnLimitBan( Player target_ply )
• • target_ply - Player being banned for passing the warning ban threshold.

Installation

• Simply unzip and place the awarn2 folder into your addons folder.
• Start your server and type !warn to see the menu. Be sure to make any changes to the options menu you like.
• Open addons/awarn2/lua/awarn/modules/awarn_settings.lua and modify the warning threshold punishments to your liking.
• If installed on multiple servers sharing a single database, navigate to awarn2/lua/awarn/modules/awarn_sql.lua and edit the AWarn.ServerKey for each server (This is a unique identifier that will be stored along with the warning to allow you to tell which server the warning came from)

Updating

1. Backup any settings files within AWarn2. This includes the SQL settings if using MYSQL, any custom punishment settings, localization changes, etc.
2. Delete your current AWarn2 folder from addons and install the newest version. Do not just overwrite files.
3. Go into and edit back in any custom changes or settings you had from before.

Special Note on Upgrading to version 3.4 or later. Due to a change in backwards compatibility, if you are upgrading from the free version or version 3.0.5 or before you will NEED to upgrade first to version 3.3 and then to 3.4 or later. Do NOT upgrade directly to version 3.4 (or later) from the free version or 3.0.5 (or before) or it will not work.

Doing a Factory Reset (Clear ALL warnings)
If you would like to completely remove all warnings from the database and start from scratch, I have provided an additional addon you can install (link below) that adds a console command that will do this. The reason I made it separate is to prevent any abuse or accidental deletions.

1. Download the following addon: https://www.g4p.org/images/awarn2/awarn2_extensions.zip
2. Extract the addon to your addons folder like you would any other addon.
3. run the following command from your SERVER CONSOLE... or in game if you have the 'superadmin' rank.
   awarn_cleardatabase
4. You will get confirmation that the deletions were successful.
5. Once you are done, please remove the addon to prevent any abuse or accidental deletions. You can always add it back later if you decide to factory reset again.

MySQL Installation (Information also in a README file inside the Addon zip folder)

1. In your MySQL server, create a new database for Awarn2. In my example, I use awarn2 (You can use an existing database if you wish)
2. Make sure you have an SQL user that has read and write access to that database.
3. Open awarn2/lua/awarn/modules/awarn_sql.lua
4. Edit the config at the top of the file with the information for your MySQL server.
5. Restart your server and if configured properly, AWarn2 will create 2 tables inside the database you selected.
   ( awarn_playerdata and awarn_warnings )

Please note: I will not provide support for setting up the MySQL modules. I am only providing compatibility for those modules. if you are having issues with the MySQL modules, please take that up with those authors.

Screenshots