WJob | gmod Whitelisted Job Management System - scripts

Description of WJob | gmod Whitelisted Job Management System

1. 📘 What is WJob - Gmod Whitelisting Job System 2?
2. ✔️ Prerequisites
3. 📕 Overview of the Administration Panel
4. 🟢 Managing Connected Users
5. 💾 User Whitelist Backup System
6. 🔬 Clear and Optimized Database Management
7. ⏰ Database Entry Expiration System
8. 💼 Activating Job or Job Group Whitelists Without Restart
9. 🧰 Options for a Job or Job Category
10. 🔒 Real-Time Customizable Job Access Restriction System
11. ⚙️ Server Options for WJob - Gmod Whitelisting Job System 2
12. 🔔 Smooth and Translated Notification System
13. 🔌 API
14. ⚡ System and File Optimization
15. 🧩 Gmod Addons Compatible with WJob - Whitelist Job System

📘 What is WJob - Gmod Whitelisting Job System 2?

WJob - Gmod Whitelisting Job System 2 for DarkRP or NJob arrives 10 years after the release of my first Whitelist Job System on Gmodstore, which was also GMod's first whitelist system. WJob - Gmod Whitelisting Job System 2 is a brand-new, completely rebuilt system that addresses all the shortcomings of the previous version and introduces even more features. It’s far more optimized and user-friendly—so much so that you won’t need documentation or Lua skills to use it.

Server jobs are organized into groups that you can expand, enabling you to whitelist an entire job group or individual jobs. Jobs not subjected to the whitelist appear grey in the list; click on them to activate the whitelist, and they turn white with a small whitelist icon. The system also includes a blacklist and various job restriction features, preventing players from accessing certain jobs if prohibited.

Integration with my existing addons enriches job access conditions. For instance, with the Karma and Reputation System, you can restrict job access based on a player’s reputation on your server or their character.

The entire system is incredibly lightweight, with a client file of 44KB and a server file of 19KB. Don’t judge an addon by its file size—Zworld Afterlife Gamemode is proof of that.

✔️ Prerequisites

Prerequisites: At a minimum, you need DarkRP (or its derivatives like MilitaryRP, AnimRP, MangaRP, StarwarsRP, CloneRP) or the NJob - Gmod Job Creator and Editor addon as a replacement, which is more optimized and adds an in-game job configuration system.

No Lua knowledge is required to use WJob.

📕 Overview of the Administration Panel

The WJob administration panel is a centralized tool for efficiently managing access to server jobs. It provides features such as adding players to whitelists or blacklists, toggling access, and configuring specific access conditions based on time, reputation, or other criteria.

Access is available via multiple methods, such as the /wjob or /whitelist commands, shortcut buttons (e.g., F3), or my Nor Admin Mod administration system.

Players without full permissions will only see options they can interact with.

🟢 Managing Connected Users

From the management menu, you can add players to job or job group whitelists, provided the necessary conditions are met. You’ll need the appropriate admin ranks or job permissions defined in the menu.

User management can be done through multiple interfaces: my chat system, scoreboard, admin system, or directly via the menu using the /whitelist command. This flexibility ensures effective administration tailored to your server’s needs.

💾 User Whitelist Backup System

Changes to job access are saved in real time, ensuring players retain their access when they return. You can disable this feature for specific jobs if needed and set expiration durations for temporary access, accommodating server needs or management preferences.

🔬 Clear and Optimized Database Management

The database management system is designed to be intuitive. Entries display the type (Whitelist, Blacklist, Full Access), job group or specific job (e.g., Citizens/Mayor/Full Access), user connection time, whitelist start date, and expiration time, indicating whether an entry is permanent, ongoing, or expired. Each entry also shows who added it—via console command, the system, or another user.

A comprehensive search feature allows you to find entries by SteamID, username, or job, ensuring efficient and quick data management.

⏰ Database Entry Expiration System

You can specify whether whitelist or blacklist entries are permanent or temporary with a specific expiration duration. Temporary access can also be session-based, expiring once the player disconnects.

💼 Activating Job or Job Group Whitelists Without Restart

Activating a job whitelist is simple. Open the WJob menu and navigate to whitelist management. Your server’s jobs, grouped, will be displayed. Select a job by clicking on it; a window will ask for confirmation to activate the whitelist. Once confirmed, the activation is immediate, and configuration options for the job appear on the right. To remove a job, right-click it.

🧰 Options for a Job or Job Category

The whitelist system allows precise control over job access. Several options are available for customization: activate or deactivate the whitelist and blacklist independently, limit the number of whitelisted players (0 for unlimited), and decide if the whitelist persists after a disconnect. Permissions can be adjusted to allow or restrict management and modification of whitelists and blacklists, as well as access to the database for players within the same job category. Restrictions can also prevent viewing or editing other job categories.

