Guns4d | The ultimate 3d gun mod.
For a list of possible fields and properties, see the Gun class
Guns are defined using the gun class
The appearance and handling of guns by default are defined by two table fields: their consts and their properties. properties define nearly everything, from how a gun handles to how it looks, what model it uses, etc. while consts define attributes that should never change, like bones within the gun, framerates,
wether the gun is allowed to have certain attributes at all. The other fields of the class define tracking variables or other important things for the internal workings. There are essentially only 3 fields you must define to register a gun: itemstring, name, and properties. To hold the gun, the item defined in itemstring must actually exist, it will not automatically register. To have a functional gun however, more will need to be changed in terms of properties. it's reccomended that you take a look at existing mods (like guns4d_pack_1) for guidance
Guns4d uses a class system for most moving parts- including the gun. New guns therefore are created with the :inherit(def) method,
where def is the definition of your new gun- or rather the changed parts of it. So to make a new gun you can run Guns4d.gun:inherit()
or you can do the same thing with a seperate class of weapons. Set name to "__template" for template classes of guns.
for properties: for tables where you wish to delete the parent class's fields altogether (since inheritence prevents this) you can set the field __replace_old_table=true
additionally
Ammunition is currently self-defined. Ammo has its own attributes seperate from the gun. In the future this will be changed to where the ammunition can both have a custom effect on the gun and the gun can have an effect on the ammunition.
subclasses are classes which are defined in properties.subclasses (where they will be instantiated on construction of the instance).
The resulting instance will then be put (under the same name/index) into the gun instance's subclass_instances table which will then be iterated. If the subclass has an update field it will be called as a function. If the properties change and the subclass no longer exists, it will be destroyed the next time properties are regenerated. This is so that things like scopes or other subclasses can be removed automatically if they no longer are present. To add a subclass after construction, you can simply change the gun's properties using a property modifier by adding a function to Gun.property_modifiers. See property_modifiers.md.
