Modèle:MinecraftConnect/doc

Description

Ce modèle crée un lien pour se connecter directement à un serveur Minecraft avec un bouton de copie de l'adresse.

Le lien lance automatiquement Minecraft (principalement sur Windows) et le bouton 📋 permet de copier l'adresse pour une connexion manuelle.

Paramètres

Paramètre	Description	Obligatoire	Défaut
serveur	Adresse IP ou nom de domaine du serveur	✓ Oui	-
port	Port du serveur (format :PORT)	✕ Non	:25565
texte	Texte du lien affiché	✕ Non	Rejoindre le serveur
titre	Texte au survol (attribut title)	✕ Non	Cliquez pour vous connecter au serveur Minecraft
label	Label d'accessibilité du bouton copier (aria-label)	✕ Non	Copier l'adresse du serveur
icone	Icône/emoji du bouton copier	✕ Non	📋
message	Message affiché après la copie	✕ Non	✓ Copié !

Exemples d'utilisation

Exemple basique

{{MinecraftConnect|serveur=play.hypixel.net}}

Serveur Minecraftnefald.fr<button class="mc-connect-copy" onclick="copyMCAddress()" title="Copier l'adresse">📋</button>

<script>

function copyMCAddress() { var address = document.getElementById('mc-address').textContent; navigator.clipboard.writeText(address).then(function() { var btn = document.querySelector('.mc-connect-copy'); btn.textContent = '✓'; btn.style.background = '#4CAF50'; setTimeout(function() { btn.textContent = '📋'; btn.style.background = ; }, 2000); }).catch(function() { alert('Adresse: ' + address); }); } </script>

---

Avec port personnalisé

{{MinecraftConnect
|serveur=monserveur.fr
|port=:25566
|texte=Mon serveur perso
}}

Serveur Minecraftnefald.fr<button class="mc-connect-copy" onclick="copyMCAddress()" title="Copier l'adresse">📋</button>

<script>

function copyMCAddress() { var address = document.getElementById('mc-address').textContent; navigator.clipboard.writeText(address).then(function() { var btn = document.querySelector('.mc-connect-copy'); btn.textContent = '✓'; btn.style.background = '#4CAF50'; setTimeout(function() { btn.textContent = '📋'; btn.style.background = ; }, 2000); }).catch(function() { alert('Adresse: ' + address); }); } </script>

---

Exemple complet avec personnalisation

{{MinecraftConnect
|serveur=survival.example.com
|port=:19132
|texte=🌍 Serveur Survie
|titre=Rejoindre le serveur de survie communautaire
|label=Copier l'adresse du serveur Survie
|icone=📑
|message=Adresse copiée !
}}

Serveur Minecraftnefald.fr<button class="mc-connect-copy" onclick="copyMCAddress()" title="Copier l'adresse">📋</button>

<script>

function copyMCAddress() { var address = document.getElementById('mc-address').textContent; navigator.clipboard.writeText(address).then(function() { var btn = document.querySelector('.mc-connect-copy'); btn.textContent = '✓'; btn.style.background = '#4CAF50'; setTimeout(function() { btn.textContent = '📋'; btn.style.background = ; }, 2000); }).catch(function() { alert('Adresse: ' + address); }); } </script>

---

Sans port (utilise le port par défaut 25565)

{{MinecraftConnect
|serveur=mc.example.net
|port=
|texte=Serveur principal
}}

Serveur Minecraftnefald.fr<button class="mc-connect-copy" onclick="copyMCAddress()" title="Copier l'adresse">📋</button>

<script>

function copyMCAddress() { var address = document.getElementById('mc-address').textContent; navigator.clipboard.writeText(address).then(function() { var btn = document.querySelector('.mc-connect-copy'); btn.textContent = '✓'; btn.style.background = '#4CAF50'; setTimeout(function() { btn.textContent = '📋'; btn.style.background = ; }, 2000); }).catch(function() { alert('Adresse: ' + address); }); } </script>

---

Avec emoji personnalisé

{{MinecraftConnect
|serveur=creative.example.com
|texte=⚡ Serveur Créatif
|icone=🎨
}}

Serveur Minecraftnefald.fr<button class="mc-connect-copy" onclick="copyMCAddress()" title="Copier l'adresse">📋</button>

<script>

function copyMCAddress() { var address = document.getElementById('mc-address').textContent; navigator.clipboard.writeText(address).then(function() { var btn = document.querySelector('.mc-connect-copy'); btn.textContent = '✓'; btn.style.background = '#4CAF50'; setTimeout(function() { btn.textContent = '📋'; btn.style.background = ; }, 2000); }).catch(function() { alert('Adresse: ' + address); }); } </script>

---

Style minimaliste

{{MinecraftConnect
|serveur=vanilla.mc.net
|texte=Vanilla
|icone=📋
|message=✓
}}

Serveur Minecraftnefald.fr<button class="mc-connect-copy" onclick="copyMCAddress()" title="Copier l'adresse">📋</button>

<script>

function copyMCAddress() { var address = document.getElementById('mc-address').textContent; navigator.clipboard.writeText(address).then(function() { var btn = document.querySelector('.mc-connect-copy'); btn.textContent = '✓'; btn.style.background = '#4CAF50'; setTimeout(function() { btn.textContent = '📋'; btn.style.background = ; }, 2000); }).catch(function() { alert('Adresse: ' + address); }); } </script>

Comportement

• Lien direct : Le lien cliquable lance Minecraft et se connecte automatiquement (fonctionne principalement sur Windows avec le launcher officiel)
• Bouton copie : Le bouton avec icône copie l'adresse complète (serveur:port) dans le presse-papier
• Feedback visuel : Un message de confirmation apparaît pendant 2 secondes après la copie
• Animation : Le bouton s'anime lors de la copie pour confirmer l'action
• Responsive : Le modèle s'adapte automatiquement aux écrans mobiles

Compatibilité

• Windows : Connexion directe fonctionnelle avec le launcher Minecraft officiel
• macOS/Linux : Support limité du lien direct, utiliser le bouton copier
• Minecraft Java Edition uniquement (pas Bedrock)

Notes techniques

• Nécessite l'autorisation du protocole minecraft:// dans LocalSettings.php
• Le CSS doit être ajouté dans MediaWiki:Common.css
• Le JavaScript doit être ajouté dans MediaWiki:Common.js
• Les pages utilisant ce modèle sont automatiquement ajoutées à Catégorie:Pages avec lien Minecraft

Configuration requise

Ajouter dans LocalSettings.php :

// Autoriser le protocole minecraft://
$wgUrlProtocols[] = 'minecraft://';

Voir aussi

• Modèle:ButtonLink - Pour créer des liens externes stylisés
• Modèle:Lien externe - Pour les liens externes classiques
• Catégorie:Pages avec lien Minecraft - Pages utilisant ce modèle