{"id":30689058,"url":"https://github.com/HvH-gg/CS2-Essentials","last_synced_at":"2025-09-02T01:04:55.183Z","repository":{"id":224711519,"uuid":"763995338","full_name":"HvH-gg/CS2-Essentials","owner":"HvH-gg","description":"A plugin for Counter-Strike 2 with essential functionality for HvH servers.","archived":false,"fork":false,"pushed_at":"2025-08-11T09:57:59.000Z","size":66,"stargazers_count":29,"open_issues_count":4,"forks_count":3,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-08-11T11:41:44.606Z","etag":null,"topics":["counter-strike","counter-strike-2","counterstrikesharp","cs2","cs2-plugin","essentials","hvh","plugin","rapidfire"],"latest_commit_sha":null,"homepage":"https://hvh.gg","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HvH-gg.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":"2024-02-27T09:41:46.000Z","updated_at":"2025-08-11T09:57:33.000Z","dependencies_parsed_at":"2024-07-28T08:51:32.905Z","dependency_job_id":"a23ed522-b174-4519-9c32-e928612101ee","html_url":"https://github.com/HvH-gg/CS2-Essentials","commit_stats":null,"previous_names":["hvh-gg/cs2-essentials"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/HvH-gg/CS2-Essentials","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HvH-gg%2FCS2-Essentials","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HvH-gg%2FCS2-Essentials/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HvH-gg%2FCS2-Essentials/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HvH-gg%2FCS2-Essentials/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HvH-gg","download_url":"https://codeload.github.com/HvH-gg/CS2-Essentials/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HvH-gg%2FCS2-Essentials/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273214038,"owners_count":25065074,"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-09-01T02:00:09.058Z","response_time":120,"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":["counter-strike","counter-strike-2","counterstrikesharp","cs2","cs2-plugin","essentials","hvh","plugin","rapidfire"],"created_at":"2025-09-02T01:04:17.337Z","updated_at":"2025-09-02T01:04:55.151Z","avatar_url":"https://github.com/HvH-gg.png","language":"C#","funding_links":[],"categories":["CounterStrikeSharp Plugins"],"sub_categories":[],"readme":"![Copyright ev0lve Digital](https://img.shields.io/badge/Copyright-ev0lve%20Digital-blue) ![GitHub License](https://img.shields.io/github/license/HvH-gg/CS2-Essentials) ![Issues](https://img.shields.io/github/issues/HvH-gg/CS2-Essentials) ![Downloads](https://img.shields.io/github/downloads/HvH-gg/CS2-Essentials/total) ![Stars](https://img.shields.io/github/stars/HvH-gg/CS2-Essentials)\n\n# [HvH.gg](https://hvh.gg) CS2 Essentials (1.2.7)\n### If you use this plugin, you do NOT need [RapidFireFix](https://github.com/HvH-gg/RapidFireFix) anymore.\n\nOur CS2 Essentials plugin is the only plugin you need to run a successful HvH server. It includes basic features like **reset score** and **rage quit** as well as optional restrictions for **weapons**, **friendly fire**, **rapid fire** and other exploit/crash fixes.\n\n# Features\n- Custom Vote support (requires [CS2-CustomVotes](https://github.com/imi-tat0r/CS2-CustomVotes))\n- Reset score `!rs`\n- Rage quit `!rq`\n- Restrict weapons (awp, scout, autosniper)\n- Restrict friendly fire (default, only utility damage)\n- Restrict rapid fire (0 allows rapid fire, 1 blocks rapid fire, 2 reflects damage scaled, 3 reflects damage but keeps the player alive)\n- **Linux only:** Restrict teleport/airstuck exploit (enabling this will also prevent the server crash exploit)\n\n# Requirements\n- [Metamod:Source](https://www.sourcemm.net/downloads.php/?branch=master)\n- [CounterStrikeSharp(v255)](https://github.com/roflmuffin/CounterStrikeSharp/releases)\n\n# Install\n1. Install Metamod:Source and CounterStrikeSharp\n2. Place the `addons` folder in your servers `game/csgo/` directory  \n   ![extract](https://du.hurenso.hn/r/0NyFPY.png)\n3. Edit the config file to your liking  \n   3.1. Located at `addons/counterstrikesharp/configs/plugins/CS2-Essentials/CS2-Essentials.json`\n4. Restart your server\n\n# Config\nTo reload your config after editing, use `hvh_cfg_~~~~reload` in the server console.\n```json\n{\n   \"RapidFireFixMethod\": 1, // 0 allows rapid fire, 1 blocks rapid fire, 2 reflects damage scaled, 3 reflects damage but keeps the player alive\n   \"RapidFireReflectScale\": 1, // damage reflect percentage (0.0 - 1.0)\n   \"AllowedAwpCount\": -1, // how many awps are allowed per team (0 for none, -1 for unlimited)\n   \"AllowedScoutCount\": -1, // how many scouts are allowed per team (0 for none, -1 for unlimited)\n   \"AllowedAutoSniperCount\": -1, // how many auto snipers are allowed per team (0 for none, -1 for unlimited)\n   \"UnmatchedFriendlyFire\": true, // if true, only utility damage will be dealt to teammates (like on unmatched.gg)\n   \"RestrictTeleport\": true, // if true, the teleport and airstuck exploit will be restricted. This will also prevent the server crash exploit\n   \"AllowAdPrint\": true, // if true, players will see a \"powered by HvH.gg\" ad in the chat with the settings print\n   \"AllowSettingsPrint\": true, // if true, players will see an overview of the server settings with `!settings` and on spawn\n   \"AllowResetScore\": true, // if true, players will be able to reset their score with `!rs`\n   \"AllowRageQuit\": true, // if true, players will be able to rage quit with `!rq`\n   \"ChatPrefix\": \"[{Red}Hv{DarkRed}H{Default}.gg]\", // chat prefix for plugin messages\n   \"CustomVoteSettings\": { // settings for custom votes (requires CS2-CustomVotes)\n      \"FriendlyFireVote\": false, // if true, players will be able to vote for friendly fire settings\n      \"TeleportFixVote\": false, // if true, players will be able to vote for the teleport fix settings\n      \"RapidFireVote\": \"full\", // You can set the style (`off`, `simple`, `full`) for the rapid fire vote\n      \"Style\":\"center\" // You can set the style (`center` or `chat`) for the vote menu (might be overridden by CS2-CustomVotes settings)\n   },\n   \"ConfigVersion\": 4 // do not change\n}\n```\n\n# ConVars\nInstead of editing the config file, you can also use the following ConVars to change certain settings **on the fly**. These changes will **NOT** be saved to the config file and will be reset after a server restart.\n- `hvh_restrict_rapidfire` 0 allows rapid fire, 1 blocks rapid fire, 2 reflects damage scaled, 3 reflects damage but keeps the player alive\n- `hvh_rapidfire_reflect_scale` damage reflect percentage, 0.0 - 1.0\n- `hvh_restrict_teleport` if true, the teleport and airstuck exploit will be restricted. This will also prevent the server crash exploit\n- `hvh_restrict_awp` how many awps are allowed per team, 0 for none, -1 for unlimited\n- `hvh_restrict_scout` how many scouts are allowed per team, 0 for none, -1 for unlimited\n- `hvh_restrict_auto` how many auto snipers are allowed per team, 0 for none, -1 for unlimited\n- `hvh_unmatched_friendlyfire` if true, only utility damage will be dealt to teammates\n- `hvh_resetscore 0/1` if true, players will be able to reset their score with `!rs`\n- `hvh_ragequit 0/1` if true, players will be able to rage quit with `!rq`\n\n# ChatPrefix Colors\nYou can use all available colors from CounterStrikeSharp in the chat prefix.\n\n# Custom Votes\nIf you have [CS2-CustomVotes](https://github.com/imi-tat0r/CS2-CustomVotes) installed, you can use the following custom votes:\n- `!rapidfire` You can set the style (`off`, `simple`, `full`) in the config via `CustomVoteSettings.RapidFireVote`\n- `!friendlyfire` You can enable this in the config via `CustomVoteSettings.FriendlyFireVote`\n- `!teleport` You can enable this in the config via `CustomVoteSettings.TeleportVote`\n\u003e **Warning:** Teleport restriction is needed to prevent the server crash exploit. If you enable this vote, the server will be vulnerable to the crash exploit.\n\n# Credits\n- [HvH.gg](https://hvh.gg)\n- [Metamod:Source](https://www.sourcemm.net/)\n- [CounterStrikeSharp](https://github.com/roflmuffin/CounterStrikeSharp)\n- [MagicBulletFix](https://github.com/CS2Plugins/MagicBulletFix)\n\n# Buy us a coffee\nIf you like our work, consider [buying us a coffee](https://hvh.gg/plugins).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHvH-gg%2FCS2-Essentials","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FHvH-gg%2FCS2-Essentials","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHvH-gg%2FCS2-Essentials/lists"}