Donut Team is a labor of love, built and maintained by a small group of passionate developers. We invest our own time and resources to offer our tools, mods, and web services completely free of charge.

We don't run ads, and we will never sell your data - period.

If you've enjoyed anything we've created, please consider supporting our work with a one-time or monthly donation via our Ko-fi page . Every contribution helps us continue building great experiences for the community.

Dismiss
  • Modding Tools
  • Simpsons Hit & Run Multiplayer Server
  • Lua API Reference
  • Data Structures

Player

Available since Version 1.0.

The Player return type represents a player that is currently connected to the server in Simpsons Hit & Run Multiplayer Server mods. It is returned by certain functions that retrieve player data from the server.

Variables

Variable Name Type Description
ServerGuid string The server GUID of the player.
IsCLI boolean Whether the player is a CLI player.
IsOP boolean Whether the player is an operator.
Mutators List A list of the mutators that the player has enabled.
IPAddress string The IP address of the player.
Name string The name of the player, including the discriminator.
NameWithoutDiscriminator string The name of the player without the discriminator.
Discriminator string The discriminator of the player.
Colour number The colour of the player, represented as a hexadecimal RGB value.
SelectedMainMod MainMod The main mod that the player has selected.
Level Level The level that the player is currently in.
Session Session The session that the player is currently in.
Mods List A list of the mods that the player has.
Character PlayerCharacter Details about the player's character.
LowBandwidth boolean Whether the player has joined with the low bandwidth option enabled.
Data Dictionary A dictionary that can be used to store custom data for the player.
Ping number The player's current ping to the server, in milliseconds.
ExplosionMutator boolean Whether the player has the explosion mutator enabled.
HitAndRunMutator boolean Whether the player has the Hit & Run mutator enabled.
AllowCheaterTags boolean Whether the player allows cheater tags to be shown on their name.
Position Engine.Vector3 or nil The player's current position in the level. This is nil if the player is not currently in a level.

Methods

Function Name Description
Player:SetPosition Sets the player's position in the level.
Player:SetDynaloadData Sets the player's dynaload data. Dynaload data is used to determine which objects are loaded for the player in the level.
Player:SendCreateMissionRadarIcon Sends a command to the client to create a mission radar icon at the specified position.
Player:SendDeleteMissionRadarIcon Sends a command to the client to delete the player's mission radar icon.
Player:Kick Kicks the player from the server with an optional kick message.
Player:ChangeSession Moves the player to a different session.
Player:SendGamePlayerSetNameAndRole Sends a command to the client to update the player's name and role in the game.
Player:SendGameResync Sends a command to the client to resync the player's game state.
Player:SendGamePlayerCharacterJump Sends a command to other clients to make the player's character perform a jump action.
Player:SendGamePlayerCharacterKick Sends a command to other clients to make the player's character perform a kick action with the specified kick force.
Player:SendCreateExplosion Sends a command to other clients to create an explosion at the specified position.
Player:SendGameChatMessage Sends a chat message to the client, either as a message from a player's character or as a server message.