Difference between revisions of "Builtin Namespace Guide"

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...")
 
(Boolean)
 
(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 21:02, 30 April 2020

Return to namespace list

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