🔒 Real-Time Customizable Job Access Restriction System

Job access can be configured with various criteria. Requirements such as level or reputation (default 0) can be set. Access can also be restricted to VIP or staff members. Category-based restrictions can require players to occupy a job within the same category before accessing a new one. Time-based conditions can limit access to specific scenarios, such as weekends (real-time) or day/night cycles (in-game).

⚙️ Server Options for WJob - Gmod Whitelisting Job System 2

Server options allow customization of job management through clear ON/OFF toggles. The entire whitelist/blacklist system can be disabled globally. The database auto-maintenance feature removes inactive players after a set period (default 60 days). Chat commands like /WJob or /whitelist open the management menu for authorized players. Notifications provide global tracking via console and UI alerts for job access refusals. For advanced servers, character-based whitelisting is available with the Gmod Advanced Character Creator System.

🔔 Smooth and Translated Notification System

When a player encounters a restriction, a clear, discreet UI message explains why the job is inaccessible. This message is non-intrusive and free of unpleasant sound effects.

🔌 API

APIs enable integration with other addons. Feel free to request additional features if needed:

player:WJobCheckAccess(access_id) -- Check a user's permissions.
player:IsWhitelisted(team_id) -- Check if the user is whitelisted for a job.
player:IsBlacklisted(team_id) -- Check if the user is blacklisted for a job.

⚡ System and File Optimization

The database now uses SQL for greater flexibility and performance compared to the old text file system. This improvement reduces unnecessary CPU load on your server.

WJob is one of the most optimized whitelist systems for Garry’s Mod, consisting of just three files:
Lua Folder Size (version 1.0):

Client: 44 KB
Server: 19 KB
Config: 9 KB
Workshop Resource: only 7 KB.

This minimalist design improves loading times for players, ensuring a smooth experience.

🧩 Gmod Addons Compatible with WJob - Whitelist Job System

These addons are optional and can work independently. Compatibility ensures additional features when installed together:

1. Norda Advanced Leveling System: A robust alternative to Vrondakis, featuring regular updates and a management panel.
2. Reputation and Karma System: Restricts job access based on player reputation.
3. Nor Admin Mod: Optimized admin system with VIP management features.
4. DarkRP F4 Customizable Menu: Adapts to NJob or DarkRP features.
5. Norda Gmod Scoreboard Editor: Editable scoreboard for managing whitelists.
6. Gmod Advanced Character Creator System: Multi-character management with separate databases.

WIKI & F.A.Q

🔍 Filter

☰ 1. Installation of WJob | gmod Whitelisted Job Management System

☰ 2. Where can I find resources and materials in norda_whitelist_job_system_2?

☰ 3. How do I access the WJob - Gmod Whitelisting Job System 2 administration menu?

☰ 4. How do you add a user to the specific job whitelist in the management menu?

Access the WJob menu, select a connected player, and a menu will appear allowing you to add this user to the whitelist of a specific job (Blue Logo). The effect is immediate.

☰ 5. How do you register a user to the whitelist for a job group?

In the same WJob menu, after clicking on a connected player, you can add them to the job group's whitelist (Orange Logo). This is particularly useful for managing many jobs simultaneously.

☰ 6. How do you place a user on the blacklist for a specific job?

Select the desired user in the WJob menu and use the option to add them to the blacklist for a specific job (White Lock Icon). The effect is immediate.

☰ 7. What are the steps to add a user to the blacklist for a group of jobs?

To blacklist a player for an entire category, go to the same section and select the option for the entire job category (White Lock Icon).

☰ 8. What does "Full Access" mean in WJob - Gmod Whitelisting Job System 2?

☰ 9. How can you add a user to the Full_Access list?

From the WJob menu, select the yellow star to grant Full Access to a player. This allows them to be considered whitelisted for all jobs.

☰ 10. How do you check all the whitelist additions for a given user?

You can click on a player in the WJob menu and select Check DB to view all their entries, or search by SteamID64 in the DB section to see their whitelist or blacklist statuses.

☰ 11. How do you activate the whitelist for a job or job group?

In the JOB menu of WJob, select a category or a specific job to activate its whitelist.

☰ 12. How do you completely remove the whitelist and its configuration for a job?

Right-click on the concerned job in the WJob menu to access the deletion options, including removing the configuration alone or with all associated entries (whitelist and blacklist).

☰ 13. How to disable the whitelist for a job individually without removing the existing configuration?

In the job configuration, go to the variable (whi), which is set to ON by default. Click it to switch it to OFF.

☰ 14. How to activate the blacklist for a job?

