OSG — Online Server Gunpacks
TACZ 模组枪包服务端分发。玩家无需任何设置——加入服务器即可游玩。纯内存加载,不接触磁盘。
✨ 解决了什么问题?
保护枪包作者的艺术资产 + 免去繁琐的服务器管理。
枪包存放在服务器上,玩家无需操作。版本始终保持同步。再也不用担心“我安装了但没显示出来”的问题。
玩家加入时加载至内存,断开连接时清除——从源头上防止作者资产被复制。
? 对比
|
?️ 手动安装 |
⚡ OSG |
| 玩家设置 |
下载并安装每个枪包 |
零操作——加入即玩 |
| 更新 |
所有人重新下载 |
服务器端替换一次即可 |
| 安全性 |
文件暴露在磁盘中 |
内存加载 + 加密传输 |
| 一致性 |
版本不匹配导致 Bug |
由服务器强制统一 |
? 功能特性
| 功能 |
描述 |
| ✅ 服务器数字签名 |
客户端拒绝伪造服务器,防钓鱼 |
| ? 强制版本同步 |
服务器更新一次,所有人获取最新——告别“我已经装了”的抱怨 |
| ? 零维护 |
玩家无需安装任何东西。添加新枪包无需全服公告 |
| ⚡ 无需修改 TACZ |
仅以内存方式向 TACZ 提供资源 |
| ? 额外保护 |
纯内存运行,玩家无法复制文件——反盗版效果免费赠送 |
| ? 支持任意格式 |
文件夹或 ZIP 压缩包(推荐 ZIP) |
| ✅ 兼容所有 TACZ 枪包 |
除加密包外均支持 |
? 工作原理
TACZ 通过 Forge 的 RepositorySource 接口加载枪包——它会扫描 tacz/ 文件夹,将每个枪包包装为 PathPackResources,然后交给 Minecraft 的资源系统处理。
OSG 执行完全相同的逻辑,但文件来源是内存而非磁盘:
- 服务器扫描
server_gunpacks/ → 通过网络将枪包发送给客户端
- 客户端在 RAM 中组装这些资源 → 通过相同的
RepositorySource 接口将其作为 PackResources 提供
- TACZ 看到的它们与本地文件完全一致——没有任何区别。无需 Mixin,无需补丁。且玩家永远无法获得原始文件。
可以理解为点击了资源包提示框中的“完成”,但所有内容都保留在内存中。
? 安装指南
| 端 |
操作步骤 |
| ?️ 服务器 |
安装 OSG,将枪包放入 server_gunpacks/ 目录 |
| ? 客户端 |
安装 OSG。仅此而已。 |
? 提示:将频繁更新的枪包,或你不希望玩家复制的枪包,放入 server_gunpacks/。稳定的基础枪包可以保留在本地——节省带宽和麻烦。
? 依赖要求
Minecraft 1.20.1
Forge 47.3+
TACZ 1.1.8
⌨️ 命令列表
| 命令 |
描述 |
/osg status |
显示已加载的枪包 |
/osg reload |
服务器端热重载(已连接的玩家需要重新加入) |
❌ 不支持的功能
⚠️ 加密枪包(如 Arcana 等)——请使用其自带的加载器。OSG 不进行解密操作。
❓ 常见问题
? 如何更新枪包?
替换 server_gunpacks/ 中的文件,然后运行 /osg reload。已连接的玩家仍持有旧版本;新加入的玩家将获得更新。通过 API 加载的枪包不支持热更新。
⚖️ 这是否构成版权侵权?
OSG 是一个中立的传输工具。技术事实如下:
- 无修改 —— CRC32 完整性校验确保字节级的一致性。该工具不会更改任何枪包数据。
- 内存加载 —— 枪包数据加载到内存中,并在断开连接时清除。不会创建永久副本。
⚠️ 重要提示:中立工具并不保证合法性。服务器所有者必须验证自己拥有配置分发的枪包的合法权利。分发未经授权的受版权保护的材料可能仍构成侵权。强烈建议仅分发原创或明确获得授权的内容。
? 这会占用大量内存吗?
不会——而且这些内存本来就被使用了。
无论枪包来自本地 tacz/ 文件夹还是通过 OSG 提供,TACZ 都会将所有枪包文件加载到内存中。内存占用量完全相同。OSG 只是跳过了“写入磁盘,然后读入内存”的步骤——没有额外的开销。
数据在断开连接时会被清除,不会驻留。
? 这对枪包作者有什么好处?
OSG 不会改变你的版权归属。你的艺术资产仍然完全属于你。
- 玩家无法访问原始文件(内存加载,断开连接时清除)——你的模型、纹理和声音无法被随意复制和传播。
- 服务器端的版本管理意味着不会出现因本地副本过时导致的兼容性问题。
这不是为了推行某种新秩序——只是为那些希望保护自己的创作者提供了一种他们以前没有的选择。
?️ 如何防止版本不匹配导致的 Bug?
所有玩家都从服务器加载完全相同的枪包数据。没有人会意外使用过时的本地副本,因为根本不存在本地副本。“我安装了但没显示出来”将成为历史。
? Minecraft 1.21 支持吗?
待 TACZ 更新至 1.21 后跟进支持。
? 安全性
OSG 以近乎零的性能损耗实现枪包端到端保护。
? 枪包作者:为了防止作品被未经授权地复制,请让服务器所有者通过 OSG 进行分发——玩家无法直接访问原始文件。
? 开发者 API
如果你的模组有自定义的包加载逻辑(解密、自定义格式等),可以将解压后的数据交给 OSG——无需写入磁盘:
ExternalPackRegistry.register(() -> {
Map<String, byte[]> files = prepareFiles();
return List.of(new ExternalPack("pack_id", "namespace", files));
});
? 许可证
当前版本(Beta): 源代码——保留所有权利。编译后的 jar 包——允许自由再分发。禁止修改和再分发。
稳定版发布后: 将在 GPL v3 许可下开源,并附加以下例外条款:
加密层例外: 服务器所有者出于安全目的可以修改加密/混淆代码(com.hxwi1.ssg.util.*),并将修改后的 jar 分发给其玩家,而无需公开这些特定修改的源代码。所有其他修改仍须遵守 GPL v3。公开重新分发修改版本(非服务器专用)仍需完整公开源代码。
⚠️ OSG 的传输加密可防止网络窃听(抓包仅获得密文)。需明确说明:没有任何客户端软件能阻止用户修改自己的客户端以提取数据——这是所有本地运行软件的固有局限,并非 OSG 或其许可证所特有。
? 致谢
基于 TACZ 团队的优秀工作构建。
❗❗ 免责声明
安装本模组即表示您同意以下条款(标有 * 的项仅在测试版期间适用;正式版受 GPL v3 管辖):
- 本模组不收集或修改任何数据,且不包含任何枪械包内容。
- 服务器所有者对其分发的枪械包内容承担全部责任。
- 禁止在未获授权的情况下分发受版权保护的枪械包。请尊重枪械包作者。
- 禁止任何形式的破解、逆向工程或非法内存提取。传输加密旨在保护内容;会话密钥为随机生成。
- *严禁修改和重新分发。修改方须对因修改版本引发的任何法律纠纷、恶意软件注入或安全问题承担全部责任。原作者保留追究侵权行为的权利。
- 玩家应仅从官方渠道(Modrinth/GitHub)下载 OSG。在其他地方获得的修改版本与此项目无关。
- API 条款 — 见下文。
? API 条款(点击展开)
ExternalPackRegistry 是 OSG 提供的服务端扩展接口。使用此接口即确认并同意:
- 责任划分 — 模组开发者维护接口代码;服务器所有者确保枪械包内容的版权合规性。OSG 仅为数据通道,不参与内容选择。各负其责,互不越界。
- 侵权处理 — 若枪械包内容引发版权纠纷,责任由配置该内容的服务器所有者承担(无论是直接从
server_gunpacks/ 加载,还是通过 ExternalPackRegistry 传入)。OSG 作者可提供技术日志以帮助追溯来源,支持健康的社区生态。
- 技术边界 — OSG 接收已解密的数据,对模组的解密过程、服务器所有者的内容选择以及解密数据是否包含侵权材料均无可见性或控制权。这并非推卸责任,而是对技术边界的诚实描述。
OSG — Online Server Gunpacks
Server-side TACZ gunpack distribution. Zero setup for players — join and play. Pure in-memory, nothing touches disk.
✨ What problem does this solve?
Protect gunpack authors' art assets + hassle-free server management.
Packs live on the server, players do nothing. Versions are always in sync. No more "I installed it but it's not showing up".
Players load into memory on join, cleared on disconnect — authors' assets are protected from copying.
? Comparison
|
?️ Manual |
⚡ OSG |
| Player setup |
Download & install each pack |
Zero — join and play |
| Updates |
Everyone re-downloads |
Replace once on server |
| Security |
Files exposed on disk |
In-memory + encrypted transport |
| Consistency |
Version mismatches cause bugs |
Server-enforced |
? Features
| Feature |
Description |
| ✅ Server digital signature |
Client rejects fake servers, anti-phishing |
| ? Forced version sync |
Update once on server, everyone gets it — no more "I installed it" |
| ? Zero maintenance |
Players install nothing. Adding a new pack requires no server-wide announcement |
| ⚡ No TACZ modification |
Just feeds resources to TACZ in-memory |
| ? Bonus protection |
Pure memory, players can't copy files — anti-piracy comes for free |
| ? Any format |
Folders or zips (zip is better) |
| ✅ All TACZ packs |
Except encrypted ones |
? How It Works
TACZ loads gunpacks through Forge's RepositorySource interface — it scans the tacz/ folder, wraps each pack as a PathPackResources, and hands them to Minecraft's resource system.
OSG does the exact same thing, but the files come from memory instead of disk:
- Server scans
server_gunpacks/ → sends packs to clients over the network
- Client assembles them in RAM → provides them as
PackResources through the same RepositorySource interface
- TACZ sees them exactly like local files — no difference. No Mixin. No patch. And the player never gets the raw file.
Think of it as clicking "Done" on the resource pack prompt, but everything stays in RAM.
? Installation
| Side |
What to do |
| ?️ Server |
Install OSG, put packs in server_gunpacks/ |
| ? Client |
Install OSG. That's it. |
? Tip: Put frequently updated packs, or packs you don't want players copying, in server_gunpacks/. Stable base packs can stay local — saves bandwidth and hassle.
? Requirements
Minecraft 1.20.1
Forge 47.3+
TACZ 1.1.8
⌨️ Commands
| Command |
Description |
/osg status |
Show loaded packs |
/osg reload |
Server-side hot reload (connected players need to rejoin) |
❌ Not Supported
⚠️ Encrypted packs (Arcana, etc.) — use their original loader. OSG does not decrypt.
❓ FAQ
? How do I update packs?
Replace files in server_gunpacks/, run /osg reload. Connected players keep the old version; new joiners get the update. Packs loaded via the API cannot be hot-updated.
⚖️ Is this copyright infringement?
OSG is a neutral transport tool. Technical facts:
- No modification — CRC32 integrity ensures byte-level fidelity. The tool does not alter any gunpack data.
- In-memory loading — Pack data is loaded into memory and cleared on disconnect. No permanent copies are created.
⚠️ Important: A neutral tool does not guarantee legality. Server owners must verify they have the right to distribute the packs they configure. Distributing unlicensed copyrighted material may still constitute infringement. Strongly recommend only distributing original or explicitly authorized packs.
? Does this use a lot of memory?
No — and it was already being used.
TACZ loads all gunpack files into memory regardless of whether they come from the local tacz/ folder or through OSG. The memory usage is exactly the same. OSG just skips the "write to disk, then read into memory" step — zero extra overhead.
Data is cleared on disconnect and does not stay resident.
? How does this benefit gunpack authors?
OSG does not change your copyright. Your art assets remain fully yours.
- Players never access raw files (in-memory, cleared on disconnect) — your models, textures, and sounds cannot be casually copied and spread.
- Server-side version management means no compatibility issues from outdated local copies.
This isn't about pushing a new order — just giving creators who want to protect their work an option they didn't have before.
?️ How does this prevent version mismatch bugs?
All players load the exact same pack data from the server. No one can accidentally use an outdated local copy, because there are no local copies. "I installed it but it's not showing up" becomes a thing of the past.
? Minecraft 1.21?
Will follow when TACZ updates to 1.21.
? Security
OSG protects gunpacks end-to-end with near-zero performance cost.
? Pack authors: to protect your work from unauthorized copying, have server owners distribute through OSG — players have no direct access to the raw files.
? Developer API
If your mod has its own pack loading logic (decryption, custom formats, etc.), hand the unpacked data to OSG — no disk write needed:
ExternalPackRegistry.register(() -> {
Map<String, byte[]> files = prepareFiles();
return List.of(new ExternalPack("pack_id", "namespace", files));
});
? License
Current (Beta): Source code — all rights reserved. Compiled jar — free to redistribute. Modification and redistribution prohibited.
After stable release: Will be open-sourced under GPL v3, with the following exception:
Encryption Layer Exception: Server owners may modify the encryption/obfuscation code (com.hxwi1.ssg.util.*) for security purposes and distribute the modified jar to their own players without disclosing the source of those specific modifications. All other modifications remain subject to GPL v3. Public redistribution of modified versions (not server-specific) still requires full source disclosure.
⚠️ OSG's transport encryption prevents network eavesdropping (packet capture yields ciphertext only). To be clear: no client-side software can prevent a user from modifying their own client to extract data — this is a fundamental limitation of all locally-running software, not specific to OSG or its license.
? Credits
Built on the excellent work of the TACZ team.
❗❗ Disclaimer
By installing this mod, you agree to the following terms (items marked with * apply only during beta; the official release is governed by GPL v3):
- This mod does not collect or modify any data, and contains no gunpack content.
- Server owners are solely responsible for the gunpack content they distribute.
- Distributing copyrighted gunpacks without authorization is prohibited. Respect gunpack authors.
- Any form of cracking, reverse engineering, or illegal memory extraction is prohibited. Transport encryption exists to protect content; session keys are randomly generated.
- *Modification and redistribution are strictly prohibited. The modifying party bears full liability for any legal disputes, malware injection, or security issues caused by modified versions. The original author reserves the right to pursue infringement claims.
- Players should only download OSG from official channels (Modrinth/GitHub). Modified versions obtained elsewhere are not affiliated with this project.
- API Terms — see below.
? API Terms (click to expand)
ExternalPackRegistry is a server-side extension interface provided by OSG. By using this interface, you confirm and agree:
- Responsibility Split — Mod developers maintain interface code; server owners ensure copyright compliance of gunpack content. OSG is a data channel and does not participate in content selection. Everyone owns their part, nobody crosses lines.
- Infringement Handling — If copyright disputes arise over gunpack content, responsibility belongs to the server owner who configured that content (whether loaded directly from
server_gunpacks/ or passed through ExternalPackRegistry). The OSG author may provide technical logs to help trace the source and support a healthy community ecosystem.
- Technical Boundary — OSG receives already-decrypted data and has no visibility into or control over the mod's decryption process, the server owner's content choices, or whether the decrypted data contains infringing material. This isn't shifting blame — it's an honest description of the technical boundary.
评论 0
登录后参与评分
还没有评论,来抢沙发吧