Rarity based inventory with randomized weapon stats for gamemodes. Currently supports : DarkRP, TTT, Basewars, Santos RP. Expand for more information.
Brief Overview:
With this inventory system you can design and built a weapon-meta for your server thats totally unique! Any weapon can be used as a base for this system, allowing you to take one weapon and potentially make infinite variants of it, each with their own custom stats regarding damage, RPM, and other variables too!
As well as this, the lua files are all well managed and commented on to help even the newest user to Lua figure out how to add new weapons, rarities, prefixes and crates, as these are the main way of users to get new weapons. This was added to help encourage players to stay active on a server, trying to earn money so they can try getting more weapons or even better ones than they currently have.
Rarities are a one of the most important part of the system, as these dictate stats about the weapon values; When a weapon is gained by a player it is given a random ?rarity. Immediately, this effects the weapons stats, as the rarer the weapon is, the better it will perform. Higher damage per shot, faster RPM, less recoil, all sorts of little boosts to make the gun perform better.
As well as this, "prefixes" are also randomly generated at this point and assigned to the gun, which also gives it a set of stats to help change the weapons performance. Once again, this includes things like damage, RPM, recoil, clip size, all sorts of things. This is to ensure that even if two players happen to unbox the exact same weapon, they will always have different stats and performance, constantly encouraging the players to get more crates/weapons.
As standard the addon comes with 6 rarity's and 9 prefixes, For each weapon this gives 54 different combinations of a single weapon. The AK47 as the stats stand by default the chances of a player getting the exact same AK47 is 1/32,186. ( This math does not include the rarity chances or the prefix chances, The chance of someone getting the same UNIQUE weapon with a UNIQUE prefix is in the millions )
Support:
Does the addon not work with your weapon base? Make a support ticket i'll sort it.
You have followed my installation steps yet something went wrong? Make a support ticket and i'll sort it.
Does the addon not work with your custom gamemode? Check the config file for "CFG.MoneyCommand" if you know how to sort it your self then give it a shot, Wont work for you? Make a support ticket i'll sort it.
Anything wrong that i have not listed? Make a support ticket and i'll sort it for you!
In short. If there is any problems with my code or compatibility with other addons then i will provide help fixing it for you.
Developer Information:
-- Functions
INV:AddInventoryItem( ply, itemname, rarity or nil, prefix or nil ) -- Adds an item to the selected players inventory
INV:DeleteInventoryItem( ply, inventoryposition ) -- Deletes an item from the selected players inventory
-- For TTT
PLAYER = FindMetaTable( "Player" ) -- Just making sure you know its the players userdata
PLAYER:INVAddCredits( n ) -- Adds "n" credits to a player ( or takes them away if its a minus value )
PLAYER:INVSetCredits( n ) -- Sets a players credits to "n"
PLAYER:INVGetCredits() -- Returns credits a player has
PLAYER:INVCanAffordCredits( n ) -- returns true or false for if the player can afford "n"
-- Hooks
-- INV.AlterItemStats - Only return the weapontable.
hook.Add( "INV.AlterItemStats", "UniqueName", function( ply, weapontable ) end ) -- Called just before the player recieves the item.
![[Image: c36433669ba6c40001e7530024d20307.png]](https://media.gmodstore.com/_/script_media/c36433669ba6c40001e7530024d20307.png)
[Leak]
