Configuration & Data Storage
The mod uses world and player capabilities to store data and information. As the data is stored inside .dat files, an NBT Editor is necessary to view and edit them. Make sure to only change these files when the player is offline for player data and when the server is offline for world data. Also, I'd like to point out that the data in these files are not synchronized on load and it is assumed to be synced since the mod keeps them synchronized when it is operating and saves the data to these files.
Every island's data is kept in the world data/configuration file, located at '/world/data/capabilities.dat'.
The coordinates the mod will use when the player is transferred to the spawn and the location where the next island will be generated are both editable in this data file. The explanation for the island data within this file may be found here.
Be careful when modifying this file since if something goes wrong at the startup, the mod may not necessarily be disabled. All data may be overwritten and lost upon shutdown. Make sure to create a backup before modifying any data within this file!
Be advised to NOT edit this file! The mod uses these parameters to calculate island positions, if modified these calculations may be wrong and allow errors/unexpected behaviour to occur.
Every player has their own player data file that can be found in '/world/playerdata/players-uuid.dat'.
Within this file, the ID of the island that the player is part of can be changed. The value will be empty if the player is not part of any island. Make sure to create a backup before modifying any data within this file!
Each island is stored within the world file with a unique ID.
Within the island's data, the player UUID of the island's owner is placed. If this value is not present, it means that the island is abandoned and cannot be joined by anyone. Furthermore, for each island, a list of all player UUIDs is stored which are also part of the island.
Lastly, the file contains the location coordinates of the island's centre point, which users are teleported to when teleporting to the island.
To manually add an island to your configuration you are required to modify the capabilities.dat file within your world folder. When opened the file should contain the structure displayed below:
Now you are required to generate a new UUID, this can be obtained from https://www.uuidtools.com/minecraft. In the example we use '1e80f9d5-9b8c-4319-a6c3-7be35df31df0', this will be required to add as an entry into 'islandIds'. This is then followed by adding the islands data, this is done within the 'islands' package. As seen in the image below.
To create a proper NBT structure we recommend cloning another island's package, seen as named by the island's UUID. It is important to then alter the owner value, we recommend changing this value to the UUID of your alt account. Or whom you wish to give ownership of the island. This can be retrieved using: https://mcuuid.net/.
Finally, you should adjust the value of x & z within the island 'center' package. Keep in mind the y value should not be altared!!! From this point the islands 800x800 value is calculated, so make sure you get the correct coordinates!!
P.S. If the island is not within generated terrain you should adjust the Last Island value within the capabilities.dat. This is to be done as these coordinates are used to generate the next island!!