CustomOfflineVariables 是一款适用于 Paper 和 Folia 的 PlaceholderAPI 插件。它在玩家断开连接时保存配置好的占位符值,并提供用于在线和离线玩家数据的自定义占位符。
支持版本
- Minecraft / Paper / Folia:
26.2 - Java:
25或更高版本 - PlaceholderAPI:
2.12.3或兼容版本 - 数据库:MySQL 或 SQLite
安装方法
- 为 Minecraft 26.2 安装 Paper 或 Folia 服务器。
- 安装 PlaceholderAPI。
- 将构建好的 JAR 文件复制到服务器的
plugins目录中。 - 启动服务器以生成默认配置文件。
- 编辑
plugins/CustomOfflineVariables/config.yml。 - 重启服务器或运行
/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 不同。
你是这个资源的作者?登录后可认领此资源。
相似资源
ExyliaPlugins 的库。
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
一个在游戏内运行的 Minecraft 地图编辑器! 支持选区、蓝图、复制粘贴、笔刷和脚本。 可在创造模式中使用,也可在生存模式中临时使用。
创建用户友好的菜单以前往不同的世界
专为 Velocity 打造的自制聊天插件,功能丰富——支持跨服群组/全局/私聊消息,并集成 LibertyBans 的禁言功能。
一个高度兼容、功能完善且稳定的 TPA 模组
评论 0
登录后参与评分
还没有评论,来抢沙发吧