kpect666 发表于 7 天前

Landmark Exploration 地标探索

本帖最后由 kpect666 于 2025-7-2 14:03 编辑

# 🗺️ 地标探索插件 - 让探索变得更有趣!

> 一个专为冒险家打造的地标探索系统,让玩家在探索世界的过程中解锁各种神秘地标,获得丰厚奖励!

## 📖 插件简介

还在为服务器缺乏探索动力而烦恼吗?地标探索插件为你的服务器带来全新的探索体验!

玩家在游戏世界中走动时,会自动发现和解锁隐藏的地标。每个地标都有独特的主题、炫酷的解锁特效,以及丰厚的奖励。通过精美的GUI界面,玩家可以查看已解锁的地标,追踪探索进度。

**适用版本:** Minecraft 1.20+ (推荐1.21+)
**服务端支持:** Spigot / Paper / Purpur
**前置插件:** 无
**版本说明:** 完全兼容1.20.1+,建议使用1.21+获得最佳体验

## ✨ 核心功能

### 🎯 自动地标发现
- 玩家走进地标范围自动解锁
- 华丽的标题动画和音效提示
- 首次解锁有特殊奖励
- 重复进入显示欢迎消息

### 🎨 丰富的自定义选项
- 自定义地标名称、描述
- 可设置解锁标题和副标题
- 支持多条轮播进入消息
- 自定义音效和GUI显示物品
- 灵活的奖励命令系统

### 📊 完善的数据统计
- 记录每个玩家的解锁进度
- 统计访问次数和解锁时间
- 精美的GUI界面展示
- 支持查看所有地标坐标

### 🛠️ 强大的管理功能
- 游戏内创建和编辑地标
- 实时修改地标属性
- 灵活的权限控制
- 热重载配置支持

## 🚀 快速开始

### 安装步骤

1. 下载插件jar文件
2. 将文件放入服务器的 `plugins` 文件夹
3. 重启服务器
4. 完成!插件会自动生成配置文件

### 创建第一个地标

```bash
# 1. 传送到想要设置地标的位置
/tp 100 64 200

# 2. 创建地标(ID、名称、半径)
/landmark create demo_castle 神秘城堡 50

# 3. 设置描述
/landmark edit demo_castle description 一座充满神秘色彩的古老城堡

# 4. 设置解锁效果
/landmark edit demo_castle title &6&l地标解锁!
/landmark edit demo_castle subtitle &e神秘城堡
/landmark edit demo_castle message &7欢迎来到神秘城堡...|&6这里藏着古老的秘密

# 5. 设置GUI显示物品
/landmark edit demo_castle material BRICK

# 6. 添加奖励命令
/landmark edit demo_castle addcmd give {player} diamond 5
/landmark edit demo_castle addcmd msg:&a恭喜你发现了神秘城堡!
```

现在走到坐标附近就能体验地标解锁的乐趣了!

## 📚 详细教程

### 地标管理命令

#### 基础管理
```bash
/landmark create <ID> <名称> <半径>    # 创建地标
/landmark delete <ID>                # 删除地标
/landmark list                     # 查看所有地标
/landmark info <ID>                  # 查看地标详细信息
/landmark reload                     # 重载配置
/landmark stats                      # 查看服务器统计
```

#### 属性编辑
```bash
/landmark edit <ID> name <新名称>         # 修改名称
/landmark edit <ID> description <描述>      # 设置描述
/landmark edit <ID> title <解锁标题>      # 设置解锁标题
/landmark edit <ID> subtitle <解锁副标题>   # 设置解锁副标题
/landmark edit <ID> message <进入消息>      # 设置进入消息
/landmark edit <ID> sound <音效名>          # 设置解锁音效
/landmark edit <ID> material <物品ID>       # 设置GUI显示物品
/landmark edit <ID> radius <半径>         # 修改范围
```

#### 命令管理
```bash
/landmark edit <ID> addcmd <命令>      # 添加解锁命令
/landmark edit <ID> removecmd <序号>   # 移除指定命令
/landmark edit <ID> listcmd         # 查看所有命令
/landmark edit <ID> clearcmd          # 清空所有命令
```

### 玩家命令

```bash
/landmarkgui    # 打开地标GUI界面
/lmgui         # 同上(别名)
/lg            # 同上(短别名)
```

### 进阶功能

#### 多条进入消息
使用 `|` 分隔多条消息,玩家进入时会依次显示:
```bash
/landmark edit castle message 欢迎来到城堡|这里充满了神秘色彩|小心,有怪物出没...
```

