PurpleTravel

插件

· 作者 BatMultifonction

一个 Paper 旅行插件(家园、传送点、出生点、随机传送等...)

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

最新 1.0.0 · 1.21.11 · Paper

一键开服(送7天)

? 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 中可以看到非活跃状态的备注

智能预热分辨率

  1. 启用 LuckPerms → 仅从玩家权重最高的组读取 purpletravel.teleport_warmup.<seconds>
  2. 未启用 LuckPerms → 扫描所有权限,取最小值生效
  3. 回退机制 → 使用配置文件中的 teleport.warmup_time(默认 5 秒)
  4. 豁免条件 → 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 支持)

? 安装方法

  1. 将 JAR 文件放入 /plugins 目录
  2. 重启服务器(首次启动时会自动下载库文件)
  3. 编辑 config.yml 设置语言、数据库及跨服务器模式
  4. 通过 /purpletravel import huskhomes confirm 从 HuskHomes 导入数据(可选)
  5. 完成!无需其他额外设置

? 视觉标识

属于 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 — 现代传送插件。没有花里胡哨,只有纯粹的功能性。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源