1-1. 简介
ShuguangTP（曙光传送）是一款专为 Minecraft 服务器开发的高质量传送插件，由曙光团队开发维护，采用纯 Bukkit API 实现，无需任何 NMS 依赖，完全兼容 Arclight 混合核心。
插件支持三种传送模式：坐标传送、玩家请求传送和Home 传送。内置智能计费系统，根据传送距离和是否跨维度自动计算费用，是经济型服务器的完美选择。
所有代码已在 GitHub 开源，采用 MIT License，欢迎社区贡献。
1-2. 命令与权限
玩家命令
| 命令 | 别名 | 说明 | 权限 |
|---|---|---|---|
/stp <x> <y> <z> [world] | — | 传送到指定坐标 | shuguangtp.use |
/stpp <player> | — | 向玩家发起传送请求 | shuguangtp.use |
/stph [home] | — | 传送到 Home 点 | shuguangtp.use |
/stpaccept | /stpa | 接受传送请求 | shuguangtp.use |
/stpdeny | /stpd | 拒绝传送请求 | shuguangtp.use |
管理员命令
| 命令 | 说明 | 权限 |
|---|---|---|
/stpreload | 热重载配置文件 | shuguangtp.admin |
权限节点
| 权限节点 | 默认 | 说明 |
|---|---|---|
shuguangtp.use | 所有玩家 | 使用传送命令 |
shuguangtp.admin | OP | 管理员命令（重载） |
shuguangtp.free | 无 | 免费传送（绕过计费） |
1-3. 配置说明
配置文件位于 plugins/ShuguangTP/config.yml，插件首次启动时自动生成。
config.yml
# 计费设置
cost:
# 每格距离收取的费用
per-block: 0.05
# 跨维度传送费用倍数
cross-dimension-multiplier: 3.0
# 最低收费
minimum: 1.0
# 最高收费（0 = 不设上限）
maximum: 500.0
teleport:
# 传送延迟（秒）
delay: 3
# 移动时取消传送并退款
cancel-on-move: true
home:
# Home 数据来源：essentials / builtin
provider: essentials
1-4. 计费系统
ShuguangTP 采用智能距离计费模式，传送费用由以下公式计算：
费用 = max( min( 距离 × 单价 + 额外费, 最高限额 ), 最低收费 )
如果传送涉及跨维度，则整体费用再乘以 跨维度倍数。
计算示例
同维度 500 格距离
500 × 0.05 = 25 金币
主世界→下界 300 格距离
300 × 0.05 × 3 = 45 金币
距离过近（低于最低额）
min(5×0.05, ...) = 1 金币
距离过远（超过最高额）
min(..., 500) = 500 金币
1-5. 安装指南
安装前置插件
在服务器中安装 Vault 和任意经济插件（如 EssentialsX、CMI 等）。
放入插件
将 ShuguangTP-*.jar 文件复制到服务器的 plugins/ 目录。
启动服务器
启动或重载服务器，插件会自动在 plugins/ShuguangTP/ 下生成配置文件。
配置计费参数
根据服务器经济情况，编辑 config.yml 中的费率参数。
热重载生效
运行 /stpreload 使配置立即生效，无需重启服务器。
致谢 / Acknowledgments
本插件由 落尽红樱君不见 委托定制开发，
感谢他愿意将此插件以开源形式发布，让更多服务器玩家受益。
制作团队：曙光团队（Shuguang Team）
制作人：鳌江（Aojiang）
许可证：MIT License
制作团队：曙光团队（Shuguang Team）
制作人：鳌江（Aojiang）
许可证：MIT License