{"id":30689088,"url":"https://github.com/wiruwiru/AutomaticAds-CS2","last_synced_at":"2025-09-02T01:05:08.542Z","repository":{"id":270501649,"uuid":"865036038","full_name":"wiruwiru/AutomaticAds-CS2","owner":"wiruwiru","description":"Allows server administrators to configure an advertisement to be sent automatically, at the moment of sending it, a sound is also played so that users pay attention to the advertisement. (for CounterStrikeSharp)","archived":false,"fork":false,"pushed_at":"2025-08-22T21:21:32.000Z","size":481,"stargazers_count":17,"open_issues_count":2,"forks_count":7,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-08-22T23:56:45.535Z","etag":null,"topics":["counter-strike-2","counterstrikesharp","cs2","metamod"],"latest_commit_sha":null,"homepage":"","language":"C#","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/wiruwiru.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","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},"funding":{"custom":["https://paypal.me/lucauy"]}},"created_at":"2024-09-29T20:13:59.000Z","updated_at":"2025-08-22T21:20:47.000Z","dependencies_parsed_at":"2025-02-12T06:27:45.167Z","dependency_job_id":"18104fcd-6931-4476-9bf4-fe42f423552f","html_url":"https://github.com/wiruwiru/AutomaticAds-CS2","commit_stats":null,"previous_names":["wiruwiru/automaticads-cs2"],"tags_count":31,"template":false,"template_full_name":null,"purl":"pkg:github/wiruwiru/AutomaticAds-CS2","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wiruwiru%2FAutomaticAds-CS2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wiruwiru%2FAutomaticAds-CS2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wiruwiru%2FAutomaticAds-CS2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wiruwiru%2FAutomaticAds-CS2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wiruwiru","download_url":"https://codeload.github.com/wiruwiru/AutomaticAds-CS2/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wiruwiru%2FAutomaticAds-CS2/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273214054,"owners_count":25065078,"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-2","counterstrikesharp","cs2","metamod"],"created_at":"2025-09-02T01:04:18.324Z","updated_at":"2025-09-02T01:05:08.507Z","avatar_url":"https://github.com/wiruwiru.png","language":"C#","funding_links":["https://paypal.me/lucauy"],"categories":["CounterStrikeSharp Plugins"],"sub_categories":[],"readme":"# AutomaticAds CS2\nThis plugin allows you to schedule and display announcements in the chat at customizable intervals. Each announcement is accompanied by a brief sound effect to capture players' attention seamlessly.\n\n\u003e [!CAUTION]\n\u003e Ads with `\"Screen\"` have been re-enabled. However, the current solution does not work as well as it did before the 07/28/2025 update. It is recommended not to use this feature for now, pending a more stable method.\n\nhttps://github.com/user-attachments/assets/aae16cc4-7c67-477a-8c89-437d5c035211\n\n## 📖 Complete Documentation\nFor detailed installation instructions, configuration examples, and advanced usage, please visit our complete documentation:\n\n**[🔗 View Full Documentation](https://www.lucauy.dev/docs/automaticads)**\n\n---\n\n### Installation\n1. Install [CounterStrike Sharp](https://github.com/roflmuffin/CounterStrikeSharp) and [Metamod:Source](https://www.sourcemm.net/downloads.php/?branch=master)\n2. Download [AutomaticAds.zip](https://github.com/wiruwiru/AutomaticAds-CS2/releases/latest) from releases\n3. Extract and upload to your game server\n4. Start server and configure the generated config file\n\n---\n\n### Main Configuration Parameters\n\n| Parameter            | Description                                                                                       | Required |\n|----------------------|---------------------------------------------------------------------------------------------------|----------|\n| `ChatPrefix`         | The prefix displayed in the chat before each announcement. Supports colors. To use it, include `{prefix}` inside the `message` field in the ads configuration.                        | **YES**  |\n| `GlobalPlaySound`      | Sound that is played when an announcement is sent in case `playSoundName` is not set in the announcement and `disableSound` is not `true`. Leave it blank to disable it.                             | **YES**  |\n| `GlobalInterval` | Default interval (in seconds) between announcements if no individual interval is set in the ad configuration. (**Default**: 30s) | **YES**  |\n| `GlobalPositionX` | Default X position for screen messages. Range: -5.0 to 5.0. Negative values = left, positive = right. (**Default**: -1.8) | **YES**  |\n| `GlobalPositionY` | Default Y position for screen messages. Range: -3.0 to 3.0. Negative values = lower, positive = higher. (**Default**: 1.0) | **YES**  |\n| `AdminFlag`      | The permission flag required for a player to be considered an admin in `{admincount}` and `{adminnames}`. | **YES**  |\n| `SendAdsInOrder`     | Send announcements in an orderly manner, respecting the intervals.                                | **YES**  |\n| `UseWelcomeMessage`  | Set to `true` to enable the welcome message. Set to `false` to disable it.                        | **YES**   |\n| `JoinLeaveMessages`  | Set `true` to enable custom connection and disconnection messages. Set `false` to disable it.                        | **YES**   |\n| `WelcomeDelay`  | This is the time the plugin will wait to send the welcome message after the player connects (**Default**: 3s).                        | **YES**   |\n| `CenterHtmlDisplayTime`  | Duration (in seconds) that ads with `displayType` set to `CenterHtml` will remain visible. (**Default**: 5s) | **YES**   |\n| `ScreenDisplayTime`  | Duration (in seconds) that ads with `displayType` set to `Screen` will remain visible. (**Default**: 5s) | **YES**   |\n| `UseMultiLang` | Enables support for multiple languages in messages. When `true`, the plugin will attempt to use the player's language if available. (**Default**: `true`) | **YES**  |\n| `DefaultLanguage` | Language used as a fallback when no localized message is found for a player. (**Default**: `en`) | **YES**  |\n| `Welcome`     | Configuration for the welcome announcement. Supports variables. | **NO**   |\n| `JoinLeave`     | Configuration for connection and disconnection messages. Supports variables. | **NO**   |\n| `Ads`                | List of advertisements to be sent. Each ad can be configured individually. | **YES**  |\n\n### Ads Configuration Parameters\n\n| Parameter       | Description                                                                                         | Required |\n|-----------------|-----------------------------------------------------------------------------------------------------|----------|\n| `message` | The message/announcement to send in the chat. Supports colors. | **YES**  |\n| `viewFlag` | Flag required to view the message. Set it to `\"all\"` to make it available to all players (default: `\"all\"`). | **NO** |\n| `excludeFlag` | Users with this flag will not see the message. Set it to `\"\"` so that no players are excluded (default: `\"\"`). | **NO** |\n| `map` | The map where this announce should appear. Use `\"all\"` to show it on all maps or specify a map name (default: `\"all\"`). | **NO**   |\n| `interval` | The interval **(in seconds)** between sending this ad. Must be between `10` and `3600` (default: `600`). | **NO** |\n| `positionX` | X position for screen messages. Range: -5.0 to 5.0. If not set, uses `GlobalPositionX`. Only applies to `displayType: \"Screen\"`. | **NO** |\n| `positionY` | Y position for screen messages. Range: -3.0 to 3.0. If not set, uses `GlobalPositionY`. Only applies to `displayType: \"Screen\"`. | **NO** |\n| `disableSound` | If `true`, no sound will be played when this ad is sent (default: `false`). | **NO** |\n| `onlyInWarmup` | If `true`, the ad will only be sent during the warmup period (default: `false`).   | **NO** |\n| `onlySpec` | If `true`, this ad will only be sent to players on the spectator team (default: `false`). | **NO** |\n| `onDead` | If `true`, this ad will be sent when a player dies (default: `false`). | **NO** |\n| `triggerAd` | An array of commands that players can use to view this announcement before it is sent automatically. For example: `[\"command1\", \"command2\"]`. | **NO** |\n| `disableInterval` | If `true`, this ad will not be sent automatically. It will only be sent manually via `triggerAd` commands (default: `false`). | **NO** |\n| `disableOrder` | If `true`, this ad will ignore the sequential sending order when `sendAdsInOrder` is enabled (default: `false`). | **NO** |\n| `playSoundName` | The specific sound to play when this announcement is sent. If not set, `GlobalPlaySound` will be used if set, provided `disableSound` is not `true`. | **NO** |\n| `displayType` | Controls how the message is displayed. Options: `\"Chat\"` (default, normal chat message), `\"Center\"` (center screen text), `\"CenterHtml\"` (center screen with HTML formatting support), `\"Screen\"` (floating text on the player's screen). | **NO** |\n\n### Available Colors\n`GREEN`, `RED`, `YELLOW`, `BLUE`, `ORANGE`, `WHITE`, `PURPLE`, `GREY`, `LIGHT_RED`, `LIGHT_BLUE`, `LIGHT_YELLOW`, `LIGHT_PURPLE`, `DARK_RED`, `BLUE_GREY`, `DARK_BLUE`, `LIME`, `OLIVE`, `GOLD`, `SILVER`, `MAGENTA`.\n\n### Available Variables\nYou can use the following placeholders in your announcements:\n\n| Variable        | Description                                                   |\n|----------------|---------------------------------------------------------------|\n| `{prefix}`       | A dynamic variable replaced with the value of ChatPrefix in each message. Enables optional inclusion or exclusion of the prefix. |\n| `{ip}`           | The server's IP address.                                      |\n| `{port}`         | The server's port.                                            |\n| `{hostname}`     | The server's hostname.                                        |\n| `{map}`          | The current map being played.                                 |\n| `{time}`         | The current time in the server's timezone.                    |\n| `{date}`         | The current date.                                             |\n| `{playername}`   | The name the player has on Steam.                             |\n| `{players}`      | The current number of players online.                         |\n| `{maxplayers}`   | The maximum number of players the server can hold.            |\n| `{admincount}`   | The number of administrators currently online.                |\n| `{adminnames}`   | A comma-separated list of the names of online administrators. |\n\n---\n\n## Additional Information\n\n- **[📋 Behavior \u0026 Features](BEHAVIOR.md)** - Detailed information about plugin behavior and features\n- **[🤝 Contributing](CONTRIBUTING.md)** - Guidelines for contributing to the project\n- **[📝 TO-DO](TODO.md)** - Upcoming tasks and features\n\n---\n\n## Support\n\nFor issues, questions, or feature requests, please visit our [GitHub Issues](https://github.com/wiruwiru/AutomaticAds-CS2/issues) page.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwiruwiru%2FAutomaticAds-CS2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwiruwiru%2FAutomaticAds-CS2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwiruwiru%2FAutomaticAds-CS2/lists"}