Noir
  • 🚶‍♂️Intro
  • 📁Tutorials
    • 🎓Starting Noir
    • 📖Libraries
    • 🖥️Services
    • ❔Libraries VS Services
    • 💬Callbacks
    • 💥Classes
    • 🔎Debugging
  • 📚Examples
  • ☄️API Reference
    • Bootstrapper
    • Built-Ins
      • Classes
        • AITarget
        • Body
        • Command
        • Connection
        • Event
        • HTTPRequest
        • HTTPResponse
        • Library
        • Message
        • Object
        • Player
        • Service
        • Task
        • TickIterationProcess
        • Tracker
        • Vehicle
        • Widgets
          • MapLabelWidget
          • MapLineWidget
          • MapObjectWidget
          • PopupWidget
          • ScreenPopupWidget
          • Widget
      • Libraries
        • Base64
        • Dataclasses
        • Deprecation
        • Events
        • HTTP
        • JSON
        • Logging
        • Matrix
        • Number
        • String
        • Table
      • Services
        • CommandService
        • GameSettingsService
        • HTTPService
        • MessageService
        • NotificationService
        • ObjectService
        • PlayerService
        • TaskService
        • TPSService
        • UIService
        • VehicleService
    • Callbacks
    • Class
    • Classes
    • Debugging
    • Definition
    • Libraries
    • Noir
    • Services
    • TypeChecking
Powered by GitBook
On this page
  • Parameters
  • Returns
  • Parameters
  • Parameters
  • Returns
  • Parameters
  • Parameters
  • Returns
  • Parameters
  • Returns
  • Parameters
  • Parameters
  • Returns
  • Parameters
  • Parameters
  • Returns
  • Parameters
  • Returns
  • Parameters
  • Returns
  • Parameters
  • Returns
  • Parameters
  • Returns
  • Parameters
  • Returns
  • Parameters
  • Returns
Edit on GitHub
  1. API Reference
  2. Built-Ins
  3. Services

PlayerService

Noir.Services.PlayerService: NoirService

A service that wraps SW players in a class. Essentially makes players OOP.

Noir.Services.PlayerService:_LoadPlayers()

Load players current in-game.

Noir.Services.PlayerService:_GivePlayerData(steam_id, name, peer_id, admin, auth)

Gives data to a player.

Used internally.

Parameters

  • steam_id: integer|string

  • name: string

  • peer_id: integer

  • admin: boolean

  • auth: boolean

Returns

  • NoirPlayer|nil

Noir.Services.PlayerService:_RemovePlayerData(player)

Removes data for a player.

Used internally.

Parameters

  • player: NoirPlayer

Noir.Services.PlayerService:_IsHost(peer_id)

Returns whether or not a player is the server's host. Only applies in dedicated servers.

Used internally.

Parameters

  • peer_id: integer

Returns

  • boolean

Noir.Services.PlayerService:_MarkRecognized(player)

Mark a player as recognized to prevent onJoin being called for them after an addon reload.

Used internally.

Parameters

  • player: NoirPlayer

Noir.Services.PlayerService:_IsRecognized(player)

Returns whether or not a player is recognized.

Used internally.

Parameters

  • player: NoirPlayer

Returns

  • boolean

Noir.Services.PlayerService:_ClearRecognized()

Clear the list of recognized players.

Used internally.

Noir.Services.PlayerService:_UnmarkRecognized(player)

Mark a player as not recognized.

Used internally.

Parameters

  • player: NoirPlayer

Noir.Services.PlayerService:_GetSavedProperties()

Returns all saved player properties saved in g_savedata.

Used internally. Do not use in your code.

Returns

  • NoirSavedPlayerProperties

Noir.Services.PlayerService:_SaveProperty(player, property)

Save a player's property to g_savedata.

Used internally. Do not use in your code.

Parameters

  • player: NoirPlayer

  • property: string

Noir.Services.PlayerService:_GetSavedPropertiesForPlayer(player)

Get a player's saved properties.

Used internally. Do not use in your code.

Parameters

  • player: NoirPlayer

Returns

  • table<string, boolean>|nil

Noir.Services.PlayerService:_RemoveSavedProperties(player)

Removes a player's saved properties from g_savedata.

Used internally. Do not use in your code.

Parameters

  • player: NoirPlayer

Noir.Services.PlayerService:GetPlayers(usePeerIDsAsIndex)

Returns all players.

This is the preferred way to get all players instead of using Noir.Services.PlayerService.Players.

Parameters

  • usePeerIDsAsIndex: boolean|nil - If true, the indices of the returned table will match the peer ID of the value (player) matched to the index. Having this as true is slightly faster

Returns

  • table<integer, NoirPlayer>

Noir.Services.PlayerService:GetPlayer(ID)

Returns a player by their peer ID.

This is the preferred way to get a player.

Parameters

  • ID: integer

Returns

  • NoirPlayer|nil

Noir.Services.PlayerService:GetPlayerBySteam(steam)

Returns a player by their Steam ID.

Note that two players or more can have the same Steam ID if they spoof their Steam ID or join the server on two Stormworks instances.

Parameters

  • steam: string

Returns

  • NoirPlayer|nil

Noir.Services.PlayerService:GetPlayerByName(name)

Returns a player by their exact name.

Consider using :SearchPlayerByName() if the player name only needs to match partially.

Parameters

  • name: string

Returns

  • NoirPlayer|nil

Noir.Services.PlayerService:GetPlayerByCharacter(character)

Get a player by their character.

Parameters

  • character: NoirObject

Returns

  • NoirPlayer|nil

Noir.Services.PlayerService:SearchPlayerByName(name)

Searches for a player by their name, similar to a Google search but way simpler under the hood.

Parameters

  • name: string

Returns

  • NoirPlayer|nil

Noir.Services.PlayerService:IsSamePlayer(playerA, playerB)

Returns whether or not two players are the same.

Parameters

  • playerA: NoirPlayer

  • playerB: NoirPlayer

Returns

  • boolean

PreviousObjectServiceNextTaskService

Last updated 2 months ago

☄️