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

🎯 Features

🔧 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:

1. Server scans server_gunpacks/ → sends packs to clients over the network
2. Client assembles them in RAM → provides them as PackResources through the same RepositorySource interface
3. 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

💡 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

❌ Not Supported

⚠️ Encrypted packs (Arcana, etc.) — use their original loader. OSG does not decrypt.

❓ FAQ

🔒 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.