⚠️ Yet Another Warning System [YAWS] (User Warning and Punishment System)

Content Pack

Yet Another Warning System uses a points system. Each warning adds points onto a player. Over-time, these points decay and become inactive. Punishments can then be applied if a player reaches a certain number of active points.

To start off using Yet Another Warning System, join your game and type !warn into the chat. This will open up the UI panel. Ensure you are the superadmin usergroup, or a usergroup that is marked to always have full permissions in the config. You will first of all see all your warnings you've ever received. On the side is where you can view different tabs.

To view more information about a warn, just simply click on it. If your using the cards view, it will expand out to reveal the rest of the information. If you're in table view, it will open a popup box to show the exact same info. To copy information about a warn, simply right click on the entry and click to copy what you want. To go through more warns, on the bottom you will see it uses a page system. Just simply go through the pages to view all the warnings a player has ever been given. Use the double arrows to go right to the first/last pages.

To search for a specific warn from an ID (e.g someone's appealing a warn and they've copied and given to you the ID of it) just simply type into the console yaws {id} - YAWS will search and find the warning and give it to you.

To search for another player, go to the "Players" tab. This will display all the current online players. If you want to filter it down, use the search box and click Submit Search. This is also how you can search for offline players as long as the switch is selected. The search box accepts names and SteamID's (and yes, also SteamID64's). Once you find the player you want, you can click on their card and open their page. This will display their warnings along with three buttons on the bottom, one for going back, one for submitting a new warning for that player, and a final one for viewing their admin notes.

To submit a new warning, click on the submit warning button and you will see a popup box with some fields appear. The first dropdown is for if you wish to select a preset. The second box is for the reason of the warn and the third is the points the warn will give. Simply click "Warn Player" once your done to submit the warning.

To view admin notes, click the admin notes button and it will show a massive text field with any admin notes the player has. You can edit this textbox and click save to edit the notes.

To change something Yet Another Warning System for the entire server, and configure it from a owner's standpoint, you will use the "Admin" tab. This should only be seen by your most high up staff, as access to it allows them to change the entire addon's settings.

The first sub-tab is the Permissions tab, where you can change what permissions every usergroup has. If the usergroup is part of the FullPerms config option in the file-based configs, this won't matter to them.

The second tab is a Settings tab where you can change settings about the addon, for example the prefix/color or how points should cooldown.

The third tab is where you can add presets for warnings. They accept a name which is how they're seen in the dropdown, a reason and a number of points both of which are what are applied to the warning. If you require to, you can delete/edit existing warnings as you please.

The forth and final tab is for adding punishments. These are applied after the player reaches a certain number of active warning points. You can select a punishment type at the bottom-left dropdown, and select what point threshold it should be triggered at. The bottom-right box contains all the parameters that punishment type has, e.g. if you want a ban you can select the duration/reason of the ban. You can then click the Create Punishment Threshold button to add it. These can also be edited/deleted by you later.

The fifth tab, which is only seen by the person who bought the addon, is general information about your install of Yet Another Warning System, it's version, and where to get support. This tab will also display a warning if your install is outdated and needs updated from gmodstore.

If you are a user and want to modify the settings of the addon, you can do so with the Settings tab. You can enable Dark Mode there and change the language.

• Full warning and tracking system.
• Easy way to warn users and track their offenses for all admins to see.
• Point system so if they're getting too many warns they get punished automatically.
• Warning Presets
• If your tired of typing the same thing multiple times presets can help!
• Automatically fills out the fields of your warn with pre-configured values.
• Easy to add/remove.
• If a preset doesn't fully match up, you can edit it in the warning. It doesn't lock you down after using one.
• View anyone's offenses.
• Any player can be searched and viewed by any admin.
• Offline players can be accessed the exact same way.
• Easy to view and copy information about a warning.
• Player Notes make it so admins can leave a quick note for other admins to see.
• Delete a players warnings, or if you want to give them a clean slate, wipe them all with a single click!
• Punishments
• Each warning gives a player a certain amount of points.
• If they get too many "active" points, they can get punished.
• Punishments are easily added and configurable in-game.
• If you know how to use Lua, you can add your own types of punishments!
• Points become inactive after a certain amount of time, to ensure the players that just make a mistake or two don't get punished accidently.
• You can also make all their points inactive after a punishment to ensure your being fair!
• Currently supports by default ULX, SAM and Owain's xAdmin.
• Fully In-Game Config
• Change most aspects of the addon in-game.
• Zero reloading or server restarting required.
• Change anything you want!
• Permissions
• Fully custom permissions system so you can determine exactly what your admins can't and can do.
• User Settings
• Users get their own settings panel, that apply only for them.
• They can enable Dark Mode to stop their eyes from hurting.
• They can change languages on the fly.
• These apply over servers, so you don't have to fiddle about with them every time.
• Context Menu
• Got someone in-front of you and don't want to go all the way through the UI to warn them? Use the Context Menu.
• Warn Someone or view their warnings with the click of a button.
• Carefully Crafted UI
• UI that had a lot of time put into it to ensure it's easy to navigate and looks good.
• Light/Dark mode for the sunshines and night owls.
• Content Pack
• Fast and Efficient
• Fast and efficient code that doesn't hang up or delay your server in any way!
• MySQL / Cross-Server Support
• If you own multiple servers and a MySQL database, you can sync your warnings across all your servers!
• Admin Notes and Warnings from any server can be viewed on other servers with ease.
• Discord Relay
• If you want to show off the bad boys in your server, you can use the Discord Relay.
• You can either use CHTTP or a webserver relay if you can't install a DLL.
• I host a webserver relay for you, meaning you don't have to do anything.
• Don't trust me? I include the relay's code so you can host it yourself and even change it.

DM me on gmodstore for a 20% discount when swapping over!

Swapping over from another warning addon? We got you!

You can convert your old data to data YAWS can use, currently we support:

• Warning System
• AWarn 3
• BobsAdminToolKit

Just type in your console yaws_convert and follow the instructions. If you want a database backup before anything happens to YAWS's database tables, run yaws_convert backup.

Don't see your admin mod? Let me know via a DM or Support Ticket and I'll add it!

To translate YAWS, you'll need to have a Github account + know how to write in JSON.

YAWS's translations are stored on a github repo and fetched by the addon whenever the user requests a new language.

You can simply go to the repo here and submit a translation via PR. The README.md there will show you how the file structure works.

If you want to learn how to test it in-game, check out the knowledge base post here.

If you translate the addon, give me a DM and I'll give you a 50% discount. :)

Current translators:

• Spanish: Goran
• Russian: Levanchik
• French: dotCore, Sarbatore
• Turkish: Higamato
• German: K3hπ
• Hungarian: Aszab123
• Brazilian (Portugese): Razor

If you're a Developer and want to make something for YAWS, take a look at it's Developer API.

Missing something from it? Lemme know and I'll add it for the next version!

Beta Testers 'n Feedback People:

• Aotraz (as usual - also helped with images and the video)
• Owain (the hot man)
• Damian (the canadian)
• Every single customer I have in my Discord Server, who have been seeing previews and giving feedback on this since August. (i really need to finish these addons faster...)

Libraries:

• Better Derma Grid (Threebow) (Modified)
• Deferred-Lua (brianhang)