MINECRAFTHUB.IO
Installation

How to Add a Resource Pack to a Minecraft Server

How to add a resource pack to a Minecraft server, from hosting the zip file at a direct link to setting the SHA-1 hash and the resource-pack fields in server.properties.

MinecraftHub-generated editorial cover showing a lime pack block on one voxel island linked by an arrow to a server tower on another

Updated

A Minecraft server does not store or serve the resource pack file to players. You host the pack's zip file somewhere with a direct download link, then point server.properties at that link along with a matching SHA-1 hash. When a player connects, the server sends them the link and the hash, and their client downloads and applies the pack before they see the world. Get the link or the hash wrong and the server resource pack silently fails to load, which is the most common support question in this whole process.

The URL in resource-pack has to resolve straight to the zip file, nothing in between. A share link from Dropbox or Google Drive opens an HTML preview page first, and Minecraft's client cannot follow that redirect, so the download fails for every player who tries to connect. A GitHub release asset, a raw file host, or a web server you control all work because they return the file itself, not a page about the file.

If you have not picked a pack yet, our resource pack section is a good place to start. Packs like Bare Bones and Faithful 32x read clearly at a distance and work well as server-wide defaults, and Default Dark Mode is a lighter change players are less likely to decline.

Generate the SHA-1 hash for the pack

Minecraft clients cache a resource pack by its SHA-1 hash, not by its file name or URL. Update the zip on your host without updating the hash in server.properties, and connecting players keep using their cached copy of the old pack instead of downloading the new one. Generate a fresh hash every time the file changes, then update resource-pack-sha1 to match.

  1. 1.On Linux or macOS, run sha1sum resourcepack.zip in the folder holding the file.
  2. 2.On Windows, run certutil -hashfile resourcepack.zip SHA1 in Command Prompt.
  3. 3.Copy the 40-character hash exactly as printed, with no line breaks or extra spaces, into resource-pack-sha1.

Set the resource-pack fields in server.properties

Four fields in server.properties control the whole process.

  • resource-pack holds the direct download URL for the zip file.
  • resource-pack-sha1 holds the 40-character hash of that exact file, used to verify the download and detect when it changes.
  • resource-pack-prompt sets a custom message in the accept-or-decline dialog. Leave it blank to use Minecraft's default wording.
  • require-resource-pack, set to true or false, decides what happens next: true disconnects a player who declines or fails the download, false lets them join without the pack.

What players see when they join

A player connecting to a server with resource-pack set gets a prompt asking to accept or decline the pack before the world loads. Accepting downloads the zip into the server-resource-packs folder inside their Minecraft install and applies it for that session, and the client keeps it cached there under its hash for next time. Declining, or failing the download, leaves the player on default textures unless require-resource-pack is true, in which case they are disconnected instead.

Frequently asked questions

How do I force players to download the resource pack?

Set require-resource-pack=true in server.properties. A player who declines the prompt, or whose client fails to download the pack, is disconnected instead of joining without it. This is the only way to make a server resource pack mandatory; there is no separate whitelist or permission setting for it.

What does the resource-pack-sha1 field actually do?

It verifies that the file the client downloaded matches the file the server expects, and it tells the client when to skip a cached copy and fetch a fresh one. Clients store packs by hash under server-resource-packs, so an outdated hash can serve players a version of the pack you already replaced. Regenerate the hash and update this field every time you upload a new zip.

Why does the resource pack fail to download for some players?

The most common cause is a download link that is not direct, a Dropbox or Google Drive share page instead of the raw file. Other causes include a resource-pack-sha1 that no longer matches the file, a file host that blocks Minecraft's client or rate-limits repeated downloads, and a corporate or school network that blocks the file type outright. Test the link in a private browser window first, and confirm the hash matches the file currently at that URL.

Resources mentioned.

Related guides.