AWarn3 is now out! If you are a first time user of AWarn, I would suggest taking a look over at AWarn3! https://www.gmodstore.com/market/view/XlzoQ3NgRESyRQPdDsVbTA

***AWarn2 is now no longer supported. It has reached the end of its life as of September 1st, 2020. This version is still listed in case that someone wants to buy it for some reason, but be warned that there is absolutely no expectation of support or updates and a future gmod update could completely break this addon. Please look at buying AWarn3. I have included a way to migrate data from AWarn2 to AWarn3 if you are NOT using MySQL.***

Try it before you buy it!

If you would like to try AWarn2 for FREE, you can download a version of the script over on my website (link below) for free. The free version has all of the bells and whistles of the paid version except MySQL integration and updated GUI. I would much rather you use an official free version than a leak with potentially harmful code added to it.

The free version does NOT have the MySQL support!

Link to Free Version: https://g4p.org/awarn2/awarn2.html

A gmodstore Top 10, you won't be disappointed!

Features

• Allows administrators on your server to warn players for any reason and to view these warnings at any time.
• Players are notified of their warnings and can view their own warnings at any time.
• Admins are alerted when a player with warnings connects to the server so they can view them if they want to.
• Warnings are saved to the server's SQLite database for speed and scalability!
• If you have multiple servers or prefer to have your data on a MySQL database, there is built in support for MySQL integration.
• Punishment options are totally customizable and you can now have as many punishment tiers as you want!
• Specific players or groups can be blacklisted from being warned to protect your superadmins or owners from being trolled by other moderators or admins. These blacklists are accessed through the in-game options menu.
• There are in-game configuration options to allow for active warnings to decay over time. All warnings are still logged, but active warnings are what counts towards punishments.
• Stand-Alone but can be used with ULX/Evolve/Maestro/ServerGuard to allow servers to give access of this script to non-admin groups/players (explained below)
• Modules system and hook callbacks for developers to extend AWarn2 without modifying the base code!
• 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!

Compatible with the most popular Admin Mods!

With support for Evolve/ULX/ServerGuard/and Maestro, all you need to do is install AWarn2 alongside your admin mod, AWarn2 will detect which plugin you are using and use the permissions from your admin mod. Below are a list of permission flags you will need to assign your groups to give them special access within AWarn2.

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)

ULX Specific commands to add access:

ulx groupallow [group] [access flag] (example: ulx groupallow "moderator" "awarn_warn") ulx userallow [group] [access flag] (example: ulx userallow "Mr.President" "awarn_warn")

Maestro Specific commands to add access:

ms rankflag [group] [access flag] true (example: ms rankflag "moderator" "awarn_warn")

Evolve Specific commands to add access:

I am not familiar with how Evolve Access permissions work. If someone informs me, I will update this post.

ServerGuard

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.

https://forums.gmodserverguard.com/threads/how-to-set-awarn2-permissions.127/

Plugins

*Popup Notification by Mr.President: Click Here

NOTICE - I collect information about your server. It's very public information. IP address, server name, current map, version of Awarn2 you're running and gamemode. Nothing else is sent. This is to better help me provide support. If you disable this, I will not provide support for your server.

Chat Commands

!warn - Opens up the in game warning menu.

!warn [player] [reason] - Warns the specified player with the specified reason. Reason can be left blank if you configure awarn2 to allow blank reasons.

Console Commands

All commands except the last two can be run from a dedicated server console.

awarn_warn [player] [reason] - Warns a player with a given reason.

awarn_warn [steamid] [reason] - Warns a player using their SteamID with a given reason. This is useful for warning offline players.

awarn_removewarn [player] - Removes a single active warning from a player.

awarn_removewarn [steamid] - Removes a single active warning from a player by SteamID.

awarn_deletewarnings [player] - Deletes all warnings from a player. CAUTION: This removes all history of warnings from a player.

awarn_deletewarnings [steamid] - Deletes all warnings from a player using their SteamID. Useful for resetting an offline player's warnings. 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.

Server ConVars

These can be added to your server's config file if you want to override default settings. Use these if you have trouble getting the settings to save after changing them using the in-game settings menu.

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_decayrate - 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 targetply, Player ply, String reason )

targetply - 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 targetply )

targetply - Player being kicked for passing the warning kick threshold.

AWarnLimitBan( Player targetply )

targetply - Player being banned for passing the warning ban threshold.

Custom Methods

Player:GetActiveWarnings()

This returns the active warning count (int) for player.

Player:GetTotalWarnings()

This returns the total warning count (int) for player.

Installation

1. Simply unzip and place the awarn2 folder into your addons folder.
2. Start your server and type !warn to see the menu. Be sure to make any changes to the options menu you like.
3. If installed on multiple servers sharing a single database, navigate to data/awarn2/settings/mysql_settings.lua and edit the 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. Since there are no longer any lua files that need to be edited to configure AWarn2, you just simply need to update like you would any mod.
2. Delete your current AWarn2 folder from addons and install the newest version. Do not just overwrite files.

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: http://g4p.org/awarn2/images/awarn2/awarn2_extensions.zip
2. Extract the addon to your addons folder like you would any other addon.
3. run awarn_cleardatabase from your SERVER CONSOLE… or in game if you have the 'superadmin' rank.
4. You will get confirmation that the deletions were successful.
5. 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

This Information is also available 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. Run your server at least once to generate the settings file, then open it. It can be found in garrysmod/data/awarn2/settings/mysql_settings.txt
4. Edit the config with the information for your MySQL server.
5. Restart your server and if configured properly, AWarn2 will create the tables inside of your database and will use those.

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.

Localization/Translation Credits

Finnish (FIN)

Translation provided by [SPR] Hodas (http://steamcommunity.com/id/Hodas/)

Turkish (TR)

Translation provided by saviorsoldier (http://steamcommunity.com/profiles/76561198057034162)

German (DE)

Translation provided by Martin (http://steamcommunity.com/id/martinlink/)

Russian (RU)

Translation provided by Snappi (http://steamcommunity.com/id/snappiincognito/)

French (FR)

Translation provided by Driven (http://steamcommunity.com/profiles/76561197986344922)

Portuguese (PT)

Translation provided by Comedian (http://steamcommunity.com/id/comedinha/)

Dutch (NL)

Translation provided by Nioxed (https://steamcommunity.com/id/Nioxed/)

Spanish (ES)

Translation provided by Preston Vasquez (http://steamcommunity.com/profiles/76561198290329975/)

Polish (PL)

Translation provided by Kancer (https://steamcommunity.com/id/stalkershepard/)