🎯 LandmarkSystem

An elegant and powerful Minecraft landmark teleportation system plugin, supporting Paper/Folia servers.

✨ Features

🌟 Elegant magical theme interface
🎨 Beautiful particle effects and sounds
🔮 Automatic unlock system
⚡ Quick teleportation
📱 Intuitive GUI menu
💾 Secure data storage
⚙️ Highly configurable
🚀 Folia multi-threading support
🛡️ Complete permission system
🌐 Multi-world support
🎯 Custom interaction entities
🔄 Memory optimization

📦 Requirements

Java 21 or higher
Paper/Folia 1.20.1 or higher

📖 Usage

For detailed instructions, please check the Usage Guide.

🎮 Basic Commands

/landmark menu - Open landmark menu
/landmark create <name> [description] - Create new landmark
- Supports multi-line descriptions, each argument will be a separate line
- Example: /landmark create spawn Welcome to Spawn center This is the teleport hall
/landmark delete <name> - Delete landmark
/landmark edit <name> <description> - Edit landmark description
- Supports multi-line descriptions, each argument will be a separate line
- Example: /landmark edit spawn Welcome to Spawn center This is the teleport hall
/landmark rename <old_name> <new_name> - Rename landmark
/landmark teleport <name> - Teleport to specified landmark
/landmark reload - Reload configuration

🔒 Permission System

Admin Permissions

landmark.create - Create landmarks
landmark.delete - Delete landmarks
landmark.edit - Edit landmarks
landmark.rename - Rename landmarks
landmark.reload - Reload configuration
landmark.admin - Admin permission group

Player Permissions

landmark.teleport - Teleport permission (default: true)
landmark.menu - Menu permission (default: true)
landmark.interact - Interaction permission (default: true)

⚙️ Configuration Example

Basic Settings

settings:
  cooldown-time: 90       # Teleport cooldown (seconds)
  unlock-radius: 3        # Unlock radius (blocks)
  unlock-sound: BLOCK_ENCHANTMENT_TABLE_USE  # Unlock sound

GUI Settings

gui:
  title: '<gradient:gold:yellow>✧ Magic Landmark System ✦</gradient>'
  size: 45  # Menu size
  items:
    unlocked:
      material: AMETHYST_SHARD
      name: '<#c7a3ed><bold>%landmark_name%</bold>'
    locked:
      material: BARRIER
      name: '<gray><bold>%landmark_name%</bold>'

Particle Effects

particles:
  center:
    enabled: true
    type: END_ROD
    height: 0.1
    star_radius: 1.5
    circle_radius: 2.0

📦 Installation

Download the latest version from Releases
Place the plugin in your server's plugins folder
Restart the server or use /reload confirm
The plugin will automatically generate configuration files

🔧 Technical Features

Developed using Folia API for multi-threading support
Adventure API for rich text display
MiniMessage format support
Asynchronous data processing and storage
Smart memory management
Automatic cleanup system

🐛 Bug Reports

If you encounter any issues, please report them through:

GitHub Issues

📄 License

This project is licensed under the MIT license.

🙏 Acknowledgments

Paper - High-performance Minecraft server
Folia - Multi-threaded optimized server
MiniMessage - Text formatting library

LandMark