YoTPA

插件

· 作者 PhyschicWinter9

YoTPA 是一款轻量且强大的传送请求插件,具备自适应性能优化。简单易用、易于配置,专为现代 Minecraft 服务器打造。

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

最新 1.6.2 · 26.3 · Folia / Paper

一键开服(送7天)

Logo

YoTPA

YoTPA 是一款轻量且强大的传送请求插件,具备自适应性能优化功能。简单易用,易于配置,专为现代 Minecraft 服务器打造。

功能特性

自适应性能系统

该插件会自动检测服务器的可用内存并相应地优化自身——无需任何配置!

4 种性能模式:

  • ULTRA_LIGHT - 适用于 512 MB - 1 GB 内存(免费/廉价 VPS)
    • 最佳适用:5-10 名玩家,极少插件
  • LIGHT - 适用于 1-2 GB 内存(低端服务器)
    • 最佳适用:10-15 名玩家,轻量级插件
  • BALANCED - 适用于 2-4 GB 内存(中端服务器)
    • 最佳适用:15-25 名玩家,中等数量插件
  • HIGH_PERFORMANCE - 适用于 4+ GB 内存(高端服务器)
    • 最佳适用:25+ 名玩家,任意插件组合

性能优势:

  • 内存占用减少 30-70%
  • CPU 使用率降低 25-60%
  • 维护任务速度提升高达 83%
  • 根据服务器规格动态优化

核心功能

  • 简易 TPA 系统 - 向其他玩家发起传送请求或邀请他们传送到你身边
  • 倒计时计时器 - 传送前可配置的延迟时间,并带有视觉反馈
  • 标题显示 - 清晰的传送倒计时视觉提示
  • 移动检测 - 如果在倒计时期间玩家发生移动,传送将被取消
  • 自定义音效 - 使用 Minecraft 声音注册表完全自定义音频反馈
  • 配置验证 - 通过详细的错误信息防止因损坏的配置导致服务器崩溃
  • 权限系统 - 细粒度的访问控制
  • 请求管理 - 切换接收请求、取消发出的请求
  • 多线程支持 - 线程安全,支持更多并发玩家
  • 可自定义消息 - 完全本地化和可配置的消息内容

国际化(1.4.0 新增)

使用完整的 MiniMessage 支持,在任何语言中自定义所有插件消息:

prefix: "[YoTPA] "

commands:
  tpa:
    sent: "Teleport request sent to {target}"
    received: "{requester} wants to teleport to you."

MiniMessage 功能:

  • 富文本格式(粗体、斜体、下划线)
  • 颜色渐变:<gradient:green:aqua>text</gradient>
  • 彩虹效果:<rainbow>text</rainbow>
  • 十六进制颜色:<#FF5733>text</#FF5733>

自定义音效

使用 Minecraft 的声音 ID 自定义所有插件音效:

sounds:
  countdown: "block.note_block.pling"
  success: "entity.enderman.teleport"
  cancel: "entity.villager.no"
  request: "entity.experience_orb.pickup"

在游戏中测试音效:/playsound minecraft:block.note_block.pling master @s

配置

YoTPA 的 config.yml 文件允许你自定义插件的各个方面:

  • 请求超时时长
  • 请求间的冷却时间
  • 传送延迟倒计时
  • 性能模式设置
  • 不同操作的音效
  • 功能开关(统计信息、bStats、标题、音效)

配置文件

# YoTPA Configuration v1.3.0-Adaptive
# Smart Auto-Optimization for All Server Sizes

# Request timeout in seconds (how long before a request expires)
# Recommended: 30-120 seconds
request-timeout: 60

# Request cooldown in seconds (how long before sending another request)
# Recommended: 15-60 seconds
request-cooldown: 30

# Teleport delay in seconds (countdown before actual teleport)
# Recommended: 3-10 seconds
teleport-delay: 5

# Performance mode settings
performance:
  # Options: AUTO, ULTRA_LIGHT, LIGHT, BALANCED, HIGH_PERFORMANCE
  mode: AUTO

# Sound effects (use Minecraft sound names)
sounds:
  countdown: "block.note_block.pling"
  success: "entity.enderman.teleport"
  cancel: "entity.villager.no"
  request: "entity.experience_orb.pickup"

# Feature toggles
features:
  statistics: true
  bstats: true
  titles: true
  sounds: true

消息配置 (messages.yml)

# Customize your prefix
prefix: "[YoTPA] "

# All messages are customizable
commands:
  tpa:
    usage: "Usage: /tpa "
    sent: "Teleport request sent to {target}"
    received: "{requester} wants to teleport to you."

