Skip to content

🐘 PHP library to query servers that implement Steam query protocol (also known as Source Engine Query protocol)

License

Notifications You must be signed in to change notification settings

xPaw/PHP-Source-Query

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

PHP Source Query

Packagist Downloads Packagist Version

This class was created to query game server which use the Source query protocol, this includes all source games, and all the games that implement Steamworks.

The class also allows you to query servers using RCON although this only works for half-life 1 and source engine games.

Minecraft also uses Source RCON protocol, and this means you can use this class to send commands to your minecraft server while having engine set to Source engine.

⚠️ Do not send me emails if this does not work for you, I will not help you.

Requirements

Protocol Specifications

Supported Games

AppID Game Query RCON Notes
~ All HL1/HL2 games and mods βœ… βœ…
10 Counter-Strike 1.6 βœ… βœ…
440 Team Fortress 2 βœ… βœ…
550 Left 4 Dead 2 βœ… βœ…
730 Counter-Strike 2 βœ… βœ… host_name_store 1; host_info_show 2; host_players_show 2
1002 Rag Doll Kung Fu βœ… βœ…
2400 The Ship βœ… βœ…
4000 Garry's Mod βœ… βœ…
17710 Nuclear Dawn βœ… βœ…
70000 Dino D-Day βœ… βœ…
107410 Arma 3 βœ… ❌ Add +1 to the server port
115300 Call of Duty: Modern Warfare 3 βœ… βœ…
162107 DeadPoly βœ… ❌
211820 Starbound βœ… βœ… Call SetUseOldGetChallengeMethod method after connecting
244850 Space Engineers βœ… ❌ Add +1 to the server port
304930 Unturned βœ… ❌ Add +1 to the server port
251570 7 Days to Die βœ… ❌
252490 Rust βœ… ❌
282440 Quake Live βœ… ❌ Quake Live uses the ZMQ messaging queue protocol for rcon control.
346110 ARK: Survival Evolved βœ… βœ…
~ Minecraft ❌ βœ…
108600 Project: Zomboid βœ… βœ…

Open a pull request if you know another game which supports Source Query and/or RCON protocols.

How to tell if the game supports Source Query Protocol?

Add your server to your favourites in Steam server browser, and if Steam can display information about your server, then the protocol is supported.

Functions

Connect( $Ip, $Port, $Timeout, $Engine ) Opens connection to a server
Disconnect( ) Closes all open connections
Ping( ) Ping the server to see if it exists
Warning: Source engine may not answer to this
GetInfo( ) Returns server info in an array
GetPlayers( ) Returns players on the server in an array
GetRules( ) Returns public rules (cvars) in an array
SetRconPassword( $Password ) Sets rcon password for later use with Rcon()
Rcon( $Command ) Execute rcon command on the server

Also refer to examples folder to work things out.

License

PHP Source Query
Copyright (C) 2012-2015 Pavel Djundik

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA