目前我只有这一篇开发日志视频,专门的视频 hopefully 很快会推出!
? 工作原理
有多个插件都使用了资源包? 厌倦了手动合并它们、重新计算 SHA1 哈希值并重新托管? 想要拖放支持,让玩家即时获得自定义模型? 这个插件就是解决方案!
ResourcePackManager 会自动从兼容 automerge 的插件中获取资源包,根据配置优先级进行合并,并直接从你的服务器进行托管。玩家登录时将自动接收合并后的资源包。你也可以在 mixer 文件夹中添加手动资源包。
? 主要功能
- 自动合并你服务器的所有资源包!
- 直接从你的服务器自托管资源包! 如果无法自托管,则回退到免费的远程托管。
- 玩家登录时自动发送资源包给他们!
- 支持 Bedrock 版! 自动将合并后的 Java 版资源包转换为 GeyserMC 兼容的 Bedrock 版资源包。
- 支持代理网络! 兼容 Velocity、BungeeCord 和 Waterfall —— Bedrock 玩家在跨服连接时会收到一个单一的合并资源包。
- 支持在 mixer 文件夹中手动添加资源包。
- 24/7 Discord 技术支持。
- 无需任何设置或维护!
- 想要更棒的体验? 与 Free Minecraft Models 和 EternalTD 配合效果最佳 —— 两者均为免费插件!
? 安装设置
- 将
ResourcePackManager.jar放入你的plugins/文件夹中。 - 重启服务器。
就这么简单!插件开箱即用,默认推荐配置即可运行。你可以在配置文件中调整设置。
? Bedrock 版支持 (GeyserMC)
ResourcePackManager 会自动将合并后的 Java 版资源包转换为 GeyserMC 兼容的 Bedrock 版资源包,使 Bedrock 版和 Java 版玩家看到相同的自定义内容。此功能默认启用,无需额外设置。目前支持 FreeMinecraftModels 的自定义模型和 EliteMobs 的自定义物品。
? 代理网络设置 (Bedrock 版)
在代理后面运行多个 Geyser/Floodgate 服务器?Bedrock 客户端在每个网络连接中只能使用一个资源包。ResourcePackManager 通过将网络上所有资源包合并为一个单一包来解决这个问题,并在玩家登录时发送给 Bedrock 客户端。
要设置此功能,只需在你的代理服务器和后端服务器上均安装 ResourcePackManager(使用相同的 ResourcePackManager.jar 文件)。一切就绪后,请重启代理服务器两次,以便正确保存 geyser 映射数据!
Java 版玩家在切换服务器时直接从各后端服务器接收其资源包。
? 限制与兼容性
限制:
ResourcePackManager 会在可能的情况下进行合并,但无法修复根本性的冲突(例如 GUI 字符间距冲突或重复的物品模型 ID)。在发生冲突时,优先级较高的资源包将被选中。
兼容 automerge 的插件
- FreeMinecraftModels (推荐的模型插件!)
- EliteMobs (推荐的 Boss 插件!)
- EternalTD (推荐的迷你游戏插件!)
- BetterHUD
- ItemsAdder (需要解密并禁用托管功能)
- MMOInventory
- ModelEngine
- Nova
- Oraxen
- ValhallaMMO (需要执行
/valhalla resourcepack download) - BackpackPlus
- RealisticSurvival
- Vane-Core
有希望支持的插件吗?请在 Discord 上告诉我!
? 命令
/resourcepackmanager reload— 重载插件。/resourcepackmanager data_compliance_request— 下载所有托管数据以供检查。/resourcepackmanager status— 显示 RSPM 的当前状态。
? 托管方式
ResourcePackManager 默认尝试直接从你的服务器自托管资源包。这需要你的服务器端口对玩家可见。如果你无法转发端口或不想自托管,RSPM 会自动回退到 Nightbreak 服务器上的免费远程托管,这由 Patreon 支持者 提供支持。你可以在 config.yml 中配置托管模式。
远程托管数据政策与服务条款
ResourcePackManager 数据政策与合规性
ResourcePackManager 由 MagmaGuy 为 Nightbreak 游戏工作室开发,包含一个可选的自动托管功能,该功能会将资源包数据临时托管在远程服务器上。
截至本文撰写时,托管数据完全匿名,仅用于简化向使用该服务的服务器客户端分发资源包。本文件的未来版本可能会更新,以反映数据政策及其他相关事项的任何变更。
该系统符合:
- 欧洲议会和理事会 2000 年 6 月 8 日第 2000/31/EC 号指令
- 欧洲议会和理事会 2022 年 10 月 19 日第 (EU) 2022/2065 号法规
为了实现数据托管透明度和符合这些及其他欧洲规范,可以通过 /resourcepackmanager data_compliance_request 命令获取与某服务器相关的所有数据。该命令打包了与该请求服务器关联的所有文件和数据的完整副本。
如需要求下架你服务器的数据,请联系 MagmaGuy,邮箱地址为 magmaguy/at\nightbreak.io(将 /at\ 替换为 @)。然而,由于系统设计原因,在使用 ResourcePackManager 的服务器关闭后,数据仅保留最多 24 小时,因此邮件请求大多是不必要的。尽管如此,仍保留该选项以确保完全符合欧洲规范。
ResourcePackManager 与 Nightbreak 服务器的数据处理
- 资源包创建
- ResourcePackManager 将服务器上的多个资源包聚合为一个包含所有自定义内容的单个压缩文件。
- 初始化请求
- 向远程服务器发送初始化请求,创建一个带有随机 UUID 的
.txt文件。可通过命令/resourcepackmanager data_compliance_request获取该文件。
- SHA1 请求
- ResourcePackManager 将资源包的 SHA1 码传输至远程服务器,并保存在
.txt文件中。
- 文件传输
- 压缩后的资源包文件被发送至远程服务器,并分配与
.txt文件相同的 UUID。该文件可通过/resourcepackmanager data_compliance_request获取,并可验证其与输出文件夹中的原始文件完全一致,因为 Nightbreak 服务器不会对其进行修改。
- “Still Alive”心跳检测
- ResourcePackManager 每 12 小时发送一次“Still Alive”心跳信号,将 UUID 传输给服务器,从而更新
.txt文件中的时间戳。 - 如果在超过 24 小时内未收到“Still Alive”心跳信号,与该 UUID 关联的所有数据(
.txt文件和资源包)将从 Nightbreak 服务器上删除。
数据政策
- 伪匿名标识: 每次服务器重启时,Nightbreak 都会为服务器的文件分配一个随机 UUID,确保除非用户手动在资源包中添加此类信息,否则不会存储任何 IP 地址或可识别信息。
- 无下载记录: Nightbreak 不记录 Minecraft 客户端发出的任何下载请求相关数据。
- 不出售数据: 上传至 Nightbreak 的数据从未出售、现在不会出售、将来也不会出售。
- 遵守下架请求: Nightbreak 将配合来自服务器管理员和执法机构的下架请求。
- 自动数据移除: 只要在使用 ResourcePackManager 并使用自动托管功能,当服务器关闭后 24 小时,与服务器关联的所有数据将被自动移除;每次重启时数据会重新上传。
服务条款
截至撰写本文时,ResourcePackManager 的所有用户均可免费使用该托管服务。
用户有责任确保上传到服务器的数据不违法,并符合其 EULA 中定义的 Mojang TOS 相关规定。
滥用服务托管非资源包材料可能导致违规 IP 被永久拒绝服务。
该服务可能随时停止或以使旧版本无法连接的方式进行修改。
我们保留随时出于任何理由单方面终止本服务的权利。
? 查看 Magmaguy 更多作品!
? 合作服务器
Matecraft 是官方合作服务器!它始终同步最新的实验性功能和新地牢。社区氛围极佳,欢迎体验!
eternaltd.matecraft.org
? 开发者
API & Maven
(此内容可能已过时)
registerResourcePack(String pluginName,
String path,
boolean encrypts,
boolean distributes,
boolean zips,
boolean local,
String reloadCommand)
同时提供:reloadResourcePack()。
Maven:
<repository>
<id>magmaguy-repo-releases</id>
<name>MagmaGuy's Repository</name>
<url>https://repo.magmaguy.com/releases</url>
</repository>
<dependency>
<groupId>com.magmaguy</groupId>
<artifactId>ResourcePackManager</artifactId>
<version>CHECK-LATEST-VERSION</version>
</dependency>
This dev log is the only video I have right now, a dedicated one will (hopefully) come soon!
? How it Works
Got more than one plugin that uses resource packs? Tired of manually merging them, recalculating SHA1, and rehosting? Want drag & drop support where players instantly get custom models? This plugin is the solution!
ResourcePackManager automatically grabs the resource packs from automerge-compatible plugins, merges them based on config priorities, and hosts them directly from your server. Players automatically receive the merged pack. You can also add manual packs in the mixer folder.
? Main Features
- Automatically merges all of your server's resource packs!
- Self-hosts your resource pack directly from your server! Falls back to free remote hosting if self-hosting is unavailable.
- Automatically sends the resource pack to players when they log in!
- Bedrock support! Automatically converts your merged Java pack into a Bedrock-compatible pack for GeyserMC.
- Proxy network support! Works with Velocity, BungeeCord, and Waterfall — Bedrock players receive a single merged pack across all servers.
- Supports manual additions in the mixer folder.
- 24/7 Discord support.
- No setup or maintenance required!
- Want an even better experience? Works best with Free Minecraft Models and EternalTD — both free!
? How to Setup
- Drop
ResourcePackManager.jarinto yourplugins/folder. - Restart your server.
That's it! The plugin works with recommended defaults out of the box. You can tweak settings in the config files.
? Bedrock Support (GeyserMC)
ResourcePackManager automatically converts your merged Java resource pack into a Bedrock-compatible pack for GeyserMC, so Bedrock and Java players see the same custom content. This is enabled by default and requires no additional setup. Currently supports FreeMinecraftModels custom models and EliteMobs custom items.
? Proxy Network Setup (Bedrock)
Running multiple Geyser/Floodgate servers behind a proxy? Bedrock clients are limited to one resource pack per network connection. ResourcePackManager works around this by merging all the resource packs across your network into a single pack, which is then sent to Bedrock clients when they log in.
To set this up, just install ResourcePackManager both on your proxy server and the backend server (same ResourcePackManager.jar file). Once everything is set up, restart the proxy twice for the geyser mappings to get saved properly!
Java players receive their packs directly from each backend on server switch.
? Limitations & Compatibility
Limitations:
ResourcePackManager merges where possible but cannot fix fundamental conflicts (e.g. GUI unicode spacing clashes or duplicate item model IDs). In conflicts, the higher‑priority pack is chosen.
Automerge-compatible plugins
- FreeMinecraftModels (recommended models plugin!)
- EliteMobs (recommended bosses plugin!)
- EternalTD (recommended minigame plugin!)
- BetterHUD
- ItemsAdder (requires unencrypting & disabling hosting)
- MMOInventory
- ModelEngine
- Nova
- Oraxen
- ValhallaMMO (requires
/valhalla resourcepack download) - BackpackPlus
- RealisticSurvival
- Vane-Core
Have a plugin you'd like supported? Let me know on the Discord!
? Commands
/resourcepackmanager reload— reloads the plugin./resourcepackmanager data_compliance_request— downloads all hosted data for inspection./resourcepackmanager status— gives the current status of RSPM.
? Hosting
ResourcePackManager attempts to self-host the resource packs directly from your server by default. This requires your server ports to be accessible to players. If you can't forward ports or prefer not to self-host, RSPM automatically falls back to free remote hosting on Nightbreak servers, made possible by Patreon supporters. You can configure hosting mode in config.yml.
Remote hosting data policy & TOS
ResourcePackManager Data Policy and Compliance
ResourcePackManager, developed by MagmaGuy for the Nightbreak game studio, includes an optional auto-host feature that temporarily hosts resource pack data on a remote server.
As of this writing, the hosted data is fully anonymous and serves the sole purpose of simplifying the distribution of resource packs to clients of servers utilizing this service. Future versions of this document may be updated to reflect any changes in data policy and other related matters.
This system complies with:
- Directive 2000/31/EC of the European Parliament and of the Council of 8 June 2000
- Regulation (EU) 2022/2065 of the European Parliament and of the Council of 19 October 2022
For data hosting transparency and compliance with these and other European norms, it is possible to obtain all data related to a server via the /resourcepackmanager data_compliance_request command. This command packages a full copy of all files and data associated with the requesting server.
To request the takedown of your server's data, contact MagmaGuy at magmaguy/at\nightbreak.io (replace /at\ with @). However, due to the system's design, data is only retained for up to 24h after a server using ResourcePackManager shuts down, making email requests largely unnecessary. Nonetheless, the option remains available to ensure full compliance with European norms.
Data Handling by ResourcePackManager and Nightbreak Servers
- Resource Pack Creation
- ResourcePackManager aggregates resource packs on your server into a single zipped file containing all custom content.
- Initialization Request
- An initialization request is sent to remote servers, creating a
.txtfile with a random UUID. This file can be obtained via the/resourcepackmanager data_compliance_request.
- SHA1 Request
- ResourcePackManager transmits the SHA1 code of your resource pack to the remote server, which is saved in the
.txtfile.
- File Transmission
- The zipped resource pack file is sent to the remote server, assigned the same UUID as the
.txtfile. This file can be obtained through/resourcepackmanager data_compliance_requestand verified to be identical to the original in your output folder, as it is not modified by the Nightbreak servers.
- "Still Alive" Ping
- ResourcePackManager sends a "still alive" ping every 12 hours, transmitting the UUID to the server, which updates the timestamp in the
.txtfile. - If no "still alive" ping is received for over 24 hours, all data associated with that UUID (the
.txtfile and the resource pack) is deleted from the Nightbreak servers.
Data Policy
- Pseudonymous Identification: Nightbreak assigns a random UUID to your server's files each time the server reboots, ensuring no IP address or identifiable information is stored unless users manually add such information to their resource packs.
- No Download Logging: Nightbreak does not log any data related to download requests by Minecraft clients.
- No Data Sales: Data uploaded to Nightbreak is not, has never been, and will never be sold.
- Compliance with Takedown Requests: Nightbreak will comply with takedown requests from both server administrators and law enforcement agencies.
- Automatic Data Removal: All data associated with your server is automatically removed 24 hours after your server shuts down and is reuploaded on every restart for as long as ResourcePackManager is in use and using the auto-host feature.
Terms of service
As of writing this, the hosting service is provided for free for all users of ResourcePackManager.
It is the user's responsibility to ensure that the data uploaded to servers is not illegal and complies with any Mojang TOS as defined in their EULA.
Abusing the service to host material other than resource packages may result in a permanent denial of service for the offending IP.
The service may, at any time, cease or be modified in such a way that makes old versions unable to connect to it.
We reserve the right to unilaterally terminate this service at any time and for any reason.
? View More by Magmaguy!
? Partner servers
Matecraft is the official partner server! It's always up to date with the latest experimental features and new dungeons. Great community, check it out!
eternaltd.matecraft.org
? Developers
API & Maven
(this might be outdated)
registerResourcePack(String pluginName,
String path,
boolean encrypts,
boolean distributes,
boolean zips,
boolean local,
String reloadCommand)
Also available: reloadResourcePack().
Maven:
<repository>
<id>magmaguy-repo-releases</id>
<name>MagmaGuy's Repository</name>
<url>https://repo.magmaguy.com/releases</url>
</repository>
<dependency>
<groupId>com.magmaguy</groupId>
<artifactId>ResourcePackManager</artifactId>
<version>CHECK-LATEST-VERSION</version>
</dependency>
下载 ResourcePackManager
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ResourcePackManager
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ResourcePackManager
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ResourcePackManager
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ResourcePackManager
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ResourcePackManager
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ResourcePackManager
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ResourcePackManager
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ResourcePackManager
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ResourcePackManager
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
ResourcePackManager 2.4.12:
- [新增] Bedrock 玩家现在可以听到自定义音效和音乐:启用新的
bedrockConvertSounds设置后,合并包中的每个sounds.json都会将其命名的音效一并放入 Bedrock 资源包中。bedrockSoundExcludedPacks可用于排除某些包的音效(例如大型音乐包),而/rspm status命令会显示转换所添加的内容。默认关闭是因为 Bedrock 玩家在加入服务器前会下载整个资源包。 - [修复] 在代理后方时,Bedrock 资源包会保留所有后端服务器的自定义音效定义,而非仅保留最后一个后端的定义。
- [修复] 自定义物品模型仅在插件为其放置该模型的基类物品上映射到 Bedrock 端。此前,包含约 200 个 ModelEngine 生物的模组生成了 31,970 个 Geyser 自定义物品,导致所有 Bedrock 客户端崩溃;现在每个 ModelEngine 骨骼仅生成约两个自定义物品。若插件为某物品设置的基类与其所在资源包不同,则该模型不再在 Bedrock 端显示。
- [修复] 管理员可在游戏内使用
/resourcepackmanagerchangelog命令及其附带的 [VIEW CHANGELOG] 按钮。此前因该命令在服务器启动后才注册,导致玩家客户端无法识别。
ResourcePackManager 2.4.11:
- [修复] 自定义基岩版实体在搭配 Geyser 使用的 BungeeCord 网络中恢复正常。自 2.4.6 版本起,Geyser 桥接因 IllegalAccessError 报错并导致这些实体被禁用。
- [修复] 修复或清除 paper-global.yml 中的转发密钥后,无需重启即可重新链接后端服务器。
ResourcePackManager 2.4.10:
- [新增] 内置 CraftEngine 支持:ResourcePackManager 会合并 CraftEngine 生成的资源包。现有的 config.yml 文件保留各自的 priorityOrder(优先级顺序)。
- [新增] 在启动后出现的资源包(例如 CraftEngine 在其首次执行 /ce reload all 之前,以及 ItemsAdder 在执行 /iazip 之前等),只要对应的文件存在就会立即被合并,无需使用 /rspm reload。这些资源包会在 /rspm status 命令的“等待资源包”(Waiting for resource packs)列表下显示。
- [新增] 当 CraftEngine 也在玩家加入时发送其资源包时,ResourcePackManager 会发出警告,以避免玩家重复下载。
- [新增] CraftEngine 的物品可通过 Geyser 在基岩版上显示。
- [修复] 将 Guava 更新到 33.7.2 版本以修复 CVE-2026-102554 漏洞。
ResourcePackManager 2.4.8:
- [新增] 使用不带令牌的
/nightbreaklogin命令现在会显示一个 nightbreak.io 链接。在该网站批准服务器后,即可自动连接,无需复制令牌。通过令牌进行绑定的/nightbreaklogin操作仍然有效。 - [调整] 设置、安装和更新提示现指向
/nightbreaklogin,而非账户令牌页面。 - [修复] 当 magmaguy.com 宕机时,资源包现在会回退到自托管模式,而不是让玩家无法获取资源包。控制台和
/rspm status会提示外部访问无法验证。 - [修复] Java 版资源包在未使用自定义模型数据(如树叶或蘑菇)的情况下重新设计物品时,基岩版玩家现在会看到正常的原版物品,而不是不匹配已放置方块的无着色图标。自定义模型数据变体仍会正常转换,且现有的基岩版整合包在更新后的首次启动时会重建一次。
- [修复] Oraxen 物品中配置为放置在非纸张材质上的物品(例如 CustomCrops 中的苹果作物),现在会在基岩版上显示其自定义外观,而不是普通的原版物品。
ResourcePackManager 2.4.7:
- [修复] 单个无法读取的方块或物品纹理不再导致整个资源包合并失败。
- [调整]
/rspm status现在会显示上次自托管检查失败的原因。 - [调整] 超过 250 MiB 的资源包将收到一条提示,说明没有任何主机能够承载它们,并列出双方的大小限制。
- [修复] 在 Windows 系统上,当杀毒软件或文件索引器短暂锁定配置文件时,保存配置文件的操作不再失败。
- [修复]
/nightbreak plugins现在会将缺失的插件安装到plugins/目录中,以便在下一次启动时加载。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