Resource Pack Hosting

CuriosPaper uses an embedded Netty-based HTTP server to host and serve the generated resource pack to players.

Configuration

resource-pack:
  enabled: true
  port: 8080
  host-ip: "your-server-ip"

How the Server Works

1. On startup, the ResourcePackManager generates a ZIP file from all registered asset sources
2. A SHA-1 hash is calculated for the ZIP
3. A lightweight HTTP server starts on the configured port
4. When players join, they receive the resource pack URL: http://<host-ip>:<port>/pack.zip
5. The Minecraft client downloads and applies the pack

Port Configuration

Scenario	Recommended Port
Dedicated server	8080 or any open port
Shared hosting	Check available ports with your host
Local testing	8080

Never use the game port

The resource pack port must be different from your Minecraft server port (default: 25565). Using the same port will break both services.

Firewall Rules

Ensure the resource pack port is accessible:

Linux (UFW)Linux (iptables)Windows

sudo ufw allow 8080/tcp

sudo iptables -A INPUT -p tcp --dport 8080 -j ACCEPT

netsh advfirewall firewall add rule name="CuriosPaper RP" dir=in action=allow protocol=tcp localport=8080

Server Info

View the current resource pack server status:

/curios rp info

This shows:

• Pack file path and size
• SHA-1 hash
• Number of registered namespaces
• Conflict count

Registering External Assets

Other plugins can add their assets to the generated resource pack:

CuriosPaperAPI api = CuriosPaper.getInstance().getCuriosPaperAPI();
api.registerResourcePackAssets(myPlugin, new File(getDataFolder(), "resourcepack"));

The folder should contain the standard assets/ directory structure:

resourcepack/
└── assets/
    └── myplugin/
        ├── models/
        │   └── item/
        │       └── my_item.json
        └── textures/
            └── item/
                └── my_item.png

Rebuilding

After adding new textures or modifying assets:

/curios rp rebuild

This regenerates the ZIP, recalculates the hash, and pushes the new pack to all online players.