🖼️ Système de Resource Pack

📦 PrésentationCopy Anchor Link

Le système de resource pack de Horizons permet de :

• Héberger automatiquement vos resource packs via un serveur HTTP intégré
• Forcer ou suggérer l'utilisation du resource pack aux joueurs
• Gérer plusieurs resource packs et changer entre eux facilement
• Utiliser une URL externe si vous préférez héberger votre pack ailleurs

🗂️ Structure des FichiersCopy Anchor Link

Les resource packs doivent être placés dans le dossier plugins/Horizons/resourcepacks/ au format .zip.

⚙️ ConfigurationCopy Anchor Link

🔧 Configuration de BaseCopy Anchor Link

resourcepack:
  # Activer ou désactiver la fonctionnalité
  enabled: true

  # Message affiché lors de la demande de téléchargement
  prompt-message: "&aLe serveur utilise un resource pack pour une meilleure expérience !"

  # Port pour le serveur HTTP intégré
  port: 8080

  # Forcer l'utilisation du resource pack
  force: false

  # Délai avant d'envoyer le pack après la connexion (en ticks)
  join-delay: 40

  # Nom du pack actif par défaut (vide = premier pack trouvé)
  active-pack: ""

🔍 Configuration AvancéeCopy Anchor Link

resourcepack:
  # Activer ou désactiver la fonctionnalité
  enabled: true
  # Options de débogage
  debug: false

  advanced:
    # URL externe (si vous voulez héberger le pack vous-même)
    external-url: ""

    # Hash SHA-1 du pack externe
    external-hash: ""

    # Appliquer les mises à jour aux joueurs déjà connectés
    apply-updates-to-online-players: true

    # Intervalle de vérification des changements (en minutes)
    # Définir à 0 ou une valeur négative pour désactiver les vérifications automatiques
    check-interval: 5

    # Nom personnalisé pour le serveur HTTP dans les logs
    server-name: "Horizons ResourcePack Server"

🛠️ CommandesCopy Anchor Link

/resourcepack (Alias: /rpack, /respack)Copy Anchor Link

🔄 FonctionnementCopy Anchor Link

🖥️ Serveur HTTP IntégréCopy Anchor Link

Le plugin intègre un serveur HTTP qui héberge automatiquement vos resource packs. Les avantages sont :

• Pas besoin d'un hébergement externe
• Détection automatique de l'IP publique du serveur
• Mise en cache pour optimiser les performances
• Équilibrage de charge pour les grands serveurs

🌐 Détection d'IP et Considérations de RéseauCopy Anchor Link

Comment Fonctionne la Détection d'IPCopy Anchor Link

Pour que les joueurs puissent télécharger votre resource pack, le système doit connaître l'adresse IP publique du serveur. Horizons utilise une approche en plusieurs étapes :

1. Vérification si l'IP du serveur est utilisable (non locale/privée)
2. Si l'IP est locale/privée (comme 127.0.0.1, 192.168.x.x, etc.), le système tente de détecter l'IP publique via des services externes
3. Les services suivants sont consultés dans l'ordre (pour la redondance) :
   • api.ipify.org
   • checkip.amazonaws.com
   • icanhazip.com

Serveurs en Réseau Local (Important)Copy Anchor Link

Si vous hébergez votre serveur sur un réseau local:

⚠️ Vous devez ouvrir le port configuré dans votre routeur/pare-feu ⚠️

1. Configurez la redirection de port dans votre routeur (port forwarding)
2. Dirigez le port externe vers l'IP locale de votre serveur Minecraft
3. Assurez-vous que les pare-feu (Windows, etc.) autorisent également ce port

Exemple de redirection de port :
Port externe: 8080 → IP interne: 192.168.1.x → Port interne: 8080

Considérations de ConfidentialitéCopy Anchor Link

La détection d'IP publique nécessite de contacter des services externes. Si vous avez des préoccupations de confidentialité :

• Utilisez plutôt l'option external-url pour héberger votre pack sur un service externe
• Configurez manuellement l'IP dans les paramètres de votre serveur Minecraft

🔐 Sécurité et AuthentificationCopy Anchor Link

Le système calcule automatiquement le hash SHA-1 de chaque resource pack pour garantir l'intégrité du téléchargement. Minecraft utilise ce hash pour vérifier que le resource pack n'a pas été modifié.

🔄 Mise à Jour AutomatiqueCopy Anchor Link

Si apply-updates-to-online-players est activé, tous les joueurs connectés recevront automatiquement le nouveau resource pack lorsque vous :

1. Changez de pack avec la commande /resourcepack set
2. Rechargez les packs avec /resourcepack reload

📊 OptimisationCopy Anchor Link

Performances du ServeurCopy Anchor Link

• Les resource packs sont servis par lots pour éviter de surcharger le serveur
• Headers de cache configurés pour réduire la charge réseau
• Analyse périodique des nouveaux packs sans impact sur les performances

CompatibilitéCopy Anchor Link

Le système fonctionne sur tous les types d'hébergement, y compris les serveurs à IP privée, grâce à la détection automatique d'IP publique.

📝 Exemples d'UtilisationCopy Anchor Link

Exemple 1: Configuration SimpleCopy Anchor Link

resourcepack:
  enabled: true
  prompt-message: "&aPour une meilleure expérience, acceptez le resource pack!"
  port: 8080
  force: false
  join-delay: 60

Exemple 2: Utilisation d'un Pack ExterneCopy Anchor Link

resourcepack:
  enabled: true
  force: true
  prompt-message: "&cLe resource pack est obligatoire sur ce serveur!"
  advanced:
    external-url: "https://monsite.com/monpack.zip"
    external-hash: "0123456789abcdef0123456789abcdef01234567"

Exemple 3: Configuration ComplèteCopy Anchor Link

resourcepack:
  enabled: true
  debug: true
  port: 8080
  force: true
  prompt-message: "&6&lResource Pack &7» &ePour une meilleure expérience de jeu!"
  join-delay: 40
  active-pack: "MonPack.zip"
  advanced:
    external-url: ""
    external-hash: ""
    apply-updates-to-online-players: true
    check-interval: 10
    server-name: "MaCité ResourcePack"

🔧 DépannageCopy Anchor Link