🧩 Intégration Home Assistant pour CubeCoders AMP
Intégration personnalisée permettant de connecter CubeCoders AMP à Home Assistant.
Elle offre une découverte automatique des instances, des capteurs de statut et de joueurs, ainsi qu’une interface de configuration.
✨ Fonctionnalités
- 🔍 Découverte automatique des instances AMP
- 🧩 Sélection des instances à intégrer
- 📡 Intervalle de mise à jour configurable
- 📊 Capteurs intégrés :
- Statut de l’instance
- Nombre de joueurs connectés
- 🔧 Options Flow pour modifier les paramètres après installation
📦 Installation
🔹 Via HACS (recommandé) (Non disponible avant publication)
- Ouvrir HACS → Intégrations
- Cliquer sur Custom repositories
- Ajouter :
https://github.com/Potier51/HA-AMP-CubeCoders - Catégorie : Integration
- Installer l’intégration
- Redémarrer Home Assistant
🔹 Installation manuelle
- Télécharger le dépôt
- Copier le dossier :
customcomponents/ampcubecoders
dans :
/config/custom_components/
- Redémarrer Home Assistant
⚙️ Configuration
- Aller dans Paramètres → Appareils & Services
- Cliquer sur Ajouter une intégration
- Rechercher CubeCoders AMP
- Entrer :
- Adresse du serveur AMP
- Nom d'utilisateur
- Mot de passe
- L’intégration teste automatiquement la connexion
- Sélectionner les instances à intégrer
- Choisir l’intervalle de mise à jour
📊 Capteurs disponibles
Chaque instance sélectionnée crée automatiquement :
| Capteur | Description |
|---|---|
| Status | État de l’instance (Running, Stopped, etc.) |
| Players | Nombre de joueurs connectés |
🛠️ Options Flow
Après installation, tu peux modifier :
- les instances sélectionnées
- l’intervalle de mise à jour
Depuis :
Paramètres → Appareils & Services → CubeCoders AMP → Configurer
🔐 Permissions nécessaires
L’intégration utilise :
- l’adresse du serveur AMP
- Un utilisateur (il est conseillé d'en avoir un dédié, ainsi qu'un profil rôles)
- Un mot de passe ( 40 caractères sont pris en charges par AMP)
❗ Dépannage
🔸 Erreur : cannot_connect Causes possibles :
- Mauvaise adresse IP ou port
- Nom d'utilisateur incorrect
- Mot de passe incorrect
- AMP ne répond pas
- Pare-feu ou NAT bloquant l’accès
🔸 Aucune instance détectée
- Vérifier que le compte API a accès aux instances
- Vérifier que le module ADS est actif dans AMP
🧭 Roadmap
Fonctionnalités prévues :
- Capteurs CPU / RAM / Uptime
- Actions Start / Stop / Restart
- Capteurs de logs
- Capteurs de ports ouverts
- Capteurs de version AMP
- Support des serveurs distants multi‑ADS
🤝 Contribuer
Les contributions sont les bienvenues !
N’hésite pas à ouvrir une issue ou une pull request.
📄 Licence
MIT License