Skip to main content
Version: 2.0.0

Git Resource Pack Management & Server

QUIPT includes an automated Resource Pack Management Engine (ResourcePackHandler). Server owners maintain their resource pack in a Git repository (GitHub, GitLab, Gitea). QUIPT automatically pulls the latest changes, builds the .zip archive, generates a SHA-1 checksum, and serves it over HTTP to connecting players.

Complete Workflow​

sequenceDiagram
    autonumber
    participant Dev as Pack Developer / Artist
    participant Git as GitHub / GitLab Repo
    participant Hook as Quipt Webhook (/resources/update)
    participant RP as ResourcePackHandler
    participant Jetty as Embedded Jetty Server
    participant MC as Minecraft Client

    Dev->>Git: git push origin main
    Git->>Hook: HTTP POST Webhook
    Hook->>RP: updateRepo() (via JGit)
    RP->>RP: git.pull() latest commit
    RP->>RP: Zip contents into pack.zip
    RP->>RP: Calculate SHA-1 Checksum
    RP->>Jetty: Host pack.zip at /resources
    MC->>Jetty: GET /resources (Download Pack)
    Jetty-->>MC: Stream pack.zip with verified SHA-1

Configuration (resources.qpt / resources.json)​

Resource pack settings are stored in quipt/data/resources.qpt (or resources.json):

quipt/data/resources.qpt
repo_url=https://github.com/YourOrg/ServerResourcePack.git
repo_branch=main
enabled=true

# Optional authentication for private repositories
auth.isPrivate=false
auth.username=git_user
auth.password=git_token_or_password

# Internal checksum cache (auto-generated)
hashes.encrypted_zip_hash=a1b2c3d4e5f6...
hashes.commit_hash=9f8e7d6c...

Setting Up Automatic Webhooks​

To have your server update its pack instantly when you push to GitHub or GitLab:

  1. In your Git repository, navigate to Settings > Webhooks > Add Webhook.
  2. Set the Payload URL to: 
    http://<YOUR_SERVER_IP>:5252/resources/update
  3. Set the Content type to application/json.
  4. Trigger on Just the push event.

Manual In-Game Commands​

Administrators can force an immediate sync from within Minecraft:

# Trigger an immediate git pull and zip rebuild
/resourcepack update