teleport:
  countdown:
    title: "Teleporting..."
    subtitle: "Don't move!"
    message: "Teleporting in {seconds} seconds"

自定义示例

将语言更改为西班牙语

编辑 messages.yml:

prefix: "[YoTPA] "

commands:
  tpa:
    usage: "Uso: /tpa "
    sent: "Solicitud enviada a {target}"
    received: "{requester} quiere teletransportarse a ti."

然后使用 /tpareload 应用更改!

添加精美渐变

prefix: "✦ YoTPA ✦ "

teleport:
  countdown:
    title: "Teleporting..."
    message: "Teleporting in {seconds} seconds"

自定义颜色

prefix: "[TPA] "

commands:
  tpa:
    sent: "Request sent to {target}"

使用十六进制颜色

prefix: "[YoTPA] "

teleport:
  success: "Teleported to {target} successfully!"

占位符:

  • {player} - 玩家名称
  • {target} - 目标玩家名称
  • {requester} - 请求者玩家名称
  • {seconds} - 秒数
  • {cooldown} - 冷却持续时间

配置部分详解

常规设置:

  • request-timeout - 传送请求保持有效的时间(以秒为单位)(推荐:30-120)
  • request-cooldown - 玩家可以再次发送请求前的时间(以秒为单位)(推荐:15-60)
  • teleport-delay - 传送发生前的倒计时时间(以秒为单位)(最小值:1)

性能设置:

  • performance.mode - AUTO(推荐)、ULTRA_LIGHT、LIGHT、BALANCED 或 HIGH_PERFORMANCE
    • AUTO 会自动检测你的服务器内存并选择最佳模式

声音设置:

  • 所有声音均使用 Minecraft 声音注册表格式(小写加点号)
  • 插件在重新加载配置时会验证声音
  • 完整声音列表:

功能开关:

  • statistics - 启用或禁用统计信息追踪
  • bstats - 启用或禁用 bStats 指标
  • titles - 启用或禁用倒计时期间的标题动画
  • sounds - 启用或禁用所有音效

配置验证

使用 /tpareload 重新加载时,插件会进行以下验证:

  • YAML 语法
  • 所有值是否在有效范围内
  • 音效是否存在于 Minecraft 的注册表中
  • 如果无效,则显示详细的错误消息

示例验证输出:

配置验证失败!
✗ teleport-delay 必须至少为 1 秒
✗ 音效 'countdown' (invalid.sound) 未在注册表中找到

警告:
• request-timeout (5) 过低,建议范围:30-120

配置未应用。请修复错误后重试。
使用之前的配置。

如何编辑和重新加载

  1. 编辑 plugins/YoTPA/config.yml 文件
  2. 保存更改
  3. 在游戏中使用 /tpareload 应用更改并进行验证

命令概览

命令 描述 权限
/tpa <player> 请求传送到其他玩家身边 yotpa.tpa
/tpaccept 接受待处理的传送请求 yotpa.tpaccept
/tpadeny 拒绝待处理的传送请求 yotpa.tpadeny
/tpahere <player> 请求其他玩家传送到你身边 yotpa.tpahere
/tpacancel 取消你发出的传送请求 yotpa.tpacancel
/tpatoggle 切换是否接收传送请求 yotpa.tpatoggle
/tpareload 重新加载插件配置 yotpa.reload
/tpainfo 查看插件信息和统计信息 yotpa.info
/tpastats 查看传送统计信息 yotpa.stats

默认设置: 默认情况下,所有玩家都拥有所有权限。

详细命令说明

TPA 命令

发送请求以传送到其他玩家身边。

/tpa <player>
参数 类型 描述
player string 必填。你想要传送到其身边的玩家名称

示例:

/tpa Steve      # 请求传送到名为 Steve 的玩家身边
/tpa Alex123    # 请求传送到名为 Alex123 的玩家身边

TPA Command

注意:

  • 你不能向自己发送请求
  • 发送请求之间有一个可配置的冷却时间(默认:30 秒)
  • 请求会在可配置的时间后过期(默认:60 秒)
  • 目标玩家将收到带有可点击“接受/拒绝”按钮的通知

TPAccept 命令

接受来自其他玩家的待处理传送请求。

/tpaccept

无需参数 - 接受最近的传送请求。

示例:

/tpaccept    # 接受待处理的传送请求

TPAccept Command

注意:

  • 仅在你有待处理的传送请求时有效
  • 接受后,传送将在倒计时开始后执行
  • 在倒计时期间,玩家必须保持静止,否则传送将被取消
  • 如果接受 /tpa 请求,请求者将传送到你身边
  • 如果接受 /tpahere 请求,你将传送到请求者身边

