? PurpleTravel
适用于 Paper 1.21+ 的现代家园、传送点、出生点、TPA、RTP 和 /back 功能 — 更优的 HuskHomes 替代方案,零 GUI,纯聊天交互,以及创新的活跃/非活跃家园管理。
✨ 亮点
-
仅聊天界面 — 无物品栏 GUI。所有内容均为交互式冒险组件,支持悬停提示、点击传送按钮以及优雅的翻页功能
-
家园永不消失 — 当玩家的家园数量上限降低时,多余的家园会变为 非活跃状态(隐藏且无法使用),但会永久保留在数据库中。当上限提升或较旧的家园被删除时,它们会自动重新激活——从而解决了 HuskHomes 的核心缺陷
-
按组预热 — 在任意传送前倒计时均可针对每个组自定义,使用 purpletravel.teleport_warmup.<秒数>(类似 HuskHomes)。管理员可通过 purpletravel.teleport_warmup.0 实现即时传送。
-
仅 /rtp 和 /back 命令设有冷却时间 — 前往家、传送点和出生点的传送无冷却延迟;仅随机传送(RTP)和返回指令受速率限制
-
支持跨服务器使用 — 共享 MySQL 数据库 + 消息代理(插件消息或 Redis)。家园、传送点、全局出生点、TPA、/tp 和 /back 均可在多个服务器间正常工作
-
支持 SQLite 或 MySQL — 抽象数据库层,可通过配置文件在运行时切换
-
HuskHomes 导入器 — 一条命令即可迁移所有数据(家园、传送点、用户、冷却时间),保留创建日期,维持活跃/非活跃状态
-
自动更新配置 — 插件更新中的新键会自动合并到配置文件和语言文件中,保留所有编辑内容和注释
-
PlaceholderAPI 扩展 — 提供 7 个用于计分板和告示牌的占位符
-
公共 API — 13 个可取消的事件 + 完整的开发者 API,支持异步 CompletableFuture
? 命令
家
/home, /homes, /homelist, /sethome, /delhome, /edithome, /phome, /phomelist
传送点
/warp, /warps, /warplist, /setwarp, /delwarp, /editwarp
传送
/tp, /tphere, /tpoffline, /tpall, /back, /rtp, /spawn, /setspawn
请求
/tpa, /tpahere, /tpaall, /tpaccept, /tpdecline, /tpignore
管理员
/purpletravel reload|status|dump|import|delete|homeslots (别名: /purplehomes, /pt)
? 主要特性
活跃/非活跃家系统
- 拥有
purpletravel.max_homes.10 权限的玩家最多可以设置 10 个 活跃 的家
- 如果创建了 15 个家,第 11 到第 15 个(最新的)将变为 非活跃 状态——它们会永久保留在数据库中
- 删除一个活跃的家?最旧的非活跃家会自动重新激活
- 数据永远不会丢失;家只是暂时无法使用
- 工作人员在
/homes 中可以看到非活跃状态的备注
智能预热分辨率
- 启用 LuckPerms → 仅从玩家权重最高的组读取
purpletravel.teleport_warmup.<seconds>
- 未启用 LuckPerms → 扫描所有权限,取最小值生效
- 回退机制 → 使用配置文件中的
teleport.warmup_time(默认 5 秒)
- 豁免条件 →
purpletravel.bypass_teleport_warmup
冷却系统
- 仅适用于 /rtp(默认 600 秒)和 /back(默认 30 秒)——每种动作均可单独配置
- 解析逻辑与预热相同(LuckPerms 组权限 → 普通权限 → 配置文件)
- 使用
purpletravel.bypass_cooldowns 可豁免冷却
? 跨服务器
在配置文件中启用以在不同服务器间共享家园:
- 所有服务器共用同一个 MySQL 数据库 +
table_prefix
- 消息代理:
PLUGIN_MESSAGE(需要代理节点)或 REDIS(更可靠)
- 全局
/spawn 存储为网络范围内的传送点
- 玩家列表每 30 秒同步一次
- TPA 请求、RTP 以及
/tp 均支持跨服务器感知
? 依赖项
软依赖:
- LuckPerms(启用基于权重的预热/冷却覆盖功能)
- Vault(经济支持)
- PlaceholderAPI(扩展支持)
运行时库(由 Paper 自动下载):
- HikariCP 5.1.0
- SQLite JDBC 3.46.1.3
- MySQL Connector/J 8.4.0
- Jedis 5.1.5(Redis 支持)
? 安装方法
- 将 JAR 文件放入
/plugins 目录
- 重启服务器(首次启动时会自动下载库文件)
- 编辑
config.yml 设置语言、数据库及跨服务器模式
- 通过
/purpletravel import huskhomes confirm 从 HuskHomes 导入数据(可选)
- 完成!无需其他额外设置
? 视觉标识
属于 PurplePlugins 生态系统的一部分——设计风格与 PurplePunish 保持一致:
- 聊天中带有渐变效果的小写大写字母前缀
- 统一的配色方案(信息蓝、成功绿、错误红)
- 法语“你”称呼风格 + 完整的英文本地化
- 优雅的悬停菜单和点击交互效果
? API 示例
PurpleTravelAPI api = PurpleTravelAPI.getInstance();
// 获取家园
api.getHomes(player.getUniqueId()).thenAccept(homes -> {
player.sendMessage("You have " + homes.size() + " homes");
});
// 检查玩家的预热时间
int warmupSeconds = api.getTeleportWarmup(player);
// 执行包含所有功能的传送(预热、特效、经济扣除、冷却)
api.timedTeleport(player, api.positionOf(targetLocation));
// 监听事件
@EventHandler
void onHomeCreate(HomeCreateEvent e) {
e.setCancelled(true); // 阻止创建家园
}
? 权限
-
purpletravel.command.* — 按命令授予访问权限
-
purpletravel.max_homes.<n> — 活跃家园数量上限
-
purpletravel.teleport_warmup.<seconds> — 自定义预热时间
-
purpletravel.cooldown.random_teleport.<seconds> — 自定义随机传送冷却时间
-
purpletravel.admin — 管理员命令
-
GitHub: PurpleTravel 仓库
-
Discord: PurplePlugins 社区
-
文档: Wiki
PurpleTravel — 现代传送插件。没有花里胡哨,只有纯粹的功能性。
? PurpleTravel
Modern homes, warps, spawn, teleportation, TPA, RTP and /back for Paper 1.21+ — The superior HuskHomes alternative with zero GUIs, pure chat interactions, and innovative active/inactive home management.
✨ Highlights
- Chat-only UI — No inventory GUIs. Everything is interactive Adventure Components with hover tooltips, click-to-teleport buttons, and elegant pagination
- Homes never disappear — When a player's home limit decreases, excess homes become inactive (hidden, unusable) but stay permanently in the database. They auto-reactivate when the limit rises or older homes are deleted—solving HuskHomes' core flaw
- Per-group warmup — Countdown before ANY teleport is fully customizable per group with
purpletravel.teleport_warmup.<seconds> (like HuskHomes). Instant TP for staff with purpletravel.teleport_warmup.0
- Cooldowns only on /rtp and /back — Home, warp, and spawn teleports have zero cooldown delays; only random teleport and back command are rate-limited
- Cross-server ready — Shared MySQL database + broker (Plugin Messaging or Redis). Homes, warps, global spawn, TPA, /tp and /back all work across servers
- SQLite or MySQL — Abstract database layer, swap at runtime via config
- Full economy integration — Vault support for paid home slots, public home conversion, and RTP
- HuskHomes importer — Migrate all data (homes, warps, users, cooldowns) from HuskHomes in one command—creation dates preserved, active/inactive state maintained
- Auto-updating config — New keys from plugin updates merge into your config and language files automatically, preserving all your edits and comments
- PlaceholderAPI expansion — 7 placeholders for scoreboards and signs
- Public API — 13 cancellable events + full developer API with async CompletableFuture support
? Commands
Homes
/home, /homes, /homelist, /sethome, /delhome, /edithome, /phome, /phomelist
Warps
/warp, /warps, /warplist, /setwarp, /delwarp, /editwarp
Teleportation
/tp, /tphere, /tpoffline, /tpall, /back, /rtp, /spawn, /setspawn
Requests
/tpa, /tpahere, /tpaall, /tpaccept, /tpdecline, /tpignore
Admin
/purpletravel reload|status|dump|import|delete|homeslots (aliases: /purplehomes, /pt)
? Key Features
Active/Inactive Homes System
- Player with
purpletravel.max_homes.10 can have 10 active homes
- Create 15 homes? The 11 newest ones turn inactive—they stay in the database forever
- Delete an active home? The oldest inactive one auto-reactivates
- No data is ever lost; homes just become temporarily unusable
- Staff see an inactivity note in
/homes
Smart Warmup Resolution
- With LuckPerms → read
purpletravel.teleport_warmup.<seconds> from the player's highest-weight group only
- Without LuckPerms → scan all permissions, lowest value wins
- Fallback →
teleport.warmup_time from config (default 5s)
- Bypass →
purpletravel.bypass_teleport_warmup
Cooldown System
- Only on /rtp (600s default) and /back (30s default)—fully configurable per action
- Same resolution logic as warmup (LuckPerms group → permissions → config)
- Bypass with
purpletravel.bypass_cooldowns
? Cross-Server
Enable in config to share homes across servers:
- All servers use the same MySQL database +
table_prefix
- Broker:
PLUGIN_MESSAGE (requires proxy) or REDIS (more reliable)
- Global
/spawn stored as a network-wide warp
- Player lists sync every 30 seconds
- TPA requests, RTP, and
/tp all cross-server aware
? Dependencies
Soft:
- LuckPerms (enables weight-based warmup/cooldown overrides)
- Vault (economy support)
- PlaceholderAPI (expansion)
Runtime Libraries (auto-downloaded by Paper):
- HikariCP 5.1.0
- SQLite JDBC 3.46.1.3
- MySQL Connector/J 8.4.0
- Jedis 5.1.5 (Redis support)
? Installation
- Drop the JAR into
/plugins
- Restart the server (libraries auto-download on first boot)
- Edit
config.yml to set language, database, cross-server mode
- Import from HuskHomes with
/purpletravel import huskhomes confirm (optional)
- Done! No additional setup required
? Visual Identity
Part of the PurplePlugins ecosystem—matches PurplePunish's design:
- Gradient small-caps prefix in chat
- Consistent color palette (info blue, success green, error red)
- Tutoiement français + full English localization
- Elegant hover menus and click interactions
? API Example
PurpleTravelAPI api = PurpleTravelAPI.getInstance();
// Get homes
api.getHomes(player.getUniqueId()).thenAccept(homes -> {
player.sendMessage("You have " + homes.size() + " homes");
});
// Check warmup for a player
int warmupSeconds = api.getTeleportWarmup(player);
// Teleport with all features (warmup, effects, economy, cooldown)
api.timedTeleport(player, api.positionOf(targetLocation));
// Listen to events
@EventHandler
void onHomeCreate(HomeCreateEvent e) {
e.setCancelled(true); // block home creation
}
? Permissions
purpletravel.command.* — Per-command access
purpletravel.max_homes.<n> — Cap of active homes
purpletravel.teleport_warmup.<seconds> — Custom warmup
purpletravel.cooldown.random_teleport.<seconds> — Custom RTP cooldown
purpletravel.admin — Admin commands
? Support
PurpleTravel — The modern teleportation plugin. No BS, pure functionality.
评论 0
登录后参与评分
还没有评论,来抢沙发吧