Gmod Leveling System

Description of Gmod Leveling System
🇫🇷 🇬🇧

---

---

Summary:

1. 📘 Description of Gmod Leveling System
2. 🔎 About Gmod Leveling System
3. 📦 Contents
4. 💪 The Rating System includes
5. ⏲️ Playtime System
6. ⏰ AFK System
7. 📐 Level progress bar customization options in the HUD
8. 🕹️ The Console Commands
9. 💾 Backup and persistence
10. ⚙️ The Configuration file
11. ✔️ Compatibility
12. 🛠️ Gmod Admin system compatible
13. 🪄 Spawnable, Spawner entities from XP points or Level Points
14. 💰 Ability to have XP or Level purchased in-game, on your server through Spawnable XP entities + Gmod Store Builder Scripts
15. ⬇️ Drop XP or Level in game thanks to spawnable XP entities when a Npc dies
16. ❓ Functions to know associated with the Player Class for applications in other areas Addons / Mods / Scripts / Gamemodes
17. ❓ How to Restrict DarkRP jobs in relation to player level

📘 Description of Gmod Leveling System

Are you looking for a leveling addon for your Gmod or DarkRP server to give a little RPG touch? And that can work with DarkRP gamemode or that can also work without any gamemode? With great customization possibilities? Without touching the configuration file but from an intuitive interface by just clicking on ON / OFF buttons? To make your VIP ranks more interesting or advantageous? Then "Gmod Leveling System" is for you. Technical support provided.

🔎 About Gmod Leveling System

Gmod Leveling System is a leveling system for your Gmod or DarkRP servers, which means that it works as well with or without DarkRP. It allows you to add a leveling system and a management of experience points and a ranking of players from the highest level to the lowest to animate the competition on your servers, to manage the level of all your players even without an administration system, you just have to be admin to access the management interface, you can customize in real time the Progress Bar on the HUD, that is to say the horizontal position, vertical, width, length, and the colors, text.

On the jobs and ranks side you can edit predefined options, e.g. if a job earns 2 times to 4 times more experience points than another. Same thing for user ranks, for example to make your VIPs attractive by offering advantages such as XP times two and others.

Care has been taken to ensure that everything made to work with vrondakis (DarkRP Leveling System) is compatible by using the same function name assigned to the player class.

Gmod Leveling System is compatible with all gamemodes. Put the file in the addons folder and it works.

📦 Contents

1. A database management system for levels and experience points.
2. A Server Ranking System.
3. A module to manage benefits by ranks (superadmin, admin, moderator, vip, and other ranks you add)
4. A Module of management of the advantages by jobs (DarkRP Jobs that you will have added)
5. A HUD customization system (Level progression bar indicates XP and Level)
6. An information system of progression of each level. From minimum to maximum level.
7. A Playtime Module, which will allow to reward the time of play in XP. (Configurable in duration and quantity of XP)
8. An AFK Module, which will display afk users and block the reward for those who don't move. (Configurable in duration and amount of XP)
9. XP and Level Spawnable Entities
10. All this without overloading the file size, since it reaches 32kb on the client side, and 20kb on the server side (contrary to the standards around 500kb)

💪 The Server Ranking System includes
Strengthen the competition within your server with a player-accessible ranking system. When trying to open the management menu, non-admin users will only see the players' ranking.

⏲️ Playtime System

You will be able to reward your active players with experience points by their presence and according to the time they play. A module of creation of status AFK allowing to the AFK not to receive this reward that is obviously activable or deactivable by a simple button ON / OFF.

⏰ AFK System

DarkRP already has an AFK module, the Gmod Leveling System module is 6 lines long, in addition to its lightness it will have the benefit of working independently of DarkRP. You will be free to activate or deactivate it. We won't charge you for 6 lines so this little bonus is free and included.

📐 Customization options for the level progress bar in the HUD.

You will have the possibility to customize the progress bar in all directions while being responsive, ie automatically adapting to the resolution of each of your users, and what is configurable?
1. The X Y position
2. The length and width
3. The background color of the bar
4. The color of the progress bar
5. The color of the text

Change everything from day to day without having to reboot your server.

🕹️ The Gmod Console Commands

It will be possible despite the interface to do it by server command if you need it:
The command to give experience points : give_xp steamid64 amount
The command to give Levels : give_lvl steamid64 amount

- Example 1 a user bought 1000 XP points from the store of your site, the order will be :
give_xp 76561198033784269 1000

- Example 2 a user bought 1 LVL from the store of your site, the order will be :
give_lvl 76561198033784269 1

💾 Backup and persistence

There is nothing to do, install and reboot, the installation of the database is done automatically and in a fraction of seconds.

⚙️The Configuration file

Most of the configuration is done from an interface which makes the configuration file very minimal.

