Texture pack côté serveur Minecraft
DOG&DEV · 25/01/2025
Texture pack côté serveur Minecraft
Un resource pack (texture pack, pack de ressources) peut être proposé ou imposé par le serveur à la connexion des joueurs. Ce guide décrit la configuration dans server.properties (URL, hash, resource-pack-prompt) et, brièvement, l’usage de plugins pour aller plus loin.
Prérequis
- Serveur Vanilla, Paper ou Spigot
- Resource pack au format .zip (conforme aux specs Minecraft)
- URL publique (HTTPS) pour télécharger le pack — le serveur ne sert pas le fichier lui‑même, il envoie un lien au client
Hébergement du pack
Le client télécharge le pack depuis une URL. Il faut donc héberger le .zip sur :
- Un serveur web (Apache, Nginx) sur le même VPS ou un autre
- Un CDN ou stockage (Amazon S3, Cloudflare R2, etc.)
- Un outil de partage de fichiers (Dropbox, Google Drive, etc. — attention aux liens directs et à la stabilité)
L’URL doit être HTTPS pour que les clients 1.19+ l’acceptent (en 1.18 et avant, HTTP était encore accepté). Ex. : https://example.com/packs/monpack.zip.
server.properties
Dans server.properties :
# URL du resource pack (HTTPS recommandé)
resource-pack=https://example.com/packs/monpack.zip
# Hash SHA-1 du fichier .zip (en minuscules, sans espaces)
# Optionnel mais recommandé : le client vérifie l’intégrité
resource-pack-sha1=abc123def456...
# Inviter le joueur à télécharger (true) ou forcer (false, selon les versions)
# true = bouton « Télécharger » / « Accepter » ; false = refus = déconnexion
resource-pack-prompt=
- resource-pack : URL du .zip.
- resource-pack-sha1 : hash SHA-1 du fichier .zip. Pour le générer (Linux/macOS) :
sha1sum monpack.zip
Copier la chaîne en minuscules, sans espaces, dans resource-pack-sha1. Si laissé vide, le client ne vérifie pas ; certaines versions peuvent afficher un avertissement.
- resource-pack-prompt :
- Vide ou selon la version : proposer le pack sans message personnalisé.
- Texte : message affiché dans la popup.
- Le fait de forcer (refus = kick) dépend de la version et de
require-resource-packsi elle existe.
Sur les versions récentes, require-resource-pack=true force l’acceptation (refus = déconnexion). À utiliser avec précaution (joueurs lents, mobiles, etc.).
require-resource-pack (si supporté)
require-resource-pack=true
Si true, le joueur doit accepter le pack pour rester connecté. Utile pour des serveurs « tout le monde avec le même pack » ; à éviter si votre pack est très lourd ou si vous ciblez des connexions limitées.
Format du resource pack
Le .zip doit contenir au minimum :
- pack.mcmeta à la racine, ex. :
{
"pack": {
"pack_format": 22,
"description": "Mon pack"
}
}
pack_format dépend de la version Minecraft (wiki) : 22 pour 1.21, 18 pour 1.20.2, etc. Incompatibilité de format = le client peut refuser ou afficher des erreurs.
Plugins
- ResourcePackAPI (Spigot/Paper) : changer le pack par monde ou par joueur, packs multiples, conditions.
- Plugins customs : même idée, avec une URL (et éventuellement un hash) définie dynamiquement.
Pour un usage basique, server.properties suffit.
Dépannage
| Symptôme | Cause possible | Correctif |
|---|---|---|
| « Invalid hash » / checksum | resource-pack-sha1 incorrect ou fichier modifié | Recalculer sha1sum monpack.zip ; mettre à jour le hash après chaque modification du .zip |
| « Failed to download » | URL morte, pas en HTTPS (1.19+), CORS, certificat | Vérifier que l’URL est accessible en HTTPS ; pas de CORS côté Minecraft, mais l’hébergeur ne doit pas bloquer |
| Pack non proposé | Faute de frappe, mauvais chemin | Vérifier resource-pack (espace, typo) ; redémarrer le serveur |
Bonnes pratiques
- Taille : garder le pack raisonnable (< 50–100 Mo) pour ne pas pénaliser les joueurs.
- HTTPS et hash : sécurité et confiance du client.
- Pour l’icône du serveur (liste des serveurs) : icone-minecraft-server. Pour les mods et la config générale : mods-minecraft.
Ressources
Cet article s’inscrit dans notre série de guides hébergement et gaming. Pour un serveur sur-mesure, contact.