dsg/squad-rcon-php

Squad Server RCon library


README

Squad RCON PHP Logo

Squad RCON PHP

RCON PHP wrapper for Squad server management

Deutsche Squad Gemeinschaft Deutsche Squad Gemeinschaft Total Downloads Latest Stable Version Latest Unstable Version License
Deutsche Squad Gemeinschaft Discord

Join the Squad RCON Community

If you have any questions or need help with getting started with RCON in OWI games you should make sure to join the Squad RCON Community on Discord.

Installation

You can install this package by using composer and the following command:

composer require dsg/squad-rcon-php

The code will then be available under the DSG\SquadRCON namespace.

Commands

  • ListPlayers
  • ListSquads
  • AdminListDisconnectedPlayers
  • ShowCurrentMap
  • ShowNextMap
  • AdminKick "<NameOrSteamId>" <KickReason>
  • AdminKickById <PlayerId> <KickReason>
  • AdminBan "<NameOrSteamId>" "<BanLength>" <BanReason>
  • AdminBanById <PlayerId> "<BanLength>" <BanReason>
  • AdminBroadcast <Message>
  • AdminRestartMatch
  • AdminEndMatch
  • AdminChangeLevel <LevelName>
  • AdminSetNextLevel <LevelName>
  • AdminChangeLayer <LayerName>
  • AdminSetNextLayer <LayerName>
  • AdminSetMaxNumPlayers <NumPlayers>
  • AdminSetServerPassword <Password>
  • AdminSlomo <TimeDilation>
  • AdminForceTeamChange <NameOrSteamId>
  • AdminForceTeamChangeById <PlayerId>
  • AdminDemoteCommander <PlayerName>
  • AdminDemoteCommanderById <PlayerId>
  • AdminDisbandSquad <TeamId> <SquadId>
  • AdminRemovePlayerFromSquad <PlayerName>
  • AdminRemovePlayerFromSquadById <PlayerId>
  • AdminWarn <NameOrSteamId> <WarnReason>
  • AdminWarnById <PlayerId> <WarnReason>
  • AdminVoteLevel <Choices, concatenated by +>
  • AdminVoteLayer <Choices, concatenated by +>
  • AdminVoteNextLevel <Choices, concatenated by +>
  • AdminVoteNextLayer <Choices, concatenated by +>
  • AdminVote <Vote name> <Choices, concatenated by +>

USAGE

Create an instance

Instanciate the SquadServer class to open a new RCON connection. This will throw an Exception if no connection can be made.

use DSG\SquadRCON\SquadServer;

...

/** @var SquadServer */
$server = new SquadServer(new ServerConnectionInfo(
    host: '127.0.0.1',
    port: 21114,
    password: 'YourRconPassword'
));

Get current server population (Teams, Squads, Players)

Get the current population. This does use ListPlayers & ListSquads to get the Teams, Squads and Players properly ordered.

/** @var Population */
$population = $server->serverPopulation();

/** @var Team[] */
$teams = $population->getTeams();

foreach ($teams as $team) {
    $name = $team->getName();
    
    foreach ($team->getSquads() as $squad) {
        $creatorName = $squad->getCreatorName();
        $creatorSteamId = $squad->getCreatorSteamId();
        
        foreach ($squad->getPlayers() as $player) {
            $name = $player->getName();
            $steamId = $player->getSteamId();
        }
    }
    
    foreach ($team->getPlayers() as $unassigned) {
        $name = $player->getName();
        $steamId = $player->getSteamId();
    }
}

// or

/** @var Player[] */
$players = $population->getPlayers();

// or

/** @var Player|null */
$player = $population->getPlayerBySteamId('76561197960287930');

ListPlayers

Get the current Player list using the ListPlayers command. This does not include disconnected players.

/** @var Player[] */
$players = $server->listPlayers();

Get disconnected Players

Get disconnected players using the ListPlayers command.

/** @var Player[] */
$players = $server->listDisconnectedPlayers();

