World Resourcepacks - 世界资源包管理

简介

本插件诞生于德国，倾注了热爱（与啤酒）。你是否曾希望为每个世界设置不同的服务器材质包？或者仅用一条指令就能切换当前材质包？那么你来对地方了！此插件允许你为每个世界乃至整个服务器设置独立的服务器材质包，还支持指定跨世界通用的材质包。它与 BungeeCord 代理端的 Bungee Resourcepacks 插件兼容，若玩家已在其他服务器通过 Bungee Resourcepacks 应用了材质包，切换服务器时将无需重新下载。

💡重要须知

• 材质包大小限制：原版 Minecraft 客户端仅接受小于 200 MiB 的服务器材质包（1.15 前为 50 MiB，1.18 前为 100 MiB）。
• SSL 证书兼容性：某些新型 SSL 证书（如 Let's Encrypt）在 1.17 版本前 Minecraft 附带的旧 Java 版本（Java 1.8.0_51）中无法正常工作。你需要使用其他证书或不加密的下载链接（不推荐）。
• 版本兼容性：本插件不适用于不支持服务器材质包的旧版 Minecraft。
• 增强版插件：如需更多功能（如踢出拒绝材质包的玩家），请查看付费插件 Force Resourcepacks。它支持 PlaceholderAPI 和 WorldGuard，并允许在玩家接受/下载材质包时执行多种操作（指令、传送、消息、标题等）。

🎮功能特性

• 为不同世界或整个服务器设置不同的服务器材质包。
• 支持多个材质包（1.20.3+）。
• 使用正则表达式匹配世界名称！
• 提供游戏内指令进行配置。
• 根据客户端语言环境显示消息的语言系统。
• 简化的组件/JSON 消息格式化语法（MineDown）。
• 可配置向玩家发送材质包前的延迟。
• 记住玩家当前应用的材质包，世界切换时不重复发送。
• 允许玩家自行设置材质包。该包可在每次登录时重新应用，并用于没有设置材质包的世界中的重置。
• 当自动发送材质包时，告知玩家服务器发送了哪个包。
• 为开发者提供 ResourcePackSendEvent 和 ResourcePackSelectEvent，以便在其插件中对材质包的发送或选择做出反应。
• 根据客户端版本发送正确的材质包（需要 ViaVersion 或 ProtocolSupport）。通过定义具有不同 Minecraft 版本或包格式设置的多个包变体来实现。
• 自动生成 sha1 哈希值！
• 兼容 AuthMe Reloaded、OpenLogin、NLogin、LibrePremium、JPremium。需要兼容更多插件？请联系我！

🔧指令列表

执行任何 /wrp 指令都需要 worldresourcepacks.command 权限。

管理与配置

• /wrp reload [resend] (worldresourcepacks.command.reload)
• 重新加载配置文件；如果第二个参数是 "resend"，则向所有在线玩家重新发送材质包。
• /wrp version (worldresourcepacks.command.version)
• 显示插件版本。
• /wrp generatehashes (worldresourcepacks.command.generatehashes)
• 手动生成材质包哈希值。
• /wrp addpack <name> <url> (worldresourcepacks.command.addpack)
• 添加一个新材质包。
• /wrp pack <pack> (worldresourcepacks.command.pack)
• 查看和编辑现有材质包。
• /wrp listassignments (worldresourcepacks.command.listassignments)
• 查看所有服务器分配。
• /wrp deleteassignment <assignment> (worldresourcepacks.command.deleteassignment)
• 删除一个世界分配。
• /wrp assignment <assignment> (worldresourcepacks.command.assignment)
• 查看和编辑一个世界分配。
• /wrp globalassignment (worldresourcepacks.command.globalassignment)
• 查看和编辑全局分配。
• /resetpack [<playername>] [<temp>] (bungeeresourcepacks.command.resetpack)
• 将（玩家的）材质包重置为空包或存储的包。如果 <temp> 设为 false，玩家的存储包也会被重置。

玩家使用

执行 /usepack 指令需要 worldresourcepacks.command.usepack 权限。为其他玩家执行则需要 worldresourcepacks.command.usepack.others 权限。玩家要访问特定材质包，需要拥有 worldresourcepacks.pack.<packname> 权限或在包配置部分定义的自定义权限。

• /usepack
• 列出你可用的所有材质包。
• /usepack <packname> [<playername>]
• 向自己或另一名玩家发送特定材质包。

⭐配置示例 (YAML)

debug: true
default-language: en
disable-metrics: false
autogeneratehashes: true
usepack-is-temporary: true
stored-packs-override-assignments: false
permanent-pack-remove-time: 30

packs:
  lobbypack:
    url: http://example.com/lobbyresourcepack.zip
    hash: abcdef012345678abcdef012345678abcdef0123
    format: 1
    version: "1.8"
    restricted: false
    permission: worldresourcepacks.pack.lobbypack

  gamepack:
    variants:
      - url: http://example.com/minigameresourcepack_1_15.zip
        hash: 012345678abcdef012345678abcdef012345678a
        version: '1.15'
      - url: http://example.com/minigameresourcepack_1_12.zip
        hash: 012345678abcdef01234567dddcdef012345678a
        version: '1.12'

  empty:
    url: http://cdn.moep.tv/files/Empty.zip
    hash: 01517226212d27586ea0c5d6aff1aa5492dd2484

global:
  pack: lobbypack
  send-delay: 10

worlds:
  lobby:
    pack: lobbypack
  minigame:
    pack: gamepack
    regex: 'minigame_.*'

警告：此配置可能不是最新版本，请务必参考 GitHub 仓库 中的配置，尤其是在使用开发构建版时！

❓关于客户端卡顿

在 1.20.3 版本中，这应该不再是问题！

当服务器材质包发送给客户端后，客户端在下载完成后会短暂卡顿。这是因为客户端必须重新加载所有资源，检查哪些资源重叠，并进行其他计算和操作。卡顿时长通常取决于电脑性能和所有已应用材质包中纹理的大小。即使服务器材质包不包含任何高清纹理或根本没有纹理，客户端仍会完全重新加载所有本地应用的材质包。

建议遇到服务器材质包问题的玩家使用 1.14、1.15、1.16 或 1.20.3 等版本，这些版本在此方面有重大改进。

✨开发者资源

• 源代码：可在 GitHub 获取，基于 GPLv3 许可证授权。
• 开发构建版：可在 Minebench.de Jenkins 找到。
• Javadocs：可供基于本插件进行开发的开发者使用。

🔧支持与反馈

你可以在以下渠道获得支持

• 资源讨论帖
• GitHub Issue 跟踪器
• 我的 IRC 频道
• 我的 Discord 服务器

⭐统计与捐赠

• 统计：本插件集成了 bstats.org 统计。你可以在 bStats/config.yml 文件中禁用。所用 bStats-lite 类的许可证可在此处找到。
• 捐赠：编程耗时费力，如果你能负担或在商业上使用此插件，欢迎请我喝杯啤酒以示支持。
• Patreon（含奖励）
• Paypal: https://s.moep.tv/donate
• Ðoge: D7G4Svo7GTNHpuhjwUBj2k7qANnZHwYD4p
• BTC: 1EXMFRknc7kLwCmM1zf5LXNnPD4ihVCEhQ

💡免责声明

本资源由作者分发，不提供任何担保或承担任何责任。