MethodScript

https://methodscript.com/docs/3.3.5/
Admin
MethodScript is an imperative, dynamic, event-driven programming language used for scripting in...
Tokens:687,391
Snippets:3,509
Trust Score:7.2
Update:1 year ago
Show doc for...
Tokens:
Raw
### Install MethodScript Example Package (examples)

Source: https://methodscript.com/docs/3.3.5/CommandLineTools

The 'examples' command installs a built-in LocalPackage example, primarily to showcase features. It accepts one or more package names as arguments. If no package name is provided, it lists available examples. This command has no flags or options.

```MethodScript
examples <packageName>
```

```MethodScript
examples
```

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

### Installing MethodScript Examples

Source: https://methodscript.com/docs/3.3.5/CommandLineTools

Installs one of the built-in MethodScript LocalPackage examples, which can be useful for learning or showcasing features.

```Shell
java -jar commandhelper-3.3.5-SNAPSHOT-full.jar examples <example_name>
```

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

### Build Project via Command Line

Source: https://methodscript.com/docs/3.3.5/Contributing

This snippet shows how to build a Maven project from the command line. It includes commands for a standard build (`mvn install`) and a clean build (`mvn clean install`). It also demonstrates how to use build profiles, such as `provisional-build`, with the `-P` option.

```bash
mvn install
```

```bash
mvn clean install
```

```bash
mvn -Pprovisional-build clean install
```

```bash
mvn package
```

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

### MethodScript Function Return Example

Source: https://methodscript.com/docs/3.3.5/Download

This snippet demonstrates a basic function return statement in MethodScript. It shows how to return a value, potentially from arguments passed to the function.

```MethodScript
return func (args);
```

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

### MethodScript Get Procedures Simple Example

Source: https://methodscript.com/docs/3.3.5/API/functions/get_procedures

A simple example showing how get_procedures() returns the procedures available in the current scope. It first calls get_procedures() before defining a procedure, then calls it again after defining '_testProc', showing the change in output.

```MethodScript
msg(get_procedures());
proc _testProc() {}
msg(get_procedures());
```

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

### Check Maven Version

Source: https://methodscript.com/docs/3.3.5/Contributing

Verifies if Maven is installed and accessible from the command line. Maven is used as the build system for the CommandHelper project.

```Shell
mvn --version
```

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

### Example Function Return

Source: https://methodscript.com/docs/3.3.5/Architecture

A basic function signature example, likely from MethodScript itself, showing a function that accepts arguments and returns a value.

```Go
return func (args)
```

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

### Check Git Version

Source: https://methodscript.com/docs/3.3.5/Contributing

Verifies if Git is installed and accessible from the command line. This is a prerequisite for using Git for source control with CommandHelper.

```Shell
git --version
```

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

### Get MethodScript Startup Arguments (cmdline-args)

Source: https://methodscript.com/docs/3.3.5/CommandLineTools

The 'cmdline-args' command prints the necessary arguments for starting the Java program for MethodScript in a version-specific manner. These arguments can be integrated into startup flows or called dynamically. The command may return an empty string if no command-line flags are needed. It requires no arguments or flags.

```MethodScript
cmdline-args
```

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

### Configure Vim LSP for MethodScript

Source: https://methodscript.com/docs/3.3.5/Development_Environment

Configuration for the vim-lsp plugin to enable the MethodScript language server. This involves specifying the command to start the language server and potentially a whitelist parameter.

```Shell
['java', '-jar', 'absolute-path-to-jar-file', 'lang-serv', '--stdio']
```

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

### MethodScript Function Return Example

Source: https://methodscript.com/docs/3.3.5/About

A basic example of a MethodScript function that returns arguments.

```methodscript
return func (args);
```

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

### Install MethodScript Commandline

Source: https://methodscript.com/docs/3.3.5/CommandLineTools

Installs MethodScript to the system for command-line script execution (currently supports Unix only). Optionally, the command name can be set using the --command flag to support multiple installations.

```bash
install-cmdline [--command <command name>]
```

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

### Control Webserver - MethodScript

Source: https://methodscript.com/docs/3.3.5/CommandLineTools

Manages the MethodScript web server, providing functionalities to install, start, stop, and recompile. It can run in the foreground and supports forceful stops.

```MethodScript
webserver [--force] [--foreground] [--install] [--recompile] [--start] [--stop]
```

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

