Class PlayerControl<RoomType>

Represents a player object for interacting with the game and other players.

See PlayerControlEvents for events to listen to.

Type Parameters

Hierarchy

Implements

Methods

  • Returns void

  • Parameters

    Returns void

  • Returns void

  • Parameters

    • delta: number

    Returns void

  • Returns void

  • Parameters

    Returns boolean

  • Whether or not this object

    Returns boolean

  • Request for the host to check a color for this player and change it if it's taken.

    Parameters

    • color: Color

      The color to request.

    Returns Promise<void>

  • Request for the host to check a name for this player and append numbers if it's taken.

    Parameters

    • name: string

      The name to request.

    Returns Promise<void>

  • Mark one of this player's tasks as completed.

    Example

    client.me.control.completeTask(0);
    

    Parameters

    • taskIdx: number

      The index of the task to complete. Note: this is not the task ID but instead the index of the player's task, as in its position in the taskStates array.

      Emits a player.completetask event.

    Returns void

  • Despawns the component from the room it belongs in.

    Returns void

  • Type Parameters

    • Event extends BasicEvent<Event>

    Parameters

    • event: Event

    Returns Promise<Event>

  • Type Parameters

    • Event extends BasicEvent<Event>

    Parameters

    • event: Event

    Returns Promise<Event>

  • Type Parameters

    • Event extends BasicEvent<Event>

    Parameters

    • event: Event

    Returns Event

  • Type Parameters

    • Event extends BasicEvent<Event> = BasicEvent

    Parameters

    • event: string

    Returns Listener<Event>[]

  • Parameters

    • reason: string

    Returns Promise<void>

  • Murder another a player. This operation can only be called if the player is the impostor on official servers.

    Due to technical limitations, this operation cannot be canceled or reverted without advanced "breaking game", therefore it is out of scope of a single .revert() function on the event emitted.

    Emits a player.murder event.

    Returns

    Parameters

    Returns Promise<void>

  • Type Parameters

    • EventName extends "component.spawn" | "component.despawn" | "player.checkcolor" | "player.checkmurder" | "player.checkname" | "player.checkprotect" | "player.completetask" | "player.die" | "player.usemovingplatform" | "player.murder" | "player.protect" | "player.removeprotection" | "player.reportbody" | "player.revertshapeshift" | "player.chat" | "player.quickchat" | "player.setcolor" | "player.sethat" | "player.setname" | "player.setnameplate" | "player.setpet" | "player.setrole" | "player.setskin" | "player.setstartcounter" | "player.setvisor" | "player.shapeshift" | "player.startmeeting" | "player.syncsettings"

    Parameters

    Returns void

  • Type Parameters

    • K extends BasicEvent<K>

    Parameters

    • event: string
    • listener: Listener<K>

    Returns void

  • Type Parameters

    • EventName extends "component.spawn" | "component.despawn" | "player.checkcolor" | "player.checkmurder" | "player.checkname" | "player.checkprotect" | "player.completetask" | "player.die" | "player.usemovingplatform" | "player.murder" | "player.protect" | "player.removeprotection" | "player.reportbody" | "player.revertshapeshift" | "player.chat" | "player.quickchat" | "player.setcolor" | "player.sethat" | "player.setname" | "player.setnameplate" | "player.setpet" | "player.setrole" | "player.setskin" | "player.setstartcounter" | "player.setvisor" | "player.shapeshift" | "player.startmeeting" | "player.syncsettings"

    Parameters

    Returns (() => void)

      • (): void
      • Returns void

  • Type Parameters

    • K extends BasicEvent<K>

    Parameters

    • event: string
    • listener: Listener<K>

    Returns (() => void)

      • (): void
      • Returns void

  • Type Parameters

    • EventName extends "component.spawn" | "component.despawn" | "player.checkcolor" | "player.checkmurder" | "player.checkname" | "player.checkprotect" | "player.completetask" | "player.die" | "player.usemovingplatform" | "player.murder" | "player.protect" | "player.removeprotection" | "player.reportbody" | "player.revertshapeshift" | "player.chat" | "player.quickchat" | "player.setcolor" | "player.sethat" | "player.setname" | "player.setnameplate" | "player.setpet" | "player.setrole" | "player.setskin" | "player.setstartcounter" | "player.setvisor" | "player.shapeshift" | "player.startmeeting" | "player.syncsettings"

    Parameters

    Returns (() => void)

      • (): void
      • Returns void

  • Type Parameters

    • K extends BasicEvent<K>

    Parameters

    • event: string
    • listener: Listener<K>

    Returns (() => void)

      • (): void
      • Returns void

  • Parameters

    Returns Promise<void>

  • Returns void

  • Parameters

    • event: string

    Returns void

  • Remove this player's protection from a guardian angel, if they have one.

    Emits a player.removeprotection event. This is not networked, so other players will not see this update.

    Parameters

    • Optional timeout: boolean

      Whether or not this is because of a timeout.

    Returns Promise<void>

  • Returns Promise<void>

  • Send a chat message as this player.

    Due to technical impossibilities, this event cannot be canceled or reverted.

    Emits a player.chat event.

    Parameters

    • message: string

    Returns void

  • Send a player chat note for this player, i.e. "player x voted, x remaining.".

    Parameters

    Returns void

  • Update this player's color. This is a host operation on official servers. Use checkColor if you are calling this as not the host.

    Emits a player.checkname event.

    Parameters

    • color: Color

      The color to set this player's name to.

    Returns Promise<void>

  • Update this player's hat. This is not a host operation unless the client does not own this player.

    Emits a player.sethat event.

    Parameters

    • hatId: string

      The hat to set this player's hat to, see Hat.

    Returns Promise<void>

  • Update this player's name. This is a host operation on official servers. Use checkName if you are calling this as not the host.

    Emits a player.setname event.

    Parameters

    • name: string

      The name to set this player's name to.

    Returns Promise<void>

  • Update this player's nameplate. This is not a host operation unless the client does not own this player.

    Emits a player.setnameplate event.

    Parameters

    • nameplateId: string

      The nameplate to set this player's nameplate to, see Nameplate.

    Returns Promise<void>

  • Update this player's pet. This is not a host operation unless the client does not own this player.

    Emits a player.setpet event.

    Parameters

    • petId: string

      The pet to set this player's pet to, see Pet.

    Returns Promise<void>

  • Parameters

    Returns Promise<void>

  • Update this player's skin. This is not a host operation unless the client does not own this player.

    Emits a player.setskin event.

    Parameters

    • skinId: string

      The skin to set this player's skin to, see Skin.

    Returns Promise<void>

  • Change the counter at the bottom of the screen while in the lobby, usually counting down from 5 to 1. This is a host-only operation on official servers.

    Emits a player.setstartcounter event.

    Parameters

    • counter: number

      The counter to set to.

    Returns Promise<void>

  • Update this player's visor. This is not a host operation unless the client does not own this player.

    Emits a player.setvisor event.

    Parameters

    • visorId: string

      The visor to set this player's visor to, see Visor.

    Returns Promise<void>

  • Parameters

    • target: PlayerData<RoomType>
    • Optional doAnimation: boolean

    Returns Promise<void>

  • Spawn this component if does not exist in the room it belongs in.

    Returns void

  • If you're the host, this will immediately begin a meeting Start a meeting and begin the meeting

    Emits a player.startmeeting event.

    Parameters

    • body: PlayerData<Hostable<any>> | "emergency"

      The body that was reported, or "emergency" if it is an emergency meeting.

    • Optional caller: PlayerData<Hostable<any>>

      The player that called this meeting.

    Returns Promise<void>

  • Change the room's settings. Use setSettings to pass a partial game objects object. This is a host operation on official servers.

    Emits a player.syncsettings event.

    Property

    The full game settings object to update the settings to.

    Parameters

    Returns Promise<void>

  • Use the moving platfrom on the map, i.e. the one on Airship.

    Emits a movingplatform.playerupdate event.

    Returns Promise<void>

  • Type Parameters

    • EventName extends "component.spawn" | "component.despawn" | "player.checkcolor" | "player.checkmurder" | "player.checkname" | "player.checkprotect" | "player.completetask" | "player.die" | "player.usemovingplatform" | "player.murder" | "player.protect" | "player.removeprotection" | "player.reportbody" | "player.revertshapeshift" | "player.chat" | "player.quickchat" | "player.setcolor" | "player.sethat" | "player.setname" | "player.setnameplate" | "player.setpet" | "player.setrole" | "player.setskin" | "player.setstartcounter" | "player.setvisor" | "player.shapeshift" | "player.startmeeting" | "player.syncsettings"

    Parameters

    • event: EventName

    Returns Promise<PlayerControlEvents<RoomType>[EventName]>

  • Parameters

    • event: string

    Returns Promise<BasicEvent>

  • Type Parameters

    • EventName extends "component.spawn" | "component.despawn" | "player.checkcolor" | "player.checkmurder" | "player.checkname" | "player.checkprotect" | "player.completetask" | "player.die" | "player.usemovingplatform" | "player.murder" | "player.protect" | "player.removeprotection" | "player.reportbody" | "player.revertshapeshift" | "player.chat" | "player.quickchat" | "player.setcolor" | "player.sethat" | "player.setname" | "player.setnameplate" | "player.setpet" | "player.setrole" | "player.setskin" | "player.setstartcounter" | "player.setvisor" | "player.shapeshift" | "player.startmeeting" | "player.syncsettings"

    Parameters

    Returns Promise<PlayerControlEvents<RoomType>[EventName]>

  • Type Parameters

    • K extends BasicEvent<K>

    Parameters

    • event: string
    • filter: ((ev: K) => boolean | Promise<boolean>)
        • (ev: K): boolean | Promise<boolean>
        • Parameters

          • ev: K

          Returns boolean | Promise<boolean>

    Returns Promise<BasicEvent>

Properties

components: Networkable<any, NetworkableEvents<Hostable<any>>, RoomType>[]
dirtyBit: number

The dirty state of this component.

flags: number

Flags for this object, see SpawnFlag.

guardianProtector?: PlayerData<RoomType>

The player (i.e. a guardian angel) who has protected this player, if the player is being protected..

isNew: boolean

Whether the player was just spawned, or was spawned before joining.

netId: number

The net ID of this component.

ownerId: number

The ID of the owner of this component.

player: PlayerData<RoomType>

The player that this component belongs to.

playerId: number

The player ID of the player.

protectedByGuardian: boolean

Whether or not this player has been protected bya guardian angel.

room: RoomType

The room that this component belongs to.

shapeshiftTarget?: PlayerData<RoomType>

The player that this player has shapeshifted as, if any.

spawnType: SpawnType

The type of object that this component belongs to.

Constructors

Accessors

  • get owner(): undefined | Hostable<any> | PlayerData<RoomType>
  • Returns undefined | Hostable<any> | PlayerData<RoomType>

Generated using TypeDoc