Update definitions

Author: Plextora

definitions/feature/module.d.ts

@@ -120,4 +120,13 @@ declare class Module {
      * @param defVal The default value
      */
     addTextSetting(name: string, displayName: string, description: string, defVal: string): Setting;
+
+    /**
+     Adds a setting.
+     * @param name The internal name
+     * @param displayName The name that shows in the menu
+     * @param description A short description of what the setting does
+     * @param defVal The default value
+     */
+     addColorSetting(name: string, displayName: string, description: string, defVal: Color): Setting;
 }

definitions/game.d.ts

@@ -42,9 +42,17 @@ interface Game {
     getPort(): number;
 
     /**
-     * Get the current world that you're in.
+     * @deprecated use `world`
+     * Get the World object.
      */
-    getWorld() : World | null;
+    getWorld() : World;
+
+
+    /**
+     * @deprecated use `dimension`
+     * Get the Dimension object.
+     */
+    getDimension(): Dimension;
 
     /**
      * Get whether you are in a UI screen

definitions/gfx/graphics.d.ts

@@ -118,6 +118,11 @@ declare interface Graphics {
     drawRect(rect: Rect, color: Color, thickness: number): void;
     fillRect(rect: Rect, color: Color): void;
 
+    getTextSize(text: string, textSize: number): Vector2;
+
+    setClippingRect(rect: Rect): void;
+    restoreClippingRect(): void;
+
     /**
      * Draws text on the position specified
      * @param pos The position to draw the text

definitions/gfx/graphics3.d.ts

@@ -1,14 +1,46 @@
-interface Graphics3DObject {
-    drawLine(p1: Vector3, p2: Vector3, color: Color): void;
-    drawBox(p1: Vector3, p2: Vector3, color: Color): void;
-}
-
 declare interface Graphics3D {
+
+    /**
+     * Sets the color.
+     * @param color The color to set
+     */
+    setColor(color: Color): void;
+
+    /**
+     * Sets the colors. (allows for gradients)
+     * @param color The color to set
+     */
+    setColors(vec1: Color, vec2: Color, vec3: Color, vec4: Color): void;
+
+    /**
+     * Draws a line into the world (adds a line into the vertex buffer)
+     * @param p1 
+     * @param p2 
+     */
+    drawLine(p1: Vector3, p2: Vector3): void;
+
+    /**
+     * Draws a triangle into the world (adds a triangle into the vertex buffer)
+     * @param p1 
+     * @param p2 
+     * @param p3
+     */
+    drawTriangle(p1: Vector3, p2: Vector3, p3: Vector3): void;
+
+    /**
+     * Draws a quad into the world (adds a quad into the vertex buffer)
+     * @param p1 
+     * @param p2 
+     * @param p3
+     * @param p4
+     */
+    drawQuad(p1: Vector3, p2: Vector3, p3: Vector3, p4: Vector3): void;
+
     /**
-     * Draws a mesh.
-     * @param func 
+     * Call this every time you're done rendering. (batched renders the current vertex buffer into the world) 
+     * @param cull `true` for rendering through blocks, `false` to not render through blocks
      */
-    draw(func: (obj: Graphics3DObject) => void): void;
+    finish(cull?: boolean): void;
 }
 
-declare const gfx3d: Graphics3D;
+declare const graphics3D: Graphics3D;

definitions/index.d.ts

@@ -3,6 +3,8 @@
 /// <reference path="./game.d.ts" />
 /// <reference path="./latite.d.ts" />
 
+/// <reference path="./world/block.d.ts" />
+/// <reference path="./world/dimension.d.ts" />
 /// <reference path="./world/world.d.ts" />
 /// <reference path="./world/item.d.ts" />
 /// <reference path="./world/entity.d.ts" />

definitions/latite.d.ts