### MethodScript Function Return Example

Source: https://methodscript.com/docs/3.3.5/Contributing

A basic MethodScript function definition that accepts arguments and returns a value. This snippet illustrates the syntax for defining a function and its return statement.

```MethodScript
return func (args);
```

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

### Run MethodScript Engine Performance Test (cycle)

Source: https://methodscript.com/docs/3.3.5/CommandLineTools

The 'cycle' command fully starts the interpreter engine and runs exit(0) to measure engine overhead. It's designed for performance testing of the engine itself. Note that the first run includes installation overhead, which should not be compared to subsequent runs. This command takes no arguments or flags.

```MethodScript
cycle
```

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

### Starting MethodScript Language Server

Source: https://methodscript.com/docs/3.3.5/CommandLineTools

Starts the MethodScript language server, which implements the Language Server Protocol (LSP) for enhanced development features.

```Shell
java -jar commandhelper-3.3.5-SNAPSHOT-full.jar lang-serv
```

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

### Installing MSSQL JDBC Authentication (Windows)

Source: https://methodscript.com/docs/3.3.5/CommandLineTools

Downloads and installs the correct MSSQL JDBC Authentication DLL to the MethodScript folder. This command is Windows-specific and requires MethodScript to be installed.

```Shell
java -jar commandhelper-3.3.5-SNAPSHOT-full.jar install-mssql-auth
```

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

### Initial Site Deployment with MethodScript

Source: https://methodscript.com/docs/3.3.5/SiteDeployTool

Executes the initial site deployment for MethodScript using a specified configuration file. This command is run once to set up the project's deployment environment.

```Shell
java -jar MethodScript.jar site-deploy -c site-deploy-local.ini
```

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

### Get Single System Property - MethodScript

Source: https://methodscript.com/docs/3.3.5/API/functions/sys_properties

Retrieves a specific system property by its name. The example shows how to get the 'java.specification.vendor' property.

```MethodScript
sys_properties('java.specification.vendor')
```

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

### MethodScript nand Basic Example

Source: https://methodscript.com/docs/3.3.5/API/functions/nand

Provides a basic example of the nand function in MethodScript, showing its usage with two boolean arguments and the expected output.

```MethodScript
1 nand(true, true)
:false
```

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

### Installing MethodScript Command Line

Source: https://methodscript.com/docs/3.3.5/CommandLineTools

Installs MethodScript to the system, enabling command-line script execution. Currently supports Unix-based systems.

```Shell
java -jar commandhelper-3.3.5-SNAPSHOT-full.jar install-cmdline
```

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

### Get description documentation for array_contains

Source: https://methodscript.com/docs/3.3.5/API/functions/reflect_docs

This example retrieves the description documentation for the 'array_contains' function using reflect_docs.

```MethodScript
reflect_docs('array_contains', 'description');
```

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

### Run mscript on Windows

Source: https://methodscript.com/docs/3.3.5/index

Describes how to run the 'mscript' command on Windows systems after installation. This includes launching the interpreter, running script files, and accessing command-line utilities.

```powershell
mscript
```

```powershell
mscript -- help
```

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

### Get arguments documentation for array_contains

Source: https://methodscript.com/docs/3.3.5/API/functions/reflect_docs

This example retrieves the arguments documentation for the 'array_contains' function using reflect_docs.

```MethodScript
reflect_docs('array_contains', 'args');
```

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

### Advanced Kit Creation with run()

Source: https://methodscript.com/docs/3.3.5/Beginner%27s_Guide

This example shows a more robust way to create player kits using the `run()` function for better readability and handling of complex commands. It achieves the same result as the macro example but is recommended for its programmatic approach.

```MethodScript
/kit gold = >>>
run('/give '.player().' golden_shovel');
run('/give '.player().' golden_pickaxe');
run('/give '.player().' golden_axe');
<<<
```

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

### Install MethodScript Command Line

Source: https://methodscript.com/docs/3.3.5/Command_Line_Scripting

Installs MethodScript as a globally accessible interpreter on Unix-like systems. Requires the CommandHelper jar file.

```Shell
sudo java -jar CommandHelper.jar --install-cmdline
```

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

### Get PI Constant

Source: https://methodscript.com/docs/3.3.5/API/functions/math_const

This example shows how to use the math_const function to retrieve the value of the mathematical constant PI.

```MethodScript
1 math_const('PI');
```

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

