# Table of Contents

- [Functions | Wave](#functions-wave)
- [Getting Started | Wave](#getting-started-wave)
- [Hooking | Wave](#hooking-wave)
- [Console | Wave](#console-wave)
- [Input | Wave](#input-wave)
- [File System | Wave](#file-system-wave)
- [Environment | Wave](#environment-wave)
- [Table | Wave](#table-wave)
- [Signal | Wave](#signal-wave)
- [Miscellaneous | Wave](#miscellaneous-wave)
- [Actors | Wave](#actors-wave)
- [Libraries | Wave](#libraries-wave)
- [Cache | Wave](#cache-wave)
- [Script | Wave](#script-wave)
- [Reflection | Wave](#reflection-wave)
- [Credits | Wave](#credits-wave)
- [Debug | Wave](#debug-wave)
- [Introduction | Wave](#introduction-wave)
- [Changelogs | Wave](#changelogs-wave)
- [WebSocket | Wave](#websocket-wave)
- [Crypt | Wave](#crypt-wave)
- [ImGui | Wave](#imgui-wave)
- [Drawing | Wave](#drawing-wave)

---

# Functions | Wave

* * *

[](#unc-sunc)

UNC/sUNC


---------------------------

Wave's UNC/sUNC score is 100%, which means it is capable of executing any script or function you can think of. On the next page are all of the functions that Wave supports, starting with [Console Functions](/wave/functions/console)
.

[PreviousGetting Started](/wave/getting-started)
[NextConsole](/wave/functions/console)

Last updated 3 months ago

💻

---

# Getting Started | Wave

[PreviousIntroduction](/wave)
[NextFunctions](/wave/functions)

Last updated 5 months ago

* * *

*   Let's get you started with where to download Wave.
    

[](#download)

Download:


----------------------------

*   [https://getwave.gg](https://getwave.gg)
    

This is our one, and only official website for Wave. Anyone regarding a different site for Wave is a scam and is phishing you to download their fake software.

[](#installation)

Installation:


------------------------------------

You can follow the instructions below to get the best experience & installation process out of Wave!

After downloading Wave from the link above, you can proceed by doing the steps below:

*   Click `_**Download**_` on the landing page.
    

> You will then be prompted to download `_**WaveWindows**_`.

[](#register)

Register:


----------------------------

Now that you've made it this far into getting Wave, all you need to do is register an account.

*   Click the Sign Up button at the bottom of the Login Prompt.
    
*   Make up a username, email, and password that you can remember.
    
*   Once you're done, click the Sign Up button on the prompt.
    

> Congratulations, you now have access to the main Wave User-Interface!

[](#redeem-your-key)

Redeem Your Key:


------------------------------------------

*   In order to use Wave, you need a key for the software to function as it is supposed to.
    
    *   For Free users, you must go through Linkvertise and grab your key from there.
        
    
    > [https://key.getwave.gg/](https://key.getwave.gg/)
    
    *   For Premium users, you must buy a key from one of our official resellers that you can find easily on our website.
        
    
    > [https://getwave.gg/resellers](https://getwave.gg/resellers)
    
*   To actually redeem the key, hit the Settings logo near the bottom left of the user-interface.
    
*   From there, input your key where it says `XXXXX-XXXXX-XXXXX-XXXXX`.
    

_Login Prompt for Wave_

_Sign Up Prompt for Wave_

_Wave User-Interface_

_Settings > Account Prompt on Wave User-Interface_

![](https://duckys-playground.gitbook.io/~gitbook/image?url=https%3A%2F%2F1104749877-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FbMYIjZIMFAXPDosXtcgO%252Fuploads%252Ff7h43qKmISgRdQQafgE2%252Fimage.png%3Falt%3Dmedia%26token%3Db3731e2e-fd98-4086-9278-8f9936f23a17&width=768&dpr=4&quality=100&sign=50a9b56c&sv=2)

![](https://duckys-playground.gitbook.io/~gitbook/image?url=https%3A%2F%2F1104749877-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FbMYIjZIMFAXPDosXtcgO%252Fuploads%252F7Tx3HMxmKKX2HolCVs6T%252Fimage.png%3Falt%3Dmedia%26token%3D227b6da0-e3e8-40af-90d6-3890961f2620&width=768&dpr=4&quality=100&sign=a887ea2b&sv=2)

![](https://duckys-playground.gitbook.io/~gitbook/image?url=https%3A%2F%2F1104749877-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FbMYIjZIMFAXPDosXtcgO%252Fuploads%252FStcEr8wDSyaGhcOS1cre%252Fimage.png%3Falt%3Dmedia%26token%3D70fda4f2-eaa3-4896-ac92-4abfb6484261&width=768&dpr=4&quality=100&sign=eb95dd01&sv=2)

![](https://duckys-playground.gitbook.io/~gitbook/image?url=https%3A%2F%2F1104749877-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FbMYIjZIMFAXPDosXtcgO%252Fuploads%252FArt6E0hnsigj5p83uLVK%252Fimage.png%3Falt%3Dmedia%26token%3D6bee39ff-8e37-4ab5-a25f-e335be8eda9c&width=768&dpr=4&quality=100&sign=fbe536ac&sv=2)

---

# Hooking | Wave

### 

[](#clone-function)

Clone Function

Copy

    <function> clonefunction(<function> a1)

*   Clones function `a1`.
    

* * *

### 

[](#hook-function)

Hook Function

Copy

    <function> hookfunction(<function> old, <function> new)  

*   Hooks function `old`, replacing it with the function `new`. The `old` function is returned, you _must_ use this function in order to call the original function.
    

* * *

### 

[](#hook-metamethod)

Hook Metamethod

Copy

    <function> hookmetamethod(<Object> object, <string> metamethod, <function> a1)  

*   Hooks the `metamethod` passed in `object`'s metatable with `a1`.
    

* * *

### 

[](#new-c-closure)

New C Closure

Copy

    <function> newcclosure(<function> a1)  

*   Pushes a new C Closure that invokes the function `a1` upon call.
    

* * *

[PreviousFile System](/wave/functions/file-system)
[NextInput](/wave/functions/input)

Last updated 3 months ago

* * *

---

# Console | Wave

* * *

### 

[](#clear)

Clear

Copy

    <void> rconsoleclear(<void>)

*   Clears all text from the console.
    

* * *

### 

[](#close)

Close

Copy

    <void> rconsoleclose(<void>)

*   Closes the console.
    

* * *

### 

[](#error)

Error

Copy

    <void> rconsoleerr(<string> text)

*   Prints `text` into the console, with `[ERROR]` written before it.
    

* * *

### 

[](#info)

Info

Copy

    <void> rconsoleinfo(<string> text)

*   Prints `text` into the console, with `[INFO]` written before it.
    

* * *

### 

[](#input)

Input

Copy

    <string> rconsoleinput(<void>)

*   Yields the current thread until the user inputs text and presses `Enter`. Returns the input they put in.
    

* * *

### 

[](#name)

Name

Copy

    <void> rconsolename(<string> title)

*   Sets the console's title to `title`.
    

* * *

### 

[](#print)

Print

Copy

    <void> rconsoleprint(<string> text)

*   Prints `text` into the console.
    

* * *

### 

[](#print-console)

Print Console

Copy

    <void> printconsole(<string> message, <byte> red, <byte> green, <byte> blue)

*   Prints `message` into the internal and integrated console with RGB value.
    

* * *

#### 

[](#console-colors)

Console Colors:

Name

Type

Black

@@BLACK@@

Blue

@@BLUE@@

Green

@@GREEN@@

Cyan

@@CYAN@@

Red

@@RED@@

Magenta

@@MAGENTA@@

Light Gray

@@LIGHT\_GRAY@@

Dark Gray

@@DARK\_GRAY@@

Light Blue

@@LIGHT\_BLUE@@

Light Green

@@LIGHT\_GREEN@@

Light Cyan

@@LIGHT\_CYAN@@

Light Red

@@LIGHT\_RED@@

Light Magenta

@@LIGHT\_MAGENTA@@

Yellow

@@YELLOW@@

White

@@WHITE@@

Example:

Copy

    rconsolename("console") -- Sets the name of the console to 'console'
    rconsoleprint("gamer\n")
    rconsoleprint("@@YELLOW@@") -- Changes the text color to Yellow
    rconsoleprint("gamer but yellow\n")
    rconsoleerr("omg error!")
    rconsolewarn("omg warning!")
    wait(3)
    rconsoleclear() -- Clears all text
    wait(1)
    rconsoleclose() -- Closes the console

You must use `\n` at the end of `rconsoleprint` to make a new line.

`rconsoleinfo`, `rconsolewarn`, and `rconsoleerr` do this automatically.

* * *

[PreviousFunctions](/wave/functions)
[NextEnvironment](/wave/functions/environment)

Last updated 3 months ago

💻

🎮

---

# Input | Wave

* * *

### 

[](#is-roblox-active)

Is Roblox Active

Copy

    <bool> isrbxactive(<void>)

*   Returns `true` if the game window is in focus.
    

* * *

### 

[](#keyboard)

Keyboard

Copy

    <void> keypress(<uint> keycode)  

*   Simulates a key press for the specified keycode. You can find a list of codes [here](https://docs.microsoft.com/en-us/windows/desktop/inputdev/virtual-key-codes)
    .
    

Copy

    <void> keyrelease(<uint> key)  

*   Releases `key` on the keyboard.
    

* * *

### 

[](#left-click)

Left Click

Copy

    <void> mouse1click(<void>)  

*   Simulates a full left mouse button press.
    

Copy

    <void> mouse1press(<void>)  

*   Simulates a left mouse button press without releasing it.
    

Copy

    <void> mouse1release(<void>)  

*   Simulates a left mouse button release.
    

* * *

### 

[](#mouse-movement)

Mouse Movement

Copy

    <void> mousescroll(<number> number)  

*   Scrolls the mouse wheel virtually by `number` pixels.
    

Copy

    <void> mousemoverel(<number> a1, <number> a2)  

*   Moves the mouse cursor relatively to the current mouse position by coordinates `a1` and `a2`.
    

Copy

    <void> mousemoveabs(<number> a1, <number> a2)  

*   Move's your mouse to the `a1` and `a2` coordinates in pixels from top left of the window.
    

* * *

### 

[](#right-click)

Right Click

Copy

    <void> mouse2click(<void>)

*   Simulates a full right mouse button press.
    

Copy

    <void> mouse2press(<void>)  

*   Clicks down on the right mouse button.
    

Copy

    <void> mouse2release(<void>)  

*   Simulates a right mouse button release.
    

* * *

[PreviousHooking](/wave/functions/hooking)
[NextMiscellaneous](/wave/functions/miscellaneous)

Last updated 3 months ago

💻

🖱️

---

# File System | Wave

* * *

### 

[](#append-file)

Append File

Copy

    <void> appendfile(<string> path, <string> content)

Appends `content` to the file contents at `path`.

* * *

### 

[](#delete-file)

Delete File

Copy

    <void> delfile(<string> path)

*   Deletes the file located at `path`.
    

* * *

### 

[](#delete-folder)

Delete Folder

Copy

    <void> delfolder(<string> path)

*   Deletes the folder located at `path`.
    

* * *

### 

[](#get-custom-asset)

Get Custom Asset

Copy

    <string> getcustomasset(<string> path)

*   Provides a content string suitable for use with GUI elements, sounds, meshes, and other assets to reference an item in the workspace folder.
    

* * *

### 

[](#is-file)

Is File

Copy

    <bool> isfile(<string> path)

*   Returns `true` if `path` is a file.
    

* * *

### 

[](#is-folder)

Is Folder

Copy

    <bool> isfolder(<string> path)

*   Returns `true` if `path` is a folder.
    

* * *

### 

[](#list-files)

List Files

Copy

    <table> listfiles(<string> folder)

*   Returns a table of all files in `folder`.
    

* * *

### 

[](#load-file)

Load File

Copy

    <function> loadfile(<string> path)

*   Loads the contents of the file located at `path` as a Lua function and returns it.
    

* * *

### 

[](#make-folder)

Make Folder

Copy

    <void> makefolder(<string> path)

*   Creates a new folder at `path`.
    

* * *

### 

[](#read-file)

Read File

Copy

    <string> readfile(<string> path)

*   Returns the contents of the file located at `path`.
    

* * *

### 

[](#write-file)

Write File

Copy

    <void> writefile(<string> path, <string> content)

*   Writes `content` to the supplied `path`.
    

* * *

[PreviousEnvironment](/wave/functions/environment)
[NextHooking](/wave/functions/hooking)

Last updated 3 months ago

💻

📂

---

# Environment | Wave

* * *

### 

[](#create-secure-folder)

Create Secure Folder

Copy

    <void> create_secure_folder(<string> path)

*   Creates a new secure folder to `path`.
    

> Note: The folder itself won't be able to be found by the game. This means you don't need to set the security of the instances within it.

### 

[](#fire-click-detector)

Fire Click Detector

Copy

    <void> fireclickdetector(<ClickDetector> ClickDetector, <number?> Distance = 0, <string?>)

*   Fires the `ClickDetector`. If no distance supplied, it will default to `0`.
    

* * *

### 

[](#fire-proximity-prompt)

Fire Proximity Prompt

Copy

    <void> fireproximityprompt(<ProximityPrompt> Prompt)

*   Fires the `ProximityPrompt` trigger.
    

* * *

### 

[](#fire-touch-interest)

Fire Touch Interest

Copy

    <void> firetouchinterest(<BasePart> totouch, <BasePart> Part, <uint?> toggle)

*   Touches part with `totouch`.
    

#### 

[](#actions)

Actions:

Action

Toggle

Begins the touch.

0

Ends the touch.

1

* * *

### 

[](#get-garbage-collection)

Get Garbage Collection

Copy

    <table> getgc(<bool?> IncludeTables = false)

*   Returns a `table` with all `gc` objects. Use `getgc(true)` to include tables.
    

* * *

### 

[](#get-global-environment)

Get Global Environment

Copy

    <table> getgenv(<void>)

*   Returns the `environment` that will be applied to each script ran by Wave.
    

* * *

### 

[](#get-instances)

Get Instances

Copy

    <table> getinstances(<void>)

*   Returns a `table` with instances.
    

* * *

### 

[](#get-nil-instances)

Get Nil Instances

Copy

    <table> getnilinstances(<void>)

*   Returns a `table` with instances parented to `nil`.
    

* * *

### 

[](#get-roblox-environment)

Get Roblox Environment

Copy

    <table> getrenv(<void>)

*   Returns the Roblox `environment`.
    

* * *

### 

[](#is-secured-instance)

Is Secured Instance

Copy

    <void> is_secured_instance(<Instance> Instance)

*   Returns `true`/`false` if `Instance` is secured/not secured.
    

* * *

### 

[](#set-normal-instance)

Set Normal Instance

Copy

    <table> set_normal_instance(<Instance> Instance)

*   Sets `Instance` back to its normal state. Returns `false` if `Instance` is back to normal.
    

* * *

### 

[](#set-secure-instance)

Set Secure Instance

Copy

    <table> set_secure_instance(<Instance> Instance)

*   Secures `Instance`. Returns `false` if `Instance` is secured.
    

[PreviousConsole](/wave/functions/console)
[NextFile System](/wave/functions/file-system)

Last updated 3 months ago

💻

🌎

---

# Table | Wave

* * *

### 

[](#get-raw-metatable)

Get Raw Metatable

Copy

    <table> getrawmetatable(<table> a1)  

*   Returns the `__metatable` of `a1`.
    

* * *

### 

[](#is-read-only)

Is Read Only

Copy

    <bool> isreadonly(<table> a1)  

*   Returns if `a1` is read-only.
    

* * *

### 

[](#set-raw-metatable)

Set Raw Metatable

Copy

    <bool> setrawmetatable(<table> a1, <table> a2)

*   Sets the `__metatable` of `a1` to `a2`.
    

* * *

### 

[](#set-read-only)

Set Read Only

Copy

    <void> setreadonly(<table> a1, <bool> a2)  

*   Sets the read-only value of `a1` to `a2`.
    

* * *

[PreviousScript](/wave/functions/script)
[NextSignal](/wave/functions/signal)

Last updated 3 months ago

💻

📊

---

# Signal | Wave

* * *

### 

[](#disable-connection)

Disable Connection

Copy

    <void> disableconnection(<RBXScriptConnection> Connection)

*   Disables `Connection`.
    

* * *

### 

[](#enable-connection)

Enable Connection

Copy

    <void> enableconnection(<RBXScriptConnection> Connection)

*   Enables `Connection`.
    

* * *

### 

[](#fire-signal)

Fire Signal

Copy

    <void> firesignal(<RBXScriptSignal> Signal, <variant?> Args...)

*   Fires all signals connected to the `signal`. If given, the arguments will be used to call the function.
    

* * *

### 

[](#get-connections)

Get Connections

Copy

    <table> getconnections(<RBXScriptSignal> Signal)

*   Returns a `table` with all connections to the given `signal`.
    

#### 

[](#connections)

Connections:

Connection

Description

.Function

The function connected to the connection.

:Enable

Enables the connection.

:Disable

Disables the connection.

:Fire

Fires the connection.

* * *

### 

[](#hook-signal)

Hook Signal

Copy

    <void> hooksignal(<RBXScriptSignal> Signal, <function> callback)

*   Intercepts signal invocations. When the `Signal` is fired, the `callback` is called for each Lua connection with an info table and arguments. Returning `true` from the callback triggers the original connection.
    

> Note: `hooksignal` cannot intercept C connections or CoreScript Lua connections.

* * *

### 

[](#is-connection-enabled)

Is Connection Enabled

Copy

    <bool> isconnectionenabled(<RBXScriptConnection> Connection)

*   Returns `true` if a connection is enabled.
    

* * *

### 

[](#is-signal-hooked)

Is Signal Hooked

Copy

    <void> issignalhooked(<RBXScriptSignal> Signal)

*   Returns `true` if `Signal` is hooked.
    

* * *

### 

[](#unhook-signal)

Unhook Signal

Copy

    <void> unhooksignal(<RBXScriptSignal> Signal)

*   Unhooks a signal hooked with `hooksignal`.
    

* * *

[PreviousTable](/wave/functions/table)
[NextLibraries](/wave/libraries)

Last updated 3 months ago

💻

📶

---

# Miscellaneous | Wave

* * *

WARNING: `decompile()` is a Premium only function.

### 

[](#decompile)

Decompile

Copy

    <string> decompile(<Instance> Script)

*   Decompiles `Script` and returns the decompiled output.
    

#### 

[](#example)

Example:

Copy

    local LocalPlayer = game:GetService("Players").LocalPlayer 
    local PlayerModule = LocalPlayer.PlayerScripts.PlayerModule
    local Decompiled = decompile(PlayerModule) -- Decompiles PlayerModule
    setclipboard(Decompiled) -- Copies the decompiled output to your clipboard

* * *

### 

[](#get-hidden-ui)

Get Hidden UI

Copy

    <Instance> gethui(<void>)

*   Returns the `CoreGui` service, allowing GUI's being hidden from detection in-game.
    

* * *

### 

[](#get-namecall-method)

Get Namecall Method

Copy

    <string> getnamecallmethod(<void>)

*   Returns the namecall method if the function is called in an `__namecall` metatable hook.
    

* * *

### 

[](#get-thread-identity)

Get Thread Identity

Copy

    <void> getthreadidentity(<value> number)

*   Returns the current thread's identification number.
    

* * *

### 

[](#identify-executor)

Identify Executor

Copy

    <string, string> identifyexecutor(<void>)

*   Returns `Wave` and the version if the current executor is Wave.
    

* * *

### 

[](#is-scriptable)

Is Scriptable

Copy

    <bool> isscriptable(<Instance> object)

*   Checks if `object` can be scripted or modified by a script.
    

* * *

WARNING: `saveinstance()` is a Premium only function.

### 

[](#save-instance)

Save Instance

Copy

    <void> saveinstance(<Instance?> Object, <string?> FilePath, <table?> Options)

*   Saves the current game into your workspace folder as a `.RBXL` file.
    

> If `Object` is specified, it will save that object and its descendants as a `.RBXM` file.

> If `Object` is `game`, it will be saved as a `.RBXL` file.

> If `FilePath` is specified, it will write the file to the specified path.

> `FilePath` does not need to contain a file extension, only the name of the file.

#### 

[](#options)

Options:

Name

Type

Default

Description

Decompile

Boolean

false

If enabled, `LocalScripts` and `ModuleScripts` will be decompiled.

DecompileTimeout

Number

10

If the decompilation run time exceeds this value, it will be canceled. This value is in seconds.

DecompileIgnore

Table

{"Chat", "CoreGui", "CorePackages"}

Scripts that are a descendant of the specified services will be saved but not decompiled.

NilInstances

Boolean

false

If enabled, instances parented to `nil` will be saved.

RemovePlayerCharacters

Boolean

true

If enabled, player characters will not be saved.

SavePlayers

Boolean

false

If enabled, Player objects and their descendants will be saved.

MaxThreads

Number

3

The number of decompilation threads that can run at once. More threads allow for more scripts to be decompiled at the same time.

ShowStatus

Boolean

true

If enabled, Save Instance progress will be displayed.

IgnoreDefaultProps

Boolean

true

If enabled, default properties will not be saved.

IsolateStarterPlayer

Boolean

true

If enabled, `StarterPlayer` will be cleared and the saved starter player will be placed into folders.

#### 

[](#example-saving-the-game-to-a-custom-folder)

Example - Saving the game to a custom folder:

Copy

    makefolder("MySaves")
    saveinstance(game, "MySaves/Cool Game")

#### 

[](#example-saving-a-specific-object-with-decompiled-scripts)

Example - Saving a specific object with decompiled scripts:

Copy

    saveinstance(workspace.CoolModel, "Cool Model", {
        Decompile = true
    })

* * *

### 

[](#set-clipboard)

Set Clipboard

Copy

    <void> setclipboard(<string> content)

*   Sets `content` to the clipboard.
    

* * *

### 

[](#set-fast-flag)

Set Fast Flag

Copy

    <void> setfflag(<string> flag, <string> value)

*   Sets `flag`'s value to `value`.
    

> You can find a list of all Fast Flags here: [FFlag Tracker](https://raw.githubusercontent.com/MaximumADHD/Roblox-FFlag-Tracker/main/PCDesktopClient.json)

* * *

### 

[](#set-fps-cap)

Set FPS Cap

Copy

    <void> setfpscap(<uint> cap)

*   Sets the fps cap to `cap`.
    

* * *

### 

[](#set-namecall-method)

Set Namecall Method

Copy

    <void> setnamecallmethod(<string> method)

*   Sets the current namecall method to the new namecall method. Must be called in a `__namecall` metatable hook.
    

* * *

### 

[](#set-thread-identity)

Set Thread Identity

Copy

    <void> setthreadidentity(<value> number)

*   Sets the current thread's identification `number`.
    

* * *

### 

[](#message-box)

Message Box

Copy

    <uint> messagebox(<string> text, <string> title, <uint> flag)

*   Creates a message box.
    

* * *

#### 

[](#flags)

Flags:

Flag

Value

OK

0

OK / Cancel

1

Abort / Retry / Ignore

2

Yes / No / Cancel

3

Yes / No

4

Retry / Cancel

5

Cancel / Try Again / Continue

6

#### 

[](#return-values)

Return Values:

Value

Description

1

OK was clicked.

2

Cancel was clicked.

3

Abort was clicked.

4

Retry was clicked.

5

Ignore was clicked

6

Yes was clicked.

7

No was clicked.

10

Try Again was clicked.

11

Continue was clicked.

* * *

### 

[](#queue-on-teleport)

Queue On Teleport

Copy

    <void> queue_on_teleport(<string> script)

*   Queues `script` to be executed after the next teleport.
    

* * *

### 

[](#request)

Request

Copy

    <table> request(<table> a1, <bool?> Async)

*   Creates an http request with `a1`.
    

> Aliases: `http_request`

* * *

[PreviousInput](/wave/functions/input)
[NextReflection](/wave/functions/reflection)

Last updated 22 days ago

💻

💡

---

# Actors | Wave

* * *

This library is Wave Premium only!

### 

[](#get-actors)

Get Actors

Copy

    <string> get_actors(<void>)

*   Returns all the actors in the game, example above will return `0` if there are no actors in the game.
    

* * *

### 

[](#get-current-actor)

Get Current Actor

Copy

    <string> get_current_actor(<void>)

*   Returns the actor instance of the current running thread.
    

* * *

### 

[](#get-deleted-actors)

Get Deleted Actors

Copy

    <string> get_deleted_actors(<void>)

*   Checks actor threads specifically connected to an expired actor instance.
    

> Note: This function does not return the actor instance directly. Instead, it returns a lightuserdata that can be passed to `run_on_actor`.

* * *

### 

[](#is-parallel)

Is Parallel

Copy

    <string> is_parallel(<void>)

*   Returns if the thread is parallel or not.
    

* * *

### 

[](#run-on-actor)

Run On Actor

Copy

    <string> run_on_actor(<ActorState>, <Script>)

*   Will run the script on an actor state.
    

Copy

    local id, channel = create_comm_channel()
    channel.Event:Connect(print) -- .Event returns channel, so we are connecting directly to channel
    
    run_on_actor(Instance.new("Actor"), [[\
    local s = get_comm_channel(...)\
    s:Fire("hello from actor")\
    ]], id)

* * *

[PreviousLibraries](/wave/libraries)
[NextCache](/wave/libraries/cache)

Last updated 3 months ago

📚

👨‍🎤

---

# Libraries | Wave

[👨‍🎤Actors](/wave/libraries/actors)
[🗃️Cache](/wave/libraries/cache)
[👾Crypt](/wave/libraries/crypt)
[🐞Debug](/wave/libraries/debug)
[🖍️Drawing](/wave/libraries/drawing)
[🖥️ImGui](/wave/libraries/imgui)
[📎WebSocket](/wave/libraries/websocket)

[PreviousSignal](/wave/functions/signal)
[NextActors](/wave/libraries/actors)

* * *

---

# Cache | Wave

* * *

### 

[](#clone-reference)

Clone Reference

Copy

    <Instance> cloneref(<Instance.X>)

*   Pushes `Instance.X` in a new cache.
    

* * *

### 

[](#compare-instances)

Compare Instances

Copy

    <bool> compareinstances(<Instance.X>, <Instance.Y>)

*   Compares instances internally.
    

* * *

### 

[](#invalidate)

Invalidate

Copy

    <void> cache.invalidate(<Instance>)

*   Invalidates `Instance` in the cache within registry.
    

* * *

### 

[](#is-cached)

Is Cached

Copy

    <bool> cache.iscached(<Instance>)

*   Returns if `Instance` is currently cached in the cache within registry.
    

* * *

### 

[](#replace)

Replace

Copy

    <void> cache.replace(<Instance.X>, <Instance.Y>)

*   Replaces `Instance.X` with `Instance.Y` in the cache within registry.
    

* * *

[PreviousActors](/wave/libraries/actors)
[NextCrypt](/wave/libraries/crypt)

Last updated 3 months ago

📚

🗃️

---

# Script | Wave

* * *

### 

[](#get-calling-script)

Get Calling Script

Copy

    <Instance> getcallingscript(<void>)

*   Gets the script that is calling this function.
    

* * *

### 

[](#get-loaded-modules)

Get Loaded Modules

Copy

    <table> getloadedmodules(<void>)

*   Returns a `table` with all loaded `modules` currently in game.
    

* * *

### 

[](#get-running-scripts)

Get Running Scripts

Copy

    <table> getrunningscripts(<void>)

*   Returns a list of scripts that are running in the environment. Returns `nil` if there are no scripts running.
    

* * *

### 

[](#get-scripts)

Get Scripts

Copy

    <table> getscripts(<void>)

*   Returns a list of scripts within the global state of the caller.
    

* * *

### 

[](#get-script-bytecode)

Get Script Bytecode

Copy

    <string> getscriptbytecode(<Instance> Script)

*   Returns the bytecode of the given script. This can be used in a dissassembler.
    

* * *

### 

[](#get-script-closure)

Get Script Closure

Copy

    <function> getscriptclosure(<Instance> Script)

*   Returns the closure from the given script, can be used to gather `upvalues` or `constants`.
    

* * *

### 

[](#get-script-environment)

Get Script Environment

Copy

    <table> getsenv(<LocalScript, ModuleScript> Script)

*   Returns the global environment of the given script.
    

* * *

### 

[](#get-script-hash)

Get Script Hash

Copy

    <string> getscripthash(<Instance> Script)

*   Returns a SHA384 hash of the scripts bytecode. You can use this to detect changes of a script.
    

* * *

[PreviousReflection](/wave/functions/reflection)
[NextTable](/wave/functions/table)

Last updated 3 months ago

💻

🕹️

---

# Reflection | Wave

* * *

### 

[](#check-caller)

Check Caller

Copy

    <bool> checkcaller(<void>)  

*   Returns `true` if the current thread was created by Wave.
    

* * *

### 

[](#get-hidden-property)

Get Hidden Property

Copy

    <variant> gethiddenproperty(<Instance> Object, <string> Property)

*   Returns the `value` of the property that cannot be accessed through Lua.
    

* * *

### 

[](#is-executor-closure)

Is Executor Closure

Copy

    <bool> isexecutorclosure(<function> a1)

*   Returns `true` if `a1` was created by Wave.
    

* * *

### 

[](#is-lua-closure)

Is Lua Closure

Copy

    <bool> islclosure(<function> a1)  

*   Returns `true` if `a1` is an L Closure.
    

* * *

### 

[](#loadstring)

Loadstring

Copy

    <function> loadstring(<string> chunk, <string?> chunkName)

*   Loads `chunk` as a Lua function with optional `chunkName` and returns it.
    

* * *

### 

[](#set-hidden-property)

Set Hidden Property

Copy

    <void> sethiddenproperty(<Instance> Object, <string> Property, <variant> Value)

*   Sets the given property to new `value`.
    

* * *

### 

[](#set-scriptable)

Set Scriptable

Copy

    <void> setscriptable(<Instance> Object, <string> Property, <bool> toggle)

*   Sets the property's scriptable state to `toggle`.
    

* * *

[PreviousMiscellaneous](/wave/functions/miscellaneous)
[NextScript](/wave/functions/script)

Last updated 3 months ago

💻

🪞

---

# Credits | Wave

* * *

*   Ducky ([bruvzz](https://discord.com/users/731312800676315146)
    ) - Official Documenter for "Wave | Documentation"
    
*   Cozy ([cozyhq](https://discord.com/users/311167867297202186)
    ) - Official Documenter for "Wave | Documentation"
    
*   The Wave Development Team - Development Team for "Wave"
    

[](#anything-missing)

Anything Missing?


--------------------------------------------

*   If there is something specific or special missing on this documentation, please kindly inform [bruvzz (Ducky)](https://discord.com/users/731312800676315146)
     in his direct messages.
    
    *   You will get a response **as soon as possible**.
        
    *   If [bruvzz](https://discord.com/users/731312800676315146)
         does not respond, please kindly inform [cozyhq](https://discord.com/users/311167867297202186)
         or [rexi](https://discord.com/users/783641932370935868)
        .
        
    

[PreviousChangelogs](/wave/changelogs)

Last updated 2 months ago

📃

---

# Debug | Wave

* * *

### 

[](#get-constant)

Get Constant

Copy

    <variant> debug.getconstant(<function> f, <int> idx)

*   Returns the constant at index `idx` in function `f` or level `f`.
    

* * *

### 

[](#get-constants)

Get Constants

Copy

    <table> debug.getconstants(<function> f)

*   Returns the constants in function `f` or at level `f`.
    

* * *

### 

[](#get-info)

Get Info

Copy

    <table> debug.getinfo(<function> f)

*   Returns a table of information about function `f`.
    

#### 

[](#info)

Info:

Name

Type

Description

name

String

The name of the function.

short\_src

String

A shorter version of source.

what

String

What the function is: Lua = Lua function - C = C function

currentline

Integer

The line that is currently active.

nups

Integer

The number of upvalues that the function has.

func

Function

The function that is active.

source

String

Where the function was defined.

* * *

### 

[](#get-proto)

Get Proto

Copy

    <table, function> debug.getproto(<function> f, <int> idx, <bool?> activated)

*   Gets the inner `function` of `f` at `index`.
    

* * *

### 

[](#get-registry)

Get Registry

Copy

    <table> debug.getregistry(<void>)

*   Returns the Lua registry.
    

* * *

### 

[](#get-stack)

Get Stack

Copy

    <table> debug.getstack(<function> f, <int> idx)

*   Gets the method stack at level or function `f`.
    

* * *

### 

[](#get-upvalue)

Get Upvalue

Copy

    <variant> debug.getupvalue(union<function, number> f, <number> idx)

*   Returns the upvalue with name `idx` in function or level `f`.
    

* * *

### 

[](#get-upvalues)

Get Upvalues

Copy

    <table> debug.getupvalues(<function> f)

*   Retrieve the upvalues in function `f` or at level `f`.
    

* * *

### 

[](#set-constant)

Set Constant

Copy

    <void> debug.setconstant(<function> f, <int> idx, union<number, bool, string> value)

*   Set constant `idx` to tuple `value` at level or function `f`.
    

* * *

### 

[](#set-metatable)

Set Metatable

Copy

    <table> debug.setmetatable(<table> o, <table> mt)  

*   Set the metatable of `o` to `mt`.
    

* * *

### 

[](#set-proto)

Set Proto

Copy

    <void> debug.setproto(<function> fi, <number> index, <function> replacement)

*   Replaces `fi` at `index` with function `replacement` at level or function `fi`.
    

* * *

### 

[](#set-stack)

Set Stack

Copy

    <void> debug.setstack(<function> f, <int> idx, <table> value)

*   Sets the stack indice at `indice` to `value` at level or function `f`.
    

* * *

### 

[](#set-upvalue)

Set Upvalue

Copy

    <void> debug.setupvalue(<function> f, <int> idx, <table> value)

*   Set upvalue `idx` to `value` at level or function `f`.
    

* * *

[PreviousCrypt](/wave/libraries/crypt)
[NextDrawing](/wave/libraries/drawing)

Last updated 3 months ago

📚

🐞

---

# Introduction | Wave

* * *

[NextGetting Started](/wave/getting-started)

Last updated 3 months ago

[getwave.gg](https://getwave.gg)
 is our one and only official web domain.

[](#wave-or-documentation)

Wave | Documentation


----------------------------------------------------

[🌊Getting Started](/wave/getting-started)

[💻Functions](/wave/functions)

[📚Libraries](/wave/libraries)

[📃Credits](/wave/credits)

👋

![Page cover image](https://duckys-playground.gitbook.io/~gitbook/image?url=https%3A%2F%2F1104749877-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FbMYIjZIMFAXPDosXtcgO%252Fuploads%252F7gRuqDZVGCvdAbLFK87C%252FWave_Banner_Discord.gif%3Falt%3Dmedia%26token%3D195e4598-f051-4ad9-a788-76882f6af50b&width=1248&dpr=4&quality=100&sign=8d90efcb&sv=2)

---

# Changelogs | Wave

* * *

### 

[](#december-7th-2024)

December 7th, 2024

*   Added `get_current_actor`.
    
*   Added `get_deleted_actors`.
    

### 

[](#december-1st-2024)

December 1st, 2024

*   Added `isexecutorclosure`.
    
*   Added `getthreadidentity`.
    
*   Added `getcustomasset`.
    
*   Added `clonefunction`.
    
*   Updated `base64_decode`.
    
*   Updated `basea64_encode`.
    
*   Added `crypt.generatebytes`.
    
*   Added `crypt.generatekey`.
    
*   Added `getrunningscripts`.
    
*   Added `getscripts`.
    

### 

[](#november-30th-2024)

November 30th, 2024

*   Re-categorized and sorted everything.
    
*   Added `isscriptable`.
    
*   Added `gethui`.
    
*   Added `setthreadidentity`.
    
*   Added `is_secured_instance`.
    
*   Added `set_normal_instance`.
    
*   Added `set_secure_instance`.
    
*   Added `create_secure_folder`.
    

* * *

[PreviousWebSocket](/wave/libraries/websocket)
[NextCredits](/wave/credits)

Last updated 3 months ago

✏️

![](https://duckys-playground.gitbook.io/~gitbook/image?url=https%3A%2F%2F1104749877-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FbMYIjZIMFAXPDosXtcgO%252Fuploads%252F1emMSEy3FtnIwqIwuPOm%252FUntitled%2520%28960%2520x%2520540%2520px%29%2520%288%29.png%3Falt%3Dmedia%26token%3Dede4f6ac-a741-434f-84b2-9a3c7e1e9017&width=768&dpr=4&quality=100&sign=7ac49541&sv=2)

---

# WebSocket | Wave

* * *

### 

[](#close)

Close

Copy

    <void> Socket:Close(<void>)

*   Closes the WebSocket connection.
    

* * *

Event

Description

.OnMessage

Activated when a message is receieved over the websocket connection.

.OnClose

Activated when the websocket connection is closed.

* * *

### 

[](#connect)

Connect

Copy

    <bool> WebSocket.connect(<string> url)

*   Connects with `url` and will return the instance representing the connection.
    

* * *

### 

[](#send)

Send

Copy

    <void> Socket:Send(<string> text)

*   Sends `text` to the WebSocket connection.
    

* * *

[PreviousImGui](/wave/libraries/imgui)
[NextChangelogs](/wave/changelogs)

Last updated 3 months ago

📚

📎

---

# Crypt | Wave

* * *

### 

[](#base64-decode)

Base64 Decode

Copy

    <string> base64_decode(<string> data)  

*   Decodes `data` with base64.
    

* * *

### 

[](#base64-encode)

Base64 Encode

Copy

    <string> base64_encode(<string> data)  

*   Encodes `data` with base64.
    

* * *

### 

[](#decrypt)

Decrypt

Copy

    <string> crypt.decrypt(<string> data, <string> key)  

*   Decrypts `data` with `key`.
    

* * *

### 

[](#derive)

Derive

Copy

    <string> crypt.derive(<string> value, <uint> length)

*   Derives a secret key from `value` with the length of `length`.
    

* * *

### 

[](#encrypt)

Encrypt

Copy

    <string> crypt.encrypt(<string> data, <string> key)  

*   Encrypts `data` with `key`.
    

* * *

### 

[](#generate-bytes)

Generate Bytes

Copy

    <string> crypt.generatebytes(<string> value)

*   Generates random bytes based off `value`.
    

* * *

### 

[](#generate-key)

Generate Key

Copy

    <string> crypt.generatekey(<string> value)

*   Generates a random key based off `value`.
    

* * *

### 

[](#hash)

Hash

Copy

    <string> crypt.hash(<string> data)

*   Hashes `data` with SHA-384.
    

* * *

### 

[](#lz4-compress)

LZ4 Compress

Copy

    <string> lz4_compress(<string> data)

*   Compresses `data` using lz4.
    

* * *

### 

[](#lz4-decompress)

LZ4 Decompress

Copy

    <string> lz4_decompress(<string> data)

*   Decompresses `data` using lz4.
    

* * *

### 

[](#random)

Random

Copy

    <string> crypt.random(<uint> size)

*   Generates a random string with `size` (cannot be negative or exceed 1024).
    

* * *

[PreviousCache](/wave/libraries/cache)
[NextDebug](/wave/libraries/debug)

Last updated 3 months ago

📚

👾

---

# ImGui | Wave

* * *

### 

[](#imgui.new)

ImGui.new

*   Creates a new ImGui Window.
    

#### 

[](#example)

Example:

Copy

    local ui = ImGui.new({ title = "Example" });

* * *

### 

[](#text)

Text

*   Creates a text column.
    

#### 

[](#example-1)

Example:

Copy

    ui:Text({ title = "Hello", content = "Hello, this is an example script for Wave's ImGui Library."});

* * *

### 

[](#tabbar)

TabBar

*   Creates a side bar to put your tabs.
    

#### 

[](#example-2)

Example:

Copy

    ui:TabBar({ title = "TabBar1"});

* * *

### 

[](#tabitem)

TabItem

*   Creates a new tab.
    

#### 

[](#example-3)

Example:

Copy

    local tab_1 = ui:TabItem({ title = "Buttons & InputText"});

* * *

### 

[](#button)

Button

*   Creates a new button.
    

#### 

[](#example-4)

Example:

Copy

    tab_1:Button({
        title = "ExampleButton1",
        callback = function()
            print("Clicked on the button in the Buttons Tab!");
        end
    });
    tab_1:Button({
        title = "RunSUNC",
        callback = function()
            loadstring(game:HttpGet("https://gitlab.com/sens3/nebunu/-/raw/main/HummingBird8's_sUNC_yes_i_moved_to_gitlab_because_my_github_acc_got_brickedd/sUNCm0m3n7.lua"))()
        end
    });

* * *

### 

[](#inputtext)

InputText

*   Creates a new text-box.
    

#### 

[](#example-5)

Example:

Copy

    tab_1:InputText({
        title = "ExampleInputText",
        defaultText = "Input Example!"
    });

* * *

### 

[](#endtabitem)

EndTabItem

*   Ends any programmed code beyond the called function.
    

#### 

[](#example-6)

Example:

Copy

    tab_1:EndTabItem();

### 

[](#checkbox)

CheckBox

*   Creates a checkbox.
    

#### 

[](#example-7)

Example:

Copy

    local tab_2 = ui:TabItem({ title = "Checkbox & Slider" });
    tab_2:CheckBox({ title = "ExampleCheckBox" });

* * *

### 

[](#slider)

Slider

*   Creates a slider.
    

#### 

[](#example-8)

Example:

Copy

    tab_2:Slider({
        title = "ExampleSlider",
        min = 0,
        max = 100
    });
    tab_2:EndTabItem();

* * *

### 

[](#combobox)

ComboBox

*   Creates a combo box.
    

#### 

[](#example-9)

Example:

Copy

    local tab_3 = ui:TabItem({ title = "Combobox & Listbox" });
    tab_3:ComboBox({ 
        title = "ExampleComboBox",
        items = {"Ex1", "Ex2", "Ex3"}
    });

* * *

### 

[](#listbox)

ListBox

*   Creates a list box.
    

#### 

[](#example-10)

Example:

Copy

    tab_3:ListBox({
        title = "ExampleListBox",
        items = {"Ex1L", "Ex2L", "Ex3L"},
        currentItem = 1
    });
    tab_3:EndTabItem();

* * *

### 

[](#colorpicker)

ColorPicker

*   Creates a colorpicker.
    

#### 

[](#example-11)

Example:

Copy

    local tab_4 = ui:TabItem({ title = "Color Picker" });
    tab_4:ColorPicker({
        title = "ExampleColorPicker",
        color = {25, 25, 25}
    });
    tab_4:EndTabItem();

* * *

### 

[](#endtabbar)

EndTabBar

*   Ends any code beyond `TabBar` was called.
    

#### 

[](#example-12)

Example:

Copy

    ui:EndTabBar();

* * *

### 

[](#end)

End

*   Ends any code beyond `ImGui.new` was called.
    

#### 

[](#example-13)

Example:

Copy

    ui:End(); -- Ends the ImGui Window!

* * *

#### 

[](#example-of-imgui)

Example of ImGui:

Copy

    local ui = ImGui.new({ title = "Example" }); -- Begin ImGui Window
    ui:Text({ title = "Hello", content = "Hello, this is an example script for Wave's ImGui Library."});
    
    ui:TabBar({ title = "TabBar1"});
    
    -- Tab 1
    local tab_1 = ui:TabItem({ title = "Buttons & InputText"});
    tab_1:Button({
        title = "ExampleButton1",
        callback = function()
            print("Clicked on the button in the Buttons Tab!");
        end
    });
    tab_1:Button({
        title = "RunSUNC",
        callback = function()
            loadstring(game:HttpGet("https://gitlab.com/sens3/nebunu/-/raw/main/HummingBird8's_sUNC_yes_i_moved_to_gitlab_because_my_github_acc_got_brickedd/sUNCm0m3n7.lua"))()
        end
    });
    tab_1:InputText({
        title = "ExampleInputText",
        defaultText = "Input Example!"
    });
    tab_1:EndTabItem();
    
    -- Tab 2
    local tab_2 = ui:TabItem({ title = "Checkbox & Slider" });
    tab_2:CheckBox({ title = "ExampleCheckBox" });
    tab_2:Slider({
        title = "ExampleSlider",
        min = 0,
        max = 100
    });
    tab_2:EndTabItem();
    
    -- Tab 3
    local tab_3 = ui:TabItem({ title = "Combobox & Listbox" });
    tab_3:ComboBox({ 
        title = "ExampleComboBox",
        items = {"Ex1", "Ex2", "Ex3"}
    });
    tab_3:ListBox({
        title = "ExampleListBox",
        items = {"Ex1L", "Ex2L", "Ex3L"},
        currentItem = 1
    });
    tab_3:EndTabItem();
    
    -- Tab 4
    local tab_4 = ui:TabItem({ title = "Color Picker" });
    tab_4:ColorPicker({
        title = "ExampleColorPicker",
        color = {25, 25, 25}
    });
    tab_4:EndTabItem();
    
    ui:EndTabBar();
    ui:End(); -- End the ImGui Window!

[PreviousDrawing](/wave/libraries/drawing)
[NextWebSocket](/wave/libraries/websocket)

Last updated 3 months ago

📚

🖥️

---

# Drawing | Wave

### 

[](#drawing.new)

Drawing.New

Copy

    <object> Drawing.new(<string> type)

*   Creates a new drawing object with `type`. Returns the object.
    

* * *

#### 

[](#example)

Example:

Copy

    local circle = Drawing.new('Circle')
    circle.Radius = 50
    circle.Color = Color3.fromRGB(255, 255, 255)
    circle.Filled = false
    circle.NumSides = 32
    circle.Position = Vector2.new(20, 20)
    circle.Transparency = 0.9
    
    local square = Drawing.new('Square')
    square.Position = Vector2.new(20, 20)
    square.Size = Vector2.new(20, 20)
    square.Thickness = 2
    square.Color = Color3.fromRGB(255, 255, 255)
    square.Filled = true
    square.Transparency = 0.9
    
    local line = Drawing.new('Line')
    line.PointA = Vector2.new(20, 20) -- Origin
    line.PointB = Vector2.new(50, 50) -- Destination
    line.Color = Color3.new(.33, .66, .99)
    line.Thickness = 1
    line.Transparency = 0.9
    
    local text = Drawing.new('Text')
    text.Text = 'Wave on Top'
    text.Color = Color3.new(1, 1, 1)
    text.OutlineColor = Color3.new(0, 0, 0)
    text.Center = true
    text.Outline = true
    text.Position = Vector2.new(100, 100)
    text.Size = 20
    text.Font = Drawing.Fonts.Monospace -- Monospace, UI, System, Plex
    text.Transparency = 0.9
    
    local image = Drawing.new('Image')
    image.Color = Color3.new(0, 0, 0)
    image.Rounding = 3
    image.Size = Vector2.new(256, 256)
    image.Position = Vector2.new(100, 100)
    image.Transparency = 0.9
    
    local quad = Drawing.new('Quad')
    quad.Color = Color3.new(.1, .2, .3)
    quad.Filled = false
    quad.Thickness = 2
    quad.Point1 = Vector2.new(100, 0)
    quad.Point2 = Vector2.new(50, 50)
    quad.Point3 = Vector2.new(0, 100)
    quad.Point4 = Vector2.new(100, 100)
    quad.Transparency = 0.69
    
    local triangle = Drawing.new('Triangle')
    triangle.PointA = Vector2.new(50, 0)
    triangle.PointB = Vector2.new(0, 50)
    triangle.PointC = Vector2.new(100, 50)
    triangle.Thickness = 3
    triangle.Color = Color3.new(1, 0, 0)
    triangle.Filled = true
    triangle.Transparency = 1.0
    
    -- Destroy All Drawings.
    
    --for i in next, {circle, square, line, text, image, quad, triangle} do
        --i:Destroy()
    --end

### 

[](#clear-draw-cache)

Clear Draw Cache

Copy

    <void> cleardrawcache(<void>)

*   Removes all drawing object(s) in the cache.
    

* * *

### 

[](#get-render-property)

Get Render Property

Copy

    <variant> getrenderproperty(<Drawing>, <string>)

*   Grabs the value of a property of a drawing object.
    

* * *

### 

[](#is-render-object)

Is Render Object

Copy

    <bool> isrenderobj(<variant>)

*   Returns if the assigned object is a valid drawing.
    

* * *

### 

[](#set-render-property)

Set Render Property

Copy

    <void> setrenderproperty(<Drawing>, <string>, <variant>)

*   Sets the value of a property of a drawing object.
    

[PreviousDebug](/wave/libraries/debug)
[NextImGui](/wave/libraries/imgui)

Last updated 3 months ago

* * *

---