TrustButton – A Dynamic Path and Area Toggle System for Paper and Purpur (Minecraft 1.20+)

TrustButton introduces a clean and powerful system that allows server administrators to create special buttons which toggle a custom path or area on and off. When a player interacts with a Trust Button, the plugin hides or restores selected blocks and broadcasts a global message. This creates dynamic gameplay moments that fit perfectly into adventure maps, quests, puzzles, parkour shortcuts, and event-based mechanics.

---

Overview

A Trust Button is a custom button created by an admin. Each button can be linked to a set of blocks that will vanish or reappear when the button is clicked. The system is fully configurable, persistent across restarts, and designed to work smoothly on both Paper and Purpur servers running Java 17 or higher.

The plugin also includes an admin GUI that provides full control over all registered Trust Buttons.

---

Key Features

• Create custom Trust Buttons using /trustbutton create
• Define toggleable areas using /trustbutton areacreate
• Blocks disappear when activated and return when deactivated
• Global messages for activation and deactivation
• Fully configurable messages with HEX color support
• Persistent storage in data.yml
• Safe event handling to prevent item stealing or accidental breaking
• Tab completion for all commands
• Works on Paper and Purpur for Minecraft 1.20 and above

---

Admin GUI

The command /trustbutton admin opens a management GUI that displays all Trust Buttons placed in the world.

Each button entry in the GUI includes:

• Left-click: Opens a detailed button menu with options such as delete and view coordinates
• Right-click: Instantly teleports the admin to the button's location
• Visual list of all registered buttons for quick navigation

This makes it easy to manage large numbers of buttons across multiple worlds.

---

Commands

/trustbutton create
Gives the admin a special Trust Button item.

/trustbutton areacreate
Gives area-defining blocks linked to the selected button.

/trustbutton admin
Opens the admin GUI showing all Trust Buttons, with teleport and management options.

/trustbutton reload
Reloads the plugin configuration.

Permission required: trustbutton.admin

---

Configuration

The plugin includes a clean and simple config.yml that allows you to customize:

• Activation and deactivation messages
• HEX color formatting
• General behavior settings

All button data, block locations, and toggle states are stored in data.yml and persist after server restarts.

---

Use Cases

TrustButton is ideal for servers that want interactive world mechanics, including:

• Adventure maps with hidden or timed paths
• Parkour shortcuts that open and close
• Dungeon puzzles and quest triggers
• Secret entrances and hidden rooms
• Event-based toggles for server activities
• Roleplay mechanics that require world interaction

---

Compatibility

• Minecraft 1.20+
• Java 17+
• PaperMC and Purpur

TrustButton is designed to be lightweight, stable, and easy to integrate into any server environment that needs interactive world elements.