#### 占位符支持
在解锁命令中可以使用以下占位符:
- `{player}` - 玩家名称
- `{player_uuid}` - 玩家UUID
- `{landmark_id}` - 地标ID
- `{landmark_name}` - 地标名称
- `{world}` - 地标所在世界
- `{x}`, `{y}`, `{z}` - 地标坐标

示例:
```bash
/landmark edit castle addcmd give {player} diamond 1
/landmark edit castle addcmd msg:&a{player},恭喜你发现了{landmark_name}!
/landmark edit castle addcmd tp {player} {x} {y} {z}
```

#### 特殊命令格式
- `msg:消息内容` - 向玩家发送消息
- `message:消息内容` - 向玩家发送消息
- 其他命令作为控制台命令执行

## 🔧 配置说明

### 权限节点

| 权限 | 描述 | 默认 |
|------|------|------|
| `landmark.admin` | 管理地标权限 | OP |
| `landmark.use` | 使用地标功能 | 所有玩家 |
| `landmark.*` | 所有权限 | OP |

### 配置文件

插件会在 `plugins/LandmarkExploration/` 目录下生成以下文件:

- `landmarks.yml` - 地标数据存储
- `playerdata.yml` - 玩家数据存储

一般情况下不需要手动编辑这些文件,通过游戏内命令管理即可。

## 🎮 使用技巧

### 管理员技巧

1. **合理规划地标位置**
   - 在重要建筑物、景点设置地标
   - 控制地标密度,避免过于密集
   - 考虑新手路径,设置引导性地标

2. **设计有趣的奖励**
   - 给予探索相关的物品(地图、指南针等)
   - 设置经验奖励鼓励探索
   - 考虑给予临时效果增益

3. **创造沉浸式体验**
   - 地标名称要有吸引力
   - 描述要简洁但富有想象力
   - 进入消息要符合地标主题

### 玩家体验优化

1. **GUI界面功能**
   - 只显示已解锁的地标
   - 点击地标查看详细信息
   - 统计按钮显示完整探索进度

2. **探索建议**
   - 定期使用 `/lg` 查看解锁进度
   - 注意解锁时的提示音效
   - 重复访问地标可能有额外内容

## 📋 常见问题

**Q: 地标范围如何确定?**
A: 以创建时玩家所在位置为中心,向四周扩展指定半径的圆形区域。

**Q: 可以修改已创建地标的位置吗?**
A: 目前需要删除后重新创建。建议在创建前确认好位置。

**Q: 支持多世界吗?**
A: 完全支持!每个世界的地标都是独立的。

**Q: 玩家数据会丢失吗?**
A: 插件会自动保存玩家数据,重启服务器不会影响进度。

**Q: 如何备份地标数据?**
A: 定期备份 `plugins/LandmarkExploration/` 目录下的yml文件即可。

**Q: 能否导入/导出地标?**
A: 目前通过复制配置文件实现,未来版本可能加入专门的导入导出功能。

**Q: 1.20版本和1.21版本有什么区别?**
A: 插件在两个版本上功能完全一致。使用1.20.1 API编译确保向下兼容,同时在1.21+版本上也能完美运行。

## 🔄 更新日志

### v1.0 (当前版本)
- ✅ 基础地标创建和管理功能
- ✅ 自动地标发现系统
- ✅ 精美的GUI界面
- ✅ 完整的权限系统
- ✅ 多条消息轮播支持
- ✅ 游戏内命令管理
- ✅ 占位符系统
- ✅ 数据统计功能

### 计划功能
- 🔄 地标传送功能
- 🔄 地标分类系统
- 🔄 成就系统集成
- 🔄 地标导入导出
- 🔄 更多GUI交互选项

## 💬 反馈与支持

如果你在使用过程中遇到问题或有新的功能建议,欢迎反馈!

**常见问题自查:**
1. 确认服务器版本是否支持
2. 检查权限配置是否正确
3. 查看控制台是否有错误信息
4. 尝试重载插件配置

**获取帮助:**
- 查看插件统计:`/landmark stats`
- 重载配置:`/landmark reload`
- 查看地标列表:`/landmark list`

## 📦 下载与安装

1. 确保服务器运行 Minecraft 1.20.1+ (推荐1.21+)
2. 下载最新版本的插件jar文件
3. 放入服务器 `plugins` 文件夹
4. 重启服务器
5. 开始你的地标探索之旅!

---


**让每一次探索都变得有意义,让每一个角落都藏着惊喜!** 🗺️✨

> 制作不易,如果觉得插件好用请给个赞支持一下~
页: [1]
查看完整版本: Landmark Exploration 地标探索