📦 Minecraft Bedrock Plot Manager – Description

This script is a fully-featured Plot Management System for Minecraft Bedrock Edition using the @minecraft/server and @minecraft/server-ui APIs.
It provides players with a protected area (plot) they can purchase, manage, and customize — while offering admins powerful tools to oversee and configure the entire plot system.

🌍 Core Features

🏡 Player Plot System

Players can purchase their own plots using a scoreboard currency (Plot Tokens).
Automatic teleportation to owned or shared plots.
Member system that allows sharing the plot with friends (online or offline names).
Ownership transfer system.
A visitor system to safely explore other players' plots.

🛡 Region Protection

Each plot has a defined protection radius.
Only owners and members can:
- Break blocks
- Place blocks
- Open or interact with containers (chests, doors, etc.)
Admins bypass all restrictions.

🎛 Admin Tools

Admins (players with the plot_admin tag) get access to:

Add new plots at any location.
Remove plots from the world.
View all plot data including coordinates and ownership.
Teleport to any plot instantly.

💾 Persistent Storage

All plots are saved using Dynamic Properties, ensuring:

Data is stored permanently.
All owned plots, members, and coordinates remain after server reloads.
Save/load with automatic error handling.

🧭 User Interface

Built using ActionFormData and ModalFormData, the system includes:

A Player Menu (buy, teleport, members)
An Admin Menu (add, remove, list)
Visitor menus
Member management forms
Ownership transfer menus
All menus feature clear, styled text and intuitive navigation.

⚙️ Configuration Options

Inside the script you can easily configure:

📌 Menu activator items (stick & blaze rod)
📌 Scoreboard objective name
📌 Dynamic property key
📌 Plot size (protection radius)
📌 Admin access tag

🧩 Technical Overview

The script uses:

A Map() to maintain runtime plot data
JSON serialization for persistent storage
Scoreboard helpers for token transactions
Custom block permission handling
Player UI forms for all interactions

✔️ Perfect For:

Survival SMP servers
Creative plot servers
Cities, housing systems, or claim-based worlds
Admin-managed build zones
Any world needing secure, customizable build regions

📘 How to Use – Plot Manager System

This guide explains how players and admins can use the Plot Manager system in your Minecraft Bedrock world.

🧑‍🤝‍🧑 For Players

🪵 1. Open the Plot Menu

Use the following item to open your menu:

Player Menu Item: minecraft:stick

Right-click / tap with the stick to open the Plot Menu.

🏡 2. Buying a Plot

Open the Player Menu
Select “Buy a Plot”
Choose from the list of available plots
You must have at least 1 Plot Token
- Tokens are stored in the scoreboard objective: Ptoken

After purchase, you'll be teleported to your new plot automatically.

🚪 3. Managing Your Plot

🔹 Teleport to Your Plot

From the Plot Menu, select “Teleport to My Plot”.

🔹 Add Members

Open Manage Members
Choose Add Member
Select an online player or enter the exact name of an offline player

🔹 Remove Members

Select Remove Member inside the Manage Members menu.

🔹 View Members

Shows a list of everyone who has access to your plot.

🔹 Transfer Ownership

Give your plot to a member:

Choose an existing member
Or enter an offline player's name
The old owner becomes a member automatically.

🌍 4. Visiting Other Plots

You can open Visit Other Plots from the menu to teleport to plots owned by other players.

Visitors cannot build or interact with protected blocks.

🛡 Plot Protection

Inside a plot:

Only the owner and plot members can break/place blocks.
Visitors cannot open doors, chests, or interact with blocks.
Admins bypass all restrictions.

Each plot has a protected area determined by PLOT_SIZE.

🛠 For Admins

Admins need the tag:

/tag @s add plot_admin

🔥 1. Open the Admin Menu

Use the Admin Item:

minecraft:blaze_rod

Right-click / tap to open the menu.

🏗 2. Add a New Plot

Stand at the location where the plot center should be
Open the Admin Menu
Select Add New Plot
Enter:
- Plot name
- X, Y, Z coordinates
  (These are pre-filled with the admin’s position for convenience.)

❌ 3. Remove a Plot

Open Admin Menu
Select Remove Plot
Pick a plot from the list
This permanently deletes the plot.

📋 4. List All Plots

Shows a full list of plots with:

Plot name
Owner
Coordinates

✨ 5. Teleport to Any Plot

Admins can teleport to any plot via the admin teleport option.

⚙️ Scoreboard Setup

The system uses a scoreboard objective for purchasing plots:

/scoreboard objectives add Ptoken dummy

To give a player plot tokens:

/scoreboard players add <player> Ptoken 1

Deepcore Plot System