doganddev
Accueil Blog Boutique

Texture pack côté serveur Minecraft

DOG&DEV · 25/01/2025

Sécurité Firewall
Texture pack côté serveur Minecraft

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-pack si 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.

Commentaires (0)

Laisser un commentaire