Home Commands Examples Getting Started With Scripts Global Keywords

MapData

Importing the class

It might be required for you to import the package if you encounter any issues (like casting an Array), so better be safe than sorry and add the import at the very top of the file.

script.zs
import crafttweaker.api.data.MapData;

Implemented Interfaces

MapData implements the following interfaces. That means all methods defined in these interfaces are also available in MapData

Constructors

script.zs
new MapData() as MapData
new MapData();
script.zs
new MapData(map as IData[string]) as MapData
ParameterType
Parameter
map
Type
IData[string]

Casters

Result TypeIs Implicit
Result Type
boolean
Is Implicit
false
Result Type
byte
Is Implicit
false
Result Type
byte[]
Is Implicit
false
Result Type
double
Is Implicit
false
Result Type
float
Is Implicit
false
Result Type
int
Is Implicit
false
Result Type
int[]
Is Implicit
false
Result Type
long
Is Implicit
false
Result Type
long[]
Is Implicit
false
Result Type
short
Is Implicit
false
Result Type
stdlib.List<IData>
Is Implicit
false
Result Type
string
Is Implicit
false

Methods

Adds the given IData to this IData.

Returns: A new IData after adding the other data.
Return Type: IData

script.zs
// MapData.add(other as IData) as IData
(Hello: "World", Somewhere: "Over the rainbow").add(2);
ParameterTypeDescription
Parameter
other
Type
IData
Description
the other data to add.

Casts this IData to a boolean.

Returns: this data as a bool
Return Type: boolean

script.zs
// MapData.asBool() as boolean
(Hello: "World", Somewhere: "Over the rainbow").asBool();

Casts this IData to a byte.

Returns: this data as a byte
Return Type: byte

script.zs
// MapData.asByte() as byte
(Hello: "World", Somewhere: "Over the rainbow").asByte();

Casts this IData to a byte array.

Returns: this data as a byte array
Return Type: byte[]

script.zs
// MapData.asByteArray() as byte[]
(Hello: "World", Somewhere: "Over the rainbow").asByteArray();

Casts this IData to a double.

Returns: this data as a double
Return Type: double

script.zs
// MapData.asDouble() as double
(Hello: "World", Somewhere: "Over the rainbow").asDouble();

Casts this IData to a float.

Returns: this data as a float
Return Type: float

script.zs
// MapData.asFloat() as float
(Hello: "World", Somewhere: "Over the rainbow").asFloat();

Casts this IData to an int.

Returns: this data as an int
Return Type: int

script.zs
// MapData.asInt() as int
(Hello: "World", Somewhere: "Over the rainbow").asInt();

Casts this IData to an int array.

Returns: this data as an int array
Return Type: int[]

script.zs
// MapData.asIntArray() as int[]
(Hello: "World", Somewhere: "Over the rainbow").asIntArray();

Casts this IData to a list.

Returns: this data as a list
Return Type: stdlib.List<IData>

script.zs
// MapData.asList() as stdlib.List<IData>
(Hello: "World", Somewhere: "Over the rainbow").asList();

Casts this IData to a long.

Returns: this data as a long
Return Type: long

script.zs
// MapData.asLong() as long
(Hello: "World", Somewhere: "Over the rainbow").asLong();

Casts this IData to a long array.

Returns: this data as a long array
Return Type: long[]

script.zs
// MapData.asLongArray() as long[]
(Hello: "World", Somewhere: "Over the rainbow").asLongArray();

Casts this IData to a short.

Returns: this data as a short
Return Type: short

script.zs
// MapData.asShort() as short
(Hello: "World", Somewhere: "Over the rainbow").asShort();

Gets an escaped string version of this IData, quotes are included in the output

E.G println(("hello" as IData).asString()) prints "hello"

Returns: The escaped string version of this IData.
Return Type: string

script.zs
// MapData.asString() as string
(Hello: "World", Somewhere: "Over the rainbow").asString();

Compares this IData to the other IData

Returns: The comparison result.
Return Type: int

