{"id":30394411,"url":"https://github.com/alienmario/customguns-hl2dm","last_synced_at":"2026-02-10T03:32:12.522Z","repository":{"id":39988244,"uuid":"47191852","full_name":"Alienmario/customguns-hl2dm","owner":"Alienmario","description":"Sourcemod plugin that adds custom weapons to Half life 2: Deathmatch","archived":false,"fork":false,"pushed_at":"2025-06-08T17:33:35.000Z","size":6001,"stargazers_count":10,"open_issues_count":0,"forks_count":7,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-08T18:29:06.375Z","etag":null,"topics":["sourcemod-plugin"],"latest_commit_sha":null,"homepage":"","language":"SourcePawn","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Alienmario.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2015-12-01T13:39:05.000Z","updated_at":"2025-06-08T17:33:39.000Z","dependencies_parsed_at":"2024-11-28T00:36:58.039Z","dependency_job_id":null,"html_url":"https://github.com/Alienmario/customguns-hl2dm","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Alienmario/customguns-hl2dm","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alienmario%2Fcustomguns-hl2dm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alienmario%2Fcustomguns-hl2dm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alienmario%2Fcustomguns-hl2dm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alienmario%2Fcustomguns-hl2dm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Alienmario","download_url":"https://codeload.github.com/Alienmario/customguns-hl2dm/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alienmario%2Fcustomguns-hl2dm/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271470416,"owners_count":24765395,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-21T02:00:08.990Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["sourcemod-plugin"],"created_at":"2025-08-21T11:34:38.749Z","updated_at":"2026-02-10T03:32:10.407Z","avatar_url":"https://github.com/Alienmario.png","language":"SourcePawn","funding_links":[],"categories":[],"sub_categories":[],"readme":"# customguns-hl2dm\nSourcemod plugin that adds custom weapons to Half life 2: Deathmatch\n\nRequirements\n---------\n[Metamod](http://www.metamodsource.net/) and [Sourcemod](http://www.sourcemod.net)  \n[DHooks](https://forums.alliedmods.net/showthread.php?t=180114) \n\nGetting started\n---------\nEach custom weapon consists of:\n* Weapon script\n* Models \u0026 materials \u0026 other content like sounds (But you can use stock game content)\n* Controlling plugin (Optional for more advanced weapons)\n\nWeapon scripts are based on [Valve's weapon script](https://developer.valvesoftware.com/wiki/Weapon_script) files. It is recommended that you understand how all this works first. This plugin will read these files and look for a \"CustomGunsPluginData\" block that defines the custom weapon's properties and behavior. The properties read are mostly self explainatory and documented within the scripts of included examples.  \nIt's also possible to code weapons in their seperate plugins with the use of provided natives; however, script files are required for all weapons.\n\nOriginal fields used (for authoring custom weapons)\n* \"viewmodel\"\n* \"playermodel\"\n* \"anim_prefix\"\n* \"primary_ammo\"\n* \"secondary_ammo\"\n* \"clip_size\"\n* \"default_clip\"\n* \"clip2_size\"\n* \"default_clip2\"\n* \"autoswitchto\"\n* \"autoswitchfrom\"\n* rumble\n* SoundData { ... }\n\nInstalling the plugin\n---------\nCopy configs, gamedata and plugins folders into hl2mp/addons/sourcemod\n\nWeapon types \u0026 Examples\n---------\n* Check out the [Bubbleblower example weapon](examples/weapon_bubbleblower) for custom scripted weapons (also the [natives](scripting/include/customguns.inc)).   \n* Check out the [Molotov example weapon](examples/weapon_molotov) for throwable weapons.   \n* Check out the [OICW example weapon](examples/weapon_oicw) for bullet firing weapons.   \n* There is also the default [\"Hands\" weapon example](examples/weapon_hands) that can help accessing other weapons. \n\nInstalling weapons\n---------\nUsing the custom folder is the preferred way of organizing, although dropping the weapon content under hl2mp can work as well and offers better compatibility with FastDL systems and such.\n```\nhl2mp\n└───custom\n    └───Custom_Weapons\n        ├───materials\n        ├───models\n        ├───scripts\n        │   │───unused\n        │   │───weapon_sampleblaster420.txt\n        │   │───game_sounds_manifest.txt\n        │   └───game_sounds_weapons_custom.txt\n        └───sound\n```\n\nWeapon scripts (the txt files) go in the scripts folder. You can also easily disable weapons by moving them to the scripts/unused folder. \n[game_sounds_manifest.txt](examples/game_sounds_manifest.txt) and [game_sounds_weapons_custom.txt](examples/game_sounds_weapons_custom.txt) both go in the scripts folder. The latter file is where additional weapon sounds are added.\n\nOther content (models, sounds and materials) goes in its respective directory.\n\nIf the weapon has its own plugin, like the [bubbleblower example](examples/weapon_bubbleblower), copy it into sourcemod's plugins folder.  \n\nOnce in-game, hold the reload button or bind +attack3 to activate the weapon switcher. Use the command sm_customguns to list and spawn weapons.\n\nConvars \u0026 Commands\n---------\nCVARS:  \n```\ncustomguns_default | The preferred custom weapon that players should spawn with (weapon_hands by default)\ncustomguns_global_switcher | Enables fast switching from any weapon by holding reload button. If 0, players can switch only when holding a custom weapon.\ncustomguns_autogive | Globally enables/disables auto-giving of all custom weapons\ncustomguns_order_alphabetically | If enabled, orders weapons by name in the menu, rather than the order they were picked up. Only applies to dynamic wheel mode\ncustomguns_static_wheel | Enables stationary item placement in the radial menu (1) versus dynamic placement and resizing (0)\nhl2dm_customguns_version | Plugin version\n```\nCommands:\n```\nsm_customgun or sm_customguns | Spawns a custom gun by classname or gives it to a player if specified. Also lists available classnames.\nsm_gunmenu | Lets the players pick their weapon menu skin. Styles can be customized in configs/customguns_styles.txt\nsm_seqtest \u003csequence id\u003e | Viewmodel sequence test\n```\n\nSpecial thanks\n---------\nSourcemod (http://www.sourcemod.net)  \nDHooks by Dr!fter (https://forums.alliedmods.net/showthread.php?t=180114)  \nThis thread (https://forums.alliedmods.net/showthread.php?p=1876312)   \n[FT]Xen0morph  \nHenky‼  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falienmario%2Fcustomguns-hl2dm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falienmario%2Fcustomguns-hl2dm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falienmario%2Fcustomguns-hl2dm/lists"}