CustomOfflineVariables

插件

· 作者 WuBarlynn

CustomOfflineVariables 是一个适用于 Paper 和 Folia 的 PlaceholderAPI 插件。它在玩家断开连接时保存已配置的占位符值,并提供自定义占位符以获取在线和离线玩家的数据。

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

最新 1.2.0 · 26.2 · Folia

一键开服(送7天)

CustomOfflineVariables 是一款适用于 Paper 和 Folia 的 PlaceholderAPI 插件。它在玩家断开连接时保存配置好的占位符值,并提供用于在线和离线玩家数据的自定义占位符。

支持版本

  • Minecraft / Paper / Folia:26.2
  • Java:25 或更高版本
  • PlaceholderAPI:2.12.3 或兼容版本
  • 数据库:MySQL 或 SQLite

安装方法

  1. 为 Minecraft 26.2 安装 Paper 或 Folia 服务器。
  2. 安装 PlaceholderAPI。
  3. 将构建好的 JAR 文件复制到服务器的 plugins 目录中。
  4. 启动服务器以生成默认配置文件。
  5. 编辑 plugins/CustomOfflineVariables/config.yml。
  6. 重启服务器或运行 /offlinevars reload。

该 PlaceholderAPI 扩展已内置并自动注册。请勿使用 /papi ecloud download。请通过以下命令检查并测试其是否生效:

/papi list
/papi parse <player> %offlinevars_云币%

数据库配置

MySQL

首先创建配置的数据库:

CREATE DATABASE IF NOT EXISTS `minecraft-offline-papi`
  CHARACTER SET utf8mb4
  COLLATE utf8mb4_unicode_ci;

配置连接信息:

database:
  type: mysql
  host: localhost
  port: 3306
  database: minecraft-offline-papi
  username: root
  password: password
  table: player_variables

成功连接后,插件会自动创建 player_variables 表。

SQLite

database:
  type: sqlite
  table: player_variables

SQLite 数据库存储路径为:

plugins/CustomOfflineVariables/database.db

自定义变量

使用 target-key 时,插件会自动生成查询语句:

variables:
  金额:
    target-key: cloud_coin
    default: "0"
    cache-duration: 60

对应的占位符:

%offlinevars_金额%

也支持自定义 SQL。%uuid% 和 %name% 会被替换为目标玩家的离线 UUID 和名称:

variables:
  example:
    query: "SELECT value FROM custom_table WHERE uuid = '%uuid%'"
    return-column: value
    default: "N/A"
    cache-duration: 60

同步功能

位于 sync 下的占位符会在玩家断开连接时被解析并保存:

sync:
  save_cloud_coin:
    placeholder: "%cmi_user_balance_formatted%"
    target-key: cloud_coin
    sync-on-quit: true

命令与权限

命令 描述 权限
/offlinevars info 显示插件信息 无
/offlinevars reload 重新加载配置 offlinevars.admin
/offlinevars debug <player> <variable> 调试某个变量的查询 offlinevars.admin

UUID 行为说明

插件通过以下方式根据玩家名称生成离线 UUID:

OfflinePlayer:<player name>

此设计旨在用于离线模式下的玩家数据。更改玩家名称或其大小写可能会导致生成的离线 UUID 不同。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源