### Simple Hello World Scripts

Source: https://methodscript.com/docs/3.3.5/Advanced_Guide

These are basic 'Hello World' examples. One script sends 'Hello Console!' to the console using the 'console()' function, and the other sends 'Hello Player!' to the player using the 'msg()' function.

```MethodScript
/hello world console = console('Hello Console!');
```

```MethodScript
/hello world player = msg('Hello Player!');
```

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

### Redis Persistence with SET, GET, DEL, KEYS

Source: https://methodscript.com/docs/3.3.5/Persistence_Network_Integration

Utilizes Redis as a key-value store for persistence. Standard Redis commands like SET, GET, and DEL are used for basic operations. The KEYS command with filtering is employed for multi-get operations.

```MethodScript
SET key value
GET key
DEL key
KEYS filter
GET key
```

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

### Run CommandHelper Commandline Utilities

Source: https://methodscript.com/docs/3.3.5/index

Demonstrates how to run command-line utilities provided by the CommandHelper JAR file. This is useful for accessing help or installing the command-line version.

```bash
java -jar commandhelper-3.3.5-SNAPSHOT-full.jar help
```

```bash
java -jar commandhelper-3.3.5-SNAPSHOT-full.jar install-cmdline
```

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

### Get Type of Value

Source: https://methodscript.com/docs/3.3.5/API

Returns the ClassType of a given value, serving as a general replacement for is_* functions. For example, typeof(array()) returns 'array'.

```MethodScript
typeof(mixed value)
```

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

### MethodScript reflect_type Example with typeof()

Source: https://methodscript.com/docs/3.3.5/API/functions/reflect_type

Illustrates how to use reflect_type with the typeof() operator to get information about a variable's type.

```MethodScript
int @i = 1;
msg(reflect_type(typeof(@i)));
```

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

### Install mscript Wrapper (Linux/MacOS)

Source: https://methodscript.com/docs/3.3.5/index

Details the installation of the 'mscript' bash file on Unix-like systems (Linux/MacOS) for easier execution of the MethodScript interpreter and utilities. Requires sudo privileges.

```bash
mscript
```

```bash
mscript -- help
```

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

### MethodScript substr Example 3: 'lightning'

Source: https://methodscript.com/docs/3.3.5/API/functions/substr

Extracts a substring from 'lightning' starting at index 5 until the end of the string, returning 'ning'.

```MethodScript
substr('lightning', 5)
```

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

### phas_recipe Usage

Source: https://methodscript.com/docs/3.3.5/API/functions/phas_recipe

This snippet demonstrates the basic usage of the phas_recipe function, showing how to call it with a player and a recipe key.

```MethodScript
phas_recipe([player], recipeKey)
```

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

### Start Local Development Server with http-server

Source: https://methodscript.com/docs/3.3.5/SiteDeployTool

Starts a local HTTP server for development, serving files from the current directory on port 8080. The '-o' flag automatically opens the default page (index.html) in the browser.

```Shell
npx http-server -p 8080 -c-1 -o "index.html"
```

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

### Display recompile Command Help

Source: https://methodscript.com/docs/3.3.5/Advanced_Guide

Displays usage instructions and a list of long options for the `/recompile` command.

```MethodScript
/recompile -h
```

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

### MethodScript: Add Furnace Recipe

Source: https://methodscript.com/docs/3.3.5/API/functions/add_recipe

Demonstrates adding a furnace recipe. This example shows how to define the key, type, result, input, experience, and cooking time for a smelting recipe.

```MethodScript
{
    key: 'cook_grass_to_dirt',
    type: 'FURNACE',
    result: {name: 'DIRT'},
    input: {'MYCELIUM', 'GRASS_BLOCK'},
    experience: 0.001,
    cookingtime: 200
}
```

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

### MethodScript substr Example 2: 'smiles'

Source: https://methodscript.com/docs/3.3.5/API/functions/substr

Extracts a substring from 'smiles' starting at index 1 and ending at index 5, returning 'mile'.

```MethodScript
substr('smiles', 1, 5)
```

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

### Launching MethodScript Persistence Network Viewer

Source: https://methodscript.com/docs/3.3.5/CommandLineTools

Launches a GUI tool for visualizing MethodScript databases.

```Shell
java -jar commandhelper-3.3.5-SNAPSHOT-full.jar pn-viewer
```

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

