Works with
Compatible add-ons, packages, or tools that pair well with this resource.
-
Customizable Protection Optional -
Boss Monster Optional -
Better Npc Optional -
Rust Translation API Optional
About Customizable Weapons
The plugin provides a wide range of weapon customization options, allowing you to adjust parameters such as damage, durability, and magazine capacity depending on the module or setup you configure. It also supports custom items and unique damage types, making it suitable for many weapon-related systems, including turrets, NPCs, and bosses.
What can be created with this plugin?
Using this plugin, you can build your own custom weapon systems and mechanics. For example, it is possible to configure weapons that are more effective against certain types of players.
You can also create custom NPCs or bosses equipped with weapons that deal significant damage to regular players, while combining this setup with armor from another plugin, such as CustomizableProtection, to reduce the impact of that specific damage type.
In addition, the plugin can be used to design progression-based systems, such as crafting-based armor upgrades or a weapon enhancement system with levels from +1 to +20, where weapon power increases step by step.
These examples are not built-in features of the plugin by default, but rather systems that can be created with it through configuration and integration with other plugins.
Ultimately, the possibilities are highly flexible and are limited mainly by your imagination.
Features:
- Customizability
- Item setup files are all separately in their own file and folder, making it easy to customize items
- Support for NPCs, turrets, etc.
- Ability to create your own items
- Nice UI, allowing players to see items as best as possible
Permissions:
customizableweapons.give - Permission to issue weapons
customizableweapons.icon.show
customizableweapons.icon.hide
customizableweapons.***** any permissions you configure, the default with the examples goes vip1, vip2
Console Commands:
cw.give <custom item name> - give yourself a custom item cw.give <steamid> <custom item name> - give the player a custom item cw.create <new unique shortname> <shortname> - Add a custom item based on the image of another item cw.reload - Quick reloading of items
File Hierarhy:
• CustomizableWeapons
↳ • Custom
↳ admin.lr.json
↳ • Permissions
↳ • [0] vip2
↳ rifle.lr300.json
↳ • [1] vip1
↳ rifle.lr300.json
↳ • Default
↳ bow.compound.json
↳ bow.hunting.json
↳ crossbow.json
↳ hmlmg.json
↳ lmg.m249.json
↳ multiplegrenadelauncher.json
↳ pistol.eoka.json
↳ pistol.m92.json
↳ pistol.nailgun.json
↳ ... etc.
Custom item settings:
{
"Name": "Admin LR300",
"Description": "Powerful admin gun",
"UI Settings": {
"Name Color (or use <color></color> in name)": "1 0 0 1",
"Frame Color": "1 0 0 1"
},
"Unique SkinId": 2400056213,
"Shortname": "rifle.lr300",
"Unbreakable": true,
"Durability": 1000000.0,
"Magazine Capacity": 10000,
"Effects when hit": {
"Maximum and minimum values in the accumulation": {
"Max Radiation Poison": 500.0,
"Max Bleading": 100.0,
"Min Temperature": -100.0,
"Max Temperature": 100.0,
"Max Wetness": 100.0
},
"Radiation Poison": 0.0,
"Bleading": 0.0,
"Temperature": 0.0,
"Hunger": 0.0,
"Thirst": 0.0,
"Wetness": 0.0,
"Number of electric balls (recommended to 10)": 0
},
"Base damage by type & ammo": {
"ammo.rifle": {
"Hunger": 1000000.0,
"Thirst": 1000000.0,
"Cold": 1000000.0,
"Drowned": 1000000.0,
"Heat": 1000000.0,
"Bleeding": 1000000.0,
"Poison": 1000000.0,
"Bullet": 1000000.0,
"Slash": 1000000.0,
"Blunt": 1000000.0,
"Radiation": 1000000.0,
"Bite": 1000000.0,
"Stab": 1000000.0,
"Explosion": 1000000.0,
"ElectricShock": 1000000.0,
"Arrow": 1000000.0,
"AntiVehicle": 1000000.0,
"Collision": 1000000.0
},
"ammo.rifle.explosive": {
"Hunger": 1000000.0,
"Thirst": 1000000.0,
"Cold": 1000000.0,
"Drowned": 1000000.0,
"Heat": 1000000.0,
"Bleeding": 1000000.0,
"Poison": 1000000.0,
"Bullet": 1000000.0,
"Slash": 1000000.0,
"Blunt": 1000000.0,
"Radiation": 1000000.0,
"Bite": 1000000.0,
"Stab": 1000000.0,
"Explosion": 1000000.0,
"ElectricShock": 1000000.0,
"Arrow": 1000000.0,
"AntiVehicle": 1000000.0,
"Collision": 1000000.0
},
"ammo.rifle.incendiary": {
"Hunger": 1000000.0,
"Thirst": 1000000.0,
"Cold": 1000000.0,
"Drowned": 1000000.0,
"Heat": 1000000.0,
"Bleeding": 1000000.0,
"Poison": 1000000.0,
"Bullet": 1000000.0,
"Slash": 1000000.0,
"Blunt": 1000000.0,
"Radiation": 1000000.0,
"Bite": 1000000.0,
"Stab": 1000000.0,
"Explosion": 1000000.0,
"ElectricShock": 1000000.0,
"Arrow": 1000000.0,
"AntiVehicle": 1000000.0,
"Collision": 1000000.0
},
"ammo.rifle.hv": {
"Hunger": 1000000.0,
"Thirst": 1000000.0,
"Cold": 1000000.0,
"Drowned": 1000000.0,
"Heat": 1000000.0,
"Bleeding": 1000000.0,
"Poison": 1000000.0,
"Bullet": 1000000.0,
"Slash": 1000000.0,
"Blunt": 1000000.0,
"Radiation": 1000000.0,
"Bite": 1000000.0,
"Stab": 1000000.0,
"Explosion": 1000000.0,
"ElectricShock": 1000000.0,
"Arrow": 1000000.0,
"AntiVehicle": 1000000.0,
"Collision": 1000000.0
}
}
}
Default item settings:
{
"Shortname": "multiplegrenadelauncher",
"Unbreakable": false,
"Durability": 200.0,
"Magazine Capacity": 6,
"Effects when hit": {
"Maximum and minimum values in the accumulation": {
"Max Radiation Poison": 500.0,
"Max Bleading": 100.0,
"Min Temperature": -100.0,
"Max Temperature": 100.0,
"Max Wetness": 100.0
},
"Radiation Poison": 0.0,
"Bleading": 0.0,
"Temperature": 0.0,
"Hunger": 0.0,
"Thirst": 0.0,
"Wetness": 0.0,
"Number of electric balls (recommended to 10)": 0
},
"Base damage by type & ammo": {
"ammo.grenadelauncher.buckshot": {
"Hunger": 0.0,
"Thirst": 0.0,
"Cold": 0.0,
"Drowned": 0.0,
"Heat": 0.0,
"Bleeding": 0.0,
"Poison": 0.0,
"Bullet": 15.0,
"Slash": 0.0,
"Blunt": 0.0,
"Radiation": 0.0,
"Bite": 0.0,
"Stab": 0.0,
"Explosion": 0.0,
"ElectricShock": 0.0,
"Arrow": 0.0,
"AntiVehicle": 0.0,
"Collision": 0.0
},
"ammo.grenadelauncher.he": {
"Hunger": 0.0,
"Thirst": 0.0,
"Cold": 0.0,
"Drowned": 0.0,
"Heat": 0.0,
"Bleeding": 0.0,
"Poison": 0.0,
"Bullet": 0.0,
"Slash": 0.0,
"Blunt": 55.0,
"Radiation": 0.0,
"Bite": 0.0,
"Stab": 0.0,
"Explosion": 35.0,
"ElectricShock": 0.0,
"Arrow": 0.0,
"AntiVehicle": 0.0,
"Collision": 0.0
},
"ammo.grenadelauncher.smoke": {
"Hunger": 0.0,
"Thirst": 0.0,
"Cold": 0.0,
"Drowned": 0.0,
"Heat": 0.0,
"Bleeding": 0.0,
"Poison": 0.0,
"Bullet": 0.0,
"Slash": 0.0,
"Blunt": 0.0,
"Radiation": 0.0,
"Bite": 0.0,
"Stab": 0.0,
"Explosion": 0.0,
"ElectricShock": 0.0,
"Arrow": 0.0,
"AntiVehicle": 0.0,
"Collision": 0.0
}
}
}
Defaut Config:
{
"Icon Position (0 - Off | -1 - left by 1 slot, 1 - right by 1 slot | ..)": -2,
"Global Settings": {
"Give Options": {
"Attachments": {
"weapon.mod.8x.scope": false,
"weapon.mod.burstmodule": false,
"weapon.mod.extendedmags": false,
"weapon.mod.flashlight": false,
"weapon.mod.holosight": false,
"weapon.mod.lasersight": false,
"weapon.mod.muzzleboost": false,
"weapon.mod.muzzlebrake": false,
"weapon.mod.simplesight": false,
"weapon.mod.silencer": false,
"weapon.mod.small.scope": false
}
},
"Disable the mechanics of unloading ammunition when removing the magazine?": false,
"Disable the magazine bonus when you change capacity?": false,
"Limit the number of bullets loaded in the weapon to the capacity of the magazine set for the player holding the weapon?": true
}
}