PHPackages                             stormyy/q3tool - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. stormyy/q3tool

ActiveLibrary[Utility & Helpers](/categories/utility)

stormyy/q3tool
==============

Quake 3 Server interaction for PHP

0.2.1(8y ago)12911MITPHPPHP >=5.3.0

Since May 24Pushed 8y ago1 watchersCompare

[ Source](https://github.com/Stormyy/q3tool)[ Packagist](https://packagist.org/packages/stormyy/q3tool)[ Docs](http://github.com/c9jester/q3tool)[ RSS](/packages/stormyy-q3tool/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (2)DependenciesVersions (2)Used By (1)

Q3Tool
======

[](#q3tool)

PHP class for working with ioquake3-based game servers. Fork from c9jester/q3tool with fixes from avail/q3tool

Overview
--------

[](#overview)

Q3Tool is a simple PHP class that allows developers to quickly and easily retrieve information from, or send remote commands (RCON) to game servers that are based on the Quake 3 (ioq3) engine. It was developed for, and has been extensively used with, Urban Terror servers, but should work for just about anything using ioq3 (or even just the same protocol).

Usage
-----

[](#usage)

```
// Using composer (https://packagist.org/packages/jester/q3tool)
require('vendor/autoload.php');

// Or stand-alone
require('q3tool.php');

// Default port, no RCON
$tool = new q3tool("myclan.org");

// Non-default port, no RCON
$tool = new q3tool("myclan.org", 27961);

// Including RCON
$tool = new q3tool("myclan.org", 27960, "super1337password");

// Get a list of players as an array
$players = $tool->get_info("playerlist");

// Or just how many players are on
$player_num = $tool->get_info("players");

// Sending an RCON command
$response = $tool->send_rcon('bigtext "Hello all!"');
```

See DATA\_TYPES for more information on retrieving the information you want.

Known Issues
------------

[](#known-issues)

Getting the console response from sending an RCON command is unreliable at best. This seems to be an issue with ioq3 truncating the reply when sent over the wire. I have not yet figured out a solution. Issuing commands, however, does work.

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 73.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

3278d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4cb9e867b01d637a74de7c695846595c94b36241a626f35e953c6e2860e3cef0?d=identicon)[Stormyy](/maintainers/Stormyy)

---

Top Contributors

[![c9jester](https://avatars.githubusercontent.com/u/4666421?v=4)](https://github.com/c9jester "c9jester (11 commits)")[![avail](https://avatars.githubusercontent.com/u/2692729?v=4)](https://github.com/avail "avail (2 commits)")[![Stormyy](https://avatars.githubusercontent.com/u/5009558?v=4)](https://github.com/Stormyy "Stormyy (2 commits)")

---

Tags

gameq3quakeioq3

### Embed Badge

![Health badge](/badges/stormyy-q3tool/health.svg)

```
[![Health](https://phpackages.com/badges/stormyy-q3tool/health.svg)](https://phpackages.com/packages/stormyy-q3tool)
```

###  Alternatives

[jacklul/q3serverlist

Simple library for querying Quake 3 based master servers and it's game servers

176.2k](/packages/jacklul-q3serverlist)[irfa/php-gatcha

Simple Items Gatcha with PHP

362.4k](/packages/irfa-php-gatcha)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)