# 🧭 指南石传送
使用 Waystone Warps 插件改变你的旅程吧！ 制作并放置指南石，在你的世界中设置传送点。 在探索时发现其他人放置的指南石并轻松在它们之间传送。 知道你随时可以瞬间传送回家，或即时拜访你的朋友，从而简化你在世界上的旅程。
以下是你所能期待的一些很棒的功能：
- **物理定位** - 传送点与世界中一个物理的指南石结构绑定，从而带来更具沉浸感的体验。
- **直观的 GUI 菜单** - 你可以使用点击菜单来管理你的整个指南石。 从此不再需要输入命令。
- **轻松管理访问权限** - 将你的指南石限制为你自己使用，开放给你的朋友，或将其公开供公众寻找。
- **传送费用** - 让你的玩家为此付出努力！ 更改传送费用，可以是经验值、物品，甚至是提供的经济插件。
## 项目状态
测试版。 可以在测试服务器上安全运行，但不建议在生产环境中使用，因为会频繁进行更改。
## 安装
从发布选项卡下载最新版本（.jar 文件），并将其放在服务器的插件文件夹中。
要获得额外的功能，例如每玩家/等级权限和传送限制，你必须安装
[Vault](https://www.spigotmc.org/resources/vault.34315/) 以及一个兼容的权限和聊天
元数据提供程序。 [LuckPerms](https://luckperms.net/) 是处理这两项的推荐插件。
## 快速开始
要建立一个指南石传送点，在一个光滑的石块上放置一个磁石，然后右键单击该磁石。 这将打开一个创建菜单，你可以在其中
命名你的传送点。 建立指南石传送点后，你将看到各种与传送管理相关的选项。
要传送到指南石，右键单击指南针以打开传送菜单。
## 权限
- worldwidewarps.command.warpmenu - 允许使用 `warpmenu` 命令来打开允许玩家传送到传送点的菜单。
## 每玩家限制
请确保你安装了 Vault 提供程序才能设置限制，如安装部分所述。 每个 Vault
提供程序插件都有自己实现此功能的方式。 由于 LuckPerms 是推荐的提供程序，因此说明
将使用它。
要为玩家设置元数据，请使用命令：
`/lp group meta set `
对于组：
`/lp user meta set `
以下是你设置的不同限制：
- waystonewarps.warp_limit - 定义玩家可以创建多少个指南石传送点。
- waystonewarps.teleport_cost - 定义传送的费用。
- waystonewarps.teleport_timer - 定义传送需要多长时间。
## 从源代码构建
### 要求
- Java JDK 21 或更高版本
- Git
### 编译
```
git clone https://gitlab.com/Mizarc/waystonewarps.git
cd waystone-warps/
./gradlew shadowJar
```
构建的 .jar 二进制文件可以在 `build/libs` 文件夹中找到。
## 支持
如果你遇到任何错误、崩溃或意外行为，请 [打开一个问题](https://github.com/mizarc/waystone-warps/issues)在这个仓库中。
## 许可证
Waystone Warps 使用宽松的 MIT 许可证。 请查看 [LICENSE](LICENSE) 以获取更多信息。