NJob - Gmod Job Creator and Editor - Script

Description of NJob - Gmod Job Creator and Editor

1. ℹ️ What is NJob - Gmod Job Creator and Job Editor ?
2. ⚙️ The NJob administration panel
3. ✔️ NJob server options adjustable from the NJob management menu
4. 📐 Create jobs and define settings for each job in real time
5. 🖌️ Customise the playermodels for each job in real time by configuring skins, bodygroups and colours
6. 🎨 Customise the display of the player's job on the HUD in real time
7. 🔒 Real-time customizable verification system to condition access to a profession
8. 🥇 Definition of the hierarchical order of Jobs in a job category
9. ⬆️ Job progression system, levels and experience points
10. 💰 Basic currency system included
11. 💾 System for saving users' jobs when they log off
12. ⏰ Definition of a maximum occupation time for a Job
13. 🔔 Modular, non-intrusive notification display system
14. 🔌 DarkRP API and Alias (Addons for DarkRP work in NJob without DarkRP)
15. ⚡ Optimisation
16. 🧩 Gmod addons compatible with Norda - Osgmod
17. 🏷️ Managing permissions and management tasks
18. 📚 Documentation and tutorials for users
19. 🔄 Support, technical assistance and updates

NJob - Gmod Job Creator and Editor is a Job System add-on for Gmod, designed to simplify the creation, editing and customisation of jobs on servers without requiring the DarkRP framework. Thanks to its intuitive interface, NJob enables administrators to manage all aspects of jobs in real time, without modifying lua files or restarting the server. Features include full customisation of playermodels, skins, bodygroups and colours, as well as advanced options for defining access conditions, such as player level, reputation or VIP status (no need for a system job whitelist in this case). NJob also offers a job progression system with levels and job experience points once you reach 100% progression the system can automatically promote, an integrated currency system, and saving of users' jobs when they log out. Compatible with DarkRP addons via aliases, NJob provides efficient and optimised role management, offering a flexible, high-performance alternative for administrators looking to set up game servers with personalised jobs (roles) and simplified management.

With NJob, everything is managed from a single menu, without requiring a single line of code. Forget about manual file modifications and frequent restarts of your server.

NJob is a complete, stand-alone job management system. It lets you create new jobs, edit existing ones, configure playermodels with their bodygroups, skins and colours when they can be coloured, define the weapons for each job, as well as their descriptions and access conditions, all in real time and without restarting.

Menu-driven configuration avoids syntax errors that can disrupt server operation.

From the same menu, you can also customise the way jobs are displayed on your HUD, as well as managing players' progress and currency.

Regulate the behaviour of NJob on the server side by activating options from the interface, which are taken into account in real time. For example, if you want to change the salary distribution interval from 5 to 10 minutes, you can do this directly from the interface.

Here is the list of server options available in NJob :
1. Activation of the passive XP gain system for job progression.
2. Number of job XP points per cycle.
3. Duration of a salary cycle.
4. Notification in chat of XP gain per cycle (ON | OFF).
5. Job XP points reset when player dies (ON | OFF).
6. Job lost on player death, revert to server default job (ON | OFF).
7. Automatic assignment to a job group and to the level 1 job in that group (ON | OFF).
8. Automatic maintenance: deletion of inactive players from the database after a set number of days (0 = OFF).
9. Deletion of a job's default weapons after a job change (ON | OFF).
10. Respawn on job change (ON | OFF).
11. Respawn on job category change (ON | OFF).
12. Kill on job change (ON | OFF).
13. Activate the ‘/NJob’ chat command to open the NJob management menu (ON | OFF).
14. Activate the command to promote a targeted player, if authorised (ON | OFF).
15. Activate the command to demote a target player, if authorised (ON | OFF).
16. Display notifications in the console (ON | OFF).
17. Transition effect when changing jobs (ON | OFF).
18. Cooldown configuration for job change in seconds.

From the job creation menu, create and delete jobs, edit all the settings of a job in real time. Changes take effect immediately.

No Lua file to modify. No jobrelated.lua to edit. No need to restart.

What you can edit on a job in NJob :
1. The job name.
2. The job category: allows you to move a job easily to another category.
3. Job logo: assign a logo to a job via a simple image link (imgur).
4. Job colour code.
5. Define whether this is the server's default job.
6. Define whether the job should be saved so that the player can find it again when reconnecting.
7. Define the number of workstations available for a job.
8. Take into account occupied jobs saved (includes disconnected players in the calculation or not).
9. The number of Job EXP required to automatically move on to the next job.
10. Allow the job to edit jobs in its category.
11. Allows a member to be promoted.
12. Demote a member.
13. Permit the promotion and demotion of a member of equal level.
14. Manage NJob as a superadmin.
15. ESP jobs: display the position of each member of the same job group.
16. Admin ESP: display the position of everyone with a job on the map.
17. Define the job salary.
18. Define the maximum life of the player who gets the job.
19. Define the job's maximum armour.
20. Set the maximum duration of a job: the player will be removed from the job automatically after the set duration.

NJob lets you choose the bodygroups and skins for each playermodel you assign to a job. When the player gets the job, they receive the playermodel in the form you've predefined, and you can adjust this in real time.

This option, which does not exist natively on DarkRP, is not normally visible in the F4 menu provided for DarkRP. However, I've updated my DarkRP F4 menu to include this new feature.

