Starwarp

插件

· 作者 StarOG

1:1 复刻的 Donut SMP 传送系统

0 本站下载 0 关注 更新于 3 个月前

最新 1.0.0 · 1.21.10 · Folia / Paper

一键开服(送7天)

⭐ StarWarps

StarWarps 是一款面向现代 Minecraft 服务器和大型网络的高端、生产就绪的传送管理插件。它提供快速、安全、高度优化且完全可配置的传送功能,支持倒计时、移动取消、权限控制、精美的传送 GUI、持久化存储以及兼容 Paper/Folia 的调度机制。

✨ 特性

  • ? 快速优化的传送
  • ? 无限自定义传送点
  • ⏳ 可配置的传送倒计时
  • ? 基于移动的传送取消
  • ⚡ 在配置的出生地世界内实现即时传送
  • ?️ 高端 /warps GUI
  • ? GUI 分页支持
  • ? 单个传送点的权限控制
  • ? 支持旧版颜色代码、Hex 颜色、MiniMessage 风格格式以及渐变效果
  • ? 专用的 warps.yml 存储
  • ? 安全的 /warpreload 配置与传送数据重载
  • ? 不区分大小写的传送点名称
  • ?️ 重复和无效传送点保护
  • ? 世界与坐标验证
  • ? 可配置的传送和 GUI 音效
  • ? 智能 Tab 补全
  • ? 自动清理活动的传送任务
  • ? 兼容 Paper/Folia 的调度架构
  • ⚙️ 高度可配置的 YAML 文件
  • ? 专为大型服务器和网络设计
  • ?️ 稳健处理缺失的世界、无效的坐标、损坏的数据以及运行时错误

? 安装

  1. 下载最新的 StarWarps .jar 文件。
  2. 将其放入服务器的 plugins 文件夹中。
  3. 启动或重启服务器。
  4. StarWarps 将自动生成其配置文件。
  5. 根据需要配置插件。
  6. 使用 /setwarp <name> 创建你的第一个传送点。

在进行重大更改之前,请始终备份 config.yml 和 warps.yml。

? 命令

玩家命令

命令 描述
/warp <name> 传送到指定的传送点
/warps 打开传送 GUI
/warpinfo <name> 查看传送点信息

管理员命令

命令 描述
/setwarp <name> 在当前位置创建或更新传送点
/delwarp <name> 删除现有的传送点
/warpreload 重载 StarWarps 配置和传送数据

示例

/warp spawn
/warp crates
/warp shop
/warps
/warpinfo spawn

/setwarp spawn
/setwarp crates
/delwarp crates
/warpreload

? 权限

权限 描述
starwarps.warp 允许玩家使用 /warp
starwarps.warp.<warp> 允许访问特定的传送点
starwarps.setwarp 允许创建/编辑传送点
starwarps.delwarp 允许删除传送点
starwarps.warpinfo 允许使用 /warpinfo
starwarps.reload 允许使用 /warpreload
starwarps.admin 获得 StarWarps 的管理员访问权限
starwarps.bypass.delay 绕过传送倒计时
starwarps.bypass.movement 防止移动取消传送

权限示例

starwarps.warp
starwarps.warp.spawn
starwarps.warp.shop
starwarps.warp.crates
starwarps.bypass.delay
starwarps.bypass.movement

可以使用单传送点权限来限制特定的目的地,例如:

starwarps.warp.shop

⏳ 传送系统

默认情况下,StarWarps 使用 5 秒的传送倒计时。

当玩家执行:

/warp spawn

StarWarps 会通过聊天栏和操作栏显示剩余的倒计时。

示例:

You will be teleported in 5 seconds.

如果玩家移动的距离超过了配置的移动阈值,传送将被取消:

Teleport cancelled because you moved.

默认移动阈值为 0.5 格。

拥有 starwarps.bypass.delay 权限的玩家可以绕过倒计时。

拥有 starwarps.bypass.movement 权限的玩家可以在不影响传送的情况下移动。

? 出生地世界行为