### MethodScript substr Example 1: 'hamburger'

Source: https://methodscript.com/docs/3.3.5/API/functions/substr

Extracts a substring from 'hamburger' starting at index 4 and ending at index 8, returning 'urge'.

```MethodScript
substr('hamburger', 4, 8)
```

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

### Launch Persistence Network Viewer

Source: https://methodscript.com/docs/3.3.5/CommandLineTools

Launches a GUI tool for visualizing Persistence Network databases. It can also set up a server for remote access with specified port and password.

```shell
pn-viewer [--server] [--password <password>] [--port <#port>]
```

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

### Deploy MethodScript Website

Source: https://methodscript.com/docs/3.3.5/About

Instructions on how to deploy the MethodScript website locally using the site-deploy tool. This command requires a Java Runtime Environment.

```bash
java -jar MethodScript.jar site-deploy
```

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

### Get MethodScript Preference Property - MethodScript

Source: https://methodscript.com/docs/3.3.5/API/functions/sys_properties

Retrieves a MethodScript preference property, which are prefixed with 'methodscript.preference.'. The example demonstrates fetching the 'debug-mode' preference.

```MethodScript
sys_properties('methodscript.preference.debug-mode')
```

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

### Example 1: Get all entities in a world

Source: https://methodscript.com/docs/3.3.5/API/functions/all_entities

Retrieves and displays all entities present in the player's current world using the all_entities function.

```MethodScript
msg(all_entities(pworld()))
```

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

### Build MethodScript with Maven

Source: https://methodscript.com/docs/3.3.5/Architecture

This command initiates the build process for MethodScript using Maven. It cleans previous build artifacts and installs the project, downloading necessary dependencies.

```bash
mvn clean install
```

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

### Getting MethodScript JVM Arguments

Source: https://methodscript.com/docs/3.3.5/CommandLineTools

Prints the necessary command-line arguments required for the Java program to properly start MethodScript. This can be integrated manually or dynamically.

```Shell
java -jar commandhelper-3.3.5-SNAPSHOT-full.jar cmdline-args
```

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

### Running MethodScript Commands

Source: https://methodscript.com/docs/3.3.5/CommandLineTools

Demonstrates the general syntax for executing MethodScript commands using either the full JAR file or the installed command-line version.

```Shell
java -jar commandhelper-3.3.5-SNAPSHOT-full.jar <mode name> <[mode specific arguments]>
```

```Shell
mscript -- <mode name> <[mode specific arguments]>
```

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

### Deploy Documentation Site

Source: https://methodscript.com/docs/3.3.5/CommandLineTools

Deploys the documentation site by completely rewriting the remote site for reproducible builds. It supports various flags for cache management, validation, preference generation, and progress bar control, as well as options for specifying configuration files and overriding RSA keys or post-scripts.

```bash
site-deploy [-d] [--clear-local-cache] [--generate-prefs] [--no-progress-clear] [--use-local-cache] [-c <config file>] [--override-id-rsa <id-rsa-path>] [--override-post-script <script-location>]
```

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

### MethodScript: Get Bytes from ByteArray

Source: https://methodscript.com/docs/3.3.5/API

Retrieves a specified number of bytes from a byte array, starting at a given position. Returns a new byte array primitive containing the extracted bytes.

```MethodScript
ba_get_bytes(byte_array, length, [pos])
```

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

### Get Function Documentation

Source: https://methodscript.com/docs/3.3.5/CommandLineTools

Retrieves and displays documentation for a specific function using a regex pattern. It can also show examples or open the documentation in a web browser.

```shell
api [-eo] [--platform <platform>] <functionRegex>
```

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

### MethodScript Basic Syntax Example

Source: https://methodscript.com/docs/3.3.5/privacy_policy

A simple example demonstrating the basic syntax of MethodScript, including variable declaration and a function call. This snippet is intended to illustrate fundamental language constructs.

```MethodScript
function greet(name) {
  return "Hello, " + name + "!";
}

let message = greet("World");
print(message);
```

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

### Example 3: Get entities in your chunk

Source: https://methodscript.com/docs/3.3.5/API/functions/all_entities

Retrieves and displays all entities located in the chunk the player is currently in, using the all_entities function with the player's location.

```MethodScript
msg(all_entities(ploc()))
```

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

### MethodScript main.ms Event Binding

Source: https://methodscript.com/docs/3.3.5/Advanced_Guide

