```text
__ ___ ______ __ __
/ |/ /__ __/_ __/__ / /__ ___ ___ ____/ /_
/ /|_/ / _ \/ -_) / / -_) / -_) _ \/ _ \/ __/ __/
/_/ /_/\___/\__/_/ \__/_/\__/ .__/\___/_/ \__/
/_/
README 语言 [ [中文](README.md) | [**English**](README-EN.md) ]
# MoeTeleport
[](https://www.codefactor.io/repository/github/CarmJos/MoeTeleport)
[](https://github.com/CarmJos/MoeTeleport/releases)
MoeTeleport 是一个开源传送插件，包含多个功能，并且会持续更新以根据用户需求添加新功能。
项目代码符合开发规范，适合新开发者学习 Bukkit 并制作自己的插件。
## 功能与优点
### 当前功能
- 多个存储格式，按需选择。
- 支持 YAML、JSON 和 MySQL/MariaDB 存储
- 支持直接调用 [EssentialsX](https://github.com/EssentialsX/Essentials)/CMI 数据，无缝切换
- 可点击的消息 (例如“点击-同意”)
- 基于 MineDown 语法，可定制化配置
- 玩家之间的传送请求
- 支持处理玩家的请求
- 设置传送点
- 支持根据权限设置不同数量的传送点作为 VIP 增值内容
- 设置家园位置 (视为私有传送点)
- 支持根据权限设置不同数量的家园作为 VIP 增值内容
- 返回死亡地点和上次位置
### 优点
- **轻量级插件。** 适合小型服务器，配置简单方便。
- **规范化开发。** 插件架构符合开发规范，适合新开发者学习。
- 从 [3.0.0]() 版本开始使用 EasyPlugin，可能与其他主流插件结构略有不同。
- **持续维护。** 所有新的功能需求都可以提交，很可能在后续开发中得到支持。
- 功能需求请 [提交 Issues](https://github.com/CarmJos/MoeTeleport/issues/new?assignees=&labels=enhancement&template=feature_issues.md)，不要在帖子中提交！
- 提交与“传送”相关的请求，很可能在后续开发中得到更新和支持。
## [依赖](https://github.com/CarmJos/MoeTeleport/network/dependencies)
- **[必要]** 插件基于 [Spigot-API](https://hub.spigotmc.org/stash/projects/SPIGOT) 、[BukkitAPI](http://bukkit.org/).
- **[已包含]** 消息格式基于 [MineDown](https://github.com/Phoenix616/MineDown)。
- 所有 messages.yml 支持 MineDown 语法。
- **[推荐]** 变量部分基于 [PlaceholderAPI](https://www.spigotmc.org/resources/6245/).
如果需要更多细节，请阅读此页面。 [依赖](https://github.com/CarmJos/MoeTeleport/network/dependencies)。
## [命令](src/main/resources/plugin.yml)
主命令是 `/MoeTeleport` 或 `/mt`。
此插件中的所有命令都支持配置“简化命令”，
例如允许玩家直接输入 '/back' 并执行 '/MoeTeleport back'，请参阅 [配置](#Config) 相关内容。
- 必需参数 '< 参数 >'
- 可选参数 '[参数]'
```text
# reload
@ 管理员命令 (MoeTeleport.admin)
- 重新加载插件配置文件。
# back
- 返回到上次地点。
----- [传送命令] -----
# teleport to <目标玩家>
- 请求传送到目标玩家的位置。
# teleport here <目标玩家>
- 请求目标玩家传送到自己的位置。
# teleport accept [目标玩家]
- 同意传送请求（可以指定玩家请求）。
# teleport deny [目标玩家]。
- 拒绝传送请求（可以指定玩家请求）。
----- [家园命令] -----
# home to [家园名称]
- 发送到指定的家园。
- 如果没有填写具体的家园，返回到第一个设置的家园。
- 如果有以“home”命名的家园，优先返回到“home”。
# home list
- 列出所有家园名称。
# home set [家园名称]
- 设置一个家园位置。
- 如果没有指定家园名称，默认值为“home”。
# home delete [家园名称]
- 删除一个家园位置
----- [传送点命令] -----
# warp to <传送点名称>
- 传送到指定的地点。
# warp list
- 列出所有当前的传送点位置。
# warp set <传送点名称>
- 设置一个传送点位置。
- 如果传送点已经存在且你是传送点的所有者（或服务器管理员），
- 旧的传送点将被覆盖。
# warp delete <传送点名称>
- 删除你自己的传送点
```
## Config
### 插件配置文件 ([config.yml]())
请阅读源代码以获取更多详细信息。
### 消息配置文件 ([messages.yml]())
支持 [MineDown 语法](https://wiki.phoenix616.dev/library:minedown:syntax)
请阅读源代码以获取更多详细信息。
## 使用统计
[](https://bstats.org/plugin/bukkit/MoeTeleport/14459)
## 支持与捐赠
如果你发现这个插件帮助到了你，你可以捐赠来支持我。 感谢您对这个开源项目的支持！
衷心感谢以下朋友们对本项目的开发给予支持：
- 本插件由 [**璎珞 **](https://www.yingluo.world/) 服务器委托，已授权。
- 感谢 [**XingMC**(MagicMC 服务器开发者)](https://www.mcbbs.net/?4816320) 为本插件后续开发提供资金。
衷心感谢 Jetbrains 慷慨地为我提供了许可，让我得以进行这个和其他开源项目的开发。
[](https://www.jetbrains.com/?from=https://github.com/CarmJos/UserPrefix)
## 开源协议
该项目的源代码使用 [GNU General Public License v3.0](https://opensource.org/licenses/GPL-3.0) 许可。
```