Home Migration Guide Getting Started With Scripts Commands Examples
BracketHandlers

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

No Description Provided

script.zs
new MapData() as MapData
new MapData();

No Description Provided

script.zs
new MapData(map as IData[string]) as MapData
ParameterTypeDescription
Parameter
map
Type
IData[string]
Description
No Description Provided

Casters

Result typeIs Implicit
Result type
boolean
Is Implicit
false
Result type
ICollectionData
Is Implicit
false
Result type
IData[string]
Is Implicit
true
Result type
INumberData
Is Implicit
false

Methods

Return Type: boolean

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

Return Type: ICollectionData

script.zs
// MapData.asCollection() as ICollectionData
{Hello : "World", Somewhere: "Over the rainbow"}.asCollection();

Return Type: MCTextComponent

script.zs
MapData.asFormattedText(indentation as string, indentDepth as int) as MCTextComponent
ParameterTypeDescription
Parameter
indentation
Type
string
Description
No Description Provided
Parameter
indentDepth
Type
int
Description
No Description Provided

Gets a List representation of this IData, returns null on anything but ListData.

Returns: null if this IData is not a list.
Return Type: stdlib.List<IData>

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

Return Type: INumberData

script.zs
// MapData.asNumber() as INumberData
{Hello : "World", Somewhere: "Over the rainbow"}.asNumber();

Checks if the Map contains the given key.

Returns: True if the Map contains the key
Return Type: boolean

script.zs
// MapData.contains(key as string) as boolean
{Hello : "World", Somewhere: "Over the rainbow"}.contains("Hello");
ParameterTypeDescription
Parameter
key
Type
string
Description
The key to search for

Retrieves the value associated with the key

Returns: The value if present, null otherwise
Return Type: IData?

script.zs
// MapData.getAt(key as string) as IData?
{Hello : "World", Somewhere: "Over the rainbow"}.getAt("Hello");
ParameterTypeDescription
Parameter
key
Type
string
Description
The key to search for

Return Type: T

script.zs
MapData.getData<T : IData>(key as string) as T
ParameterTypeDescription
Parameter
key
Type
string
Description
No Description Provided
Parameter
T
Type
IData
Description
No Description Provided

Gets the ID of the internal NBT tag.

Used to determine what NBT type is stored (in a list for example)

Returns: ID of the NBT tag that this data represents.
Return Type: byte

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

Gets the String representation of the internal INBT tag

Returns: String that represents the internal INBT of this IData.
Return Type: string

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

Merges this map and the other map. If entries from this map and the other map share the values are tried to be merged. If that does not work, then the value from the other map is used.

Returns: This map, after the merge
Return Type: MapData

script.zs
// MapData.merge(other as MapData) as MapData
{Hello : "World", Somewhere: "Over the rainbow"}.merge({Doodle: "Do"});
ParameterTypeDescription
Parameter
other
Type
MapData
Description
The other map.

Adds sets the value for the given key or creates a new entry if it did not exist before.

Returns: The previous value if present, null otherwise
Return Type: IData?

script.zs
// MapData.put(key as string, value as IData) as IData?
{Hello : "World", Somewhere: "Over the rainbow"}.put("Hello", "Goodbye");
ParameterTypeDescription
Parameter
key
Type
string
Description
The key to set the value for.
Parameter
value
Type
IData
Description
The value to set.

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

Return Type: void

script.zs
// MapData.putAll(map as IData[string]) as void
{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

Removes the entry with the given key from the Map

Return Type: void

script.zs
// MapData.remove(key as string) as void
{Hello : "World", Somewhere: "Over the rainbow"}.remove("Somewhere");
ParameterTypeDescription
Parameter
key
Type
string
Description
The key of the entry to remove

Operators

Adds all entries from the given IData to this entry

script.zs
myMapData + data as IData

Checks if the Map contains the given key.

script.zs
key as string in myMapData
"Hello" in {Hello : "World", Somewhere: "Over the rainbow"}

Retrieves the value associated with the key

script.zs
myMapData.key as string
{Hello : "World", Somewhere: "Over the rainbow"}."Hello"

Adds sets the value for the given key or creates a new entry if it did not exist before.

script.zs
myMapData.key as string = value as IData
{Hello : "World", Somewhere: "Over the rainbow"}."Hello" = "Goodbye"

Properties

NameTypeHas GetterHas SetterDescription
Name
isEmpty
Type
boolean
Has Getter
true
Has Setter
false
Description
No Description Provided
Name
keySet
Type
Set<string>
Has Getter
true
Has Setter
false
Description
No Description Provided
Name
size
Type
int
Has Getter
true
Has Setter
false
Description
No Description Provided