SimpleTpa
向好友发送传送请求。对方点击“接受”,你即可到达。
⚠️ SimpleTpa 3 需要 Paper 服务器,Minecraft 1.21 或更高版本(Purpur 及其他 Paper 分支也可用,且支持 Folia)。使用的是 Spigot 或较旧的 Minecraft 版本?请从 Files 选项卡下载 2.3 版本,它将像以前一样正常工作。
? 加入 SimpleTpa Discord 以获取更新、帮助和建议。
工作原理
- Steve 输入 /tpa Alex
- Alex 看到一条带有两个按钮的消息:[ACCEPT] [DENY]
- Alex 点击 [ACCEPT]
- Steve 保持静止 3 秒,随后播放传送动画
- Steve 被传送到 Alex 附近的安全位置
想让 Alex 来你身边吗?请使用 /tpahere Alex。
功能特性
- ✔ 可点击按钮:接受或拒绝,无需手动输入指令
- ✔ 同时处理多个请求:接受最新请求,或选择接受谁的请求
- ✔ 传送前倒计时:移动或被攻击时会取消(无法通过逃跑逃避战斗)
- ✔ 安全传送:永远不会落在岩浆中、虚空里或卡在墙内
- ✔ 冷却时间:请求之间有冷却间隔,可选显示倒计时进度条
- ✔ 7 种传送动画:可通过权限解锁
- ✔ 活动日志:查看谁向谁发起请求、结果如何以及玩家传送到了哪里
- ✔ 玩家菜单 和 管理员菜单:全部在遊戲內操作
- ✔ 完全自定义:消息、颜色、声音和语言均可定制
- ✔ 跨世界传送:允许或禁止,由你决定
- ✔ Folia 兼容:同一个 jar 文件可在 Paper 和 Folia 上运行
传送动画
倒计时期间,粒子会在玩家周围旋转。
| 动画 |
外观 |
| Classic |
紫色传送门粒子(默认所有人可用) |
| Spiral |
上升的白色火花螺旋 |
| Double helix |
两条紫色线条交织在一起 |
| Rings |
围绕玩家的绿色光环 |
| Vortex |
旋转的巫术魔法漩涡 |
| Halo |
金色光环 |
| Orb |
蓝色灵魂火焰球 |
每个动画通过授予权限 simpletpa.animation.<name> 来解锁,因此它们非常适合作为排位的奖励。玩家可以从 /tpamenu 中选择自己的动画。管理员则可以通过 /tpaconfig 设置默认动画、开启或关闭动画功能并进行预览。
玩家菜单 (/tpamenu)
玩家所需的一切功能,无需记忆指令:
- 选择你的动画:未解锁的动画也会显示出来,让玩家知道可以解锁哪些内容
- 一键停止所有请求,并可在之后重新开启
- 忽略列表:查看你已忽略的玩家并将其移除
- 显示或隐藏倒计时条
所选设置会被保存,重启后依然有效。
管理菜单 (/tpaconfig)
无需打开任何配置文件即可设置插件:
- 设置:倒计时、冷却时间、请求超时、安全传送、世界限制等。点击即可更改,即时保存
- 消息:选择一个类别(请求、传送、指令、菜单等…),点击任意一条消息并在聊天栏中输入新文本
- 动画:开启或关闭、预览、设置为默认
- 语言:即时切换语言,无需重启服务器
- 日志:浏览每位玩家的 TPA 历史记录(见下文)
活动日志
有人说“他没打招呼就传送到我的基地了”?几秒钟内即可查证。
- 打开
/tpaconfig → Logs(日志) 并选择一名玩家(如果玩家众多,可按名称搜索)
- 选择 Requests sent(发出的请求)、Requests received(收到的请求) 或 Teleports(传送记录)
- 每条记录均显示详细信息:
| 列表类型 |
显示内容 |
| 发出的请求 |
时间、目标玩家、使用的指令(/tpa 或 /tpahere)以及最终结果 |
| 收到的请求 |
时间、发送者、使用的指令(/tpa 或 /tpahere)以及最终结果 |
| 传送记录 |
时间、另一位玩家、所在世界和坐标 |
可能的结果包括:accepted(接受)、denied(拒绝)、cancelled(取消)、expired(过期) 或 pending(待处理)。
日志会保存到 plugins/SimpleTpa/logs/,不会影响服务器性能。在 config.yml 中你可以决定是否启用日志(logs.enabled)、每位玩家保留多少条记录(logs.max-entries-per-player)以及保留天数(logs.retention-days,0 表示永久保存)。所有文本,包括日期格式,均可像其他消息一样自定义修改。
打造专属体验
- 消息 支持颜色、渐变和悬停文本(MiniMessage)
- 颜色主题:在
config.yml 中更改 4 种颜色,所有消息将随之更新
- 音效与粒子效果:为每个事件提供专属音效和粒子,每项均可自定义或关闭
- 语言: 包含英文和意大利语。要添加其他语言,复制
languages/en.yaml,翻译它,它就会出现在管理菜单中。未翻译的行将保持为英文。
命令
| 命令 |
作用 |
/tpa [玩家] |
请求传送到某位玩家处 |
/tpahere [玩家] |
请求某位玩家来到你身边 |
/tpaccept [玩家] |
接受请求 |
/tpdeny [玩家] |
拒绝请求 |
/tpacancel |
取消你发送的请求 |
/tpatoggle |
停止(或重新允许)所有传入请求 |
/tpaignore [玩家] |
忽略(或停止忽略)某位玩家 |
/tpamenu |
打开你的个人设置 |
/tpaconfig |
打开管理设置和日志(仅限管理员) |
/tpareload |
重新加载配置(仅限管理员) |
权限
默认情况下,玩家可以使用所有基本命令。 管理员(op)拥有其余所有权限。
| 权限 |
赋予的内容 |
默认 |
simpletpa.tpa, simpletpa.tpahere, simpletpa.tpaccept, simpletpa.tpdeny, simpletpa.tpacancel, simpletpa.tpatoggle, simpletpa.tpaignore, simpletpa.menu |
基本命令和玩家菜单 |
所有人 |
simpletpa.gui |
管理菜单和日志 |
Op |
simpletpa.admin.reload |
/tpareload |
Op |
simpletpa.animation.[名称] |
解锁动画(classic 对所有人免费) |
Op |
simpletpa.bypass.cooldown |
无需等待冷却时间 |
Op |
simpletpa.bypass.warmup |
立即传送,无倒计时 |
Op |
simpletpa.bypass.world |
即使禁用了跨世界传送,也能在世界间传送 |
Op |
simpletpa.bypass.toggle |
向已禁用请求的玩家发送请求 |
Op |
动画名称:classic, spiral, double-helix, rings, vortex, halo, orb。
安装
- 将
SimpleTpa-3.2.0.jar 放入你的 plugins 文件夹
- 重启服务器
- 完成!使用
/tpaconfig 在游戏中更改设置,或编辑 plugins/SimpleTpa/config.yml 并运行 /tpareload
语言: 默认为英文。切换至意大利语:通过 /tpaconfig → Languages,或在 config.yml 中设置 language: it。
从版本 2 更新(老用户请阅读)
版本 3 是彻底的重写。更新很简单:
- 确保你的服务器运行的是 Paper 1.21 或更高版本
- 用新版 jar 替换旧版并重启
对你产生的变化:
- 你的旧
config.yml 会保存为 config-v2-backup.yml,并创建一个新的配置文件。如果你之前有自定义消息,请再次复制它们(现在可以通过 /tpaconfig 在游戏中操作)。
- 现在默认允许跨世界传送(之前一直禁止)。若要再次禁止:设置
allow-cross-world: false。
- 默认冷却时间现在是 30 秒(之前是 20 秒)。
- v2.3 的权限仍然有效(
simpletpa.tpa, simpletpa.tpaccept, simpletpa.tpdeny)。非常旧的 v2.2 权限(tpa.tpa…)不再使用。
- 管理员(op)仍然跳过冷却时间,并且现在也跳过倒计时。
使用 EssentialsX 或 CMI?
它们也有 /tpa 命令。SimpleTpa 优先加载,因此/tpa、/tpaccept 和其他命令会自动使用 SimpleTpa。另一个插件的命令仍可通过 /essentials:tpa 使用。
SimpleTpa 向 bStats 发送匿名使用统计。你可以在 plugins/bStats/config.yml 中关闭它们。
需要帮助?加入 Discord!
- ?️ 支持论坛:发布带有 Bug 或 Question 标签的帖子,快速获得帮助
- ? 功能建议:提出想法,了解后续开发计划
- ? 公告:第一时间获知新版本发布
- ? 常见问题与文档:设置、命令、权限及常见修复方法
在寻求帮助时,请提供你的 SimpleTpa 版本、服务器版本(/version)以及任何控制台错误信息。
你也可以在这里留下评论,但 Discord 是获得回复最快的方式。
SimpleTpa
Ask to teleport to a friend. They click ACCEPT. You're there.
⚠️ SimpleTpa 3 needs a Paper server, Minecraft 1.21 or newer (Purpur and other Paper forks work too, and Folia is supported). Using Spigot or an older Minecraft version? Download version 2.3 from the Files tab, it keeps working as before.
? Join the SimpleTpa Discord for updates, help and suggestions.
How it works
- Steve types /tpa Alex
- Alex sees a message with two buttons: [ACCEPT] [DENY]
- Alex clicks [ACCEPT]
- Steve stands still for 3 seconds, and a teleport animation plays
- Steve is teleported next to Alex, always on a safe spot
Want Alex to come to you instead? Use /tpahere Alex.
Features
- ✔ Clickable buttons to accept or deny, no typing needed
- ✔ Several requests at once: accept the latest, or choose who to accept
- ✔ Countdown before teleporting, cancelled if you move or get hit (no escaping fights)
- ✔ Safe teleport: never land in lava, in the void or inside a wall
- ✔ Cooldown between requests, with an optional countdown bar
- ✔ 7 teleport animations, unlockable with permissions
- ✔ Activity log: see who asked whom, how it ended and where players teleported
- ✔ Player menu and admin menu, everything in game
- ✔ Fully customisable messages, colours, sounds and language
- ✔ Teleport between worlds: allowed or blocked, you decide
- ✔ Folia ready: the same jar runs on Paper and Folia
Teleport animations
While the countdown runs, particles swirl around the player.
| Animation |
Look |
| Classic |
Purple portal particles (default for everyone) |
| Spiral |
A rising spiral of white sparks |
| Double helix |
Two purple strands twisting together |
| Rings |
Green rings around the player |
| Vortex |
A swirling witch-magic vortex |
| Halo |
A golden halo |
| Orb |
Blue soul-fire orbs |
Each animation is unlocked with simpletpa.animation.<name>, so they make a nice reward for ranks. Players choose theirs from /tpamenu. Admins pick the default, turn animations on or off and preview them from /tpaconfig.
Player menu (/tpamenu)
Everything a player needs, without remembering commands:
- Choose your animation: locked ones are shown too, so players know what they can unlock
- Stop all requests with one click, and turn them back on later
- Ignore list: see who you ignore and remove them
- Show or hide the countdown bars
Choices are saved and stay after a restart.
Admin menu (/tpaconfig)
Set up the plugin without opening a single file:
- Settings: countdown, cooldown, request timeout, safe teleport, worlds and more. Click to change, saved instantly
- Messages: pick a section (requests, teleports, commands, menus…), click any message and type the new text in chat
- Animations: turn on or off, preview, set the default
- Languages: switch language instantly, no restart
- Logs: browse every player's TPA history (see below)
Activity log
Someone says "he teleported to my base without asking"? Check it in seconds.
- Open
/tpaconfig → Logs and pick a player (search by name if you have many)
- Choose Requests sent, Requests received or Teleports
- Every entry shows the details:
| List |
What you see |
| Requests sent |
Time, who it was sent to, /tpa or /tpahere, and how it ended |
| Requests received |
Time, who sent it, /tpa or /tpahere, and how it ended |
| Teleports |
Time, the other player, world and coordinates |
Possible outcomes: accepted, denied, cancelled, expired or pending.
Logs are saved to plugins/SimpleTpa/logs/ without slowing down the server. In config.yml you choose whether to keep them (logs.enabled), how many entries per player (logs.max-entries-per-player) and for how many days (logs.retention-days, 0 = forever). All the texts, including the date format, can be changed like any other message.
Make it yours
- Messages support colours, gradients and hover text (MiniMessage)
- Colour theme: change 4 colours in
config.yml and every message follows
- Sounds and particles for every event, each one can be changed or turned off
- Languages: English and Italian included. To add one, copy
languages/en.yaml, translate it, and it shows up in the admin menu. Lines you didn't translate stay in English
Commands
| Command |
What it does |
/tpa [player] |
Ask to teleport to a player |
/tpahere [player] |
Ask a player to come to you |
/tpaccept [player] |
Accept a request |
/tpdeny [player] |
Deny a request |
/tpacancel |
Cancel the request you sent |
/tpatoggle |
Stop (or allow again) all incoming requests |
/tpaignore [player] |
Ignore (or stop ignoring) a player |
/tpamenu |
Open your personal settings |
/tpaconfig |
Open the admin settings and logs (admins only) |
/tpareload |
Reload the configuration (admins only) |
Permissions
Players can use all the basic commands by default. Admins (op) get everything else.
| Permission |
What it gives |
Default |
simpletpa.tpa, simpletpa.tpahere, simpletpa.tpaccept, simpletpa.tpdeny, simpletpa.tpacancel, simpletpa.tpatoggle, simpletpa.tpaignore, simpletpa.menu |
Basic commands and player menu |
Everyone |
simpletpa.gui |
Admin menu and logs |
Op |
simpletpa.admin.reload |
/tpareload |
Op |
simpletpa.animation.[name] |
Unlock an animation (classic is free for everyone) |
Op |
simpletpa.bypass.cooldown |
No waiting between requests |
Op |
simpletpa.bypass.warmup |
Teleport instantly, no countdown |
Op |
simpletpa.bypass.world |
Teleport between worlds even when it's disabled |
Op |
simpletpa.bypass.toggle |
Send requests to players who disabled them |
Op |
Animation names: classic, spiral, double-helix, rings, vortex, halo, orb.
Installation
- Put
SimpleTpa-3.2.0.jar in your plugins folder
- Restart the server
- Done! Change settings in game with
/tpaconfig, or edit plugins/SimpleTpa/config.yml and run /tpareload
Language: English by default. To switch to Italian: /tpaconfig → Languages, or set language: it in config.yml.
Updating from version 2 (old users, please read)
Version 3 is a complete rewrite. Updating is easy:
- Make sure your server runs Paper 1.21 or newer
- Replace the old jar with the new one and restart
What changes for you:
- Your old
config.yml is saved as config-v2-backup.yml and a new one is created. If you had custom messages, copy them again (now you can do it in game with /tpaconfig).
- Teleporting between worlds is now allowed by default (it was always blocked before). To block it again:
allow-cross-world: false.
- Default cooldown is now 30 seconds (was 20).
- Permissions from v2.3 still work (
simpletpa.tpa, simpletpa.tpaccept, simpletpa.tpdeny). Very old v2.2 permissions (tpa.tpa…) are no longer used.
- Admins (op) still skip the cooldown, and now also skip the countdown.
Using EssentialsX or CMI?
They also have a /tpa command. SimpleTpa loads first, so /tpa, /tpaccept and the others use SimpleTpa automatically. The other plugin's command is still available as /essentials:tpa.
SimpleTpa sends anonymous usage statistics to bStats. You can turn them off in plugins/bStats/config.yml.
Need help? Join the Discord!
- ?️ Support forum: open a post tagged Bug or Question and get help fast
- ? Feature requests: suggest ideas and see what's coming next
- ? Announcements: be the first to know about new releases
- ? FAQ and docs: setup, commands, permissions and common fixes
When asking for help, please include your SimpleTpa version, your server version (/version) and any console errors.
You can also leave a comment here, but Discord is the fastest way to get an answer.
评论 0
登录后参与评分
还没有评论,来抢沙发吧