Array

Arrays

Arrays are basically just a series of items stored into a single variable. Knowing how to use arrays opens up a lot of Bukkit world things, such as using using FOR Loops to iterate through the array.

Creating an empty array

To create an array, you must first define the variable name, then assign it a size using the array(int size) common method.

myArray = array(10)

Above code will create an array of size 10. This means that you can put 10 different items into this array.

Storing data into array

myArray[9] = "Hey";

To store data into an array, add square brackets behind the variable name you defined earlier, then assign it like a regular variable. The number inside the [] brackets is called the 'index,' and it always starts from 0. Since we set the size to 10, the index range is 0 to 9. Index 10 doesn't exist. If we tried using index 10, we would get an index out of bounds error.

Reading data from array

Reading data from an array is simple. Just add the index of the item you want to access in square brackets.

#MESSAGE myArray[9]

Not so difficult right?

Advanced: Sets, Lists and Maps

Using common methods, you can also use sets, lists and maps, which add more functions to your basic array. Basic java knowledge is required to use these kind of arrays. See Methods.

Sets

Sets are created using set(). They do not have a set size, which is useful if the amount of items in your array changes. Sets do not allow duplicate elements. They also are unordered, meaning you have no control over index.

bannedWords = set()
bannedWords.add("Hoe")
bannedWords.add("Donkey")

Adds words to a banned word list.

Lists

Lists are creating using list(). Like sets, lists do not have a set size. However you have control over the index of the items.

leaderboard = list()
leaderboard.add("MidnightSugar")
leaderboard.add("Wysohn")
#MESSAGE leaderboard.indexOf(0)

Adds some players to a leaderboard, then displays person in first place.

Maps

Maps are created using map(). Like sets they do not have a set size, and do not allow duplicate elements, however they contain two objects, a key and a value.

warps = map()
warps.put("Spawn", Location("world", 500, 60, 923))
warps.put("Market", Location("world", 231, 65, 213))
player.teleport(warps.get("Spawn"))

Adds warps to a map, then teleports the player.