Player Detector¶

Picture

The Player Detector is a useful peripheral that allows you to detect players within a certain range, position and area. You can get a list of all online players and detect when a player clicks on the block.

Peripheral Name	Interfaces with	Has events	Introduced in
playerDetector	Players	Yes	0.1b

Events¶

playerClick¶

Fires when a player clicks on the block.
Values:

username: string The username of the player who clicked the block
devicename: string Th name of the peripheral like playerDetector_4

local event, username, device = os.pullEvent("playerClick")
print("The detector ".. device .." was clicked by " .. username)

playerJoin¶

Fires when a player joins the world/a server.
Values:

username: string The username of the player who clicked the block
dimension: string The resource id of the dimension the player is in

local event, username, dimension = os.pullEvent("playerJoin")
print("Player " .. username .. " joined the server in the dimension " .. dimension)

playerLeave¶

Fires when a player leaves the world/a server.
Values:

username: string The username of the player who clicked the block
dimension: string The resource id of the dimension the player was in

local event, username, dimension = os.pullEvent("playerLeave")
print("Player " .. username .. " left the server in the dimension " .. dimension)

playerChangedDimension¶

Fires when a player changes dimensions.
Values:

username: string The username of the player who clicked the block
fromDim: string The resource id of the dimension the player was in
toDim: string The resource id of the dimension the player is in

local event, username, fromDim, toDim = os.pullEvent("playerChangedDimension")
print("Player " .. username .. " left the dimension " .. fromDim .. " and is now in " .. toDim)

Info

The events will fire when a player detector has been connected to a computer. You don't have to .wrap() or .find() the peripheral (unless you intend to send messages).

Functions¶

Info

The player detector supports multidimensional spying(Since 1.19.2-0.7.30r & 1.20.1-0.7.32a). This only works if the config option playerDetMultiDimensional is set to true and the option playerDetMaxRange is set to -1(infinite)

getPlayerPos / getPlayer¶

getPlayerPos(username: string) -> table | nil

Returns information about the player with the username passed.

Properties¶

Added more properties in version 0.7.4r

table	Description
dimension: `string`	The dimension the player is in
eyeHeight: `number`	The height of the player's eyes
pitch: `number`	The pitch of the player's head
health: `number`	The health of the player
maxHealth: `number`	The max health of the player
airSupply: `number`	The air supply of the player
respawnPosition: `number`	The respawn position of the player
respawnDimension: `number`	The respawn dimension of the player
respawnAngle: `number`	The respawn angle of the player in degrees
yaw: `number`	The yaw of the player's head
x: `number`	The x coordinate
y: `number`	The y coordinate
z: `number`	The z coordinate

local detector = peripheral.find("playerDetector")

-- Get the position of Player123 and print their coordinates
local pos = detector.getPlayerPos("Player123")
print("Position: " .. pos.x .. "," .. pos.y .. "," .. pos.z)

getOnlinePlayers¶

getOnlinePlayers() -> table

Added in version 0.7r

Returns a list of all online players.

getPlayersInRange¶

getPlayersInRange(range: number) -> table

Returns a list of players within the given range of the peripheral.

Note

The center of the range is the Player Detector peripheral and not the Computer.

getPlayersInCoords¶

getPlayersInCoords(posOne: table, posTwo: table) -> table

Added in version 0.7r

Returns a list of players within the 2 positions posOne and posTwo.

The posOne and posTwo tables must contain:

x: number
y: number
z: number

Note

The area the detector going to detect is [x1, x2), [y1, y2), [z1, z2). Which means call getPlayersInCoords({x=x, y=y, z=z}, {x=x, y=y, z=z}) will always return nothing

getPlayersInCubic¶

getPlayersInCubic(w: number, h: number, d: number) -> table

Added in version 0.7r

Returns a list of players within a cuboid centered at the peripheral.
Where w, h, d correspond to the x, y, z axes and are the width, height and depth of the cuboid.

isPlayerInRange¶

isPlayerInRange(range: number, username: string) -> boolean

Returns true if the player whose username matches the provided username is within the given range of the peripheral.

isPlayerInCoords¶

isPlayerInCoords(posOne: table, posTwo: table, username: string) -> boolean

Added in version 0.7r

Returns true if the player is within the 2 positions.

The posOne and posTwo tables must contain:

x: number
y: number
z: number

isPlayerInCubic¶

isPlayerInCubic(w: number, h: number, d: number)

Added in version 0.7r

Returns true if the player is within the cuboid centered at the peripheral.
Where w, h, d correspond to the x, y, z axes and are the width, height and depth of the cuboid.

isPlayersInRange¶

isPlayersInRange(range: number) -> boolean

Returns true if there is any player in the given range.

isPlayersInCoords¶

isPlayersInCoords(posOne: table, posTwo: table) -> boolean

Added in version 0.7r

Returns true if any player is within the 2 positions.

The posOne and posTwo tables must contain:

x: number
y: number
z: number

isPlayersInCubic¶

isPlayersInCubic(w: number, h: number, d: number)

Added in version 0.7r

Returns true if any player is within the cuboid centered at the peripheral.
Where w, h, d correspond to the x, y, z axes and are the width, height and depth of the cuboid.

Changelog/Trivia¶

In early versions the player detector was also a buggy block, like the energy detector. We had bugs where the block used completely wrong coordinates or the range parameters did not work.

0.7.4r
Added more information to the getPlayerPos function. (Configurable)

0.7r
Added more functions to the player detector. One to define the range in every 3 axes, one to define 2 positions. Also added getOnlinePlayers.

0.4.2b
Added a max range config value.

0.3b
Added the functions isPlayersInRange and isPlayerinRange.

0.2.6b
Added the function getPlayersInRange.

0.1b
Added the player detector, it was the third feature of the mod.