script.zs
// MapData.compareTo(other as IData) as int
(Hello: "World", Somewhere: "Over the rainbow").compareTo(5);
ParameterTypeDescription
Parameter
other
Type
IData
Description
the data to be compared.

Gets the literal string version of this IData.

E.G println(("hello" as IData).getAsString()) prints hello

Returns: The literal string version of this IData.
Return Type: string

script.zs
// MapData.getAsString() as string
(Hello: "World", Somewhere: "Over the rainbow").getAsString();

Gets the internal ID of this data.

Returns: the intenral ID of this data.
Return Type: byte

script.zs
// MapData.getId() as byte
(Hello: "World", Somewhere: "Over the rainbow").getId();

Checks if this data is empty.

Returns: True if empty.
Return Type: boolean

script.zs
// MapData.isEmpty() as boolean
(Hello: "World", Somewhere: "Over the rainbow").isEmpty();

Maps this IData to another IData based on the given operation.

Returns: A new IData from the operation
Return Type: IData

script.zs
// MapData.map(operation as Function<IData,IData>) as IData
(Hello: "World", Somewhere: "Over the rainbow").map((data) => 3);
ParameterTypeDescription
Parameter
operation
Type
Function<IData,IData>
Description
The operation to apply to this IData

Adds all entries from the given map into this one. Can override existing keys.

script.zs
// MapData.putAll(map as IData[string])
(Hello: "World", Somewhere: "Over the rainbow").putAll({Hello: "Goodbye", Item: "Bedrock"});
ParameterTypeDescription
Parameter
map
Type
IData[string]
Description
The other entries to be added to this map

Sets the given value inside this IData at the given index.

script.zs
MapData.setAt(name as string, data as IData?)
ParameterTypeDescription
Parameter
name
Type
string
Description
The key to store the data at
Parameter
data
Type
IData?
Description
The data to store.

Operators

Adds the given IData to this IData.

script.zs
myMapData + other as IData
(Hello: "World", Somewhere: "Over the rainbow") + 2

Applies a bitwise AND (&) operation to this IData and the other IData

script.zs
myMapData & other as IData
(Hello: "World", Somewhere: "Over the rainbow") & 2

Concatenates the given IData to this IData.

script.zs
myMapData ~ other as IData
(Hello: "World", Somewhere: "Over the rainbow") ~ 2

Compares this IData to the other IData

script.zs
myMapData < other as IData
(Hello: "World", Somewhere: "Over the rainbow") < 5

Divides the given IData from this IData.

script.zs
myMapData / other as IData
(Hello: "World", Somewhere: "Over the rainbow") / 2

Applies a modulo operation to this IData against the other IData.

script.zs
myMapData % other as IData
(Hello: "World", Somewhere: "Over the rainbow") % 2

Multiplies the given IData to this IData.

script.zs
myMapData * other as IData
(Hello: "World", Somewhere: "Over the rainbow") * 2

Negates this IData.

script.zs
-myMapData
-(Hello: "World", Somewhere: "Over the rainbow")

Applies a NOT (!) operation to this IData.

script.zs
!myMapData
!true

Applies a bitwise OR (|) operation to this IData and the other IData

script.zs
myMapData | other as IData
(Hello: "World", Somewhere: "Over the rainbow") | 2

Applies a SHL (<<) operation to this data by the other data

script.zs
myMapData << other as IData
(Hello: "World", Somewhere: "Over the rainbow") << 2

Applies a SHR (>>) operation to this data by the other data

script.zs
myMapData >> other as IData
(Hello: "World", Somewhere: "Over the rainbow") >> 2

Subtracts the given IData from this IData.

script.zs
myMapData - other as IData
(Hello: "World", Somewhere: "Over the rainbow") - 2

Applies a bitwise XOR (^) operation to this IData and the other IData

script.zs
myMapData ^ other as IData
(Hello: "World", Somewhere: "Over the rainbow") ^ 2

Properties

NameTypeHas GetterHas SetterDescription
Name
isEmpty
Type
boolean
Has Getter
true
Has Setter
false
Description
Checks if this data is empty.