StayPut Remixed - ：重返世界时返回原位

简介

StayPut Remixed 是一款专为 Multiverse 多世界插件设计的辅助工具。它解决了玩家在多世界间传送时，总是被传送到目标世界出生点的问题。插件会记录玩家在每个世界的最后位置，并在返回该世界时自动传送回该位置，让玩家能够无缝继续之前的探索。

💡核心功能

• 自动记录玩家在每个 Multiverse 世界的最后位置。
• 当玩家返回一个世界时，自动将其传送至上次离开的位置，而非世界出生点。
• 支持多种数据库后端，包括 MariaDB、MySQL 和 SQLite。
• 提供调试模式，帮助排查传送问题。

🎮安装与要求

前置需求

• 服务器需安装 Multiverse-Core 插件。
• 玩家需要拥有 stayput.use 权限才能被记录位置。

安装步骤

• 从发布页面下载最新版本的 StayPutRemixed.jar。
• 将文件放入服务器的 plugins 文件夹。
• 重启服务器以生成配置文件和数据文件。

数据库配置

• 插件默认使用 SQLite，数据文件将保存在 plugins/StayPut 目录下。
• 如需使用 MySQL 或 MariaDB，请在生成的 config.yml 文件中配置数据库连接信息。

🔧命令与权限

可用命令

• /stayput reload - 重载插件配置文件。

-   需要权限：`stayput.admin`

权限节点

• stayput.use - 允许插件记录并应用玩家的位置。必须授予需要此功能的玩家或用户组。
• stayput.admin - 允许使用 /stayput reload 命令。

❓常见问题：为何仍被传送到出生点？

如果玩家返回世界时仍被传送到出生点，通常是因为另一个插件（非 Multiverse）控制了世界的出生点位置。

排查步骤

• 在 config.yml 中开启 debug 模式。
• 让玩家进行一次跨世界传送，并观察服务器控制台输出。
• 你可能会看到类似下方的日志，表明插件检测到的目标位置与世界出生点不匹配。

[StayPut] PlayerName: world1 --> world2
[StayPut] Not redirecting teleport because the destination appears to be a specific location in the world.
[StayPut] Location{world=CraftWorld(name=world2),x=0.5,y=135.0,z=0.5,pitch=0.0,yaw=-180.0} != Location{world=CraftWorld(name=null),x=0.0,y=135.0,z=0.0,pitch=0.0,yaw=0.0}

解决方案

你需要确保 Multiverse 设置的出生点与其他插件设置的出生点完全一致。

• 在游戏中，将角色移动到你想设为出生点的精确位置和视角。
• 执行 /mv set spawn 命令设置 Multiverse 的出生点。
• 保持角色位置和视角不动，执行其他插件的命令来设置其出生点。
• 传送到其他世界再返回测试。检查控制台日志，确认插件现在是否能正确识别。

⭐技术说明

Spigot API 本身无法区分“传送到世界的特定位置”（例如跨世界的 /tp 命令）和“传送到世界（无指定位置）”（例如 /mv tp 命令）。因此，StayPut 需要通过检查玩家是否被传送到该世界的出生点，来判断是否应将其重定向到上次记录的位置。

当其他插件设置了不同的出生点时，就会导致 Spigot/Multiverse 报告的出生点与实际传送目的地不一致，从而引发上述问题。

✨支持与反馈

遇到问题或有功能建议？

• 可以在本插件讨论区留言。
• 也可以在 GitHub 仓库提交 Issue。
• 或加入 Discord 社区寻求帮助：https://discord.gg/ZRzpwRhnAa

当前版本： v3.0.0

支持MC版本： 1.18 - 1.21+