当玩家已经位于配置的 出生地世界 内时,传送可以无需正常的倒计时而即时发生。

此行为是可配置的。

?️ 传送 GUI

使用:

/warps

打开 StarWarps GUI。

GUI 可以显示:

  • 传送点图标
  • 传送点名称
  • 描述
  • 权限/状态信息
  • 点击传送动作
  • 填充物品
  • 可配置的背包大小
  • 自定义 GUI 标题
  • 自定义音效
  • 针对大量传送点的分页功能

GUI 的布局和外观可以通过配置文件进行自定义。

? 传送点存储

传送点坐标存储在:

warps.yml

每个传送点存储:

  • 世界
  • X 坐标
  • Y 坐标
  • Z 坐标
  • 偏航角 (Yaw)
  • 俯仰角 (Pitch)

传送点名称会被标准化并以不区分大小写的方式处理,从而防止出现如 Spawn、spawn 和 SPAWN 这样的重复目的地。

? 示例目的地

StarWarps 可用于以下类型的目的地:

afk
auction
crates
duels
shop
spawn
world
world_nether
world_the_end

这些仅为示例。StarWarps 不要求或硬编码这些名称。管理员可以创建无限数量的自定义目的地。

示例:

/setwarp spawn
/setwarp shop
/setwarp auction
/setwarp crates
/setwarp duels

? 完全可配置的消息

StarWarps 支持:

  • 旧版颜色代码
  • Hex 颜色
  • MiniMessage 风格格式
  • 渐变
  • 倒计时占位符
  • 传送点/目的地占位符

倒计时示例:

<##A7A7A7>You will be teleported in <##37BFF8>{seconds} <##A7A7A7>seconds.

取消提示:

<##FB5454>Teleport cancelled because you moved.

成功传送:

<##A7A7A7>You were warped to <##37BFF8>{destination}<##A7A7A7>.

所有消息均可自定义。

⚙️ 配置

StarWarps 提供以下方面的配置选项:

  • 传送延迟
  • 移动阈值
  • 出生地世界即时传送
  • 传送音效
  • GUI 标题
  • GUI 大小
  • GUI 布局
  • 传送点图标
  • 填充物品
  • GUI 音效
  • 消息
  • 权限
  • 传送行为
  • 倒计时行为
  • 分页

? 重载

管理员可以使用以下命令重载受支持的配置和传送数据:

/warpreload

StarWarps 在重载期间安全地清理活跃的传送状态和已排定的任务,以防止任务重复和内存泄漏。

?️ 可靠性与性能

StarWarps 专为严肃的 Minecraft 网络而设计,并采用了以下特性:

  • 模块化架构
  • 缓存的传送点数据
  • 高效的传送状态管理
  • 最小化的排定工作
  • 无不必要的重复任务
  • 安全的任务清理
  • 兼容 Paper/Folia 的任务调度
  • 主线程安全的 Bukkit/Paper API 访问
  • 世界与位置验证
  • 防止无效传送点数据
  • 安全处理玩家断开连接
  • 死亡与世界变更时的清理
  • 重载与服务端关闭期间的清理

该系统旨在在处理大量传送点和玩家时保持高性能。

? 兼容性

平台: 兼容 Paper / Folia 的架构

构建系统: Maven

包名: me.starog.starstudio.warps

StarWarps 基于现代 Paper API 构建,其调度抽象设计旨在实现长期的可维护性。

? 数据文件

典型的 StarWarps 数据结构如下:

plugins/
└── StarWarps/
    ├── config.yml
    ├── messages.yml
    ├── gui.yml
    └── warps.yml

文件名可能因安装的版本和配置设置而异。

? 为什么选择 StarWarps?

StarWarps 并非旨在成为另一个基本的 /warp 插件。

它专注于提供高级网络级传送体验,拥有整洁的 GUI、强大的权限系统、可靠的持久化存储、可配置的传送机制、现代化的格式化以及为长期开发而设计的架构。

对玩家简单直观。对管理员功能强大。对服务器进行优化。

⭐ StarWarps — 快速、简洁、可靠。为您的网络而生。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源