{"id":20761470,"url":"https://github.com/thatsinewave/wgpinger-bot","last_synced_at":"2025-07-08T07:14:14.787Z","repository":{"id":226642182,"uuid":"769264100","full_name":"ThatSINEWAVE/WGPinger-Bot","owner":"ThatSINEWAVE","description":"A discord bot that uses Wargaming's API to check the status of each server while also checking the ping locally","archived":false,"fork":false,"pushed_at":"2025-03-06T00:22:25.000Z","size":37,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-14T17:12:40.286Z","etag":null,"topics":["community","discord-api","discord-bot","discord-py","good-first-contribution","good-first-issue","good-first-pr","good-first-project","mit-license","open-source","ping","pinger","prototype","python","status-check","thatsinewave","wargaming","wargaming-api","world-of-tanks","world-of-tanks-bot"],"latest_commit_sha":null,"homepage":"https://github.com/ThatSINEWAVE/WGPinger-Bot","language":"Python","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/ThatSINEWAVE.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"ThatSINEWAVE","ko_fi":"thatsinewave"}},"created_at":"2024-03-08T17:22:33.000Z","updated_at":"2025-03-06T00:23:05.000Z","dependencies_parsed_at":"2025-04-14T17:12:43.148Z","dependency_job_id":"64c1b784-cd0a-41d4-97ff-ff4ddfa8e882","html_url":"https://github.com/ThatSINEWAVE/WGPinger-Bot","commit_stats":null,"previous_names":["thatsinewave/wgpinger-bot"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ThatSINEWAVE/WGPinger-Bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThatSINEWAVE%2FWGPinger-Bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThatSINEWAVE%2FWGPinger-Bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThatSINEWAVE%2FWGPinger-Bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThatSINEWAVE%2FWGPinger-Bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ThatSINEWAVE","download_url":"https://codeload.github.com/ThatSINEWAVE/WGPinger-Bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThatSINEWAVE%2FWGPinger-Bot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264220427,"owners_count":23574880,"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","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":["community","discord-api","discord-bot","discord-py","good-first-contribution","good-first-issue","good-first-pr","good-first-project","mit-license","open-source","ping","pinger","prototype","python","status-check","thatsinewave","wargaming","wargaming-api","world-of-tanks","world-of-tanks-bot"],"created_at":"2024-11-17T10:20:54.220Z","updated_at":"2025-07-08T07:14:14.744Z","avatar_url":"https://github.com/ThatSINEWAVE.png","language":"Python","funding_links":["https://github.com/sponsors/ThatSINEWAVE","https://ko-fi.com/thatsinewave"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# WGPinger - Server Monitoring Discord Bot\n\nThis Discord bot provides server statistics for Wargaming (WG) servers and allows users to check the ping for specific game servers. Additionally, it updates Discord channel names with real-time player counts and ping information.\n\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n# [Join my discord server](https://discord.gg/2nHHHBWNDw)\n\n\u003c/div\u003e\n\n## Features\n\n- Get real-time Wargaming server statistics (player counts) by region\n- Check ping to specific game servers \n- Automatically update Discord channel names with server stats and ping information\n- Support for multiple regions: EU, NA, ASIA, and more\n- Easy configuration using environment variables\n\n\u003cdiv align=\"center\"\u003e\n\n## ☕ [Support my work on Ko-Fi](https://ko-fi.com/thatsinewave)\n\n\u003c/div\u003e\n\n## Installation\n\n1. **Clone the repository:**\n\n```bash\ngit clone https://github.com/your-username/WGPinger-Bot.git\ncd WGPinger-Bot\n```\n\n2. **Install the required Python packages:**\n\n```bash\npip install discord.py python-dotenv aiohttp\n```\n\n3. **Set up your environment variables:**\n\nCopy the example environment file and edit it with your credentials:\n\n```bash\ncp .env.example .env\n```\n\nThen edit the `.env` file with the following information:\n- Your Discord bot token\n- Your Wargaming Application ID\n- Channel IDs for server stats display\n\n4. **Run the bot:**\n\n```bash\npython main.py\n```\n\n## Environment Configuration\n\nThe bot uses environment variables for all configuration settings:\n\n- `DISCORD_BOT_TOKEN`: Your Discord bot token\n- `WG_APPLICATION_ID`: Your Wargaming application ID\n- Server channel mappings (for each server):\n  - `SERVER_PLAYERS_CHANNEL_ID`: Channel to display player count\n  - `SERVER_PING_CHANNEL_ID`: Channel to display ping\n\nExample for the `.env` file:\n\n```\nDISCORD_BOT_TOKEN=your_discord_bot_token_here\nWG_APPLICATION_ID=your_wargaming_application_id_here\n\n# Channel IDs\nEU1_PLAYERS_CHANNEL_ID=123456789012345678\nEU1_PING_CHANNEL_ID=123456789012345678\n```\n\n## Commands\n\n1. **/wgstats** - Fetches Wargaming server statistics for a specific region.\n\n### Usage:\n\n```\n/wgstats [region]\n```\n\n`region` (optional): The server region (\"EU\", \"NA\", \"ASIA\", or \"ALL\"). Defaults to \"EU\" if not specified.\n\n2. **/checkping** - Checks the ping for a specific game server or all servers.\n\n### Usage:\n\n```\n/checkping [server]\n```\n\n`server`: The server API name or \"ALL\" to check ping for all servers.\n\n\u003cdiv align=\"center\"\u003e\n\n# [Join my discord server](https://discord.gg/2nHHHBWNDw)\n\n\u003c/div\u003e\n\n## Server Configuration\n\nServer information is stored in `clusters.json`. This file contains details about each game server:\n- Server name\n- Location\n- Connection address\n- API identifier\n- Color code for display\n\n## Automatic Channel Updates\n\nThe bot automatically updates Discord channel names with:\n- Current player counts for each server\n- Current ping times in milliseconds\n\nThese updates occur every 5 minutes to avoid Discord API rate limits.\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthatsinewave%2Fwgpinger-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthatsinewave%2Fwgpinger-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthatsinewave%2Fwgpinger-bot/lists"}