@@ -225,9 +225,14 @@ interface ClientEvents {
     "text-input": TextInputEvent;
 
     /**
-     * Called whenever the player joins or changes worlds (does not fire when the player leaves the world).
+     * Called whenever the server transfers a player into another server.
      */
-    "world-change": LatiteEvent;
+    "transfer": LatiteEvent;
+
+    /**
+     * Calls whenever the player goes into a different dimension.
+     */
+    "change-dimension": LatiteEvent;
 }
 
 interface Latite {

definitions/script.d.ts

@@ -5,21 +5,20 @@ interface EngineLibraries {
 }
 
 /**
- * Prints to chat.
- * @param contents The contents to log.
+ * Adds chat message(s) to the chat.
+ * @param contents The contents to send to chat. They will be separated into different chat messages.
  */
-declare function clientMessage(... contents: any[]): void;
+declare function clientMessage(... messages: any[]): void;
 
 /**
  * Load a specified library.
- * @param path The filepath, HTTP or HTTPS link to the JS file.
- * @throws Invalid filepath or Non-OK HTTP/HTTPS error code
+ * @param library The Latite Scripting engine built-in library.
  */
-declare function require<K extends keyof EngineLibraries>(path: K): EngineLibraries[K];
+declare function require<K extends keyof EngineLibraries>(library: K): EngineLibraries[K];
 
 /**
- * 
- * @param path The path to load the library
+ * Load and run a specified JavaScript module. This returns whatever is in `exports` or `module.exports` of the JavaScript module.
+ * @param path The path to load the JavaScript file.
  */
 declare function require(path: string): any;
 
@@ -43,10 +42,22 @@ declare function setTimeout(func: () => void, timeout: number): number;
  * Calls a function every x milliseconds.
  * @param func The function to call
  * @param timeout The time in milliseconds
- * @returns The Timeout ID
+ * @returns The Interval ID
  */
 declare function setInterval(func: () => void, timeout: number): number;
 
+/**
+ * Cancels a timeout with a specified ID (stops it from executing.) No effect if the id is invalid.
+ * @param timeoutId A valid Timeout ID. It is the return value of the `setTimeout` function.
+ */
+declare function clearTimeout(timeoutId: number): void;
+
+/**
+ * Cancels an interval with a specified ID (stops it from executing.) No effect if the id is invalid.
+ * @param intervalId A valid Interval ID. It is the return value of the `setInterval` function.
+ */
+declare function clearInterval(intervalId: number): void;
+
 interface ScriptModule {
     /**
      * What the script exports.

definitions/world/block.d.ts

@@ -0,0 +1,15 @@
+declare class Block {
+    /**
+     * Example: minecraft:deepslate_diamond_ore
+     */
+    public readonly name: string;
+    /**
+     * Examle: tile.stone.stone
+     */
+    public readonly translateName: string;
+
+    /**
+     * Example: itemGroup.name.ore
+     */
+    public readonly itemGroupName: string;
+}

definitions/world/dimension.d.ts

@@ -0,0 +1,23 @@
+declare interface Dimension {
+    /**
+     * Returns `true` if in a dimension, returns `false` if not. You will only be able to use the Dimension methods if you are in a world.
+     */
+    exists(): boolean;
+
+    /**
+     * Gets a block at the specified position. Will return null if no block was found. (If it's air, it will also return a Block)
+     * @param x Integer for x coordinate
+     * @param y Integer for y coordinate
+     * @param z Integer for z coordinate
+     */
+    getBlock(x: number, y: number, z: number): Block;
+
+
+    /**
+     * Gets the dimension's name, for example, `"Overworld"`
+     */
+    getName(): string;
+}
+
+
+declare const dimension: Dimension;

definitions/world/entity.d.ts

@@ -18,6 +18,17 @@ declare class Entity {
      * @throws
      */
     getPosition(): Vector3;
+
+    /**
+     * Get the interpolated position. Use this in the context of rendering based on entity position.
+     */
+    getPositionInterpolated(): Vector3;
+
+    /**
+     * Get the position the entity was in the last tick.
+     */
+    getPreviousPosition(): Vector3;
+
     /**
      * Get the rotation. Note that this will fail if you dont have permission to get the rotation
      * @throws