ValorlessUtils - 实用工具库

ValorlessUtils 是一个为我的其他插件开发的实用工具库，旨在简化插件开发流程。它提供了一系列常用功能模块，帮助开发者更高效地构建插件。

💡核心功能

• Utils: 通用工具集。
• Logging: 日志记录功能。
• NBT: NBT 数据操作。
• Config: 配置文件管理。
• Translator: 多语言翻译支持。
• SFX: 音效与粒子效果。
• Encoder: 数据编码与解码。
• Crafting Recipes: 自定义合成配方管理。

变量类型

• Vector2: 二维向量。
• Vector3: 三维向量。

所有功能都设计得相当简单且易于使用。

🎮集成方式

你可以通过 Maven 将此库集成到你的插件项目中。具体集成方法可在 GitHub 页面查看。由于我不熟悉其他方式，因此未提供其他集成方法的说明。

Maven 依赖配置

将以下代码添加到你的 pom.xml 文件中：

<repository>
  <id>jitpack.io</id>
  <url>https://jitpack.io</url>
</repository>
<dependency>
  <groupId>com.github.Valorless</groupId>
  <artifactId>ValorlessUtils</artifactId>
  <version>1.17.0</version>
  <scope>provided</scope>
</dependency>

🔧相关链接

• API 文档: https://valorless.github.io/ValorlessUtils
• 历史版本与构建: 如果你需要旧版本或特定构建，可以在此处找到：https://github.com/Valorless/ValorlessUtils/tree/main/builds
• 使用此库的插件: 请查看 GitHub 页面了解详情。
• Discord 社区: https://discord.gg/yyEPqSeXF9

ValorlessUtils

ValorlessUtils 是一个功能丰富的 Minecraft 插件，旨在为服务器管理员提供一系列实用工具，以简化日常管理和增强游戏体验。它整合了多种常用功能，从物品管理到世界编辑，帮助您更高效地运行服务器。

💡核心功能

ValorlessUtils 提供了多种强大的管理工具：

• 物品管理：轻松生成、修改和检查游戏物品。
• 世界编辑：提供便捷的世界操作功能，如时间设置、天气控制等。
• 玩家管理：包含传送、查看玩家信息等实用指令。
• 服务器工具：辅助服务器维护与调试的命令。

🎮命令与权限

插件的主要命令是 /valorlessutils，其别名包括 /vutils、/vu 和 /val。

基础命令格式

• /valorlessutils - 显示插件的主要帮助菜单。
• /valorlessutils help - 列出所有可用的命令和详细说明。

常用功能命令示例

插件包含大量子命令，例如

• /vutils give <物品名> [数量] [玩家] - 给予玩家特定物品。
• /vutils time set <day|night|noon|midnight> - 设置世界时间。
• /vutils weather <clear|rain|thunder> - 改变天气。

权限节点

大多数命令都需要相应的权限节点才能执行，格式通常为 valorlessutils.command.<子命令名>。例如：

• valorlessutils.command.give - 允许使用给予物品的命令。
• valorlessutils.command.time - 允许使用修改时间的命令。

🔧安装与配置

安装步骤

• 确保服务器运行的是 Paper、Purpur 或兼容的 Spigot 服务端（推荐版本 1.16.5+）。
• 将下载的 ValorlessUtils.jar 文件放入服务器的 plugins 文件夹。
• 重启或重载服务器。
• 插件首次运行后，会在 plugins/ValorlessUtils 目录下生成配置文件。

配置说明

主要的配置文件是 config.yml。您可以在其中：

• 启用或禁用特定模块。
• 设置命令别名。
• 调整各种功能的默认参数。
• 修改消息提示文本。

✨依赖与兼容性

必需依赖

• Paper/Purpur/Spigot：插件需要在此类服务端上运行。

可选依赖

插件可能与以下插件有功能联动或提供更好的集成体验（具体请查看插件更新日志）：

• PlaceholderAPI：用于在消息中使用其他插件提供的变量。
• Vault：如果包含经济功能，可能需要此插件。

版本支持

插件主要支持 Minecraft 1.16.5 及以上版本。对于特定版本的功能兼容性，请查看 GitHub 页面上的发布说明。

❓常见问题

• 问：安装后命令无效怎么办？
• 答：请确认是否正确放置了 JAR 文件，并检查服务器日志是否有加载错误。确保您拥有使用命令的相应权限。

• 问：如何更新插件？
• 答：建议从官方来源下载新版本 JAR 文件，替换旧的 JAR 文件，然后重启服务器。请注意备份旧的配置文件夹。

• 问：插件会导致性能问题吗？
• 答：ValorlessUtils 在设计上注重性能。如果遇到卡顿，请尝试在配置文件中禁用不常用的功能模块。

⭐获取与支持

• 下载链接：插件的官方发布版本可以在其 GitHub 仓库 的 Releases 页面找到。
• 问题反馈：如果您遇到了 Bug 或有功能建议，请在 GitHub 仓库的 Issues 页面提交。
• 文档：更详细的命令列表和配置选项，请参阅项目仓库内的 Wiki 或 README 文件。