MineTP

MineTP — 传送石与传送柱

建造你自己的快速旅行网络。寻找远古石柱。随身携带卷轴以备不时之需。

MineTP 为 Minecraft 添加了一套完整的、对服务器友好的快速旅行系统：可合成并自行命名的传送石、自然生成于各个维度的宏伟极乐传送柱，以及让你从任何地方一键回家的一次性传送卷轴。所有内容均在服务端验证，管理员可自由配置，专为保持多人世界稳定而打造。

特性

传送石

一座高耸发光的方尖碑，你可以合成并放置在任何想要设立旅行点的地方。

• 右键激活。传送石会加入你的个人网络，并获得一个自动生成的村庄风格名称——Riverwood、Ebonreach、Stonehollow、Frosthaven 等等，数以百计。
• 再次右键打开传送菜单。
• 可共享或保持私有。作为拥有者，你可以将传送石切换为全局，让每位发现它的玩家都能前往。切换回来后，访客立即失去访问权限。
• 可通过菜单中的 [R] 按钮重命名，或用命名过的命名牌右键点击（命名牌会被消耗）。
• 受保护：只有拥有者或管理员才能破坏它。
• 两格高，发出满级光照，放置和使用时喷出紫色末地粒子。

极乐传送柱

一座 3x3、五格高的水晶塔，自然生成——散布在世界各处的免费公共旅行点。

• 始终公开，无归属。任何人都可以发现并使用。没有人可以认领、重命名或转换它。
• 不占用你的个人传送石配额。如果管理员限制了每位玩家可拥有的传送石数量，传送柱不受限制。
• 生成于主世界、下界和末地。
• 真正分散：每个 40x40 区块单元生成一座传送柱——平均相隔约 640 格——任意两座之间的最小距离保证为 515 格。每个单元内的锚点由世界种子决定，因此布局看似随机但从不聚集，且相同种子下布局完全一致。
• 每座主世界村庄保证生成一座传送柱，放置在村庄旁边，绝不放在村庄内部。模组会清理草、花、蕨类、树苗、原木和树叶，平整 3x3 地基，并用周围自然方块填补深达两格的坑洞。它绝不会建在房屋、道路、农田、水井、箱子、床、工作站或水面之上——如果位置不够干净，它会直接尝试其他地方。
• 定位闪电：传送柱偶尔会被闪电击中——真实的闪光、真实的雷声，零伤害零着火。这是为了让你在夜晚能从远处发现传送柱。仅当附近有玩家时才会触发，管理员可以调整或关闭它。
• 仅限创造模式移除。传送柱在生存模式下无法被挖掘，即使是管理员也不行，因此公共旅行点不会在共享服务器上消失。
• 各维度地形要求：主世界需要露天且地面为泥土、草方块、石头、雪或沙子；下界需要下界岩、玄武岩或黑石；末地需要露天且地面为末地石。

传送卷轴

一张一次性羊皮纸，专为你在洞穴深处且背包已满时准备。

• 在任何地方右键——无需传送石——即可打开你的目的地列表。
• 选择一个目的地，旅行，卷轴化为尘埃。
• 只有在你实际旅行时才会消耗。关闭菜单、触发冷却、选择已不存在的目的地，或未通过安全着陆检查，卷轴都会留在你手中。
• 创造模式下永不消耗。
• 卷轴本身就是费用：卷轴旅行不消耗经验（管理员可更改此设置）。
• 可堆叠至 16 个。

合成配方

传送石 — 3 个末影珍珠 + 3 个黑曜石 -> 1 个传送石

[       ] [ 珍珠 ] [       ]
[ 珍珠 ] [       ] [ 珍珠 ]
[ 黑曜 ] [ 黑曜 ] [ 黑曜 ]

传送卷轴 — 8 张纸 + 1 个末影珍珠 -> 2 个传送卷轴

[   纸   ] [   纸   ] [   纸   ]
[   纸   ] [ 珍珠 ] [   纸   ]
[   纸   ] [   纸   ] [   纸   ]

极乐传送柱没有配方——它仅通过世界生成出现。管理员可以从创造模式标签页或使用命令放置一座。

传送菜单

• 可滚动列表，支持鼠标滚轮。
• 三种视图：全部传送点 / 我的传送点 / 全局传送点。
• 按距离或按名称排序。
• 颜色标记：青色 [P] 你自己的，黄色 [G] 公开的，品红色 [N] 自然传送柱，橙色 [?] 尚未索引的旧发现。
• 每行显示维度和距离，颜色编码：绿色主世界，红色下界，紫色末地。超过 1000 格后距离切换为千米。
• 在确认前显示每个目的地的经验消耗——“免费”或“消耗：N 等级”。
• 左键点击某行进行传送。右键点击你自己的传送石可切换全局状态。[G] 和 [R] 按钮仅在你拥有的传送石上显示。
• 实时更新：菜单打开时每两秒刷新一次，因此如果其他玩家重命名了传送石或将其设为私有，你会立即看到——且无需加载任何远程区块。
• 完全本地化：英语加 13 种西班牙语本地化（es_es、es_419、es_mx、es_co、es_ar、es_cl、es_pe、es_ve、es_ec、es_bo、es_uy、es_py、es_do）。

