PlexVariables

插件

· 作者 Applex

使用 YAML 创建带有条件、表达式和持久化存储的自定义 PlaceholderAPI 变量。

0 本站下载 0 关注 更新于 4 周前

最新 1.0.2 · 26.3 · Paper / Purpur

一键开服(送7天)

PlexVariables

无需编写 Java 即可创建强大的自定义 PlaceholderAPI 变量。

PlexVariables 允许你使用简单的 YAML 文件定义可复用的占位符。你可以创建静态值、动态条件、数学表达式以及持久化的玩家或服务器级变量——这一切都不需要开发自定义插件。

适用于自定义记分板(Scoreboards)、DeluxeMenus、TAB 栏、进度系统、服务器信息展示等场景。

功能特性

  • 静态变量 - 在服务器范围内定义可复用的文本和数值。
  • 条件变量 - 根据权限、世界、玩家统计数据或其他条件改变占位符的输出。
  • 表达式变量 - 使用数学运算符和 PlaceholderAPI 变量执行计算。
  • 持久化存储 - 使用 SQLite 保存玩家专属和全局数值。
  • 嵌套变量 - 引用其他 PlexVariables 和外部 PlaceholderAPI 占位符。
  • 自动文件发现 - 跨多个 YAML 文件和文件夹组织变量。
  • 内置调试工具 - 测试变量解析并检查详细的评估结果。
  • 安全重载 - 无效配置的重载会保留你之前的有效设置。
  • 性能优先 - 内存缓存、异步存储以及解析安全限制。
  • 高度可配置 - 支持自定义格式、条件和表达式,且无强制品牌植入。

配置

在 plugins/PlexVariables/variables/ 目录下创建变量。

示例 - 静态变量

variables:
  server_name:
    value: "&d&lPlex Network"

  welcome:
    value: "&fWelcome %player_name% to %plexvar_server_name%!"

现在你可以在任何支持 PlaceholderAPI 的地方使用:

%plexvar_server_name%
%plexvar_welcome%

Static Variables

示例 - 条件变量

variables:
  health_status:
    conditions:
      - condition: "%player_health% <= 5"
        value: "&cCritical"
      - condition: "%player_health% <= 10"
        value: "&eLow"
    default: "&aHealthy"

占位符 %plexvar_health_status% 会根据玩家的生命值自动变化。

Conditional Variables

PlexVariables 还支持数学表达式、持久化玩家数值、全局变量以及混合不同类型的变量。

Combined Variables

如需完整的配置示例和高级功能说明,请参阅 文档。

命令与权限

命令 描述
/pv help 显示可用命令
/pv list [page] 列出已加载的变量
/pv parse <player|--null> <text> 解析占位符
/pv test <player|--null> <variable> 调试变量解析
/pv get <variable> [player|global] 获取存储的值
/pv set <variable> <player|global> <value> 设置存储的值
/pv add <variable> <player|global> <amount> 向存储的值添加数值
/pv reset <variable> <player|global> 重置存储的值
/pv reload 重载配置和变量

别名: /plexvariables, /plexvar, /pvar, /pv

命令拥有独立的权限节点 plexvariables.*。plexvariables.admin 权限授予管理访问权。

详细命令语法和权限说明请参阅 README。

兼容性

  • 服务端软件: Paper
  • Minecraft: 已在 1.21.1, 1.21.4, 1.21.11, 26.1.1, 26.1.2, 26.2 和 26.3 上测试
  • Java: 测试过的 Paper 1.21.x 版本需 Java 21;Paper 26.x 需 Java 25
  • 必需依赖: PlaceholderAPI

如果你的变量中使用了外部占位符,可能需要安装额外的 PlaceholderAPI 扩展。

有关兼容性详情,请参阅各个版本的更新日志。

安装

  1. 安装 PlaceholderAPI。
  2. 下载 PlexVariables 并将 JAR 文件放入服务器的 plugins 文件夹中。
  3. 启动或重启你的 Paper 服务器。
  4. 在 plugins/PlexVariables/variables/ 内部创建或编辑 YAML 文件。
  5. 运行 /pv reload 以应用更改。

正在更新? 请备份插件目录并替换旧的 JAR 文件。现有的变量、配置和存储数据保持兼容。

文档与支持

关于高级用法、示例、集成指南和故障排除:

PlexVariables 遵循其 GitHub 仓库中包含的许可协议提供源代码可用服务。


由 Applex | Plex Studios 开发

网站 · GitHub

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源