As the SCP content's license says, you are in right to edit my addon and to publish a new version of it as long as you don't discredit me.

First of all, you need to download and extract my addon content into your game's addons folder, I recommand either to download the code from Github[github.com] or by extracting the Steam's version, for example by using that {LINK REMOVED}site. We will doing the changes in it, so when I mention a path, this is located from this folder. Also, remove the original version from your game (unsubscribe or disable it).

Of course, if your goal is to change the default model by a custom one, you will also have to have a ready-to-use model (I won't cover how to modelize and import a model in GMod).

Then restart your game and launch a multiplayer game (number of players doesn't matters).

Once you have spawned, give you the keycard you want to edit and open the weapon's code file from the folder lua/weapons (you can use the 'Copy to Clipboard' option from the spawnmenu to recognize which file represents the weapon). If the autorefresh is not disabled (which should not), you will be able to see the changes in real-time.

By default, the model is set in the base file (lua/weapons/guthscp_keycard_base.lua) and the skin of each keycard is set automatically using the value of SWEP.GuthSCPLVL - 1.

This works fine for the assets I use, but, if you are here, it probably doesn't fit for you.
So we will have to configure the renderer, which is present in each keycard's file.

In the file, locate the code with SWEP.GuthSCPRenderer and uncomment it.
By uncommenting, I mean remove theses at the beggining and the end:

Code example from lua/weapons/guthscp_keycard_lvl_1.lua:

For the keycards of level 1 to 5, I already preconfigured the renderer to use this addon: https://steamcommunity.com/sharedfiles/filedetails/?id=2741330635
If you intend of using this addon, well, you have nothing to do except to uncomment each renderer's code in each file.

Otherwise, you will have to configure each part by refering to the comments.

The renderer is split in two parts :
─ World Model which is used in 3rd person view or when you are looking to another player
─ View Model which is only used in first person view

However, each of these part share a common configuration structure:
─ model: (obviously) the model to use, if swep_ck.enabled = true, it will be used by SWEP:Construction Kit
─ skin: (obviously) the skin on the model to use, if swep_ck.enabled = true, it will be used by SWEP:Construction Kit
─ use_hands: (only for view model) if the player hands should be drawn, useful for custom View Models and PlayerModels containing c_hands
─ swep_ck: SWEP:Construction Kit configuration structure
| • enabled: true or false, toggle the SWEP:Construction Kit renderer
| • bone: Model's bone attachment, its origin
| • pos: Model's position, relative to its origin (the bone)
| • angle: Model's angles, retative to its origin (still the bone)
| • size: Model's scale in 3 axis, a value of 1 represents the normal size

The implementation of SWEP:Construction Kit allows you to render a model in a weapon at a precise position, angle, size, bone, color, etc.. You might use it if you do not have a world or view model compatible with default's weapon renderer (there is no need to install the SWEP:CK addon, it's already implemented on mine)


As said above, the changes you made in the file should be directly visible in-game, so tweak the values as you will without having to reload the game.

Once you are satisfied with the result, you can put the edited folder in your server's addons folder. Don't forget to remove the original version from your server.



It's the end of this article, hope it helped, if you have any questions or remarks, comment below :)