Players & movement
Player checks and controls
Query native player states and apply resource-owned movement, aim and firing restrictions. Includes IsPlayer checks, FreezePosition, FreezeRotation, Allow controls, permissions and replication limits.
On this page5 sections
Read native player state and apply client-local controls. Player IDs are network IDs, not entity handles. Omit the ID to target the local player. Failed reads return nil, reason; failed controls return false, reason.
The original checks and controls are available in client 2.31.13+op77.62, protocol 1.25. These are client APIs; server resources request their own client's actions through permissioned events.
permissions { 'players.read', 'players.controls' }Local avatar visibility
Local player visibility explains
Open77.players.setLocalPuppetVisible(visible) and
Open77.players.isLocalPuppetVisible(), including the
players.local.visibility permission and resource cleanup. Hide the native body
and third-person double while keeping the selected camera, for example in Prop
Hunt. These functions require a compatible client independently of the utility
version listed above.
Passenger drive-by
Passenger drive-by covers setLocalDriveByEnabled,
getDriveByState, isDriveByEnabled and isInDriveBy, plus the server policy
setDriveByEnabled. It includes client/server examples, permissions, phases and
cleanup. Use the Unstable .117 client and server, protocol 1.42.
Read-only checks
Every global below also exists under Open77.players with the indicated method.
| Global | Method | Meaning |
|---|---|---|
IsPlayerSwimming([playerId]) |
isSwimming |
Native surface swimming or diving |
IsPlayerDiving([playerId]) |
isDiving |
Native underwater swimming state |
IsPlayerAiming([playerId]) |
isAiming |
Graph-produced aim state, including toggle aim |
IsPlayerShooting([playerId]) |
isShooting |
Graph trigger state; not confirmation of damage or every projectile |
IsPlayerReloading([playerId]) |
isReloading |
Reload state |
IsPlayerGrounded([playerId]) |
isGrounded |
Movement ground contact |
IsPlayerCrouching([playerId]) |
isCrouching |
Crouched locomotion |
IsPlayerSliding([playerId]) |
isSliding |
Sliding locomotion |
IsPlayerSprinting([playerId]) |
isSprinting |
Sprint state, not a velocity threshold |
IsPlayerVaulting([playerId]) |
isVaulting |
Vault state |
IsPlayerJumping([playerId]) |
isJumping |
Jump/double-jump phase |
IsPlayerFalling([playerId]) |
isFalling |
Falling phase |
IsPlayerInVehicle([playerId]) |
isInVehicle |
Native mounted state |
IsPlayerDriver([playerId]) |
isDriver |
Mounted in the driver's seat |
IsPlayerPassenger([playerId]) |
isPassenger |
Mounted in a non-driver seat |
Remote checks require a streamed, presentation-ready player and return
nil, 'player_not_streamed' otherwise. Swimming/diving are currently local-only:
their PSM field is not replicated, so querying a remote player returns
nil, 'state_not_replicated' rather than inventing a false result. Remote values are
presentation snapshots and must not authorize server-side rewards/damage.
local swimming, reason = IsPlayerSwimming()
if swimming == nil then return end -- unavailable is not the same as false
if swimming then Open77.log.info('Player is swimming') endResource-owned controls
These client calls affect the local player. Server scripts can signal their own client resource using the normal permissioned event API. They are gameplay controls, not server-side anti-cheat enforcement.
Global / Open77.players method |
Argument | Block bit |
|---|---|---|
FreezePosition / freezePosition |
true requests native forced-freeze locomotion |
1 |
FreezeRotation / freezeRotation |
true applies native camera/turn restriction |
2 |
AllowJump / allowJump |
false blocks jumping |
4 |
AllowAim / allowAim |
false blocks aim entry and exits held aim |
8 |
AllowRunning / allowRunning |
false requests native forced walking |
16 |
AllowShoot / allowShoot |
false blocks firearm firing decisions, including an ongoing automatic firing sequence |
32 |
AllowCrouch / allowCrouch |
false requests native standing |
64 |
AllowDodge / allowDodge |
false blocks ground/air dodge entry |
128 |
AllowWeapons / allowWeapons |
false applies the native no-weapons restriction |
256 |
AllowInteraction / allowInteraction |
false blocks native world interactions |
512 |
Only actual Lua booleans are accepted: the string 'false' is rejected.
allow=true releases this resource's block; it cannot override another resource
or a vanilla restriction. freeze=false follows the same ownership rule.
Open77.players.resetControls() releases every block owned by the caller.
Open77.players.getControlMask() returns the combined Open77 block bitmask; it is not
an inventory of vanilla restrictions. All require players.controls.
assert(AllowJump(false))
assert(AllowShoot(false))
-- When this activity ends:
assert(Open77.players.resetControls())The host releases blocks on resource stop, session teardown, death and player-body replacement. The native query has a two-second watchdog so abandoned runtime state does not leave a player locked indefinitely. These controls do not freeze a vehicle, stop a moving platform, cancel server teleports, or cancel projectiles already fired.
Compatibility limits
Movement controls restrict native locomotion and input; they are not physics anchors. Airborne, moving-platform and traversal behavior can differ. Combat checks return nil, 'state_unavailable' until a graph sample exists. Swimming and diving use native state and do not synthesize missing remote-player data.
IsPointOnRoad is not implemented. The exposed road/lane natives inspected so far
query the current player/vehicle; they do not classify arbitrary world coordinates.
An asphalt material or pedestrian navmesh hit would not be a correct replacement.
// For agents & LLMsthis page as Markdownllms.txtllms-full.txt