Description
GameQuery Server Lists is a free, open-source WordPress plugin released under GPL-2.0-or-later.
It is built for gaming blogs and community websites that want a fast, reliable way to promote game servers.
With this plugin, a site owner can add server addresses, select the game, and publish a server list in minutes.
Lists can be embedded anywhere with shortcodes and integrated in widget areas across pages.
WordPress admins can embed lists with:
[wpgs_list_123][wpgs_list id="123"]
Key features include:
- One-click secure GameQuery account connection with API key selection.
- Multi-game list support with templates and background refresh via WP-Cron.
- Built-in analytics for views and clicks.
- Campaign goal automation that can auto-hide a server list after owner-defined click/view limits are reached.
External services
This plugin connects to GameQuery services for account connection, server data fetching, and game catalog lookup.
-
GameQuery API (
https://api.gamequery.dev) is used to fetch server payload data and the games catalog.- Data sent on server fetch requests: configured
game_idvalues, configured serverIP:PORTvalues, API account email, API token, and selected API plan. - Data sent on games catalog requests: no user identifiers or personal data; only a GET request for available games.
- Trigger: when list cache is refreshed (WP-Cron or cache miss) and when games catalog cache refreshes.
- Terms of Service: https://gamequery.dev/terms-of-service
- Privacy Policy: https://gamequery.dev/privacy-policy
- Data sent on server fetch requests: configured
-
GameQuery account service (
https://gamequery.dev) is used when an admin connects an account from plugin settings.- Data sent: site URL, admin URL, plugin version, PKCE/session metadata, and temporary authorization/session tokens during the connect flow.
- Trigger: only after an admin clicks the connect button.
- Terms of Service: https://gamequery.dev/terms-of-service
- Privacy Policy: https://gamequery.dev/privacy-policy
Installation
- Upload plugin files to
/wp-content/plugins/gamequery-servers-lists, or install through your deployment process. - Activate the plugin through the “Plugins” screen in WordPress.
- In
WPGS -> Settings, connect your account with the one-click GameQuery popup (or use manual credentials). - Create lists in
WPGS -> Lists.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“GameQuery Server Lists” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “GameQuery Server Lists” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.1.6
- Security: stop pre-filling the API token field in Settings; the stored value is no longer echoed into the HTML. A “(saved)” indicator and optional “Clear saved token” checkbox replace the old behavior.
- Security: restrict the Account Base URL and API Base URL settings to
gamequery.devhosts by default and block loopback/private/link-local targets. DefineWPGS_ALLOW_CUSTOM_API_URLinwp-config.phpto opt-in to custom hosts for staging/dev setups. - Security: require
https://for the default GameQuery endpoints and reject URLs containing embedded credentials.
0.1.5
- Remove per-list Custom CSS input and all frontend
<style>injection paths. - Replace admin inline
<script>blocks withwp_enqueue_script()+wp_add_inline_script(). - Move admin menu to a lower position in the WordPress sidebar.
- Escape stats progress bar output at render time with
wp_kses(). - Prefix shortcode names to
wpgs_listandwpgs_list_{id}. - Add explicit external service disclosure with data usage plus Terms/Privacy links.
0.1.4
- Replace browser datalist behavior with a dedicated searchable game selector in Server Groups.
- Add manual Game ID override support while keeping automatic game-name to game-id mapping.
- Store the games catalog in WordPress DB and refresh it every 7 days.
- Update manual Game ID placeholder example to
minecraft.
0.1.3
- Add secure one-click GameQuery account connect flow with popup key selection.
- Add plugin account base URL setting for the connect flow.
- Harden connect security with ownership confirmation, endpoint rate limits, and connection alerts.
- Lock plan field to auto-detected value and auto-correct stale plan settings during API fetch.
- Improve Stats page with status filtering, search, and trash actions (single + bulk).
0.1.2
- Add widget support and shortcode rendering improvements.
- Add campaign goal controls and copy-IP display option.
- Improve cache-busting for admin/frontend assets.
0.1.1
- Improve cache-busting for admin/frontend assets.
0.1.0
- Initial MVP release.











