ServerVariables - 自定义玩家与服务器变量

简介

ServerVariables 是一款功能强大的 Minecraft 插件，它允许你为服务器和玩家创建自定义变量，并完全掌控其数值。变量可通过命令进行修改，其值可通过 /svar get 命令或 PlaceholderAPI 获取。无论是构建多货币经济系统、管理传送门状态，还是实现自定义点数或违规记录系统，它都能轻松胜任。

💡支持与帮助

如果你需要帮助，可以通过以下方式联系作者或社区

• 作者支持：如有问题或需要直接联系作者，你可以：

- 在 SpigotMC 的插件讨论区发布问题。

- 在 SpigotMC 上向作者发送私信。

- 在 GitHub 上提交 Issue。

• 社区支持：我们有一个 Discord 社区（主要为西班牙语，但也支持英语）。

- 加入 Discord 后，请前往 “Plugins Ajneb97” 分类。

- 在 “general-plugins-ajneb97” 频道中提问。

- 请注意，此频道由社区用户提供互助支持，作者不一定能及时回复。如需作者直接帮助，请使用上述方式。

🎮功能特性

ServerVariables 提供了全面的变量管理功能：

• 变量类型：创建玩家变量或全局（服务器）变量。
• 值类型：支持 TEXT（文本）、INTEGER（整数）、DOUBLE（小数）、LIST（列表）四种数据类型。
• 变量控制：

- 为变量设置允许的取值范围。

- 为变量设置可显示的文本值。

- 为变量设置初始值。

• 便捷操作：通过命令轻松设置、获取、增加、减少或重置变量。
• 高度兼容：

- 支持 PlaceholderAPI，可在任意位置显示变量值。

- 提供开发者 API。

- 兼容 Minecraft 1.8 及以上版本。

- 支持 MySQL 数据库。

🔧命令列表

所有命令中的 <player> 参数仅在变量类型为 PLAYER 时需要。在命令末尾添加 silent:true 可以隐藏操作成功的信息提示。

• /svar set <variable> <value> (可选)<player> (可选)silent:true

设置一个变量的值。

• /svar get <variable> (可选)<player> (可选)silent:true

获取一个变量的值。

• /svar add <variable> <value> (可选)<player> (可选)silent:true

为一个变量增加值（仅适用于 INTEGER 或 DOUBLE 类型）。

• /svar reduce <variable> <value> (可选)<player> (可选)silent:true

减少一个变量的值（仅适用于 INTEGER 或 DOUBLE 类型）。

• /svar list <option>

管理 LIST（列表）类型的变量。

• /svar reset <variable> (可选)<player> (可选)silent:true

将一个变量的值重置为初始值。

• /svar reload

重载插件配置文件。

- 别名：`/servervariables`

❓应用示例

以下是一些使用 ServerVariables 可以实现的场景：

• 创建一个包含多种货币的经济系统。
• 管理一个具有开启/关闭状态的传送门。
• 实现自定义玩家点数系统。
• 记录玩家违规次数。
• 结合 ConditionalEvents 等插件，实现生命值系统，跟踪玩家死亡并减少其生命数量。

💡简介

ServerVariables 是一款强大的 Minecraft 插件，它允许你为服务器中的每个玩家创建和管理自定义变量。这些变量可以存储数值、文本或布尔值，并能通过 PlaceholderAPI 在其他插件中使用，极大地增强了服务器的自定义和交互能力。

🎮核心功能

• 变量类型：支持整数、浮点数、文本和布尔值。
• 变量作用域：可创建全局变量（所有玩家共享）或玩家变量（每个玩家独立）。
• 数据存储：变量数据安全地存储在插件的数据文件中。
• PlaceholderAPI 集成：所有变量都可以通过 PlaceholderAPI 以占位符形式调用。
• 全面可配置：通过 config.yml 文件轻松自定义插件行为。
• API 支持：为开发者提供了完整的 API，以便其他插件与之交互。

🔧命令与权限

主要命令

• /servervariables 或 /sv

- `help` - 显示帮助信息。

- `info` - 显示插件信息。

- `reload` - 重载插件配置。

- `version` - 显示插件版本。

变量管理命令

• /servervariables variable 或 /sv var

- `create <变量名> <类型> [作用域]` - 创建一个新变量。

- `delete <变量名>` - 删除一个变量。

- `list [页码]` - 列出所有变量。

- `info <变量名>` - 查看变量信息。

- `set <变量名> <值> [玩家]` - 设置变量的值。

- `get <变量名> [玩家]` - 获取变量的值。

- `add <变量名> <数值> [玩家]` - 为数值变量增加值。

- `reset <变量名> [玩家]` - 将变量重置为默认值。

权限节点

• servervariables.admin - 授予使用所有管理命令的权限。
• servervariables.use - 授予使用基础命令（如查看变量）的权限。

✨安装与设置

前置需求

• 运行 Spigot、Paper 或任何基于它们的服务端（1.13+）。
• 安装 PlaceholderAPI 插件（可选，但强烈推荐用于占位符功能）。

安装步骤

• 将 ServerVariables.jar 文件放入服务器的 plugins 文件夹。
• 重启服务器以生成配置文件和文件夹。
• 根据需求编辑 plugins/ServerVariables/config.yml 文件。
• 使用 /sv reload 命令或重启服务器以应用配置更改。

创建你的第一个变量

• 使用命令创建变量：

    /sv var create coins integer player

（这将为每个玩家创建一个名为 `coins` 的整数类型变量）

• 为玩家设置初始值：

    /sv var set coins 100 Notch

• 通过 PlaceholderAPI 使用占位符：

    %servervariables_player_coins%

（在支持 PAPI 的插件中显示玩家 `Notch` 的硬币数量）

❓常见问题

• 问：变量数据存储在哪里？

- 答：所有变量数据都保存在 `plugins/ServerVariables/data.yml` 文件中。

• 问：如何在其他插件中使用这些变量？

- 答：安装 PlaceholderAPI 后，你可以使用 `%servervariables_<作用域>_<变量名>%` 格式的占位符。对于玩家变量，格式为 `%servervariables_player_<变量名>%`。

• 问：支持哪些变量类型？

- 答：支持 `integer`（整数）、`double`（浮点数）、`text`（文本）和 `boolean`（布尔值，true/false）。

• 问：如何备份变量数据？

- 答：定期备份 `plugins/ServerVariables` 目录下的 `data.yml` 文件即可。

⭐注意事项

• 在删除变量或修改配置前，建议先备份 data.yml 文件。
• 确保为管理命令设置好权限，避免普通玩家误操作。
• 变量名应避免使用特殊字符和空格，以确保兼容性。
• 如需更多帮助或报告问题，请访问插件的官方页面或 GitBook 文档。