You can configure the number of xp for each level manually.

You will be able to configure it there:
cfg.Lvl_Max = 100 //The Level Max on the server, default value 100.
cfg.base_xp = 30 //The XP base for upgrade. Default 30
cfg.xp_requier_per_lvl = 20 //XP Required by level based on base_xp. Value in percent. Default 20%.
cfg.delay_to_become_afk = 10 //Time to be considered as AFK, by default every 10 minutes
cfg.delay_playtime_to_earn_xp = 5 //Delay to receive a reward in experience points, by default every 5 minutes
cfg.XP_amount_earn_with_playtime = 50 //+50XP every 5 minutes (Time set with cfg.delay_playtime_to_earn_xp)
cfg.XP_loose_when_die = 5 //% The user loses 5% of the amount of XP he had when he loses a life.
cfg.XP_earn_when_kill = 5 //% The player who kills a player gains 5% XPMAX for the victim's level.
cfg.Npcs_XP_Minimum=5 Set the minimum XP gain when an Npcs is eliminated
cfg.Npcs_XP_Maximum=10 Define the maximum XP gain when an Npcs is eliminated, a script is planned soon which will allow to configure the xp gain by class of npcs

✔️ Compatibility

Compatible with DarkRP, StarwarsRP, HogwartsRP.
For those who want to optimize their Gmod Server and don't want to run on DarkRP the system will continue to run without DarkRP or any gamemode. Backup is totally independent. You change gamemode, the stats are kept and reusable in other gamemodes.
Compatible with addons made to work with Vrondakis Leveling System.
Compatible wiith darkrpgmaster (DarkRPG) on demand.

🛠️ System Admin Gmod compatible

If you want an optimized administration system that holds up in the long run and is not too heavy in weight, Garry's Mod Admin Mod will allow you to give XP and Level from its administration interface.

🪄 Spawnable entities, Spawner XP points or Level points

The addon includes spawnable entities.
Experience points (+5 XP, +10 XP, +25 XP, +50 XP, +100 XP, +500 XP, +1000 XP): The experience points are represented as bright blue balls, the more xp they give the bigger they are.
Level points (+1 Lvl) : The level points are represented as a luminous red ball.

💰 Possibility to buy XP or Level in game, on your server with spawnable XP entities + Gmod Store Builder scripts

I have already created a store system called Gmod Store Builder where you will be able to configure spawnable XP/LVL entities as an item to be purchased from a store that you will have placed on the map, the store will be able to be a Npcs model of your choice, have the posture that you will have chosen from its list of animations and provide a background dialog.

⬇️ Get XP or Level in game thanks to spawnable XP entities when a NPC dies

If you want the XP to spawn hard when a NPCS dies then NPC Death Loot Manager will make you happy. Create an inventory by Class of Npcs with a drop rate of entities, here it will be XP and at the death of Npcs the XP points will spawner on the ground in the form of luminous blue ball.
It will be possible to put Level points for bosses for example.

❓ Functions to know associated with the Player Class for applications in other areas Addons, Mods, Scripts, Gamemodes

The Glua functions on the Client and Server sides :
player:getLevel() //Allows to return the level of the player
player:getXP() //Allows to return the player's XP
player:getMaxXP() //Allows to know the XP allowing to reach the next level of the player
player:hasLevel(level) //Allows to know if the player has a higher level than the one requested.

Glua functions on the server side :
player:setLevel(lvl, save) //Allows to define the level of the player (Usually used for administration), save = true to save, false to not save. Sometimes when you want to assign a level like when loading a character you don't want to save.
player:setXP(xp) //Allows to define the XP of the player (Usually used for administration)
player:addXP(xp) //Allows to add XP to the player
player:addLevels(lvl) //Allows you to add a level to the player
player:Lvl_Options_Check(var) //Allows to check if the option is activated. 1 = Active (For example XP x2), 0 = OFF

❓ How to restrict DarkRP jobs according to the level of the players

You just have to add the variable level = X, X being the level you want to restrict the access level.
For example if you set level = 10 then only players with a minimum level of 10 will be able to request access to the job.

Installation: Download and Unzip the folder norda_leveling_system.zip Install the addon in the addons file of your Gmod server,

- Path : garrysmod/addons/ norda_leveling_system

- Gmod Content Workshop ID : 2686510013
- You can add this to a server-side Lua file : resource.AddWorkshop( 2686510013 )
- To add the gmod workshop resources to your collection : Gmod Leveling System [Content Only] | Gmod Workshop

Tip to avoid the leak of Gmod Leveling System installed on your Garry's Mod server: How avoid the Leak of your Gmod scripts
How Install an addon on Gmod? : How install an addon on Gmod
How Publish an addon on the Gmod workshop? : Documentation how create a content pack to publish on the workshop?