Getting Started

What is PolyPack?

PolyPack is a collection of 18 server-side Minecraft mods built with Polymer. Every mod works with vanilla clients - players connect with a standard Minecraft client and experience custom items, blocks, GUIs, and entities with no client mods required. Polymer handles server-side resource pack generation and virtual entity rendering automatically.

Requirements

• Minecraft 1.21.1
• Fabric Loader 0.18.4+
• Fabric API (latest for 1.21.1)
• Polymer (core libs are bundled with PolyPack)
• SGUI (server-side GUI library - bundled)

Installation

1. Install Fabric Loader for Minecraft 1.21.1 on your dedicated server or LAN host.
2. Download the PolyPack JARs from the latest GitHub Release.
3. Place the JARs you want in your server’s mods/ folder.
4. Start the server once so Polymer can generate the resource pack automatically.
5. Let players connect with vanilla Minecraft. The server sends the resource pack on join.

Recommended Server Layout

• Directoryserver/

  • Directorymods/

    • digitalchest-<version>.jar
    • battlefox-<version>.jar
    • wallet-<version>.jar
    • ...
  • Directoryconfig/

    • battlefox.*
    • wallet.*
    • polyciv.*
  • Directoryworld/

    • …
  • server.properties

Tip

Players do not need any client mods. Custom textures, items, and GUIs are all delivered through the server resource pack.

Choosing Your Mods

PolyPack is fully modular. Every mod can be installed independently unless noted. Pick and choose what fits your server:

Core Tech & Storage

Mod	Description	Dependencies
Digital Chest	Infinite server-side storage with search, sorting, color channels, and automation	Standalone
Polymer Pipes	Tiered item transport with filters, priority routing, and visual animations	Standalone (optional: Digital Chest for pipe integration)
PolyTech	Energy system with generators, machines (macerator, compressor, furnace), cables, and wireless power	Requires Digital Chest + Polymer Pipes
PolyBBSM	Multi-capacity buckets and upgraded shears with wood and special-material variants	Standalone

RPG & Combat

Mod	Description	Dependencies
Battle Fox	Tame and bond with a combat fox - RPG progression with tiers, armor, and special moves	Standalone
Guardian Mobs	Convert Creakings and Skeletons into loyal base defenders with special attacks	Standalone

Civilization & Economy

Mod	Description	Dependencies
PolyCiv	Full NPC village simulation - 25+ buildings, seasons, events, traits, and population growth	Standalone (optional: Wallet for economy, Digital Chest for storage)
Wallet	Double-entry ledger economy with casino games (blackjack, poker, roulette, scratch cards)	Standalone (optional: Digital Chest)
PolyGuild	Adventurer’s guild with procedural quests, bounty board, and rank progression	Standalone (optional: Wallet for payouts)

Magic & Nature

Mod	Description	Dependencies
PolyMagic	21 spells across 6 schools, mana system, 12 staffs, and spell mastery	Standalone
PolyCrops	Crop genetics, crossbreeding, mutations, irrigation, and seed analysis	Standalone

Building & Decoration

Mod	Description	Dependencies
PolyDecor	Decorative furniture and props via Polymer display entities	Standalone
Polymer Templates	Structure capture and paste with an in-world template editor	Standalone

Minigames

Mod	Description	Dependencies
Wallet Bowling	Solo ten-pin bowling with wallet-backed betting	Requires Wallet
Fishing Duel / Archery Duel	Competitive two-player minigames with spectator betting	Standalone (optional: Wallet for betting)
PolyVolley	Server-side volleyball with arena courts and scoring	Standalone (optional: Wallet for wagers)

Compatibility

Mod	Description	Dependencies
Advanced Netherite Patch	Makes the Advanced Netherite mod work with Polymer	Requires Advanced Netherite (external)
Client Companion	Optional client-side mod with JEI/REI/EMI recipe integration and terminal enhancements	Client-side only, auto-detects installed mods

Dependency Chain

PolyTech -> requires Digital Chest + Polymer Pipes
Wallet Bowling -> requires Wallet

Everything else is pick-and-choose. “Optional” dependencies enable extra integration - for example, PolyCiv can use Wallet for Village Coin redemption, but runs fine without it.

Note

Soft dependencies are auto-detected at startup. If the optional mod is present, integration activates. If not, the feature is simply hidden. No configuration needed.

Quick Start Recommendations

First time? Start with these three for a well-rounded experience:

• Digital Chest - infinite storage solves inventory headaches fast
• Battle Fox - a fun combat companion from day one
• Wallet - gives your server an economy backbone

Want the full tech tree? Add Digital Chest -> Polymer Pipes -> PolyTech for a complete industrial automation stack.

Building a community server? Add PolyCiv + Wallet + PolyGuild for NPC villages, an economy, and quest content that keeps players engaged.

Configuration

Most mods work out of the box with zero config. Server-specific settings (like economy starting balance, PolyCiv simulation tick rate, etc.) are exposed in each mod’s config files under config/ in your server directory. Check individual mod pages for details.

Updating

Drop the new JARs into mods/ and restart the server. Polymer regenerates the resource pack automatically. Database-backed mods (Wallet, PolyCiv) handle schema migrations on startup.