DatapackLoader - 数据包自动加载器

DatapackLoader 是一款能够自动为你的 Minecraft 服务器添加数据包的插件。它可用于安装数据包并加速数据包的开发流程，同时支持 Folia 服务器。

💡添加数据包的方法

有三种方式可以为你的服务器添加数据包

• 在控制台使用 /dl import <url> 命令，并粘贴数据包 .zip 文件的下载链接。
• 手动将数据包文件拖放至插件生成的 datapacks 文件夹中。
• 在 config.yml 配置文件中启用 starter-datapack 选项。

🎮命令与权限

以下是可用的命令及其对应的权限节点。

玩家/控制台命令

• /dl
• 权限：datapackloader.command
• 描述：使用插件的主命令。
• /dl help
• 权限：datapackloader.command.help
• 描述：获取插件文档的链接。
• /dl import <url>
• 权限：仅限控制台执行
• 描述：从指定的 .zip 文件 URL 链接导入并安装一个数据包。
• /dltp <worldname>
• 权限：datapackloader.command.tp
• 描述：以旁观者模式传送到指定世界的出生点。

🔧配置文件与资源

插件运行后会生成以下文件，你可以根据需要对其进行配置或查看：

• config.yml：主配置文件。
• README.txt：说明文件。

❓获取帮助

如果你需要进一步的帮助或想与其他用户交流

• 教程视频：请查看插件相关的视频教程。
• 联系与社区：欢迎加入我们的 Discord 服务器：https://discord.gg/txJDdYcRV6

感谢所有使用 DatapackLoader 的玩家！

简介

DatapackLoader 是一个轻量级的 Bukkit/Spigot 插件，它允许服务器管理员在服务器运行时动态加载、卸载和重新加载 Minecraft 数据包，无需重启服务器。这为使用数据包来添加新内容、修改游戏机制或创建自定义体验的服务器提供了极大的便利。

💡功能特性

• 动态数据包管理：在服务器运行时加载、卸载和重新加载数据包。
• 目录监控：自动检测并加载放置在指定文件夹中的新数据包。
• 命名空间管理：自动处理数据包的命名空间，避免冲突。
• 简易命令：提供简单直观的命令来管理数据包。
• 配置灵活：可通过配置文件自定义数据包目录等设置。

🎮命令与权限

主命令：`/datapackloader` 或简写 `/dpl`

• /dpl load <数据包名称> - 加载指定的数据包。

- 权限：`datapackloader.load`

• /dpl unload <数据包名称> - 卸载指定的数据包。

- 权限：`datapackloader.unload`

• /dpl reload <数据包名称> - 重新加载指定的数据包。

- 权限：`datapackloader.reload`

• /dpl list - 列出所有已加载的数据包。

- 权限：`datapackloader.list`

• /dpl info <数据包名称> - 显示指定数据包的详细信息。

- 权限：`datapackloader.info`

• /dpl help - 显示帮助信息。

- 权限：`datapackloader.help`

• /dpl version - 显示插件版本信息。

- 权限：`datapackloader.version`

管理员权限：datapackloader.admin - 授予所有上述命令的使用权限。

🔧安装与配置

安装步骤

• 将下载的 DatapackLoader.jar 文件放入服务器的 plugins 文件夹。
• 启动或重启服务器以生成配置文件和文件夹。
• 插件会自动创建 plugins/DatapackLoader/datapacks/ 目录，这是默认的数据包存放位置。
• 将你的 .zip 格式数据包文件放入上述目录中。

基本配置

插件生成的主要配置文件是 plugins/DatapackLoader/config.yml。你可以调整以下设置：

• datapacks-folder： 数据包文件夹的路径（相对于服务器根目录或绝对路径）。
• auto-load： 是否在服务器启动时自动加载文件夹内的所有数据包。
• check-updates： 是否检查插件更新。

✨使用方法

加载数据包

• 确保数据包是 .zip 格式，并已放置在配置的数据包文件夹内（默认为 plugins/DatapackLoader/datapacks/）。
• 在游戏内或控制台使用命令 /dpl load <文件名>。

- 例如，如果你的数据包文件是 `adventure_pack.zip`，则使用 `/dpl load adventure_pack`。

卸载数据包

• 使用命令 /dpl unload <数据包名称> 来卸载一个已加载的数据包。此处的名称是加载时使用的名称（不含 .zip 后缀）。

重新加载数据包

• 如果你修改了数据包文件，可以使用 /dpl reload <数据包名称> 来重新加载它，使更改生效。

自动加载

• 如果配置中 auto-load 设置为 true，那么所有放置在数据包文件夹内的 .zip 文件都将在服务器启动时自动加载。

❓注意事项与常见问题

重要提示

• 数据包文件必须是 .zip 格式。内部结构应符合标准 Minecraft 数据包格式（即包含 data 和 pack.mcmeta 的文件夹）。
• 插件会管理数据包的命名空间。加载时，它会将数据包内容放入以数据包文件名命名的独立命名空间中，以避免与其它数据包冲突。
• 在卸载数据包时，其对应的所有命名空间内容将从游戏中移除。

可能遇到的问题

• 数据包未生效：请检查数据包格式是否正确，并通过 /dpl list 确认是否已成功加载。
• 命令无权限：确保你拥有相应的权限，或使用 op 权限。
• 与其他插件冲突：极少数情况下，与其他修改数据包加载机制的插件可能存在兼容性问题。请确保你的 Minecraft 服务器版本与插件版本兼容。

⭐支持与开发

DatapackLoader 是一个开源项目。如果你遇到问题、有功能建议或想贡献代码，欢迎访问其 GitHub 页面：

https://github.com/lichenaut/DatapackLoader

你可以在该页面提交 Issue 或 Pull Request。