ListSquads

Get currently active squads (and teams)

/** @var Team[] */
$teams = $server->listSquads();

AdminKick

Kick a player by name, SteamId or ingame id.

/** @var bool */
$success = $server->adminKick('76561197960287930', 'Reason');

// or

/** @var bool */
$success = $server->adminKickById($player->getId(), 'Reason');

AdminBan

Ban a player by name, SteamId or ingame id.

/** @var bool */
$success = $server->adminBan('76561197960287930', '1h', 'Reason');

// or

/** @var bool */
$success = $server->adminBanById($player->getId(), '1h', 'Reason');

Get the current map

Get the current map using the ShowNextMap command

/** @var array */
$map = $server->showCurrentMap();
echo $map['level'];
echo $map['layer'];

Get the next map

Get the next map using the ShowNextMap command

/** @var array */
$map = $server->showNextMap();
echo $map['level'];
echo $map['layer'];

AdminRestartMatch

Restart the current match

/** @var bool */
$success = $server->adminRestartMatch();

AdminEndMatch

End the current match

/** @var bool */
$success = $server->adminEndMatch();

AdminBroadcast

Broadcast message to all players on the server

/** @var bool */
$success = $server->adminBroadcast('Hello from the other side');

AdminChangeLevel

Change the level ( and pick a random layer on it) and travel to it immediately

/** @var bool */
$success = $server->adminChangeLevel('Sumari');

AdminSetNextLevel

Set the next Level ( and pick a random layer on it) to travel to after this match ends

/** @var bool */
$success = $server->adminSetNextLevel('Sumari');

AdminChangeLayer

Change the layer and travel to it immediately

/** @var bool */
$success = $server->adminChangeLayer('Sumari AAS v1');

AdminSetNextLayer

Set the next layer to travel to after this match ends

/** @var bool */
$success = $server->adminSetNextLayer('Sumari AAS v1');

AdminSetMaxNumPlayers

Set the maximum amount of players / slots

/** @var bool */
$success = $server->adminSetMaxNumPlayers(80);

AdminSetServerPassword

Set the server password

/** @var bool */
$success = $server->adminSetServerPassword('secret');

AdminSlomo

Sets the game speed with the AdminSlomo. Default 1.0

/** @var bool */
$success = $server->adminSlomo(1.5);

AdminForceTeamChange

Forces a player to the opposite team by providing the name or steamid.

/** @var bool */
$success = $server->adminForceTeamChange('Name or SteamId');

AdminForceTeamChangeById

Forces a player to the opposite team by providing the ingame Player id.

/** @var bool */
$success = $server->adminForceTeamChangeById($player->getId());

AdminDisbandSquad command.

Disbands a Squad by providing the Team id / index & Squad id / index.

/** @var bool */
$success = $server->adminDisbandSquad($team->getId(), $squad->getId());

AdminRemovePlayerFromSquad

Removes a Player from his Squad by providing the Player name.

/** @var bool */
$success = $server->adminRemovePlayerFromSquad('Name');

AdminRemovePlayerFromSquadById

Removes a player from his Squad by providing the ingame Player id.

/** @var bool */
$success = $server->adminRemovePlayerFromSquadById($player->getId());

AdminWarn

Warns a Player by providing his name / steamid and a message.

/** @var bool */
$success = $server->adminWarn('Name or SteamId', 'Warn Reason');

AdminWarnById

Warns a Player by id.

/** @var bool */
$success = $server->adminWarnById($player->getId(), 'Warn Reason');

Important Note

Make sure to always close the connection manually or trigger a disconnect by destructing the object to preventt blocking the RCON server by using up it'S available connections.

$server->disconnect();
// Or
unset($server);

Special Thanks

  • SquadSlovenia (Intial creators)
  • Brozowski (Major contributor)
  • [ToG] subtlerod (Major contributions to the used SquadRcon implementation)
  • Thomas Smyth (Creator of SquadJS, a great resource for Squad RCON).