🔒 Only TP
English | 中文
A server-side command limiter for Minecraft: let your players use teleport commands only, or block every non-teleport command — without giving them operator rights.
📖 What it does
| Mode | Effect |
|---|---|
| Allow TP only | Regular players may use teleport commands. Everything else stays vanilla. |
| Block non-TP | Teleport commands are allowed for everyone; every other command is blocked. Operators can be given an extra command whitelist. |
| Enable both | Both rules apply at once, each with its own exemption list. |
| Disable mod | No restriction at all. |
- 🚫 Blocked commands answer with a red
Only TP: This command has been disabled! - 🎮 Blocked game-mode switching shows its own red notice.
- ⭐ Every mode has its own exemption list — players on it are never restricted.
- 🎯 Optional target selectors (
@a,@p, …) for restricted players, switchable.
🚀 Installing
- Put the jar into your server's
modsfolder (Forge, NeoForge or Fabric). - Start the server once.
config/onlytp-common.tomlandconfig/onlytp-client.tomlare created automatically. - Edit the file, or use the in-game editor (below).
- Pick a mode, fill in the exemption list and — if you want one — the operator command whitelist, then save.
The mod is authoritative on the server. A client without it plays normally, it simply cannot open the editor.
🖱️ The in-game editor
Two independent entries:
- Mod list → Only TP → Config. Uses the loader's own configuration screen where one exists; otherwise it is generated by Cloth Config API, which is therefore needed on the client for that entry (1.20.x on every loader, 1.21+ on Fabric).
- Pause menu button — appears only with AvalonBase installed and opens AvalonBase's editor.
Editing requires operator permission on the server (the screen is read-only otherwise). If the server owner turns the entry off, the mod-list entry shows an "entry closed" notice and the pause button disappears.
⚙️ Configuration
Both files are plain TOML, safe to edit by hand at any time — changes apply without restarting the server.
config/onlytp-common.toml — the rules, decided on the server and sent to clients:
| Key | Meaning |
|---|---|
mode |
disabled / allow_tp_only / block_non_tp / both |
allow_entity_selectors |
Allow target selectors such as @a |
enable_config_entry |
Allow entering the visual editor (also shows the pause button when AvalonBase is present) |
mode_allow_tp_only / mode_block_non_tp |
Exemption lists of that mode |
command_whitelist |
Extra commands operators may use in "block non-TP" mode |
config/onlytp-client.toml — per-client preferences, never sent anywhere:
| Key | Meaning |
|---|---|
gui_button_style |
0 = modern look, 1 = vanilla-style buttons |
enable_animations |
Interface open/close animations |
show_tips |
1 = show the in-game tip about the editor |
💡 Good to know
- Which commands count as "teleport commands" is decided by the mod, not by the config.
- Command names are matched case-insensitively; a leading
/is ignored. - Everything is decided on the server: installing the mod on a client only adds the visual editor.
🔗 Links
- CurseForge: https://www.curseforge.com/minecraft/mc-mods/only-tp
- Modrinth: https://modrinth.com/mod/only-tp
- Source & issues: https://github.com/Huziyang520/Only-TP
- Backup feedback page: https://issue.mengcai.online/
🧩 Optional dependencies
- AvalonBase — https://www.curseforge.com/minecraft/mc-mods/avalonbase · https://modrinth.com/mod/avalonbase — adds the pause-menu editor.
- Cloth Config API — https://www.curseforge.com/minecraft/mc-mods/cloth-config · https://modrinth.com/mod/cloth-config — required on the client for the mod-list config entry where the loader has no native screen.
📄 License
MIT — Huziyang520
English | 中文
🔒 Only TP
一个 Minecraft 服务端的指令限制模组：让玩家只能使用传送类指令，或者禁止所有非传送指令 —— 不需要给他们管理员权限。
📖 它做什么
| 模式 | 效果 |
|---|---|
| 非OP玩家仅允许TP指令 | 普通玩家可以使用传送类指令，其它指令保持原版行为。 |
| OP玩家禁止非TP指令 | 所有人都能用传送类指令；其它指令一律禁止。管理员可以额外配一份命令白名单。 |
| 同时启用 | 两套规则同时生效，各自带独立的豁免名单。 |
| 关闭模组功能 | 完全不做限制。 |
- 🚫 被拦截的指令会收到红字
Only TP: 该指令已被禁止！ - 🎮 被拦截的游戏模式切换会显示对应的提示。
- ⭐ 每个模式都有自己的豁免名单：名单里的玩家完全不受限制。
- 🎯 受控玩家是否可用
@a、@p这类目标选择器，可单独开关。
🚀 安装
- 把 jar 放进服务端的
mods文件夹（Forge / NeoForge / Fabric）。 - 启动一次服务端，会自动生成
config/onlytp-common.toml与config/onlytp-client.toml。 - 直接改文件，或使用游戏内编辑界面（见下）。
- 选好模式、填好豁免名单（需要的话再配管理员命令白名单），保存即可。
判定完全在服务端。客户端不装也能正常玩，只是打不开编辑界面。
🖱️ 游戏内编辑界面
两个互相独立的入口：
- 模组列表 → Only TP → 配置。加载器自带配置界面时就用自带的；否则由 Cloth Config API 生成，所以该入口在客户端需要 Cloth（1.20.x 全加载器、1.21+ 的 Fabric 端）。
- 暂停菜单按钮 —— 只在装了 AvalonBase 时出现，打开的是 AvalonBase 的编辑界面。
编辑需要在服务端拥有管理员权限（否则界面只读）。服主关闭入口后，模组列表入口只显示「入口已关闭」提示，暂停菜单按钮也不再出现。
⚙️ 配置文件
两个文件都是纯 TOML 文本，随时可以手改，改动无需重启服务端即可生效。
config/onlytp-common.toml —— 规则，由服务端判定并下发给客户端：
| 键 | 含义 |
|---|---|
mode |
disabled / allow_tp_only / block_non_tp / both |
allow_entity_selectors |
是否允许 @a 这类目标选择器 |
enable_config_entry |
是否允许进入可视化配置界面（装了 AvalonBase 时也决定暂停按钮） |
mode_allow_tp_only / mode_block_non_tp |
对应模式的豁免玩家名单 |
command_whitelist |
「禁止非TP指令」模式下管理员可额外使用的指令 |
config/onlytp-client.toml —— 只影响本机的偏好，不参与同步：
| 键 | 含义 |
|---|---|
gui_button_style |
0 = 现代风格，1 = 原版风格按钮 |
enable_animations |
界面开/关动画 |
show_tips |
1 = 进世界时提示一次编辑界面的用法 |
💡 使用须知
- 哪些指令算「传送类指令」由模组内置决定，不需要在配置里写。
- 指令名不区分大小写，开头的
/会被忽略。 - 所有判定都在服务端完成；客户端装本模组只是为了拿到可视化编辑界面。
🔗 相关链接
- CurseForge：https://www.curseforge.com/minecraft/mc-mods/only-tp
- Modrinth：https://modrinth.com/mod/only-tp
- 源码与问题反馈：https://github.com/Huziyang520/Only-TP
- 备用反馈地址：https://issue.mengcai.online/
🧩 可选前置
- AvalonBase —— https://www.curseforge.com/minecraft/mc-mods/avalonbase · https://modrinth.com/mod/avalonbase —— 提供暂停菜单编辑界面。
- Cloth Config API —— https://www.curseforge.com/minecraft/mc-mods/cloth-config · https://modrinth.com/mod/cloth-config —— 加载器没有自带配置界面时，客户端打开模组列表配置入口需要它。
📄 许可证
MIT —— Huziyang520
No gallery available for this project.
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
Only TP 1.7.0 (Fabric) for Minecraft 26.3 1.7.0 |
26.3
|
fabric
|
Download |
|
Only TP 1.7.0 (NeoForge) for Minecraft 26.3 1.7.0 |
26.3
|
neoforge
|
Download |
|
Only TP 1.7.0 (Fabric) for Minecraft 26.1-26.2 1.7.0 |
26.1, 26.1.1, 26.1.2, 26.2
|
fabric
|
Download |
|
Only TP 1.7.0 (NeoForge) for Minecraft 26.1-26.2 1.7.0 |
26.1, 26.1.1, 26.1.2, 26.2
|
neoforge
|
Download |
|
Only TP 1.7.0 (Fabric) for Minecraft 1.21.9-1.21.11 1.7.0 |
1.21.9, 1.21.10, 1.21.11
|
fabric
|
Download |
|
Only TP 1.7.0 (NeoForge) for Minecraft 1.21.9-1.21.11 1.7.0 |
1.21.9, 1.21.10, 1.21.11
|
neoforge
|
Download |
|
Only TP 1.7.0 (Fabric) for Minecraft 1.21.6-1.21.8 1.7.0 |
1.21.6, 1.21.7, 1.21.8
|
fabric
|
Download |
|
Only TP 1.7.0 (NeoForge) for Minecraft 1.21.6-1.21.8 1.7.0 |
1.21.6, 1.21.7, 1.21.8
|
neoforge
|
Download |
|
Only TP 1.7.0 (Fabric) for Minecraft 1.21.2-1.21.5 1.7.0 |
1.21.2, 1.21.3, 1.21.4, 1.21.5
|
fabric
|
Download |
|
Only TP 1.7.0 (NeoForge) for Minecraft 1.21.2-1.21.5 1.7.0 |
1.21.2, 1.21.3, 1.21.4, 1.21.5
|
neoforge
|
Download |
|
Only TP 1.7.0 (Fabric) for Minecraft 1.21-1.21.1 1.7.0 |
1.21, 1.21.1
|
fabric
|
Download |
|
Only TP 1.7.0 (NeoForge) for Minecraft 1.21-1.21.1 1.7.0 |
1.21, 1.21.1
|
neoforge
|
Download |
|
Only TP 1.7.0 (Fabric) for Minecraft 1.20.5-1.20.6 1.7.0 |
1.20.5, 1.20.6
|
fabric
|
Download |
|
Only TP 1.7.0 (NeoForge) for Minecraft 1.20.5-1.20.6 1.7.0 |
1.20.5, 1.20.6
|
neoforge
|
Download |
|
Only TP 1.7.0 (Fabric) for Minecraft 1.20.2-1.20.4 1.7.0 |
1.20.2, 1.20.3, 1.20.4
|
fabric
|
Download |
|
Only TP 1.7.0 (NeoForge) for Minecraft 1.20.2-1.20.4 1.7.0 |
1.20.2, 1.20.3, 1.20.4
|
neoforge
|
Download |
|
Only TP 1.7.0 (Fabric) for Minecraft 1.20-1.20.1 1.7.0 |
1.20, 1.20.1
|
fabric
|
Download |
|
1.7.0 (Forge) 1.20-1.20.1 1.7.0 |
1.20, 1.20.1
|
forge
|
Download |
|
1.6.3-fix |
1.21.2, 1.21.3, 1.21.4, 1.21.5
|
neoforge
|
Download |
|
1.6.3-fix |
1.21.2, 1.21.3, 1.21.4, 1.21.5
|
fabric
|
Download |
|
1.6.3 |
1.20, 1.20.1
|
forge
|
Download |
|
1.6.3 |
26.1, 26.1.1, 26.1.2, 26.2
|
neoforge
|
Download |
|
1.6.3 |
26.1, 26.1.1, 26.1.2, 26.2
|
fabric
|
Download |
|
1.6.3 |
1.21.10, 1.21.11, 1.21.9
|
neoforge
|
Download |
|
1.6.3 |
1.21.10, 1.21.11, 1.21.9
|
fabric
|
Download |
|
1.6.3 |
1.21.6, 1.21.7, 1.21.8
|
neoforge
|
Download |
|
1.6.3 |
1.21.6, 1.21.7, 1.21.8
|
fabric
|
Download |
|
1.6.3 |
1.21.2, 1.21.3, 1.21.4, 1.21.5
|
neoforge
|
Download |
|
1.6.3 |
1.21.2, 1.21.3, 1.21.4, 1.21.5
|
fabric
|
Download |
|
1.6.3 |
1.21, 1.21.1
|
neoforge
|
Download |
|
1.6.3 |
1.21, 1.21.1
|
fabric
|
Download |
|
1.6.3 |
1.20.5, 1.20.6
|
neoforge
|
Download |
|
1.6.3 |
1.20.5, 1.20.6
|
fabric
|
Download |
|
1.6.3 |
1.20.2, 1.20.3, 1.20.4
|
neoforge
|
Download |
|
1.6.3 |
1.20.2, 1.20.3, 1.20.4
|
fabric
|
Download |
|
1.6.3 |
1.20, 1.20.1
|
fabric
|
Download |
|
1.6.2 |
26.3
|
neoforge
|
Download |
|
1.6.2 |
26.3
|
fabric
|
Download |
|
1.6.1 |
26.3
|
neoforge
|
Download |
|
1.6.1 |
26.3
|
fabric
|
Download |
|
Only TP 1.6.0 1.6.0 |
26.3
|
fabric
|
Download |
|
Only TP 1.6.0 1.6.0 |
26.3
|
neoforge
|
Download |
|
1.5.6 |
26.3
|
neoforge
|
Download |
|
1.5.6 |
26.3
|
fabric
|
Download |
|
1.5.5fix |
26.3
|
neoforge
|
Download |
|
1.5.5fix |
26.3
|
fabric
|
Download |
|
Only TP 1.5.5 1.5.5 |
26.3
|
fabric
|
Download |
|
Only TP 1.5.5 1.5.5 |
26.3
|
neoforge
|
Download |
|
Only TP 1.5.5 1.5.5 |
26.2
|
fabric
|
Download |
|
Only TP 1.5.4 1.5.4 |
26.2
|
fabric
|
Download |
|
Only TP 1.5.5 1.5.5 |
26.2
|
neoforge
|
Download |
|
Only TP 1.5.4 1.5.4 |
26.2
|
neoforge
|
Download |
|
Only TP 1.5.3 1.5.3 |
26.2
|
fabric
|
Download |
|
Only TP 1.5.3 1.5.3 |
26.2
|
neoforge
|
Download |
|
Only TP 1.5.0 1.5.0 |
26.2
|
neoforge
|
Download |
|
Only TP 1.5.0 1.5.0 |
26.2
|
fabric
|
Download |
|
Only TP 1.5.0 1.5.0 |
26.1.2
|
fabric
|
Download |
|
Only TP 1.5.0 1.5.0 |
26.1.2
|
neoforge
|
Download |
|
Only TP 1.5.0 1.5.0 |
1.21.11
|
neoforge
|
Download |
|
Only TP 1.5.0 1.5.0 |
1.21.11
|
fabric
|
Download |
|
Only TP 1.5.0 1.5.0 |
1.21.8
|
neoforge
|
Download |
|
Only TP 1.5.0 1.5.0 |
1.21.8
|
fabric
|
Download |
|
Only TP 1.4.0 1.4.0 |
26.2
|
neoforge
|
Download |
|
Only TP 1.4.0 1.4.0 |
26.2
|
fabric
|
Download |
|
Only TP 1.4.0 1.4.0 |
26.2
|
neoforge
|
Download |
|
Only TP 1.4.0 1.4.0 |
26.1.2
|
neoforge
|
Download |
|
Only TP 1.4.0 1.4.0 |
26.1.2
|
fabric
|
Download |
|
Only TP 1.4.0 1.4.0 |
1.21.11
|
fabric
|
Download |
|
Only TP 1.4.0 1.4.0 |
1.21.11
|
neoforge
|
Download |
|
Only TP 1.3.1 1.3.1 |
1.21.1
|
neoforge
|
Download |
|
Only TP 1.3.1 1.3.1 |
1.21.1
|
neoforge
|
Download |
|
Only TP 1.3.1 1.3.1 |
1.21.1
|
fabric
|
Download |
|
Only TP 1.3.1 1.3.1 |
1.21.1
|
forge
|
Download |
|
Only TP 1.3.1 1.3.1 |
1.19.2
|
fabric
|
Download |
|
Only TP 1.3.1 1.3.1 |
1.19.2
|
forge
|
Download |
|
Only TP 1.3.1 1.3.1 |
1.18.2
|
fabric
|
Download |
|
Only TP 1.3.1 1.3.1 |
1.18.2
|
forge
|
Download |
|
Only TP 1.3.1 onlytp-Forge-1.3.1 |
1.20.1
|
forge, neoforge
|
Download |
|
Only TP 1.3.1 onlytp-Fabric-1.3.1 |
1.20.1
|
fabric
|
Download |
|
Only TP 1.3.0 onlytp-Fabric-1.3.0 |
1.20.1
|
fabric
|
Download |
|
Only TP 1.3.0 onlytp-Forge-1.3.0 |
1.20.1
|
forge, neoforge
|
Download |
|
Only TP 1.2.0 onlytp-Forge-1.2.0 |
1.20.1
|
forge, neoforge
|
Download |
|
Only TP 1.2.0 onlytp-Fabric-1.2.0 |
1.20.1
|
fabric
|
Download |
|
Only TP 1.0.10 Forge-1.0.10-1.20.1 |
1.20.1
|
forge
|
Download |
|
Only TP 1.1.0 Neoforge-1.1.0-1.21.1 |
1.21.1
|
neoforge
|
Download |
|
Only TP 1.1.1 Neoforge-1.1.1-26.2 |
26.2
|
neoforge
|
Download |
|
Only TP 1.1.1 Neoforge-1.1.1-26.1.2 |
26.1.2
|
neoforge
|
Download |
|
Only TP Fabric-1.0.9fix2 Fabric-1.0.9fix2 |
26.2
|
fabric
|
Download |
|
Only TP Fabric-1.0.9fix Fabric-1.0.9fix-26.2 |
26.2
|
fabric
|
Download |
|
Only TP Fabric-1.0.9 Fabric-1.0.9-26.2 |
26.2
|
fabric
|
Download |
|
Only TP Fabric-1.0.8 Fabric-1.0.8-26.2 |
26.2
|
fabric
|
Download |
|
Only TP 1.0.5.5 Neoforge-1.0.5.5-1.21.1 |
1.21.1
|
neoforge
|
Download |
|
Only TP 1.0.4.2 Forge-1.0.4.2-1.20.1 |
1.20.1
|
forge
|
Download |
|
Only TP 1.0.5.4 Neoforge-1.0.5.4-1.21.1 |
1.21.1
|
neoforge
|
Download |
|
Only TP 1.1.0 Neoforge-1.1.0-26.2 |
26.2
|
neoforge
|
Download |
|
Only TP 1.1.0 Neoforge-1.1.0-26.1.2 |
26.1.2
|
neoforge
|
Download |
|
Only TP Fabric-1.0.7 Fabric-1.0.7-26.2 |
26.2
|
fabric
|
Download |
|
Only TP Fabric-1.0.6 Fabric-1.0.6-26.1.2 |
26.1.2
|
fabric
|
Download |
|
Only TP 1.0.6 Fabric-1.0.6-1.21.11 |
1.21.11
|
fabric
|
Download |
|
Only TP Fabric-1.0.6 Fabric-1.0.6-1.21.8 |
1.21.8
|
fabric
|
Download |
|
Only TP Fabric-1.0.6 Fabric-1.0.6-1.21.1 |
1.21.1
|
fabric
|
Download |
|
Only TP Fabric-1.0.6 Fabric-1.0.6-1.20.1 |
1.20.1
|
fabric
|
Download |
|
Only TP Fabric-1.0.6 Fabric-1.0.6-26.2 |
26.2
|
fabric
|
Download |
|
Only TP 1.0.5.3 Neoforge-1.0.5.3-1.21.1 |
1.21.1
|
neoforge
|
Download |
|
Only TP 1.0.4.1 Forge-1.0.4.1-1.20.1 |
1.20.1
|
forge
|
Download |
|
Only TP 1.0.5 Neoforge-1.0.5-1.21.1 |
1.21.1
|
neoforge
|
Download |
|
Only TP 1.0.4 Forge-1.0.4-1.20.1 |
1.20.1
|
forge
|
Download |