VanillaPoints

插件

· 作者 Lazarrew

轻量级插件,提供出生点、家和传送点的命令,无需使用 /tp。易于配置且无依赖。

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

最新 1.4.0 · 26.2 · Bukkit / Paper

一键开服(送7天)

VanillaPoints

VanillaPoints 是一款轻量级的 Paper 插件,适用于私人生存服务器。它允许玩家保存并查看出生点、家坐标和传送点坐标,但不提供传送功能,从而保留原版风格的导航体验。

要求

  • Paper API 1.21+
  • Java 21+
  • Maven(用于从源代码构建)

功能

  • 无传送功能,仅显示坐标。
  • 点击显示的坐标可将其复制到剪贴板。
  • 使用 data.yml 进行 YAML 存储。
  • 支持可选的 SQLite 和 MySQL 存储后端。
  • 命令/API 变更采用异步持久化队列。
  • 使用 data.yml.tmp 和 data.yml.bak 实现更安全的保存机制。
  • 提供公开的 Bukkit ServicesManager API 以及可取消的点事件。
  • 消息内容可配置,内置英文和俄文翻译。
  • 复制格式可配置。
  • 加载已保存的坐标时进行数据验证。
  • 管理员重载命令。

命令

命令 描述 权限
/spawn 显示出生点坐标。 无
/setspawn 将当前位置保存为出生点。 vanillapoints.setspawn
/home 显示你的家坐标。 无
/sethome 将当前位置保存为你的家。 无
/warp [name] 列出所有传送点(不指定名称),或显示特定传送点的坐标。 无
/warps 列出可用的传送点。 无
/setwarp <name> 将当前位置保存为传送点。 vanillapoints.setwarp
/delwarp <name> 删除一个传送点。 vanillapoints.delwarp
/vp reload 重载配置文件、消息和数据。 vanillapoints.reload

传送点名称只能包含拉丁字母、数字、下划线和连字符,长度最多为 32 个字符。

配置

config.yml:

settings:
  language: en
  save-immediately: true
  normalize-to-block: true
  copy-format: '{x} {y} {z}'

storage:
  backend: yaml # yaml | sqlite | mysql
  migrate-yaml-on-first-run: true
  sqlite:
    file: storage.db
  mysql:
    host: localhost
    port: 3306
    database: vanillapoints
    username: root
    password: ''
    pool-size: 8
    use-ssl: true

可用的内置语言:

  • en 使用 messages.yml。
  • ru 使用 messages_ru.yml。

copy-format 支持 {x}、{y}、{z}、{world} 和 {warp}(视情况适用)。

settings.save-immediately 会在坐标变更后将写入操作排入异步队列。当禁用此选项时,待处理的数据将在执行 /vp reload 和插件关闭时刷新。

storage.backend 默认设置为 yaml 以保证兼容性。切换到 sqlite 或 mysql 后,坐标数据会缓存在内存中以加快命令响应速度,并以异步方式持久化快照。如果启用了 storage.migrate-yaml-on-first-run 且所选的 SQL 后端为空,则现有的 data.yml 中的坐标将被导入一次,而 YAML 文件将保留作为备份。

公开 API

其他插件可以通过 Bukkit 服务访问 VanillaPoints:

RegisteredServiceProvider<VanillaPointsAPI> provider = Bukkit.getServicesManager()
        .getRegistration(VanillaPointsAPI.class);
VanillaPointsAPI api = provider == null ? null : provider.getProvider();

公开 API 包位于 dev.vaniley.vanillapoints.api。修改方法和返回 Location 的方法必须在服务器主线程上调用。修改方法会触发来自 dev.vaniley.vanillapoints.api.event 的可取消 Bukkit 事件;PointInfo 方法返回不可变的 DTO 以实现更安全的读取。

安装

  1. 构建或下载插件 .jar 文件。
  2. 将其放入服务器的 plugins 文件夹中。
  3. 重启服务器。
  4. 根据需要编辑 plugins/VanillaPoints/config.yml 和 messages*.yml。
  5. 在配置文件或消息更改后,使用 /vp reload 进行重载。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源