目前我只有这一篇开发日志视频,专门的视频 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.jar into your plugins/ 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
.txt file 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
.txt file.
- File Transmission
- The zipped resource pack file is sent to the remote server, assigned the same UUID as the
.txt file. This file can be obtained through /resourcepackmanager data_compliance_request and 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
.txt file.
- If no "still alive" ping is received for over 24 hours, all data associated with that UUID (the
.txt file 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>
评论 0
登录后参与评分
还没有评论,来抢沙发吧