MapData - CraftTweaker Documentation

Version:

Language:

Home Commands Examples Getting Started With Scripts Global Keywords

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.

ZenScript
 Copy
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

IData

Constructors

ZenScript
 Copy
new MapData() as MapData
new MapData();

ZenScript
 Copy
new MapData(map as IData[string]) as MapData

Parameter	Type
Parameter map	Type IData[string]

Casters

Result Type	Is 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

asBoolean

Name: asBoolean

Return Type: boolean

ZenScript
 Copy
// MapData.asBoolean() as boolean

{Hello : "World", Somewhere: "Over the rainbow"}.asBoolean();

asCollection

Name: asCollection

Return Type: ICollectionData

ZenScript
 Copy
// MapData.asCollection() as ICollectionData

{Hello : "World", Somewhere: "Over the rainbow"}.asCollection();

asList

Name: asList

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>

ZenScript
 Copy
// MapData.asList() as stdlib.List<IData>

{Hello : "World", Somewhere: "Over the rainbow"}.asList();

asNumber

Name: asNumber

Return Type: INumberData

ZenScript
 Copy
// MapData.asNumber() as INumberData

{Hello : "World", Somewhere: "Over the rainbow"}.asNumber();

asString

Name: asString

Gets the String representation of this IData

Returns: String that represents this IData (value and type).
Return Type: string

ZenScript
 Copy
// MapData.asString() as string

{Hello : "World", Somewhere: "Over the rainbow"}.asString();

contains

Name: contains

Checks if the Map contains the given key.

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

ZenScript
 Copy
// MapData.contains(key as string) as boolean

{Hello : "World", Somewhere: "Over the rainbow"}.contains("Hello");

Parameter	Type	Description
Parameter key	Type string	Description The key to search for

getAt

Name: getAt

Retrieves the value associated with the key

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

ZenScript
 Copy
// MapData.getAt(key as string) as IData?

{Hello : "World", Somewhere: "Over the rainbow"}.getAt("Hello");

Parameter	Type	Description
Parameter key	Type string	Description The key to search for

getData

Name: getData

Retrieves the value associated with the key and returns it as the given type.

Returns: The value if present, null otherwise.
Return Type: @org.openzen.zencode.java.ZenCodeType.Nullable T

ZenScript
 Copy
MapData.getData<T : IData>(key as string) as @org.openzen.zencode.java.ZenCodeType.Nullable T

Parameter	Type	Description
Parameter key	Type string	Description The key to search for.
Parameter T	Type IData	Description

getId

Name: getId

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

ZenScript
 Copy
// MapData.getId() as byte

{Hello : "World", Somewhere: "Over the rainbow"}.getId();

getString

Name: getString

Gets the String representation of the internal INBT tag

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

ZenScript
 Copy
// MapData.getString() as string

{Hello : "World", Somewhere: "Over the rainbow"}.getString();

merge

Name: merge

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

ZenScript
 Copy
// MapData.merge(other as MapData) as MapData

{Hello : "World", Somewhere: "Over the rainbow"}.merge({Doodle: "Do"});

Parameter	Type	Description
Parameter other	Type MapData	Description The other map.

put

Name: put

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?

ZenScript
 Copy
// MapData.put(key as string, value as IData) as IData?

{Hello : "World", Somewhere: "Over the rainbow"}.put("Hello", "Goodbye");

Parameter	Type	Description
Parameter key	Type string	Description The key to set the value for.
Parameter value	Type IData	Description The value to set.

putAll

Name: putAll

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

ZenScript
 Copy
// MapData.putAll(map as IData[string])

{Hello : "World", Somewhere: "Over the rainbow"}.putAll({Hello: "Goodbye", Item: "Bedrock"});

Parameter	Type	Description
Parameter map	Type IData[string]	Description The other entries to be added to this map

remove

Name: remove

Removes the entry with the given key from the Map

ZenScript
 Copy
// MapData.remove(key as string)

{Hello : "World", Somewhere: "Over the rainbow"}.remove("Somewhere");

Parameter	Type	Description
Parameter key	Type string	Description The key of the entry to remove

Operators

ADD

Name: ADD

Adds all entries from the given IData to this entry

ZenScript
 Copy
myMapData + data as IData

CONTAINS

Name: CONTAINS

Checks if the Map contains the given key.

ZenScript
 Copy
key as string in myMapData
"Hello" in {Hello : "World", Somewhere: "Over the rainbow"}

MEMBERGETTER

Name: MEMBERGETTER

Retrieves the value associated with the key

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

MEMBERSETTER

Name: MEMBERSETTER

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

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

Properties

Name	Type	Has Getter	Has Setter
Name isEmpty	Type boolean	Has Getter true	Has Setter false
Name keySet	Type Set<string>	Has Getter true	Has Setter false
Name size	Type int	Has Getter true	Has Setter false