SetPickupPropertyValue

From Onset Developer Wiki
Revision as of 21:33, 22 December 2020 by BlueMountains (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
SetPickupPropertyValue

Type: Function
Context: Server & Client
Introduced: v1.0

Description

Sets a property value for this entity. Useful to store information for individual entities which can be accessed on client and server and across different packages.

Syntax

SetPickupPropertyValue(pickup, PropertyName, Value, bSync)
Client Syntax
SetPickupPropertyValue(pickup, PropertyName, Value)

Parameters

  • pickup
    The pickup identifier
  • PropertyName
    Name of the property variable
  • Value
    Value can be a boolean, integer, float, string or table
  • bSync (optional)
    Enable automatic network sync for this property value. Default: true

Return Value

  • Returns true on success.

Example

Server

function OnPackageStart()
	local pickup = CreatePickup(1, 0.0, 0.0, 0.0)
	SetPickupPropertyValue(pickup, "testValue", "Some test value string")
end
AddEvent("OnPackageStart", OnPackageStart)

Client

AddEvent("OnPickupStreamIn", function(pickup)
	AddPlayerChat("P: "..GetPickupPropertyValue(pickup, "testValue"))
end)

See also