PublicTP

PublicTP – Public & Private Warp Management Plugin PublicTP is a fully GUI‑driven Minecraft Spigot/Bukkit plugin that allows players to create, manage, and use warp points with both public and private visibility. It is designed to replace traditional chat‑based warp systems with a modern, intuitive interface – all interactions are performed through menus, chest GUIs, and anvils, without requiring any chat commands (except for the initial menu).

✨ Key Features Full GUI Interaction – No chat commands are needed for creating, renaming, deleting, or teleporting. Everything is done via clickable menus.

Public & Private Warps – Each warp can be set as public (visible and usable by all players) or private (only the owner can see and use it).

Warp Creation – Players can create a warp at their current location. The process is fully guided:

Enter the warp name using an anvil GUI (no experience cost). Choose an icon from a list of 26 materials (with smart recommendations based on the name). Select Public or Private. Warp Management – Owners can:

Rename their warps via an anvil GUI.

Toggle visibility (public ↔ private) with a single click.

Delete their warps (with a confirmation prompt).

Teleportation – Players can teleport to any public warp or their own private warps directly from the GUI.

Rich Information Display – Each warp shows:

Exact coordinates (X, Y, Z)

Owner name

Creation date & time

Current status (Public/Private)

Custom icon

Smart Icon Suggestions – When creating a warp, the plugin automatically recommends an icon based on the name (e.g., home → Oak Door, nether → Obsidian, machine → Dispenser, etc.).

Pagination – Lists are paginated (15 items per page) for smooth navigation even with many warps.

Permission‑based – All features are protected by permissions, and the default settings allow ordinary players to use the menu, create, delete, and manage their own warps. Administrators (OP) have full control over all warps.

No Experience Cost – Renaming and naming through anvil GUIs do not consume any levels or experience.

🎮 How It Works (User Flow) Open the main menu Type /tpmenu (or use the assigned command). The main panel shows three options:

Public Warps – List of all public warps (click to teleport).

Private Warps – List of your own private warps (click to teleport).

Edit My Warps – Manage all warps you have created.

Manage your warps In the “Edit My Warps” list, each warp appears with its icon, name, and details. Clicking a warp opens a management GUI where you can:

Teleport to the warp.

Toggle public/private status.

Rename – opens an anvil GUI; type the new name in the middle slot and click the result.

Delete – opens a confirmation screen.

Create a new warp From the “Edit My Warps” screen, click “Create Warp” (green emerald). An anvil GUI appears – type your desired name in the middle slot and confirm. Then you are shown an icon selection screen (with a recommended icon highlighted). Pick one, then choose Public or Private. The warp is instantly saved and appears in your list.

Delete a warp Click “Delete Warp” (redstone block) in the “Edit My Warps” screen. A list of your warps is shown – click the one you want to delete, then confirm or cancel.

📜 Commands Command Usage Permission Description /tpmenu /tpmenu publictp.menu Opens the main teleport panel (GUI). /setwarp /setwarp <name> [public/private] publictp.set Creates a warp via command (icon defaults to player head). /warp /warp <name> publictp.use Teleports to a public warp or your own private warp. /delwarp /delwarp <name> publictp.delete Deletes a warp (only if you own it, unless OP). /warps /warps publictp.list Lists all public warps in chat. 🔑 Permission Nodes Permission Default Description publictp.menu true Allows use of /tpmenu and the GUI. publictp.use true Allows teleporting via /warp. publictp.list true Allows viewing the list of public warps. publictp.set true Allows creating warps (via GUI or command). publictp.delete true Allows deleting your own warps. publictp.admin op Grants full access to manage all warps (overrides ownership checks). 🛠️ Technical Details Minecraft Version: 1.21.4 (Spigot/Paper API)

Java Version: 21

Data Storage: YAML file (plugins/PublicTP/warps.yml) – portable and human‑readable.

No External Dependencies: Pure Bukkit/Spigot API – no third‑party libraries required.

Performance: Lightweight and efficient; uses asynchronous chat event handling only for internal logic (no chat input required).