Awarn2 - Warning Module [OFF]

Description

AWarn2 allows you to easily give your players warnings for various reasons. These warnings stay with the player until they are deleted, allowing you and other admins on your server to easily view what the player has been warned for in the past. With AWarn2, you can easily spot repeat offenders and deal with them.
Awarn2 also gives you the ability to assign punishments to warnings. Do you want to have a player automatically get banned for 24 hours after reaching 3 warnings? You can do that with AWarn2. The punishment system is totally customizable to fit your needs and 100% optional if you want to only use AWarn2 to track warnings.
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. The blacklists are located in the awarn_settings.lua file.
  
• 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!
  

---

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.

Quote: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)

ULXSpecific commands to add access:

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

Maestrospecific commands to add access:

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

EvolveI 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.
ServerGuardIf 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.

Quote:https://forums.gmodserverguard.com/threa...sions.127/

---

Chat Commands

Quote:!warn - Opens the AWarn VGUI Menu.
!warn [player] [reason] - Warns a player with a given reason.

---

Console Commands

Quote: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.

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

---

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.

Quote: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

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

---

Installation

Quote:

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. Open addons/awarn2/lua/awarn/modules/awarn_settings.lua and modify the warning threshold punishments to your liking.
   
4. 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)