SMPPositionSaver

插件

· 作者 fox3000foxy

SMP Position Saver – 轻量级 Bukkit 插件,可在可配置的 SMP 世界中自动保存/恢复玩家位置(YAML 存储、通配符支持、可选命令)。

0 本站下载 0 关注 更新于 8 个月前

最新 1.0.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

SMP 位置保存器

一个适用于 Minecraft 1.21.8 的 Bukkit 插件,用于在 SMP 世界中保存和恢复玩家的位置。

功能

  • 自动保存:当玩家离开 SMP 世界时保存其位置
  • 自动恢复:当玩家进入 SMP 世界时恢复上次保存的位置
  • 灵活的配置:可配置被视为 SMP 的世界列表
  • 多世界支持:同时处理多个 SMP 世界
  • YAML 存储:位置数据存储在 positions.yml 中

安装

  1. 使用 Maven 编译插件:
mvn clean package
  1. 将生成的 JAR 文件从 target/ 目录复制到服务器的 plugins/ 文件夹中。

  2. 重启服务器或重新加载插件。

配置

config.yml 文件将在插件文件夹中自动生成:

# SMP 世界配置
smp-worlds:
  - "world"
  - "world_nether"
  - "world_the_end"
  - "survival"
  - "survival_nether"
  - "survival_the_end"

# 自定义消息
messages:
  position-saved: "§a你的位置已在 {world} 中保存!"
  position-restored: "§a你已被传送至你在 {world} 中的上一个位置!"
  no-position-saved: "§c该世界没有已保存的位置。"
  config-reloaded: "§a配置已成功重载!"

# 选项
options:
  save-on-quit: true
  restore-on-join: true
  clear-on-death: true
  debug: false
  # 进入/退出 SMP 世界时执行的数据包函数
  entry-function: "datapack:functions/enter_smp"
  exit-function: "datapack:functions/exit_smp"

SMP 世界配置

在 smp-worlds 部分添加或删除世界名称,以定义哪些世界属于 SMP 组。

  • 名称可以是精确匹配,也可以使用通配符 *。例如 world_* 将匹配 world_1、world_nether 等。

选项

  • save-on-quit: 当玩家离开服务器时保存位置
  • restore-on-join: 当玩家加入服务器时恢复位置
  • clear-on-death: 当玩家在 SMP 世界中死亡时清除已保存的坐标
  • debug: 启用调试日志

工作原理

当玩家进入 SMP 世界时:

  1. 插件检查该玩家在此世界中是否保存了位置
  2. 如果存在,则将玩家传送至上一次保存的位置
  3. 否则,会发送一条消息告知他们当前没有可用位置

当玩家离开 SMP 世界时:

  1. 插件自动保存玩家的当前位置
  2. 记录坐标(x, y, z)、方向(yaw, pitch)和世界名称
  3. 发送一条消息确认保存成功

数据存储

位置数据保存在 plugins/SMPPositionSaver/positions.yml 中,结构如下:

players:
  <player-uuid>:
   <world-name>:
    x: 123.45
    y: 64.0
    z: -456.78
    yaw: 90.0
    pitch: 0.0

权限

  • smppositionsaver.use: 允许使用位置保存系统(默认:true)

命令

  • /smp: 将玩家传送至配置文件中定义的 SMP 坐标。
  • /smp reload: 重载配置文件;需要权限 smp.reload(默认为 op)。

此命令并非正常运行所必需,但在编辑 config.yml 后无需重启服务器时非常有用。

兼容性

  • Minecraft: 1.21.8
  • API: Spigot/Paper 1.21+
  • Java: 21+

开发

插件包含以下组件:

  • SMPPositionSaver: 主插件类
  • ConfigManager: 配置管理器
  • PositionManager: 玩家位置管理器
  • PlayerWorldChangeListener: 监听世界变更事件
  • PlayerPosition: 表示已保存位置的模型

支持

如有任何问题或故障,请查看服务器日志或在配置中启用调试模式。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源