🗺️ Monument Waypoints

Player-owned teleport waypoints with taxes, permissions and a clean GUI.

Let your players build, manage and even earn money from their own teleport points! Monument Waypoints brings a complete waypoint system to your server – including a tax system, trust/access management, search, promotion, and full Bedrock support.

---

✨ Features

• 📍 Player-Owned Waypoints – Players receive a Waypoint Item (Recovery Compass) they can place to create their own teleport point.
• 🔓 Public or Private – Waypoints can be made public or kept private.
• 🤝 Trust System – Grant individual players access to your private waypoints.
• 💰 Custom Tax per Waypoint – Owners can set a usage fee (tax) that's automatically paid to them whenever someone teleports there.
• 🏦 Server Fees – Configurable server fee, either as a fixed price or distance-based (with a max cap).
• 📈 Promotion System – Waypoints can be "promoted" for a fee to appear in a dedicated promoted list.
• 🏛️ Server Waypoints – Admins can create their own permanent server waypoints.
• 🔍 Search – Players can search public waypoints by name.
• ⏱️ Teleport Warmup – Configurable warmup time, cancels if the player moves.
• 🖥️ Clean GUI – Dedicated menus for your own waypoints, public waypoints, server waypoints, and promoted waypoints.
• 📱 Bedrock Support – Full Floodgate/Geyser support, including dedicated forms for Bedrock players.
• 🌐 Multi-Language – German and English included out of the box, easy to extend.
• 🔧 Fully Configurable – All messages, prices, GUI titles, and limits can be adjusted in config.yml.

---

⚙️ Requirements

Plugin	Required
Vault	✅ Yes (for economy features)
Floodgate	⬜ Optional (for Bedrock support)
Geyser-Spigot	⬜ Optional (for Bedrock support)

🟢 Supports API version 1.20

---

🛠️ Commands

Command	Description
/mw	Opens the Monument Waypoints main menu

(Alias: /monumentwaypoints)

---

🔑 Permissions

Permission	Default	Description
monumentwaypoints.use	true	Allows using the waypoint features
monumentwaypoints.admin	op	Admin access (e.g. server waypoints, reload)

---

📋 Example Configuration

waypoint:
  default-public: true
  default-tax: 13.0
  max-tax: 1000.0
  max-public-waypoints-per-player: 10
  marker-material: "LODESTONE"

server-fee:
  mode: "FIXED"
  fixed-price: 5.0
  distance-price-per-block: 0.05
  distance-max-price: 250.0

---

💡 How It Works

1. A player gets the Waypoint Creator item via /mw (or your shop).
2. They place it on a block – a Lodestone marker appears above it and the waypoint is created.
3. The owner can make the waypoint public, set a tax, or grant trusted access to specific players.
4. Other players find the waypoint through the GUI or search and teleport there – paying the server fee and, if applicable, the owner's tax.

---

📜 License & Support

For questions, bugs, or feature requests, feel free to open an issue on Modrinth! 🐛

Enjoy Monument Waypoints! 🚀