Illustrates how to bind an event in main.ms, including calling a procedure and executing code upon event trigger. This file runs once at server startup.

```MethodScript
bind(some_event, null, null, @event,
_my_proc();
console('In some_event');
)
console('Finished binding all events in main.ms');
```

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

### Example 2: Get entities in a chunk

Source: https://methodscript.com/docs/3.3.5/API/functions/all_entities

Retrieves and displays entities within a specific chunk identified by its X and Z coordinates using the all_entities function.

```MethodScript
msg(all_entities(pworld(), 5, -3))
```

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

### Launch Browser with URL

Source: https://methodscript.com/docs/3.3.5/API/functions/x_launch_browser

Launches the desktop's default browser with the provided URL. This function is restricted and will throw an IOException on headless systems. It was introduced in version 3.3.2.

```MethodScript
x_launch_browser(url)
```

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

### MethodScript: 'for' loop for countdown

Source: https://methodscript.com/docs/3.3.5/Loops

This example demonstrates a 'for' loop in MethodScript used for counting down. It starts from a user-defined value and decrements the counter in each iteration until it reaches 0.

```MethodScript
for(@i = $userInput, @i >= 0, @i--){ msg(@i); }
```

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

### MethodScript Filter Configuration Example

Source: https://methodscript.com/docs/3.3.5/Persistence_Network

This snippet demonstrates the configuration of filters in MethodScript, showing how to map namespaces to connections using wildcards. It illustrates the precedence of filters based on specificity.

```MethodScript
storage.**.name=$connection1
storage.**=$connection2
```

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

### MethodScript: Add Stonecutting Recipe

Source: https://methodscript.com/docs/3.3.5/API/functions/add_recipe

Demonstrates adding a stonecutting recipe. This example shows how to define the key, type, result, and input for a stonecutting operation.

```MethodScript
{
    key: 'diamond_hoe_to_diamond',
    type: 'STONECUTTING',
    result: {name: 'DIAMOND'},
    input: 'DIAMOND_HOE'
}
```

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

### Get return type documentation for array_contains

Source: https://methodscript.com/docs/3.3.5/API/functions/reflect_docs

This example retrieves the return type documentation for the 'array_contains' function using reflect_docs. It shows that 'type' can be used interchangeably with 'return' for this purpose.

```MethodScript
reflect_docs('array_contains', 'return'); // Using 'type' would also work
```

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

### Generate Syntax Colors (Command Line)

Source: https://methodscript.com/docs/3.3.5/index

This command generates up-to-the-minute syntax colors for Notepad++ using the Obsidian theme by running CommandHelper from the command line. It requires Java and the CommandHelper.jar file.

```bash
java -jar CommandHelper.jar syntax npp obsidian
```

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

### MethodScript Get Procedures Nested Example

Source: https://methodscript.com/docs/3.3.5/API/functions/get_procedures

Illustrates the behavior of get_procedures() with nested procedures. It shows how the function captures procedures defined within other procedures, demonstrating scope awareness.

```MethodScript
msg(get_procedures());
proc _testProc() {
proc _innerProc() {}
msg(get_procedures());
}
_testProc();
msg(get_procedures());
```

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

### Create Player Kits with Macros

Source: https://methodscript.com/docs/3.3.5/Beginner%27s_Guide

This macro allows players to receive a set of golden tools by typing a single command. It demonstrates basic macro functionality by aliasing multiple `/give` commands.

```MethodScript
/kit gold = /give player() golden_shovel \ /give player() golden_pickaxe \ /give player() golden_axe
```

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

### Get Bytes from Byte Array in MethodScript

Source: https://methodscript.com/docs/3.3.5/Changelog

Retrieves a specified number of bytes from a byte array, starting at a given offset. Used for reading chunks of binary data.

```MethodScript
ba_get_bytes
```

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

### Launch Browser

Source: https://methodscript.com/docs/3.3.5/API

Launches the system's default web browser with a specified URL. This function will throw an IOException on headless systems.

```MethodScript
x_launch_browser(url)
```

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

### JSON Hierarchical Data Example

Source: https://methodscript.com/docs/3.3.5/Persistence_Network_Integration

Illustrates how JSON data is structured hierarchically, including the use of a special '_' key to represent root values within nested structures.

```json
{
    "a": {
        "b": "value stored at a.b"
    }
}
```

