⭐ StarWarps
StarWarps 是一款面向现代 Minecraft 服务器和大型网络的高端、生产就绪的传送管理插件。它提供快速、安全、高度优化且完全可配置的传送功能,支持倒计时、移动取消、权限控制、精美的传送 GUI、持久化存储以及兼容 Paper/Folia 的调度机制。
✨ 特性
- ? 快速优化的传送
- ? 无限自定义传送点
- ⏳ 可配置的传送倒计时
- ? 基于移动的传送取消
- ⚡ 在配置的出生地世界内实现即时传送
- ?️ 高端
/warps GUI
- ? GUI 分页支持
- ? 单个传送点的权限控制
- ? 支持旧版颜色代码、Hex 颜色、MiniMessage 风格格式以及渐变效果
- ? 专用的
warps.yml 存储
- ? 安全的
/warpreload 配置与传送数据重载
- ? 不区分大小写的传送点名称
- ?️ 重复和无效传送点保护
- ? 世界与坐标验证
- ? 可配置的传送和 GUI 音效
- ? 智能 Tab 补全
- ? 自动清理活动的传送任务
- ? 兼容 Paper/Folia 的调度架构
- ⚙️ 高度可配置的 YAML 文件
- ? 专为大型服务器和网络设计
- ?️ 稳健处理缺失的世界、无效的坐标、损坏的数据以及运行时错误
? 安装
- 下载最新的 StarWarps
.jar 文件。
- 将其放入服务器的
plugins 文件夹中。
- 启动或重启服务器。
- StarWarps 将自动生成其配置文件。
- 根据需要配置插件。
- 使用
/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 — 快速、简洁、可靠。为您的网络而生。
⭐ StarWarps
StarWarps is a premium, production-ready warp management plugin built for modern Minecraft servers and serious networks. It provides fast, secure, highly optimized, and fully configurable teleportation with countdowns, movement cancellation, permissions, a polished warp GUI, persistent warp storage, and Paper/Folia-compatible scheduling.
✨ Features
- ? Fast and optimized warp teleportation
- ? Unlimited custom warps
- ⏳ Configurable teleport countdown
- ? Movement-based teleport cancellation
- ⚡ Instant teleportation inside the configured spawn world
- ?️ Premium
/warps GUI
- ? GUI pagination support
- ? Per-warp permissions
- ? Legacy colors, Hex colors, MiniMessage-style formatting, and gradients
- ? Dedicated
warps.yml storage
- ? Safe
/warpreload configuration and warp reloading
- ? Case-insensitive warp names
- ?️ Duplicate and invalid warp protection
- ? World and location validation
- ? Configurable teleport and GUI sounds
- ? Intelligent tab completion
- ? Automatic cleanup of active teleport tasks
- ? Paper/Folia-compatible scheduling architecture
- ⚙️ Highly configurable YAML files
- ? Designed for large servers and networks
- ?️ Robust handling of missing worlds, invalid locations, corrupted data, and runtime errors
? Installation
- Download the latest StarWarps
.jar.
- Place it inside your server's
plugins folder.
- Start or restart your server.
- StarWarps will generate its configuration files.
- Configure the plugin as required.
- Use
/setwarp <name> to create your first warp.
Always back up config.yml and warps.yml before making major changes.
? Commands
Player Commands
| Command |
Description |
/warp <name> |
Teleport to a specific warp |
/warps |
Open the warp GUI |
/warpinfo <name> |
View information about a warp |
Admin Commands
| Command |
Description |
/setwarp <name> |
Create or update a warp at your current location |
/delwarp <name> |
Delete an existing warp |
/warpreload |
Reload StarWarps configuration and warp data |
Examples
/warp spawn
/warp crates
/warp shop
/warps
/warpinfo spawn
/setwarp spawn
/setwarp crates
/delwarp crates
/warpreload
? Permissions
| Permission |
Description |
starwarps.warp |
Allows the player to use /warp |
starwarps.warp.<warp> |
Allows access to a specific warp |
starwarps.setwarp |
Allows creating/editing warps |
starwarps.delwarp |
Allows deleting warps |
starwarps.warpinfo |
Allows using /warpinfo |
starwarps.reload |
Allows using /warpreload |
starwarps.admin |
Administrative StarWarps access |
starwarps.bypass.delay |
Bypasses the teleport countdown |
starwarps.bypass.movement |
Prevents movement from cancelling teleportation |
Permission Examples
starwarps.warp
starwarps.warp.spawn
starwarps.warp.shop
starwarps.warp.crates
starwarps.bypass.delay
starwarps.bypass.movement
Per-warp permissions can be used to restrict individual destinations, for example:
starwarps.warp.shop
⏳ Teleport System
By default, StarWarps uses a 5-second teleport countdown.
When a player executes:
/warp spawn
StarWarps displays the remaining countdown through chat and the action bar.
Example:
You will be teleported in 5 seconds.
If the player moves beyond the configured movement threshold, the teleport is cancelled:
Teleport cancelled because you moved.
The default movement threshold is 0.5 blocks.
Players with starwarps.bypass.delay can bypass the countdown.
Players with starwarps.bypass.movement can move without cancelling their teleport.
? Spawn World Behavior
When a player is already inside the configured spawn world, warp teleportation can occur instantly without the normal countdown.
This behavior is configurable.
?️ Warp GUI
Use:
/warps
to open the StarWarps GUI.
The GUI can display:
- Warp icons
- Warp names
- Descriptions
- Permission/status information
- Click-to-teleport actions
- Filler items
- Configurable inventory size
- Custom GUI title
- Custom sounds
- Pagination for large warp collections
The GUI layout and appearance can be customized through configuration files.
? Warp Storage
Warp locations are stored in:
warps.yml
Each warp stores:
- World
- X coordinate
- Y coordinate
- Z coordinate
- Yaw
- Pitch
Warp names are normalized and handled case-insensitively, preventing duplicate destinations such as Spawn, spawn, and SPAWN.
? Example Destinations
StarWarps can be used for destinations such as:
afk
auction
crates
duels
shop
spawn
world
world_nether
world_the_end
These are examples only. StarWarps does not require or hardcode them. Administrators can create unlimited custom destinations.
Example:
/setwarp spawn
/setwarp shop
/setwarp auction
/setwarp crates
/setwarp duels
? Fully Configurable Messages
StarWarps supports:
- Legacy color codes
- Hex colors
- MiniMessage-style formatting
- Gradients
- Countdown placeholders
- Warp/destination placeholders
Example countdown:
<##A7A7A7>You will be teleported in <##37BFF8>{seconds} <##A7A7A7>seconds.
Cancellation:
<##FB5454>Teleport cancelled because you moved.
Successful teleport:
<##A7A7A7>You were warped to <##37BFF8>{destination}<##A7A7A7>.
All messages can be customized.
⚙️ Configuration
StarWarps provides configuration for:
- Teleport delay
- Movement threshold
- Spawn-world instant teleport
- Teleport sounds
- GUI title
- GUI size
- GUI layout
- Warp icons
- Filler items
- GUI sounds
- Messages
- Permissions
- Warp behavior
- Countdown behavior
- Pagination
? Reloading
Administrators can reload supported configuration and warp data using:
/warpreload
StarWarps safely cleans up active teleport states and scheduled tasks during reloads to prevent duplicated tasks and memory leaks.
?️ Reliability & Performance
StarWarps is designed for serious Minecraft networks and uses:
- Modular architecture
- Cached warp data
- Efficient teleport state management
- Minimal scheduled work
- No unnecessary repeating tasks
- Safe task cleanup
- Paper/Folia-compatible scheduling
- Main-thread-safe Bukkit/Paper API access
- World and location validation
- Protection against invalid warp data
- Safe handling of player disconnects
- Cleanup on death and world changes
- Cleanup during reloads and server shutdown
The system is designed to remain performant with large numbers of warps and players.
? Compatibility
Platform: Paper / Folia-compatible architecture
Build System: Maven
Package: me.starog.starstudio.warps
StarWarps is built around modern Paper APIs with a scheduling abstraction designed for long-term maintainability.
? Data Files
Typical StarWarps data structure:
plugins/
└── StarWarps/
├── config.yml
├── messages.yml
├── gui.yml
└── warps.yml
File names may vary depending on the installed version and configuration setup.
? Why StarWarps?
StarWarps isn't designed to be just another basic /warp plugin.
It focuses on providing a premium network-grade teleportation experience with a clean GUI, powerful permissions, reliable persistence, configurable teleport mechanics, modern formatting, and an architecture designed for long-term development.
Simple for players. Powerful for administrators. Optimized for servers.
⭐ StarWarps — Fast. Clean. Reliable. Built for your network.
评论 0
登录后参与评分
还没有评论,来抢沙发吧