LandRealms

LandRealms is a comprehensive Minecraft plugin that allows players to create and manage their own personal flat worlds. Players can create custom realms, invite friends, teleport between worlds, and maintain separate inventories for each realm. The plugin features an intuitive GUI for easy world management and a robust permission system.

Features

• Create and manage personal flat worlds
• Intuitive GUI for world management
• Separate inventories for each world
• Player invitation system
• Peaceful mode toggle for worlds
• Multi-language support (English and Russian)
• Admin controls for world management
• World persistence across server restarts

Commands

All commands can be accessed using either /lr or /flatworld as the base command.

Basic Commands

• /lr - Opens the main GUI menu
• /lr help - Shows help information
• /lr gui - Opens the main GUI menu (alternative)

World Creation and Management

• /lr create <name> - Creates a new flat world with the specified name
• /lr delete <world> - Deletes one of your worlds
• /lr tp <world> or /lr teleport <world> - Teleports to a specified world
• /lr back - Returns to your previous world
• /lr list - Shows a list of your accessible worlds (opens GUI)

Invitation System

• /lr invite <world> <player> - Invites a player to your world
• /lr accept - Accepts a pending world invitation
• /lr deny - Denies a pending world invitation

World Settings

• /lr setlimit <world> <limit> - Sets the player limit for a world
• /lr peaceful <world> <on/off> - Toggles peaceful mode in a world

Item Transfer

• /lr items - Opens the admin item transfer menu
• /lr getitems - Opens the player item transfer menu

Admin Commands

• /lr assign <world> <player> - Assigns ownership of a world to a player
• /lr vanilla - Shows a list of vanilla (non-custom) worlds
• /lr vanilla add <world> - Adds a world to the vanilla worlds list
• /lr vanilla remove <world> - Removes a world from the vanilla worlds list
• /lr vanilla current - Adds the current world to the vanilla worlds list
• /lr reload - Reloads the plugin configuration

Permissions

• flatworlds.donor - Allows creating flat worlds
• flatworlds.delete - Allows deleting own flat worlds
• flatworlds.teleport - Allows teleporting to accessible worlds
• flatworlds.invite - Allows inviting players to own worlds
• flatworlds.list - Allows viewing list of accessible worlds
• flatworlds.admin - Grants access to all admin commands
• flatworlds.unlimited - Allows creating unlimited number of worlds
• flatworlds.peaceful - Allows toggling peaceful mode in own worlds

GUI Navigation

1. Main Menu - Access your worlds, create new worlds, and manage items
2. Worlds List - View and manage your worlds
3. World Management - Teleport to a world, manage players, change settings, or delete the world
4. World Settings - Change player limit, spawn point, time, weather, and peaceful mode
5. World Players - Manage players in your world and send invitations

Translation Support

The plugin supports multiple languages through the locale system. Currently, English (en) and Russian (ru) are included. Translations are stored in YAML files in the plugins/LandRealms/locale/ directory.

Note about translations: Some translations may not be fully implemented or may display incorrectly. If you encounter any translation issues, please report them. You can also create your own translation by copying an existing language file and translating the messages.

To change the plugin language, edit the language setting in the config.yml file.

Usage Examples

Creating a New World

1. Type /lr to open the main GUI
2. Click on the Emerald block labeled "Create World"
3. Enter the name of your new world in chat
4. Wait for the world to be created
5. You will be automatically teleported to your new world

Inviting a Friend

1. Type /lr to open the main GUI
2. Click on your world in the worlds list
3. Click on the Player Head labeled "Manage Players"
4. Click on the Book labeled "Invite Player"
5. Enter the name of the player you want to invite in chat
6. The player will receive an invitation they can accept with /lr accept

Returning to a Previous World

If you've teleported between worlds and want to go back:

1. Type /lr back to return to your previous world
2. Your inventory and location will be preserved

Troubleshooting

• If the /lr back command doesn't work, ensure you have the flatworlds.teleport permission
• If translations appear incorrect, check your config.yml language setting
• If a world fails to load, check the server console for error messages
• For inventory issues, try using /lr getitems to retrieve items from other worlds

Configuration

The plugin creates several configuration files:

• config.yml - Main configuration settings
• worlds.yml - World data and settings
• previous-worlds.yml - Stores previous world data for the /lr back command
• locale/en.yml and locale/ru.yml - Language files