TPADeny 命令

拒绝来自其他玩家的待处理传送请求。

/tpadeny

无需参数 - 拒绝最近的传送请求。

示例:

/tpadeny    # 拒绝待处理的传送请求

TPADeny Command

注意:

  • 仅在你有待处理的传送请求时有效
  • 请求者将收到其请求被拒绝的通知
  • 请求会立即从系统中移除

TPAHere 命令

请求其他玩家传送到你的位置。

/tpahere <player>
参数 类型 描述
player string 必填。你希望传送到你身边的玩家名称

示例:

/tpahere Steve      # 请求 Steve 传送到你身边
/tpahere Alex123    # 请求 Alex123 传送到你身边

TPAHere Command

注意:

  • 你不能向自己发送请求
  • 发送请求之间有一个可配置的冷却时间(默认:30 秒)
  • 请求会在可配置的时间后过期(默认:60 秒)
  • 目标玩家必须使用 /tpaccept 接受请求

TPACancel 命令

取消你发出的传送请求。

/tpacancel

无需参数 - 取消你最近发出的请求。

示例:

/tpacancel    # 取消你的待处理请求

注意:

  • 仅在你有活动的发出请求时有效
  • 目标玩家将收到请求被取消的通知
  • 如果你误发了请求,这非常有用

TPAToggle 命令

切换你是否希望接收传送请求。

/tpatoggle

无需参数 - 切换你的请求接收状态。

示例:

/tpatoggle    # 开启/关闭接收传送请求

注意:

  • 当关闭时,其他玩家无法向你发送传送请求
  • 你将收到一条显示当前状态的消息
  • 你的设置会在服务器重启后保留

TPAReload 命令

使用验证重新加载插件配置。

/tpareload

无需参数 - 重新加载并验证配置文件。

示例:

/tpareload    # 重新加载插件配置

TPAReload Command

注意:

  • 需要 yotpa.reload 权限(默认:仅限 OP)
  • 验证 YAML 语法和所有配置值
  • 检查所有音效是否存在于 Minecraft 的注册表中
  • 如果配置无效,则显示详细错误
  • 仅在所有验证通过后才会应用配置
  • 在修改 config.yml 文件后非常有用

TPAInfo 命令

查看插件信息及实时统计数据。

/tpainfo

无需参数——显示插件信息。

示例:

/tpainfo    # 查看插件信息和统计

显示内容:

  • 当前性能模式(基于内存自动检测)
  • 优化级别和设置
  • 活跃的传送请求
  • 正在进行的传送
  • 内存使用统计
  • 插件版本

备注:

  • 有助于监控插件性能
  • 帮助诊断问题
  • 展示插件如何根据您的服务器进行自我优化

TPAStats 命令

查看传送统计数据和 usage 数据。

/tpastats

无需参数——显示传送统计。

示例:

/tpastats    # 查看传送统计

显示内容:

  • 发送的总传送请求数
  • 接收的总传送请求数
  • 成功率
  • 最活跃的玩家
  • 其他使用指标

备注:

  • 需要在配置文件中启用 features.statistics: true
  • 按玩家追踪统计数据
  • 数据在服务器重启后保留

优化建议

针对 FREE/低配服务器(512 MB - 1 GB):

  • 将模式保持为 AUTO 或 ULTRA_LIGHT
  • 限制插件总数为 5-8 个
  • 在 server.properties 中将 view-distance 设置为 4
  • 使用 Paper 而非 Spigot
  • 同时在线玩家限制在 5-10 人

针对 MID-RANGE 中等配置服务器(2-4 GB):

  • 使用 AUTO 或 BALANCED 模式
  • 可运行 10-15 个插件
  • view-distance 设为 6-8
  • 支持 15-25 名玩家

针对 HIGH-END 高配服务器(4+ GB):

  • 使用 AUTO 或 HIGH_PERFORMANCE 模式
  • 无明显插件数量限制
  • view-distance 设为 10-12
  • 支持 25+ 名玩家

性能

YoTPA 在设计时即考虑了性能:

  • 轻量级 - 对服务器 TPS 影响极小
  • 线程安全 - 并发操作不会导致延迟
  • 内存高效 - 自动适应您服务器的资源状况
  • 异步操作 - 非阻塞任务执行
  • 无锁设计 - 避免竞态条件或死锁

安装

  1. 从发布页面下载最新的 JAR 文件
  2. 将 JAR 文件放入服务器的 plugins 文件夹中
  3. 重启服务器
  4. 完成!插件将根据您的服务器规格自动配置

注意: 这是我的第一个插件项目!

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源