Adding a Gun

The easiest method of creating guns is to copy existing code. Tutorials here will provide example code blocks, and otherwise, you may download existing packs for complete references.

Some packs to install and copy from:

The Point Blank Extended Edition pack is good for realistic guns.

The Doom pack is good for special guns like plasma guns, charging weapons, etc..

The Blue Archive pack is also good for realistic guns.

Each pack has guns with prewritten code so everything is easy for you.

Alternatively, as you read through these tutorials, example copy-pastable code will be provided.

If you have no coding experience, it’s recommended to copy-paste from whichever source is convenient when you can.

If you’re copying from a pack: the gun item file is located in packname/assets/pointblank/items. When you copy-paste it into your own pack, it should be located in the same place: packname/assets/pointblank/items

Otherwise, you can create a new text file in the same location packname/assets/pointblank/items; name the file the name of the gun, with the suffix: .json


packname/
  assets/
    pointblank/
        geo/
        animations/
        textures/
        models/
        items/
            gunname.json

Example: m4a1.json

When naming your gun, use proper naming conventions: packname_gunname

Example: pbext_akm.json

Here, pbext is the pack name, so the item name is unique. After that, the _ is added before the name of the gun (akm) so that the file name is easy to read. Unique file names are important in case there are other packs that add the same items. This proper naming convention ensures that players can install your pack without errors. If you don’t do this, players may encounter issues when loading your pack, if they also have other packs that add the same weapon, or if the base mod has the same weapon.

Example, if you want to make an M16A1 for a cold war pack, you will want to avoid naming it m16a1 because there’s already an m16a1 in the base mod. Instead, name it:

coldwar_m16a1.json

Or maybe your pack name is cw

cw_m16a1.json

Of course, it depends on your pack name.

Notice: no uppercases are used in naming the files.