旅行规则

• 跨维度旅行开箱即用。
• 经验消耗随距离变化（默认模式）：128 格以内免费，1000 格以内消耗 1 级，2000 格以内消耗 2 级，3000 格以内消耗 3 级，更远或跨维度消耗 5 级。创造和旁观模式始终免费旅行。管理员可以将整个系统切换为免费。
• 旅行间隔冷却，默认 5 秒。
• 你会落在传送石旁边，绝不会落在其顶部。在生存模式下，模组会寻找安全落点——坚固地面、无流体、下方无岩浆块、营火或仙人掌——如果没有安全落点则拒绝传送。创造和旁观模式可以落在任何地方。
• 坐标、世界边界和碰撞在移动前都会进行验证。

为服务器打造

• 服务端是唯一权威。发现、权限、全局切换、重命名、保护和传送本身全部在服务端决定。修改过的客户端无法前往它从未发现的目的地、认领传送柱或伪造传送卷轴。
• 传送队列：每 tick 最多处理 2 次传送，最多 8 次待处理，因此一群玩家同时跳跃不会导致区块加载激增。玩家不能重复排队同一行程，断开连接会取消排队。
• 每位玩家的反刷屏限制：每 2 秒 4 次打开列表、8 次编辑和 4 次传送请求。
• 目的地列表从不加载远程区块。元数据存储在每个世界的索引中，因此即使你的网络跨越数千格，打开菜单也不产生任何开销。实际方块仍会在你传送的那一刻进行验证。
• 低成本空闲：附近无人的传送柱每 tick 仅消耗一次整数比较，且不产生网络流量。
• 每个世界独立数据。发现、目的地索引和村庄状态以世界 SavedData 存储，因此不同世界永不混淆。
• 玩家名称与 UUID 一同缓存，因此离线玩家永远不会显示为原始 UUID。

配置

config/minetp.json，全部可在游戏内通过 /minetp config set <字段> <值> 编辑。

字段	默认值	说明
teleportCostMode	xp	'xp' 为基于距离的消耗，'free' 为无消耗
teleportCooldownSeconds	5	旅行间隔冷却
maxWaystonesPerPlayer	0	个人传送石上限；0 表示无限制
pillarSpacingOverworld	40	主世界自然传送柱的单元大小（区块，0 禁用）
pillarSpacingNether	40	同上，用于下界
pillarSpacingEnd	40	同上，用于末地
pillarMinDistance	500	传送柱之间保证的最小距离（格）
villagePillars	true	每座主世界村庄保证一座传送柱
scrollFreeTravel	true	传送卷轴为其自身行程付费（无经验消耗）
pillarLightning	true	传送柱上的装饰性定位闪电
pillarLightningSeconds	120	同一传送柱上闪电之间的平均秒数
pillarLightningRadius	48	仅当玩家在此距离内时才触发闪电

传送柱间距在世界生成时读取，因此更改它仅影响新生成的区块。

命令

所有命令需要权限等级 2（管理员）。

命令	说明
/minetp give [player]	给予一个传送石物品
/minetp config get	显示当前配置
/minetp config set <field> <value>	更改一项设置并保存
/minetp config reload	从磁盘重新加载配置
/minetp pillar spawn	在你站立的位置放置一座自然传送柱
/minetp pillar remove	完全移除附近的传送柱
/minetp pillar count	统计玩家附近已加载区块中的传送柱数量
/minetp pillar strike	立即触发一道定位闪电，预览效果
/minetp village status	已有传送柱的村庄数量
/minetp village here	在此区块强制尝试生成村庄传送柱
/minetp index rebuild	索引已加载区块中的传送石
/minetp data import-legacy	从旧版 JSON 文件导入发现记录

/minetp data import-legacy 将已有的 config/minetp_players.json 迁移到当前世界。原始文件保持不变，备份写入世界文件夹。

创造模式标签页

MineTP 注册了自己的创造模式标签页。

• 传送石和传送卷轴——任何玩家均可使用。
• 极乐传送柱——仅限管理员。它在启用了“管理员物品标签页”选项的创造模式下对管理员（权限等级 2）显示，与原版用于命令方块和屏障的权限门槛相同。放置主方块即可：结构会在下一个 tick 自行完成。

兼容性

• Minecraft 1.21.1，NeoForge 21.1.233 或更新版本。
• Java 21。
• 适用于单人和专用服务器。
• 无依赖项。
• 客户端和服务端必须运行相同版本的模组（网络协议 5）。
• 无 mixin，无核心模组，不替换任何原版行为。村庄生成、结构和地形均保持不变——村庄传送柱放置在村庄旁边，不会修改村庄本身。

注意事项

• 这是早期版本。欢迎反馈和错误报告。
• 自然传送柱仅出现在新生成的区块中。已有世界会在你探索到新地形时获得它们，村庄会在其区块加载时获得传送柱。
• 未经许可，请勿重新分发本模组或将其包含在整合包中。