Resource:EntityData: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 82: Line 82:
This function checks if an element has entity data available under a certain key.
This function checks if an element has entity data available under a certain key.


<syntaxhighlight lang="lua">string exports.entityData:hasEntityData(element/table theElement, var/table key, [string type="public"])</syntaxhighlight>  
<syntaxhighlight lang="lua">boolean exports.entityData:hasEntityData(element/table theElement, var/table key, [string type="public"])</syntaxhighlight>  
===Required Arguments===  
===Required Arguments===  
*'''element theElement:''' This is the element/elements with data you want to retrieve.
*'''element theElement:''' This is the element/elements with data you want to retrieve.
Line 101: Line 101:
This function imposes restrictions on the key which, if not satisfied, will not perform the entity data assignment
This function imposes restrictions on the key which, if not satisfied, will not perform the entity data assignment


<syntaxhighlight lang="lua">string exports.entityData:setKeyFlag(var key, table flag)</syntaxhighlight>  
<syntaxhighlight lang="lua">boolean exports.entityData:setKeyFlag(var key, table flag)</syntaxhighlight>  
===Required Arguments===  
===Required Arguments===  
*'''var key:''' The name of the entity data entry you want to check for.  
*'''var key:''' The name of the entity data entry you want to check for.  
Line 107: Line 107:
===Returns===
===Returns===
Returns true if the flag is set and false if the flag is not set on the key.
Returns true if the flag is set and false if the flag is not set on the key.
</section>
===createTransaction===
<section name="Shared" class="server" show="true">
This function creates instructions for the data transfer in the form of a transaction that must be accepted or canceled.
<syntaxhighlight lang="lua">boolean exports.entityData:createTransaction()</syntaxhighlight>
===Returns===
Returns the index of a new transaction created
</section>
===triggerTransaction===
<section name="Shared" class="server" show="true">
This function acceptance of the transaction for sending must be created beforehand, unless you send the instruction itself in the form of an array, then no transaction is needed.
<syntaxhighlight lang="lua">string exports.entityData:triggerTransaction(int transaction/table transaction)</syntaxhighlight>
===Required Arguments===
*'''int transaction:''' - The transaction number, if this value is provided, the data transfer will not be executed immediately
===Returns===
Returns true on valid transaction other than false
</section>
===cancelTransaction===
<section name="Shared" class="server" show="true">
This feature will cancel the transaction and will not allow it to be submitted correctly.
<syntaxhighlight lang="lua">boolean exports.entityData:cancelTransaction(int transaction)</syntaxhighlight>
===Required Arguments===
*'''int transaction:''' - The transaction number, if this value is provided, the data transfer will not be executed immediately
===Returns===
Returns true on valid transaction other than false
</section>
</section>

Revision as of 14:09, 26 November 2021

Name: entityData

Developer: User:GalAnonim (Rick)

State: OpenSource

GitHub Source: https://github.com/httpRick/entityData/tree/main

Current Version: 1.0.0

Overview

The system of non-standard data operation for Elements on the MTA SA platform replaces ElementData

Exported functions

setEntityData

This function passes user information about the element to entity Data, the data can be created by the server but you should avoid passing data from client to server when assigning.

Click to collapse [-]
Shared

This function encrypts the data of the file

string exports.entityData:setEntityData(element/table theElement, var/table key, var value, [string type="public", int transaction])

Required Arguments

  • element theElement: The element/elements you wish to attach the data to.
  • var key: The key/keys you wish to store the data under.

Optional Arguments

  • string type: type of data synchronization
    • "public" - Synchronizes between the server and the client, and between the client and the server (required to be enabled in the options)
    • "local" - It does not synchronize, it remains on the side on which it was given
    • "private" - Assigns and synchronizes one value for a given key for all items
  • int transaction: - The transaction number, if this value is provided, the data transfer will not be executed immediately

Returns

Returns true if the data was set succesfully, false otherwise.

getEntityData

This function retrieves entity data attached to an element under a certain key.

Click to collapse [-]
Shared

This function encrypts the data of the file

string exports.entityData:getEntityData(element/table theElement, var/table key, [string type="public"])

Required Arguments

  • element theElement: This is the element/elements with data you want to retrieve.
  • var key: The name/names of the entity data entry you want to retrieve.

Optional Arguments

  • string type: type of data synchronization
    • "public" - Synchronizes between the server and the client, and between the client and the server (required to be enabled in the options)
    • "local" - It does not synchronize, it remains on the side on which it was given
    • "private" - Assigns and synchronizes one value for a given key for all items

Returns

This function returns a variable/tables containing the requested entity data, or false if the element/elements or the entity data does not exist.

getAllEntityData

Click to collapse [-]
Shared

This function returns a table of all entity data of an element.

string exports.entityData:getAllEnintyData(element/table theElement, [string type="public"])

Required Arguments

  • element theElement: This is the element/elements with data you want to retrieve.

Optional Arguments

  • string type: type of data synchronization
    • "public"
    • "local"
    • "private"
    • "all"

Returns

If successful, returns a table with as keys the names of the entity data and as values the corresponding entity data values. Returns false in case of failure.

hasEntityData

Click to collapse [-]
Shared

This function checks if an element has entity data available under a certain key.

boolean exports.entityData:hasEntityData(element/table theElement, var/table key, [string type="public"])

Required Arguments

  • element theElement: This is the element/elements with data you want to retrieve.
  • var key: The name/names of the entity data entry you want to check for.

Optional Arguments

  • string type:type of data synchronization
    • "public" - Synchronizes between the server and the client, and between the client and the server (required to be enabled in the options)
    • "local" - It does not synchronize, it remains on the side on which it was given
    • "private" - Assigns and synchronizes one value for a given key for all items

Returns

This function returns true if the element contains entity data for key, or false if the element doesn't exist or there is no data associated with the key.

setKeyFlag

Click to collapse [-]
Shared

This function imposes restrictions on the key which, if not satisfied, will not perform the entity data assignment

boolean exports.entityData:setKeyFlag(var key, table flag)

Required Arguments

  • var key: The name of the entity data entry you want to check for.
  • table flag: A flag containing all the restrictions key

Returns

Returns true if the flag is set and false if the flag is not set on the key.

createTransaction

Click to collapse [-]
Shared

This function creates instructions for the data transfer in the form of a transaction that must be accepted or canceled.

boolean exports.entityData:createTransaction()

Returns

Returns the index of a new transaction created

triggerTransaction

Click to collapse [-]
Shared

This function acceptance of the transaction for sending must be created beforehand, unless you send the instruction itself in the form of an array, then no transaction is needed.

string exports.entityData:triggerTransaction(int transaction/table transaction)

Required Arguments

  • int transaction: - The transaction number, if this value is provided, the data transfer will not be executed immediately

Returns

Returns true on valid transaction other than false


cancelTransaction

Click to collapse [-]
Shared

This feature will cancel the transaction and will not allow it to be submitted correctly.

boolean exports.entityData:cancelTransaction(int transaction)

Required Arguments

  • int transaction: - The transaction number, if this value is provided, the data transfer will not be executed immediately

Returns

Returns true on valid transaction other than false