# 🖼️ Système de Resource Pack

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

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

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: ""

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"

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

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

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

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

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é.

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

• 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

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.

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

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"

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"