=== Gaming-Plus Game Server Status ===
Contributors: nilsdberlin
Tags: minecraft, game server, server status, gaming, community
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Show the live status of your Minecraft & Steam game servers on your WordPress site: online/offline, players, version, ping. Fast, no external API.

== Description ==

Game Server Status shows your community a clean, modern status card telling them whether your server is up right now – including player count, version, MOTD and ping. No external services: the query runs directly over the game protocol (Minecraft Java & Bedrock, Steam/Source A2S).

Easy to use: add your server under the "Game Server" menu (name, address, port) – you instantly get a ready-to-use shortcode, or let it create a finished page with one click.

`[gpgss_server_status id="1"]`

With live updates (every 30 seconds, without reloading):

`[gpgss_server_status id="1" refresh="30"]`

Or directly by address, without saving:

`[gpgss_server_status host="mc.yourserver.com" port="25565"]`

Results are cached for 60 seconds to keep your site fast.

= What's on board =

* Minecraft Java & Bedrock, Steam/Source (CS2, Rust, ARK, Valheim, GMod, 7DTD, TF2 …)
* Server icon, "Copy address" & "Join" (steam://connect)
* Player list, live auto-refresh, server grid
* Player history (24h) & uptime display
* Gutenberg block, design options (5 card styles, theme/color/width)
* Downtime alerts via email & Discord

= Planned =

* Rank/perk sales with in-game delivery

The plugin is fully translatable and ready for community translations via translate.wordpress.org.

== Installation ==

1. Upload the plugin folder to `wp-content/plugins/` (or install the ZIP via "Plugins > Add New > Upload Plugin").
2. Activate the plugin.
3. Add a server under the "Game Server" menu and insert the shortcode shown – or click "Create page" right away.
4. Alternatively, insert the "Game Server Status" block in the editor and pick your server.

== Frequently Asked Questions ==

= Which servers are supported? =

Minecraft Java, Minecraft Bedrock, and Steam/Source games via A2S: Counter-Strike 2, Rust, ARK, Valheim, Garry's Mod, 7 Days to Die, Team Fortress 2 and more. For Source games, use the query port (not always the game port).

= Does the plugin need an external API? =

No. The query runs directly over sockets (Minecraft Server List Ping, and UDP for Bedrock and Steam/Source).

= Can it show whether a whitelist is active? =

No. The whitelist status is not part of the server response and cannot be reliably read from the outside.

= Will I be notified when my server goes down? =

Yes. Under "Game Server > Alerts" you can enable email and/or a Discord webhook. The plugin checks every 5 minutes and reports downtime as well as recovery.

= Is any data sent to third parties? =

No. The plugin only contacts the game servers YOU enter (to query their status), and – only if you enable it – your own Discord webhook for downtime notifications. There is no external service, no tracking, and no sharing of visitor data.

== Screenshots ==

1. The status card on your website – with server icon, player count, version, ping and player list.
2. Design settings: choose from 5 card styles with an instant live preview.
3. Server management in the admin – with live status per server.
4. Downtime alerts via email and Discord webhook.

== Changelog ==

= 1.0.0 =
* First public release. Includes: Minecraft (Java & Bedrock) and Steam/Source games (CS2, Rust, ARK, Valheim, GMod, 7DTD, TF2), server icon, copy/join button, player list, live auto-refresh, server grid, player history (24h) & uptime, Gutenberg block, 5 card styles with design options, and downtime alerts (email/Discord).