In the job configuration, go to the variable (blk), which is set to OFF by default. Click it to switch it to ON.

☰ 15. How to limit the number of users on a job's whitelist?

In the job configuration, go to the variable (max), which is set to 0 (0 = OFF) by default. Set it to the maximum numeric value you desire.

☰ 16. How to disable automatic saving for additions to a job's whitelist?

In the job configuration, go to the variable (w_save), which is set to OFF by default. Set it to ON.

☰ 17. How to automatically remove a user from a job's whitelist once they obtain the job?

In the job configuration, go to the variable (w_unik), which is set to OFF by default. Set it to ON.

☰ 18. How to configure a job so it can manage WJob like a superadministrator?

In the job configuration, go to the variable (as_superadmin), which is set to OFF by default. Set it to ON.

☰ 19. How to allow a job to modify the whitelist configuration for its job group?

In the job configuration, go to the variable (can_set), which is set to OFF by default. Set it to ON.

☰ 20. How can a job manage both the whitelist and blacklist for its job category?

To enable a job to manage whitelist and blacklist settings for its category, access the job configuration menu. There, set the variables can_whitelist and can_blacklist to ON, which are by default set to OFF. This will allow the job to add or remove users from these lists as needed.

☰ 21. How can a job remove entries from the whitelist and blacklist of its job category?

In the job configuration settings, find the variables can_unwhitelist and can_unblacklist and change their settings from OFF to ON. This adjustment gives the job the ability to delete entries from the whitelist and blacklist, thus providing complete control over access permissions.

☰ 22. How to allow a job to review the additions database?

In the job configuration, go to the variable (can_checkup), which is set to OFF by default. Set it to ON.

☰ 23. How to restrict the information accessible to a job concerning jobs from other groups?

In the job configuration, go to the variable (can_db_hide), which is set to OFF by default. Set it to ON.

☰ 24. How to restrict access to a job based on a required level?

Go to the Access Option menu in a job configuration to the line (required_level) and set the minimum level required to access the job.

☰ 25. How to condition access to a job based on required reputation?

Go to the Access Option menu in a job configuration to the line (required_reputation) and set the required karma to access the job.

☰ 26. How to reserve access to a job for VIP members only?

Go to the Access Option menu in a job configuration to the line (vip_access) and set it to ON.

☰ 27. How to limit access to a job to staff only?

Go to the Access Option menu in a job configuration to the line (staff_access) and set it to ON.

☰ 28. How to restrict access to a job to players who have a job in the same group?

Go to the Access Option menu in a job configuration to the line (cat_access) and set it to ON.

☰ 29. How to restrict access to a job during weekends only?

Go to the Access Option menu in a job configuration to the line (w_j) and set it to ON.

☰ 30. How to limit access to a job during the night only?

Go to the Access Option menu in a job configuration to the line (da_j) and set it to ON.

☰ 31. How to restrict access to a job during the day only?

Go to the Access Option menu in a job configuration to the line (n_j) and set it to ON.

☰ 32. How to globally disable job whitelists without uninstalling the addon?

Sometimes, you may need to instantly disable whitelists. To do this, simply go to the (whi) line in the server configuration menu and set it to OFF.

☰ 33. How to globally disable job blacklists without removing the addon?

To disable blacklists, simply access the (blk) line in the server configuration menu and set it to OFF.

☰ 34. How to modify the auto-maintenance delay of the database?

In the server configuration menu under the line (mod_db_clean2), adjust the default setting of 60 days to the delay you desire. Set it to 0 to turn this feature off.

☰ 35. How to disable access to the menu via chat commands?

Navigate to the line (mod_chatcmd) in the server configuration menu and set it to OFF.

☰ 36. How to enable global notifications in the user console?

In the server configuration menu under the line (mod_notif), set it to ON to enable notifications.

☰ 37. How to disable HUD notifications during job access restrictions?

Go to the (wj_tx) line in the server configuration menu and set it to OFF.

☰ 38. What is the Character-Specific Whitelist option?

In the server configuration menu under the line (ac_wi), set it to OFF to apply the whitelist only to the Steam account. If you use the Norda Character System, your characters will have their independent whitelist entries.

☰ 39. What is the purpose of the option to reduce the number of lines displayed per page in the database?

In the server configuration menu under the line (jb_rowmax), adjust the number of entries displayed per page. For example, setting it to 10 with 200 entries in your database will result in 20 pages.

☰ 40. How to reset elements?

The reset button is located at the top right of your management menu. It allows you to reset the entire user database (Blacklist/Whitelist/Full Access), the whitelist configurations, as well as the server options.

☰ 41. How to add a user to a whitelist via the server console?

☰ 42. Can I retrieve my old whitelist from an old system?