SimpleTP
家园、传送点、TPA、/back、RTP 和出生点,配备简洁的库存菜单。所有设置均位于一个带有注释的 config.yml 中。
SimpleTP 是一款轻量级的 Paper 服务器传送插件,旨在提供类似 Essentials 风格的传送系统功能,且没有臃肿的代码。它完全异步运行,自动迁移数据,并允许你关闭或自定义任何部分。
功能特性
家园 (Homes)
- 分页家园菜单:左键点击进行传送,右键点击可重命名、更改图标、移动或删除(需确认)
- 基于权限的家数量限制:
simpletp.homes.10、命名组(如 simpletp.homes.vip)或无限制
- 使用不带名称参数的
/home 命令将传送至你的默认或唯一家园
传送点 (Warps)
- 带有分类(商店、活动等)的传送点菜单,支持可配置的图标和描述
- 管理员可在游戏内编辑传送点:图标(选择现有图标或使用手中物品)、分类、描述、权限、位置
- 可选的单个传送点权限
TPA (玩家间传送请求)
- 支持
/tpa、/tpahere、/tpaall 以及聊天中的可点击 [接受] [拒绝] 按钮
- 带有头像的玩家选择菜单,以及包含接受、拒绝、全部接受和全部拒绝功能的传入请求菜单
- 支持多个传入请求、请求超时机制及
/tpatoggle
- 个人设置:接收请求、自动拒绝、声音效果
传送机制
- 预热时间:动作栏倒计时,移动或受到伤害时取消传送
- 按命令设置的冷却时间和费用(需 Vault,可选)
- 安全传送:永远不会让玩家落在岩浆、虚空或方块内部,而是寻找最近的安全位置
/back 返回上一个位置以及死亡地点
/rtp 支持按世界设置半径、世界边界感知及安全位置搜索(支持下界)
/spawn 出生点传送、首次加入时的出生点传送、在没有床的情况下重生在出生点
- 按世界规则:例如禁止在下界设置家园,或禁止传送到活动世界
完全可配置
- 每个命令均可启用或禁用,重新分配权限并重命名别名。禁用的命令会自动从菜单中消失。
- 切换各个系统:GUI、预热时间、冷却时间、/back、RTP、经济系统、声音、粒子效果、TPA 超时、安全传送、世界规则
- 声音和粒子效果可按操作单独设置(或设为
none)
- GUI 布局:标题、大小、槽位、材质、自定义模型数据(资源包)、填充物、可见按钮
- 多语言支持:所有文本均位于语言文件中,支持 MiniMessage 格式。可添加自定义语言,或让玩家显示其客户端语言。
- 执行
/simpletp reload 即可实时应用更改。错误的值绝不会导致插件崩溃:它们会回退到默认值并给出清晰警告。
- 配置文件在升级时自动更新,同时保留你的值和注释。
底层架构稳固
- 异步数据库:内置 H2,或用于网络服务器的 MySQL/MariaDB,使用 HikariCP 连接池
- 菜单已针对 Shift 点击、拖拽、数字键和双击等漏洞进行了防护
- 兼容 Folia 调度
- 自动从 SimpleTP 1.x 迁移,并在迁移前创建备份
支持版本
| 服务器类型 |
状态 |
| Paper 1.21.4 - 1.21.11 |
支持 |
| Folia 1.21.4+ |
支持 |
| Purpur, Pufferfish 及其他 Paper 分支 |
支持 |
| Paper 1.21 - 1.21.3 |
不支持 |
| Spigot / Bukkit |
不支持(需要 Paper API) |
依赖要求
- Paper 1.21.4 或更高版本(或 Paper 分支)
- Java 21 或更高版本
- 可选: Vault 和经济类插件以支持传送费用
命令列表
| 命令 |
描述 |
/home [name] |
传送至家园 |
/sethome [name] |
设置或移动家园 |
/delhome <name> |
删除家园 |
/homes |
打开家园菜单 |
/tpa [player] |
请求传送至某玩家(不指定玩家则打开选择器) |
/tpahere <player> |
邀请某玩家来到你身边 |
/tpaccept [player] |
接受请求 |
/tpdeny [player] |
拒绝请求 |
/tpacancel [player] |
取消你发出的传出请求 |
/tpatoggle |
开启或关闭传入请求 |
/tpaall |
邀请所有人来到你身边(管理员) |
/warp [name] / /warps |
使用传送点 / 打开传送点菜单 |
/setwarp <name> [category] |
创建或移动传送点(管理员) |
/delwarp <name> |
删除传送点(管理员) |
/editwarp <name> |
编辑传送点(管理员) |
/spawn |
传送至出生点 |
/back |
返回上一个位置或死亡地点 |
/rtp [world] |
随机安全传送(别名 /wild) |
/tpmenu |
打开主菜单 |
/tpsettings |
个人设置 |
/tp, /tp2m |
管理员传送 |
/setnewspawn |
设置新的出生点(管理员) |
/simpletp reload |
重载配置(管理员) |
权限节点
| 权限 |
描述 |
默认值 |
simpletp.player |
所有普通玩家功能 |
所有人 |
simpletp.homes.<number> |
家园数量限制,例如 simpletp.homes.20 |
- |
simpletp.homes.<group> |
来自配置组的家园限制,例如 simpletp.homes.vip |
- |
simpletp.homes.unlimited |
无家园数量限制 |
- |
simpletp.warp.admin |
创建、编辑和删除传送点 |
op |
simpletp.admin |
使用 /tp 和 /tp2m |
op |
simpletp.tpaall |
使用 /tpaall |
op |
simpletp.setspawn |
使用 /setnewspawn |
op |
simpletp.reload |
使用 /simpletp reload |
op |
simpletp.bypass |
绕过冷却时间、预热时间、费用、世界规则和 TPA 开关 |
op |
每个命令的权限节点均可在 config.yml 中更改。
从 1.x 版本升级
替换 jar 文件并重启服务器。家园数据、配置值和自定义消息将自动迁移,备份将写入 plugins/SimpleTP/backups/ 目录。
更新日志 - 2.0.0
新增功能
- GUI 菜单:主菜单、家园菜单、带分类的传送点菜单、TPA 玩家选择器、传入请求菜单、设置菜单
- 新增传送点功能、
/back(包括死亡地点)、/rtp、/spawn、/tpaall、/tpsettings、/tpmenu
- 冷却时间、Vault 费用、安全传送、按世界规则、粒子效果、MySQL 支持、多语言支持
- 每个命令和功能均可切换、重新分配权限和设置别名
- 支持带验证的实时重载,配置文件自动更新
已修复
messages.yml 中存在重复的 tpa: 部分,导致 TPA 消息被隐藏
- 第二个 TPA 请求会覆盖第一个请求
- 家名可能导致聊天格式注入漏洞
/tpatoggle 在重启后被重置
已更改
- 采用异步 HikariCP 数据库层、兼容 Folia 的计划任务调度,并移除已废弃 API 的使用
SimpleTP
Homes, warps, TPA, /back, /rtp and spawn, with clean inventory menus. Every setting lives in one commented config.yml.
SimpleTP is a lightweight teleport plugin for Paper servers that want everything an essentials-style teleport system offers, without the bloat. It runs fully async, migrates its own data, and lets you switch off or re-shape any part of it.
Features
Homes
- Paginated homes menu: left-click to teleport, right-click to rename, change icon, move or delete (with confirmation)
- Home limits by permission:
simpletp.homes.10, named groups (simpletp.homes.vip) or unlimited
/home without a name goes to your default or only home
Warps
- Warps menu with categories (Shops, Events, ...), configurable icons and descriptions
- Admins edit warps in-game: icon (pick one or use the item in hand), category, description, permission, location
- Optional per-warp permissions
TPA
/tpa, /tpahere, /tpaall and clickable [Accept] [Deny] buttons in chat
- Player picker menu with heads, plus an incoming-requests menu with accept, deny, accept all and deny all
- Multiple incoming requests, request timeout,
/tpatoggle
- Personal settings: receive requests, auto-deny, sounds
Teleporting
- Warmup with an action bar countdown that cancels when you move or take damage
- Per-command cooldowns and costs (Vault, optional)
- Safe teleport: never lands players in lava, the void or inside blocks, and finds the nearest safe spot instead
/back to your previous location and death location
/rtp with per-world radius, world border awareness and safe-spot search (nether supported)
/spawn, first-join spawn, respawn at spawn without a bed
- Per-world rules: for example no homes in the nether, or no teleporting into an event world
Fully configurable
- Every command can be enabled or disabled, re-permissioned and aliased. Disabled commands disappear from the menus automatically.
- Toggle every system: GUI, warmup, cooldowns, /back, RTP, economy, sounds, particles, TPA timeout, safe teleport, world rules
- Sounds and particles per action (or
none)
- GUI layouts: titles, sizes, slots, materials, custom model data (resource packs), filler, visible buttons
- Languages: every text is in a language file with MiniMessage support. Add your own language or let players see their client language.
/simpletp reload applies changes live. Bad values never crash the plugin: they fall back to defaults with a clear warning.
- The config updates itself on upgrades and keeps your values and comments.
Solid under the hood
- Async database: H2 built in, or MySQL/MariaDB for networks, with HikariCP
- Menus are protected against shift-click, drag, number-key and double-click exploits
- Folia compatible scheduling
- Automatic migration from SimpleTP 1.x, with backups made first
Supported versions
| Server |
Status |
| Paper 1.21.4 - 1.21.11 |
Supported |
| Folia 1.21.4+ |
Supported |
| Purpur, Pufferfish and other Paper forks |
Supported |
| Paper 1.21 - 1.21.3 |
Not supported |
| Spigot / Bukkit |
Not supported (needs the Paper API) |
Requirements
- Paper 1.21.4 or newer (or a Paper fork)
- Java 21 or newer
- Optional: Vault and an economy plugin for teleport costs
Commands
| Command |
Description |
/home [name] |
Teleport to a home |
/sethome [name] |
Set or move a home |
/delhome <name> |
Delete a home |
/homes |
Open the homes menu |
/tpa [player] |
Request to teleport to a player (no player opens the picker) |
/tpahere <player> |
Ask a player to come to you |
/tpaccept [player] |
Accept a request |
/tpdeny [player] |
Deny a request |
/tpacancel [player] |
Cancel your outgoing requests |
/tpatoggle |
Turn incoming requests on or off |
/tpaall |
Ask everyone to come to you (admin) |
/warp [name] / /warps |
Use warps / open the warps menu |
/setwarp <name> [category] |
Create or move a warp (admin) |
/delwarp <name> |
Delete a warp (admin) |
/editwarp <name> |
Edit a warp (admin) |
/spawn |
Teleport to spawn |
/back |
Return to your previous or death location |
/rtp [world] |
Random safe teleport (alias /wild) |
/tpmenu |
Open the main menu |
/tpsettings |
Personal settings |
/tp, /tp2m |
Admin teleport |
/setnewspawn |
Set the spawn (admin) |
/simpletp reload |
Reload the config (admin) |
Permissions
| Permission |
Description |
Default |
simpletp.player |
All normal player features |
everyone |
simpletp.homes.<number> |
Home limit, e.g. simpletp.homes.20 |
- |
simpletp.homes.<group> |
Home limit from a config group, e.g. simpletp.homes.vip |
- |
simpletp.homes.unlimited |
No home limit |
- |
simpletp.warp.admin |
Create, edit and delete warps |
op |
simpletp.admin |
/tp and /tp2m |
op |
simpletp.tpaall |
/tpaall |
op |
simpletp.setspawn |
/setnewspawn |
op |
simpletp.reload |
/simpletp reload |
op |
simpletp.bypass |
Bypass cooldowns, warmups, costs, world rules and TPA toggles |
op |
Every command's permission node can be changed in config.yml.
Upgrading from 1.x
Replace the jar and restart. Homes, config values and custom messages are carried over automatically, and backups are written to plugins/SimpleTP/backups/.
Changelog - 2.0.0
New
- GUI menus: main, homes, warps with categories, TPA player picker, incoming requests, settings
- Warps,
/back (including death location), /rtp, /spawn, /tpaall, /tpsettings, /tpmenu
- Cooldowns, Vault costs, safe teleport, per-world rules, particles, MySQL support, multiple languages
- Every command and feature can be toggled, re-permissioned and aliased
- Live reload with validation, self-updating config
Fixed
- A duplicate
tpa: section in messages.yml hid the TPA messages
- A second TPA request overwrote the first one
- Home names could inject chat formatting
/tpatoggle was reset on restart
Changed
- Async HikariCP database layer, Folia-compatible scheduling, no deprecated API usage
评论 0
登录后参与评分
还没有评论,来抢沙发吧