🎯 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

1. Download the latest version from Releases
2. Place the plugin in your server's plugins folder
3. Restart the server or use /reload confirm
4. 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:

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