Only Server Gunpack

1.0.0 — 2026-06-27

Initial release.

Features

• Server-side gunpack distribution — packs are scanned from server_gunpacks/, streamed to clients on join, and loaded entirely in memory
• AES-256/GCM encrypted transport — per-session random key, per-chunk random IV; packet capture yields ciphertext only
• Key masking — encryption key is XOR-masked before transmission
• Resumable transfer — interrupted downloads resume without restarting
• CRC32 integrity — chunk-level and full-pack checksum verification
• Zero local footprint — gunpack data never touches the client filesystem, auto-cleared on disconnect
• No Mixin — plugs into Forge's standard RepositorySource and PackResources APIs; zero conflicts with other mods
• Sequential pack delivery — packs are sent one at a time with ACK flow to avoid network congestion
• Anti-collision sending — per-player send generation counter prevents stale transfers
• Priority override — server packs load at Pack.Position.TOP, taking precedence over any local duplicates
• External pack provider API — other server mods can register packs programmatically via ExternalPackRegistry
• Client adapter API — client mods can hook post-download processing via ClientAdapterRegistry
• Commands: /osg status and /osg reload
• i18n — English and Simplified Chinese translations

Server Config

[gunpack_paths]
    gunpackDirectory = "server_gunpacks"

[transfer]
    maxPackSizeMB = 100
    chunkSizeBytes = 1048064
    transferTimeoutSeconds = 120
    requireAckBeforeJoin = true

Requirements

• Minecraft 1.20.1
• Forge 47.3+
• TACZ 1.1.8

Known Limitations

• Encrypted packs (e.g. Arcana) are not supported — use their native loader
• Reload may cause a brief client freeze while TACZ processes resources — this is expected