Builtin Namespace Guide: Difference between revisions
From MINR.ORG WIKI
Created page with "Return to namespace list = Built-Ins = '''Status: STABLE (safe to use)''' == Types == === TpData === A data structure to manage teleport destina..." |
|||
| (5 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
[[Namespace Documentation|Return to namespace list]] | [[Namespace Documentation|Return to namespace list]] | ||
= Built-Ins = | = Built-Ins (page is not ready yet) = | ||
'''Status: STABLE (safe to use)''' | '''Status: STABLE (safe to use - but not the documentation!)''' | ||
== Variables == | |||
* constant Double pi | |||
== Types == | == Types == | ||
<div class="mw-collapsible mw-collapsed" style="border:1px solid #888888; padding:7px;> | |||
<div class="mw-collapsible-content"> | |||
</div></div> | |||
=== Boolean === | |||
A simple type with two values [true, false] used for conditional scripts (e.g. those including @if) | |||
<div class="mw-collapsible mw-collapsed" style="border:1px solid #888888; padding:7px;> | |||
==== Constructors (2) ==== | |||
<div class="mw-collapsible-content"> | |||
* '''Boolean(Boolean other)''' : Creates a new Boolean with the value of other. | |||
* '''Boolean(String other)''' : Creates a Boolean with value true if other matches "true" in any casing (e.g. "tRuE") or false otherwise. | |||
</div></div> | |||
<div class="mw-collapsible mw-collapsed" style="border:1px solid #888888; padding:7px;> | |||
==== Operators TODO ==== | |||
<div class="mw-collapsible-content"> | |||
'''Unary Operators (always before the Boolean)''' | |||
* '''Boolean ! <Boolean>''' : Returns the opposite value of the Boolean (if true, returns false; and vice versa) | |||
'''Type-Preserving Binary Operators''' | |||
* '''Boolean <Boolean> && <Boolean>''' : Returns the AND of two Booleans (e.g. returns true if both operands are true, otherwise returns false). | |||
* '''Boolean <Boolean> || <Boolean>''' : Returns the OR of two Booleans (e.g. returns false if both operands are false, otherwise returns true). | |||
* '''Boolean <Boolean> == <Boolean>''' : Returns true if two Booleans have the same value, otherwise returns false. | |||
* '''Boolean <Boolean> != <Boolean>''' : Returns false if two Booleans have the same value, otherwise returns true. | |||
'''Type-Casting Binary Operators''' | |||
* '''String <Boolean> + <String>''' : Casts the Boolean to a String, then returns the strings joined in order (also accepts <String> + <Boolean>). | |||
</div></div> | |||
<div class="mw-collapsible mw-collapsed" style="border:1px solid #888888; padding:7px;> | |||
==== Methods TODO ==== | |||
<div class="mw-collapsible-content"> | |||
</div></div> | |||
=== Int === | |||
=== Long === | |||
=== Float === | |||
=== Double === | |||
=== String === | |||
=== Block === | |||
=== Item === | |||
=== Entity === | |||
=== Player === | |||
=== <Type>[] (List) === | |||
=== TpData === | === TpData === | ||
Latest revision as of 20:02, 30 April 2020
Built-Ins (page is not ready yet)
[edit]Status: STABLE (safe to use - but not the documentation!)
Variables
[edit]- constant Double pi
Types
[edit]Boolean
[edit]A simple type with two values [true, false] used for conditional scripts (e.g. those including @if)
Constructors (2)
[edit]- Boolean(Boolean other) : Creates a new Boolean with the value of other.
- Boolean(String other) : Creates a Boolean with value true if other matches "true" in any casing (e.g. "tRuE") or false otherwise.
Operators TODO
[edit]Unary Operators (always before the Boolean)
- Boolean ! <Boolean> : Returns the opposite value of the Boolean (if true, returns false; and vice versa)
Type-Preserving Binary Operators
- Boolean <Boolean> && <Boolean> : Returns the AND of two Booleans (e.g. returns true if both operands are true, otherwise returns false).
- Boolean <Boolean> || <Boolean> : Returns the OR of two Booleans (e.g. returns false if both operands are false, otherwise returns true).
- Boolean <Boolean> == <Boolean> : Returns true if two Booleans have the same value, otherwise returns false.
- Boolean <Boolean> != <Boolean> : Returns false if two Booleans have the same value, otherwise returns true.
Type-Casting Binary Operators
- String <Boolean> + <String> : Casts the Boolean to a String, then returns the strings joined in order (also accepts <String> + <Boolean>).
Methods TODO
[edit]Int
[edit]Long
[edit]Float
[edit]Double
[edit]String
[edit]Block
[edit]Item
[edit]Entity
[edit]Player
[edit]<Type>[] (List)
[edit]TpData
[edit]A data structure to manage teleport destinations that are set by a player positioned at the desired location.
Fields EDIT ME (6)
[edit]- Double x : x-coordinate of the teleport destination
- Double y : y-coordinate of the teleport destination
- Double z : z-coordinate of the teleport destination
- Float yaw : yaw of the teleport destination
- Float pitch : pitch of the teleport destination
- String world : world of the teleport destination
Constructors (1)
[edit]- rtp::TpData(Player setter) : destination fields are set to match the setter's position at the time of initialization
Methods (3)
[edit]- String string() : returns a simplified representation of the position held by the structure
- String tpString() : returns a string representation of an anonymous tp call performed by tpHere
- Void tpHere(Player player): teleports the player to the position held by the structure
Rtp
[edit]A TpData list selector and management tool that mimics the /rtp plugin functionality.
Fields (3)
[edit]- String name : custom identifier for the set of teleport locations
- Boolean doLogging : flag to enable logging of each use of teleportation
- rtp::TpData[] tpList : list of potential teleport locations
Constructors (4)
[edit]- rtp::Rtp() : initialize an empty location manager (defaults "UNNAMED", true)
- rtp::Rtp(String name) : initialize a location manager with identifier name set
- rtp::Rtp(Boolean doLogging) : initialize with logging option set
- rtp::Rtp(String name, Boolean doLogging) : initialize with name and logging set
Methods (8)
[edit]- String string() : returns a representation of name, logging status, and capacity of the structure
- Int count() : returns size of the managed location list
- Void setName(String name) : updates the name of the structure
- Void setLogging(Boolean doLogging) : updates the logging status of the structure
- Void addWarp(Player setter) : adds a location generated from setter's position at the time of the function call
- Void removeWarp(Int index) : removes a location specified by the index (between 1 and Rtp.count() inclusive)
- Void useWarp(Player player, Int index) : warps the player to the location specified by index (1 to count() inclusive), performing optional logging
- Void rtp(Player player) : Selects a location randomly and performs the actions of useWarp using the player