- Minetest - Added support for minetest utilizing official server list (By @xCausxn #573)
- Soulmask - Added support (By @xCausxn #572)
- Restore Minecraft's favicon (#575)
- Grand Theft Auto V: Rage MP - Added support (By @xCausxn #576)
- Fix duplicate game entry for The Forest (2014), add old id for backwards compatibility (By @xCausxn #579)
- Added a new stabilized field
version
in the query response (By @podrivo #532) - Euro Truck Simulator 2 (2012) - Added support (By @podrivo #523)
- Eco - Fixed querying servers using reverse queries and player names (By @Vito0912 #526)
- Factorio (2016) - Added support (By @Vito0912 #527)
- Farming Simulator 22 (2021) - Added support (By @Vito0912 #531)
- Farming Simulator 19 (2018) - Added support (By @Vito0912 #531)
- Assetto Corsa - Fixed how
state.numplayers
is set (By @podrivo #538) - TeamSpeak 2 - Fixed how
state.name
is set (By @podrivo #544) - Grand Theft Auto: San Andreas OpenMP - Fixed
state.players
returning an empty array (By @Focus04 #547) - Perf: Re-write of the
core
class. - Perf: Remove many if statements from
GameSpy2
. - Myth of Empires - Added support.
- Fix: BeamMP maxplayers that was displaying player count (By @dgibbs64 #551)
- Fix: BeamMP filter servers by address, not host (By @Rephot #558)
- Palworld - Replace old and broken protocol with the new one (#560)
- Nova-Life: Amboise - Added support.
- Abiotic Factor - Added Support.
- Fixed support for projects using
require
.
- Fixed numplayers on Palworld not beeing accurate
- Enshrouded - Added support (By @GuilhermeWerner #512).
- Fixed typo in standard port on Palworld (By jammsen #515)
- Re-added support for projects using
require
(By @GuilhermeWerner #519). - Duke Nukem Forever 2001 (2022) - Added support (By @podrivo #499)
- Node.js 16.20 is now required (from 14).
- Made the library a
module
. - Removed
GameResolver
, moved theGameDig
class in a separate file. - Modified exports, now the library exports
games
andprotocols
alongside theGameDig
class.- Many game ids have changed, see the migrate ids file for more info regarding this.
- A game always has these fields:
name
,release_year
andoptions
(which always containsport
/port_query
/port_query_offset
andprotocol
) and could containextra.old_id
.
maxAttempts
has been renamed tomaxRetries
.
- Almost all games ids have been changed to follow a standard, see CONTRIBUTING.md#naming.
- Removed
minecraftping
(as it was deprecated and the same thing asminecraft
) andminecraftpe
(deprecated, which is now the same asmbe
(Minecraft Bedrock Edition)). - Removed the
games.txt
file, the games definitions are now stored in-code (exported ongames
).
- Replaced usage of deprecated
substr
withsubstring
. - Replaced deprecated internal
punycode
with the punycode package. - Updated dependencies:
- Added eslint which spotted some unused variables and other lints.
- CLI: Resolved incorrect error message when querying with a non-existent protocol name.
- Added Deno support: the library and CLI can now be experimentally used with the Deno runtime
- Minimum Supported Deno Version:
1.39.2
. deno run --allow-net bin/gamedig.js --type tf2 127.0.0.1
- Minimum Supported Deno Version:
- Added code examples.
- New stable field:
queryPort
- this number indicates what was the port that the query was done on, 0 indicates none if not applicable. - Fixed
numplayers
not having a default value. - New options:
portCache
(defaults totrue
) after you queried a server, the second time you query that exact server (identified by specified ip and port), first add an attempt to query with the last successful port.stripColors
(defaults totrue
) for protocols that strips colors: unreal2, savage2, quake3, nadeo, gamespy2, doom3, armagetron.requestRulesRequired
(defaults tofalse
) Valve games only.requestRules
is always required to have a response or the query will timeout.requestPlayersRequired
(defaults tofalse
) Valve games only. Querying players is always required to have a response or the query will timeout. Some games may not provide a players response.noBreadthOrder
(defaults tofalse
). If multiple attempts are to be made, disable doing one of each type until reaching the retry count.checkOldIDs
(defaults tofalse
). Query will check for older game type IDs. See migration document.
- Now documented:
address
(defaults toundefined
) Override the IP address of the server skipping DNS resolution. When set, host will not be resolved, instead address will be connected to. However, some protocols still use host for other reasons e.g. as part of the query.
- Removed the players::setNum method, the library will no longer add empty players as
placeholders in the
players
fields. - Valve: dont skip players with no name and keep state.raw.players.
- Stabilized field
numplayers
. - Add note about EOS Protocol not providing players data.
- V Rising (2022) - Updated
options.port_query_offset
to[1, 15]
(#438). - Minecraft (2009) - Add note about players data.
- Fixed Project Cars and Project Cars 2 port offsets.
- Fixed Wurm Unlimited port_query being missnamed.
- BeamMP (2021) - Added support.
- Xonotic (2011) - Added support.
- Call of Duty: Black Ops 3 (2015) - Added support.
- Unreal 2: The Awakening - XMP - Added support.
- Palworld - Added support (By @jonathanprl, #495).
- The Isle Evrima - Added support (By @GuilhermeWerner, #501).
- Fixed support for the Minecraft Better Compatibility Checker Mod (By @Douile, #436).
- Added a -1 query port offset for Rising World (#441).
- Fix
Post Scriptum
not being on the valve protocol. - Added support for the Minecraft Better Compatibility Checker Mod.
- Halo Online (ElDewrito) - Added support (by @Sphyrna-029)
- Renamed
Counter Strike: 2D
toCS2D
in games.txt (why? see this). - Updated
CS2D
protocol (by @ernestpasnik) - Capitalize
Unturned
name ingames.txt
. - Fix an edge-case of the
Doom3
protocol that did not parse the correct field for max players. - Eco (2018) - Added support (requested by @dgibbs64)
- Core Keeper (2022) - Added support (by @dgibbs64)
- ARMA: Reforger (2022) - Added support (by @dgibbs64)
- Action Half-Life - Added support (by @dgibbs64).
- Action: Source (2019) - Added support (by @dgibbs64).
- Base Defense (2017) - Added support (by @dgibbs64).
- Blade Symphony (2014) - Added support (by @dgibbs64).
- Brainbread - Added support (by @dgibbs64).
- Deathmatch Classic (2001) - Added support (by @dgibbs64).
- Double Action: Boogaloo (2014) - Added support (by @dgibbs64).
- Dystopia (2005) - Added support (by @dgibbs64).
- Empires Mod (2008) - Added support (by @dgibbs64).
- Fistful of Frags (2014) - Added support (by @dgibbs64).
- Half-Life: Opposing Force (1999) - Added support (by @dgibbs64).
- Pirates, Vikings, and Knights II (2007) - Added support (by @dgibbs64).
- Project Cars (2015) - Added support (by @dgibbs64).
- Project Cars 2 (2017) - Added support (by @dgibbs64).
- The Specialists - Added support (by @dgibbs64).
- Vampire Slayer - Added support (by @dgibbs64).
- Warfork (2018) - Added support (by @dgibbs64).
- Wurm Unlimited (2015) - Added support (by @dgibbs64).
- The Forest (2014) - Added support.
- Operation: Harsh Doorstop (2023) - Added support.
- Insurgency: Modern Infantry Combat (2007) - Added support.
- Counter-Strike 2 (2023) - Added support.
- The Front (2023) - Added support.
- San Andreas OpenMP - Added support.
- ARK: Survival Ascended (2023) - Added support (by @GuilhermeWerner).
- Replace
compressjs
dependency byseek-bzip
to solve some possible import issues. - Sons Of The Forest (2023) - Added support
- Red Dead Redemption 2 - RedM (2018) - Added support
- Creativerse (2017) - Added support
- The Isle (2015) - Added support
- Updated some dependencies to solve vulnerabilities
- Fixed an issue regarding GameSpy 1 not correctly checking and parsing for numbers.
- Risk of Rain 2 (2019) - Added support
- Survive the Nights (2017) - Added support
- V Rising (2022) - Added support
- Day of Dragons (2019) - Added support
- Onset (2019) - Added support
- Don't Starve Together (2016) - Added support
- Chivalry: Medieval Warfare (2012) - Added support
- Avorion (2020) - Added support
- Black Mesa (2020) - Added support
- Ballistic Overkill (2017) - Added support
- Codename CURE (2017) - Added support
- Colony Survival (2017) - Added support
- Rising World (2014) - Added support
- BrainBread 2 (2016) - Added support
- Fixed ping returned by minecraft queries
- Added ipFamily option to query only ipv4 or only ipv6 dns records
- Fixed filtering out fake "Max Players" player on CSGO
- Removed moment dependency
- Updated dependencies
- Fixed nodejs version requirement in package.json (node 14 has been required since gamedig 4)
- Ground Breach (2018) - Added support
- Minecraft (All Versions) - Fixed character encoding for strings returned by servers using Geyser
- Barotrauma (2019) - Added support
- Counter-Strike 1.5 - Fixed support
- Rust - Fixed maxplayers >255
- dayZ - Fixed tag info not parsing when queryRules wasn't set
- NodeJS 14 is now required
- Dependencies are updated
- Node 14 is now required due to new requirement in
got
dependency
- Fixes player info parsing issues on bf1942-based mods (Thanks cetteup)
- Adds Project Zomboid support (Thanks xhip)
- Adds Post Scriptum support (Thanks arkuar)
- Adds some more DayZ info to state.raw (Thanks podrivo)
- Updates to README regarding DayZ (Thanks podrivo)
- Improvements to DayZ mod parsing from additional more recent reverse engineering (probably still buggy)
- Fixes ping always being 0 for minecraft servers
- Adds README documentation about teamspeakQueryPort
- Fixes player array corruption on some protocols which only report player counts without names (Thanks to a-sync)
- Fixes minecraft protocol not using player list from bedrock protocol in some cases
- Fixes corrupted dayzMods when packet overflow is present
- raw.tags for valve servers is now an array rather than a string
- The special mod list for dayz servers is now parsed into raw.dayzMods is requestRules is set to true
- DayZ queue length, day and night acceleration are now parsed into raw as well
- Add support for
listenUdpPort
to specify a fixed bind port. - Improved udp bind failure detection.
- Add support for Discord widget
- Greatly improve gamespy1 protocol, with additional error handling and xserverquery support.
- Fix player name extraction for Unreal Tournament (1999) and possibly other gamespy1 games.
- Clarified that nodejs 12 is now required for gamedig 3
- Fixed misc player fields not going into
raw
subobject inassettocorsa
,fivem
, andgamespy2
Major Changes:
- NodeJS 12 is now required
- The
name
field is now guaranteed to exist on all player objects. If a player's name is unknown, thename
will be an empty string. - All non-
name
player fields have been moved into araw
sub-field. This means that, like theraw
subobject of the parent response, all non-name
fields are now considered to be unstable and may be changed during minor releases of GameDig. - "Rules" are no longer queried for
valve
protocol games by default. Many games do not respond to this query anyways (meaning we have to wait for timeout), and its contents is often not even used since it only exists in the raw subfield. If you depend on rules, you may pass therequestRules: true
option to re-enable them. - The
raw.steamappid
andraw.gameid
fields for valve games have been consolidated intoraw.appId
.
- Added Valheim (2021)
- Reduced chance of protocol collisions between gamespy3 and minecraftbedrock
- Added support for the native minecraft bedrock protocol, since some bedrock servers apparently do not respond to the gamespy3 protocol.
- Support challenges in A2S_INFO (upcoming change to valve protocol)
- Add Savage 2: A Tortured Soul (2008)
- Fix Conan Exiles and other games which don't respond to the valve player query
- Add givenPortOnly query option for users that require extreme optimization
- Updated dependencies
- Added Assetto Corsa (2014)
- Fixed password flag for Squad
- Added Mordhau (2019)
- Fixed player count being incorrect in minecraftvanilla protocol in some cases
- Updated dependencies
- Replaced deprecated Request http library with Got
- Fixed minecraft protocol never throwing exceptions
- Added Days of War (2017)
- Added The Forrest (2014)
- Added Just Cause 3 Multiplayer (2017)
- Added Project Reality: Battlefield 2 (2005)
- Added Quake Live (2010)
- Added Contagion (2011)
- Added Empyrion: Galactic Survival (2015)
- Added PixARK (2018)
- Various improvements to killing floor / unreal2 protocol
- Added Hell Let Loose
- Added Rising Storm 2: Vietnam
- Added Squad
- Fixed DNS lookup not working in some situations when dns.lookup unexpectedly returns a string
- Improved minecraft protocol for non-vanilla server implementations (bedrock, waterfall, bungeecord)
- Updated dependencies
- Node 8 compatibility fixes
- Improved logging
- Servers are now limited to 10000 players to prevent OOM
- Improvements to Starmade (2012)
- Added Atlas (2018)
- Added Acra Sim Racing
- Added Mafia 2: Online
- Added rFactor
- Added Vice City: Multiplayer
- Improve out-of-order packet handling for gamespy1 protocol
- Work-around for buggy duplicate player reporting from bf1942 servers
- Report team names rather than IDs when possible for gamespy1 protocol
- Prevent tcp socket errors from dumping straight to console
- Added support for host domains requiring Punycode encoding (special characters)
- Added support for Counter-Strike: 2D
- Added details about new 2.0 reponse fields to the README.
- Added support for Insurgency: Sandstorm
- Added support for Starsiege 2009 (starsiege)
- Updated readme games list for 2.0
- Fixed csgo default port
- Node 8 is now required
- Removed the
port_query
option. You can now pass either the server's game port or query port in theport
option, and GameDig will automatically discover the proper port to query. Passing the query port is more likely be successful in unusual cases, as otherwise it must be automatically derived from the game port. - Removed
callback
parameter from Gamedig.query. Only promises are now supported. If you would like to continue using callbacks, you can use node'sutil.callbackify
function to convert the method to callback format. - Removed
query
field from response object, as it was poorly documented and unstable. - Removed
notes
field from options / response object. Data can be passed through a standard javascript context if needed.
- Rewrote core to use promises extensively for better error-handling. Async chains have been dramatically simplified by using async/await across the codebase, eliminating callback chains and the 'async' dependency.
- Replaced
--output pretty
cli parameter with--pretty
. - You can now query from CLI using shorthand syntax:
gamedig --type <gameid> <ip>[:<port>]
- UDP socket is only opened if needed by a query.
- Automatic query port detection -- If provided with a non-standard port, gamedig will attempt to discover if it is a game port or query port by querying twice: once to the port provided, and once to the port including the game's query port offset (if available).
- Added new
connect
field to the response object. This will typically include the game'sip:port
(the port will reflect the server's game port, even if you passed in a query port in your request). For some games, this may be a server ID or connection url if an IP:Port is not appropriate. - Added new
ping
field (in milliseconds) to the response object. As icmp packets are often blocked by NATs, and node has poor support for raw sockets, this time is derived from the rtt of one of the UDP requests, or the time required to open a TCP socket during the query. - Improved debug logging across all parts of GameDig
- Removed global
Gamedig.debug
.debug
is now an option on each query.
- Added support for games using older versions of battlefield protocol.
- Simplified detection of BC2 when using battlefield protocol.
- Fixed buildandshoot not reading player list
- Standardized all doom3 games into a single protocol, which can discover protocol discrepancies automatically.
- Standardized all gamespy2 games into a single protocol, which can discover protocol discrepancies automatically.
- Standardized all gamespy3 games into a single protocol, which can discover protocol discrepancies automatically.
- Improved valve protocol challenge key retry process
- First official release
- Node.js 6 is now required