```json
{
    "a": {
        "b": {
            "c": "value stored at a.b.c"
        }
    }
}
```

```json
{
    "a": {
        "b": {
            "_": "value stored at a.b",
            "c": "value stored at a.b.c"
        }
    }
}
```

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

### Add JVM Options for Java 17+

Source: https://methodscript.com/docs/3.3.5/index

Explains the mandatory JVM arguments required for Java versions 17 and above to ensure proper execution of CommandHelper and MethodScript, specifically for signal handling.

```bash
java -jar commandhelper-3.3.5-SNAPSHOT-full.jar cmdline-args
```

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

### MethodScript: Get String from ByteArray

Source: https://methodscript.com/docs/3.3.5/API

Reads a UTF-8 encoded string from a byte array, starting at a specified position. The string's length is encoded as a 32-bit integer before the string bytes. The encoding can be specified, defaulting to UTF-8.

```MethodScript
ba_get_string(byte_array, [pos], [encoding])
```

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

### Start MethodScript Language Server (lang-serv)

Source: https://methodscript.com/docs/3.3.5/CommandLineTools

The 'lang-serv' command starts the language server, which implements the Language Server Protocol. It supports '--stdio' for standard I/O or socket connections with '--host' and '--port' options. Unrecognized arguments are accepted for future compatibility but are not supported. It takes unrecognized arguments as a final parameter.

```MethodScript
lang-serv --stdio
```

```MethodScript
lang-serv --host <host> --port <#port>
```

```MethodScript
lang-serv <unrecognizedArgs, ...>
```

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

### MethodScript Function Return Example

Source: https://methodscript.com/docs/3.3.5/File_Options

This snippet demonstrates a basic function return statement in MethodScript. It shows how to return the result of a function call with arguments.

```MethodScript
return func (args);
```

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

### MethodScript: Fixing Syntax Errors (Missing Parenthesis)

Source: https://methodscript.com/docs/3.3.5/Debugging

This example shows a common syntax error in MethodScript where a parenthesis is missing in an if statement. It illustrates how compilers can help identify these errors, which are distinct from runtime errors and do not require value tracing.

```MethodScript
if(@a == 2{
msg('a is 2')
}
```

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

### MethodScript: Attach Null and Retrieve Metadata by Plugin

Source: https://methodscript.com/docs/3.3.5/API/functions/get_metadata

This example demonstrates attaching a null value to a player's metadata and then retrieving it specifically from the 'MethodScript' plugin. It gets the player's entity ID, sets 'key' to null for that player, and then retrieves the value registered by 'MethodScript'.

```MethodScript
assign(@peid, pinfo()[13])
set_metadata(@peid, 'key', null)
msg(get_metadata(@peid, 'key', 'MethodScript'))
```

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

### Clone CommandHelper Repository

Source: https://methodscript.com/docs/3.3.5/Architecture

This command is used to download the MethodScript source code from GitHub using Git. It's the first step for developers wanting to work with or build the project.

```bash
git clone https://github.com/sk89q/commandhelper.git
```

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

### Get Modern Material Name

Source: https://methodscript.com/docs/3.3.5/API

Returns the modern material name for a given legacy item ID, name, notation, or item array. Handles various input formats and returns null for invalid arguments. For example, '1' or '1:0' returns 'STONE', and an item array with {name: STONE, data: 1} returns 'GRANITE'.

```MethodScript
data_name(item)
```

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

### Building MethodScript Extensions

Source: https://methodscript.com/docs/3.3.5/CommandLineTools

Builds a MethodScript extension from a Git repository. Requires Git, Maven, and JDK to be pre-installed and configured.

```Shell
java -jar commandhelper-3.3.5-SNAPSHOT-full.jar build-extension <path_to_git_source_repo>
```

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

### Clone CommandHelper Repository

Source: https://methodscript.com/docs/3.3.5/index

This snippet shows how to clone the CommandHelper source code repository using Git. It requires Git to be installed on your system.

```bash
git clone git@github.com:EngineHub/CommandHelper.git
```

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

### Build Packet Jumper Extension

Source: https://methodscript.com/docs/3.3.5/Packet_Jumper

Instructions for building the Packet Jumper extension using git, maven, and the JDK. This process involves cloning the repository and executing a build command.

```Shell
mscript -- build-extension -s https://github.com/LadyCailin/PacketJumper.git
```
Tokens:
Raw