You have the option of displaying the job on the HUD or disabling it if you already have your own HUD. The display can be adjusted from the interface: choose the position and size. The display is responsive.

You can also choose to display the jobs of other players you're targeting, with the option to disable it. Job progress can also be displayed on the HUD.

You have several options for restricting access to a job.

The first are options that can be ticked in a job's Custom Check menu:

Access by player level: Define the player level required to access the job. This requires a leveling system such as Vrondakis or Norda Advanced leveling system - Osgmod.
Access by reputation: Define the reputation / Karma required to access the job. This requires a Reputation and Karma system - Osgmod. If you do not wish to use this option, you can leave it enabled.
VIP Access: Tick the VIP Access box to reserve the job for VIP members of your server only. You'll need a system that allows you to assign the VIP rank to a player, such as Nor Admin Mod - Osgmod.
Staff Only Access: Check the Custom Check Staff Access box to reserve the job in question for staff members only.
Access by job required: Choose the job you need to access this job. Define the name of the required job.
Access by category: Restrict access to the job if the player is not in the job/faction category.

The last option is to write your own Custom Check directly from the panel.

Within a job category, you can define which job is superior to another. This feature is useful for organising the order of power, as well as for promotion and demotion systems. It creates a logical order of progression and superiority within the category.

You can activate the job progression system automatically, which means that the player earns experience points for the job they do. When they reach 100%, they are automatically promoted to the next higher job. You can configure the threshold required for each job. This option is individual for each job and can be configured directly from the interface.

Although an advanced currency system is available on Osgmod, compatible with DarkRP and NJob, NJob also includes a simple basic currency system. This system allows, initially, to have a currency system working with your shops initially planned for DarkRP. The aliases take into account the basic DarkRP variables to ensure that the currency systems are compatible. You can define player currencies directly from the management panel.

You can choose which jobs are saved and which are not. For example, if you decide that the mayor job is saved, the player can log out and come back with their job. You might be worried that if the player doesn't come back, the job will get stuck, but that's expected too. See 12.⏰ Set a maximum occupancy time for a Job - NJob - Osgmod.

You can limit the occupancy time of a job, which means that once this time has elapsed, the player is automatically moved to the default job you have defined for the server. If a job has a maximum limit of occupied positions, players will not be able to select it even if the current holder is offline. This system allows jobs to be freed up automatically. This is an option you can choose to enable or disable.

When you change jobs, the screen goes dark and displays a message in the centre indicating the job change, along with the name of the job, before disappearing smoothly. This feature can be deactivated. You can choose to display it without the fade effect, or only in the system chat or in the client console.

The aliases created in NJob make all my GMod addons for DarkRP compatible. For example, my F4 menu will work in the same way as if you had installed DarkRP. The list of aliases created for external DarkRP addons is provided in the wiki section. If you're not sure whether one of your addons is compatible, you can consult this list. See wiki: 66. API - List of DarkRP aliases in NJob

In terms of size and weight, NJob is designed to take up a minimum of space:

Client : 81 Kb (1 client file)
Server : 46 Ko (1 server file)
Workshop : 13 Kb or 0.001 Mb

On the network side, NJob uses an optimised method for sending and receiving data, guaranteeing that players arrive on the server smoothly and that job changes take place without spikes.

A stress test was carried out with 600 jobs, with no impact on performance: no freezes or loading delays.

You can always check the load on your server when changing jobs on DarkRP using the net_graph 3 console command. No overload was observed under NJob.

None of these addons are mandatory, each can work independently of the others. I simply guarantee their compatibility.

1. Norda Advanced leveling system: An excellent alternative to Vrondakis, with support, regular updates, and a database and settings management panel.

2. Karma and Reputation System: Allows you to restrict access to jobs according to the player's reputation level (Good person / Bad person).

3. Nor Admin Mod: Offers an optimised administration system and VIP status system.

4. Gmod Money System + HUD Maker: Provides an advanced money system with customisable HUD and all its options, replacing the included money system.

5. DarkRP F4 Customizable menu: The F4 menus provided for DarkRP should work, but should not display defined bodygroups and skins, as this functionality does not exist in DarkRP. The Norda F4 Menu is adapted to the new features in NJob.

6. Norda Gmod Scoreboard Editor: Allows you to have a fully editable scoreboard and manage jobs from it, whether you are an admin or a job with the power to promote and/or demote.

7. Gmod Job NPC Customizable System: If you don't want to use an F4 menu to acquire a job, players can physically move around the game to get jobs via various NPCs you define.

8. Gmod Advanced Character Creator System: Create multiple characters in various jobs, with guaranteed compatibility between the separate databases of the different characters created.

You can define the hierarchy of jobs in a category, indicating whether one job is superior to another. You can also specify whether a job has the power to promote a user to a higher job in its category or demote a user to a lower job.

In addition, you can define whether a job has superadmin powers in NJob. A job with this level of permission will be able to manage all other jobs.

Users without a special management rank will only see a list of all the jobs you have created on the server when they open the NJob management menu. There is therefore no need to create a wiki to list this information. The list updates automatically each time a job is added, deleted or modified, including details such as the salary set, job name and category.

Like the majority of scripts on Osgmod NJob benefits from active and responsive technical support.