# 🎯 地标系统
一个优雅且强大的 Minecraft 地标传送系统插件，支持 Paper/Folia 服务器。
[](https://www.minecraft.net/)
[](https://papermc.io/)
[](https://opensource.org/licenses/MIT)
## ✨ 特性
- 🌟 优雅的魔法主题界面
- 🎨 美丽的粒子效果和音效
- 🔮 自动解锁系统
- ⚡ 快速传送
- 📱 直观的 GUI 菜单
- 💾 安全的数据存储
- ⚙️ 高度可配置
- 🚀 Folia 多线程支持
- 🛡️ 完整的权限系统
- 🌐 多世界支持
- 🎯 自定义交互实体
- 🔄 内存优化
## 📦 需求
- Java 21 或更高版本
- Paper/Folia 1.20.1 或更高版本
## 📖 使用方法
有关详细说明，请查看 [使用指南](USAGE.md)。
## 🎮 基本命令
- `/landmark menu` - 打开地标菜单
- `/landmark create [description]` - 创建新的地标
- 支持多行描述，每个参数将是一行
- 示例: `/landmark create spawn 欢迎来到中心 这是传送大厅`
- `/landmark delete ` - 删除地标
- `/landmark edit ` - 编辑地标描述
- 支持多行描述，每个参数将是一行
- 示例: `/landmark edit spawn 欢迎来到中心 这是传送大厅`
- `/landmark rename ` - 重命名地标
- `/landmark teleport ` - 传送到指定的地标
- `/landmark reload` - 重新加载配置
## 🔒 权限系统
### 管理员权限
- `landmark.create` - 创建地标
- `landmark.delete` - 删除地标
- `landmark.edit` - 编辑地标
- `landmark.rename` - 重命名地标
- `landmark.reload` - 重新加载配置
- `landmark.admin` - 管理员权限组
### 玩家权限
- `landmark.teleport` - 传送权限 (默认: true)
- `landmark.menu` - 菜单权限 (默认: true)
- `landmark.interact` - 交互权限 (默认: true)
## ⚙️ 配置示例
### 基本设置
```yaml
settings:
cooldown-time: 90 # 传送冷却时间 (秒)
unlock-radius: 3 # 解锁半径 (方块)
unlock-sound: BLOCK_ENCHANTMENT_TABLE_USE # 解锁音效
```
### GUI 设置
```yaml
gui:
title: '✧ Magic Landmark System ✦'
size: 45 # 菜单大小
items:
unlocked:
material: AMETHYST_SHARD
name: '<#c7a3ed>%landmark_name% '
locked:
material: BARRIER
name: '%landmark_name% '
```
### 粒子效果
```yaml
particles:
center:
enabled: true
type: END_ROD
height: 0.1
star_radius: 1.5
circle_radius: 2.0
```
## 📦 安装
1. 从 [发布版](https://github.com/MineSunshineOne/Landmark/releases) 下载最新版本
2. 将插件放置在服务器的 `plugins` 文件夹中
3. 重启服务器或使用 `/reload confirm`
4. 插件将自动生成配置文件
## 🔧 技术特性
- 使用 Folia API 实现多线程支持
- Adventure API 用于丰富文本显示
- MiniMessage 格式支持
- 异步数据处理和存储
- 智能内存管理
- 自动清理系统
## 🐛 错误报告
如果您遇到任何问题，请通过以下方式报告：
1. [GitHub Issues](https://github.com/MineSunshineOne/Landmark/issues)
## 📄 许可证
本项目使用 [MIT](LICENSE) 许可证。
## 🙏 致谢
- [Paper](https://papermc.io/) - 高性能 Minecraft 服务器
- [Folia](https://github.com/PaperMC/Folia) - 多线程优化服务器
- [MiniMessage](https://docs.adventure.kyori.net/minimessage.html) - 文本格式化库