Tile - Custom Function List – Ylands

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
[[Image:Ylands_Tile_-_Custom_instruction1.png]]
[[Image:Ylands_Tile_-_Custom_instruction1.png]]
*Custom instruction is a sequence which can be called from anywhere within the script of currently edited object.
*'''Custom''' instruction is a standalone '''sequence''' designed to perform a particular task and can be '''called''' from '''anywhere''' within the script of '''currently''' edited '''object'''.
*Any '''instruction''' which does '''not''' return any '''value''' is called '''statement'''.
*Any custom instruction consists of '''two parts''' - instruction '''definition''' and instruction '''call'''
*'''Instruction definition'''
**Defines '''parameters''' and '''contents''' of custom instruction.
**It is standalone script block - '''does not snap''' with other blocks.
**To create new custom instruction, simply place new block anywhere in the canvas.
**Name and parameters of a instruction can be edited via context menu (right click on block).
**Parameters work as [[Ylands Tile - Variable local|'''local''']] variables and can be used inside the custom instruction.
**Custom instruction can be terminated at any point using [[Ylands Tile - Return|'''return''']] block.
*'''Instruction call'''
**Executes the custom instruction, with defined parameters.
**Can be placed in any sequence as any other instruction.
 
 
[[Image:Ylands_Tile_-_Custom_instruction2.png]]
*Any '''Instruction''' which returns a '''value''' is called '''expression'''.
*Expression '''definition''' work in '''same''' way as for '''statement''' instructions.
*Instruction '''call''' has to be '''docked''' as '''input''' of another instruction as it would be a variable or literal.


=Notes=
=Notes=
*Custom instructions of [[Ylands Game logic - Global storage|'''Global Storage''']] are considered '''global''' and are available within the scope of whole game script.
*Custom instructions of [[Ylands Game logic - Global storage|'''Global Storage''']] are considered '''global''' and are available within the scope of whole game script.
*Custom instructions of [[Ylands Game logic - Entity storage|'''Entity Storage''']] are considered '''member''' and are available within the scope of [[Ylands Tile - Storage owner literal|'''Storage Owner''']].
*Custom instructions of [[Ylands Game logic - Entity storage|'''Entity Storage''']] are considered '''member''' and are available within the scope of [[Ylands Tile - Storage owner literal|'''Storage Owner''']].
*See also: *[[Ylands Tile - Return|'''Return''']]




----
----
{{Ylands scripting navbox}}
{{Ylands scripting navbox}}

Revision as of 13:58, 13 December 2018

Ylands Tile - Custom instruction1.png

  • Custom instruction is a standalone sequence designed to perform a particular task and can be called from anywhere within the script of currently edited object.
  • Any instruction which does not return any value is called statement.
  • Any custom instruction consists of two parts - instruction definition and instruction call
  • Instruction definition
    • Defines parameters and contents of custom instruction.
    • It is standalone script block - does not snap with other blocks.
    • To create new custom instruction, simply place new block anywhere in the canvas.
    • Name and parameters of a instruction can be edited via context menu (right click on block).
    • Parameters work as local variables and can be used inside the custom instruction.
    • Custom instruction can be terminated at any point using return block.
  • Instruction call
    • Executes the custom instruction, with defined parameters.
    • Can be placed in any sequence as any other instruction.


Ylands Tile - Custom instruction2.png

  • Any Instruction which returns a value is called expression.
  • Expression definition work in same way as for statement instructions.
  • Instruction call has to be docked as input of another instruction as it would be a variable or literal.

Notes

  • Custom instructions of Global Storage are considered global and are available within the scope of whole game script.
  • Custom instructions of Entity Storage are considered member and are available within the scope of Storage Owner.
  • See also: *Return



Template:Ylands scripting navbox