dsg / squad-rcon-php
Squad Server RCon library
Installs: 2 023
Dependents: 1
Suggesters: 0
Security: 0
Stars: 3
Watchers: 2
Forks: 2
Open Issues: 2
Requires
- ext-json: *
- dsg/php-source-query-class: 1.1.0
- spatie/data-transfer-object: ^3.8
Requires (Dev)
- phpunit/phpunit: ~5.0||~6.0||~7.0||~8.0
- dev-master
- 4.0.0
- 3.3.0
- 3.2.0
- 3.1.1
- 3.1.0
- 3.0.0
- 2.0.1
- 2.0.0
- 1.0.0
- 0.3.0
- 0.2.0
- 0.2.0-alpha11
- 0.2.0-alpha10
- 0.2.0-alpha9
- 0.2.0-alpha8
- 0.2.0-alpha7
- 0.2.0-alpha6
- 0.2.0-alpha5
- 0.2.0-alpha4
- 0.2.0-alpha3
- 0.2.0-alpha2
- 0.2.0-alpha1
- 0.1.2
- 0.1.1
- 0.1
- dev-dependabot/github_actions/actions/checkout-4
- dev-dependabot/composer/phpunit/phpunit-approx-5.0or-approx-6.0or-approx-7.0or-approx-8.0or-approx-9.0
- dev-patch-2.12
- dev-fix-squad-creator-integration
- dev-rework-squad-leader
- dev-squad-leader
- dev-brozowski
- dev-disconnect
- dev-actions
This package is auto-updated.
Last update: 2024-11-05 13:11:17 UTC
README
Squad RCON PHP
RCON PHP wrapper for Squad server management
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).