📦 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

1. Open the Player Menu

2. Select “Buy a Plot”

3. Choose from the list of available plots

4. 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

1. Open Manage Members

2. Choose Add Member

3. 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:

🔥 1. Open the Admin Menu

Use the Admin Item:

• minecraft:blaze_rod

Right-click / tap to open the menu.

---

🏗 2. Add a New Plot

1. Stand at the location where the plot center should be

2. Open the Admin Menu

3. Select Add New Plot

4. Enter:

   • Plot name

   • X, Y, Z coordinates
     (These are pre-filled with the admin’s position for convenience.)

---

❌ 3. Remove a Plot

1. Open Admin Menu

2. Select Remove Plot

3. 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:

To give a player plot tokens: