À faire une seule fois par téléphone.

1. Dans le lanceur, ouvrez Paramètres et cochez Ouvrir l'appli aux appareils de mon réseau local (téléphone).
2. Redémarrez le monde : ARRÊTER LE MONDE, puis DÉMARRER LE MONDE. La première fois, Windows peut demander s'il faut autoriser Node.js : autorisez-le sur les réseaux privés seulement.
3. Cliquez sur Téléphone, onglet Même Wi-Fi. Le lanceur affiche un QR code et un code court, par exemple K7QM-4XWD.
4. Reliez votre téléphone au même Wi-Fi que le PC (pas le réseau « invité » de la box).
5. Ouvrez l'appareil photo du téléphone, visez le QR code et touchez le lien qui apparaît. Le téléphone est appairé et l'appli s'ouvre.
6. Sans appareil photo : ouvrez sur le téléphone l'adresse affichée sous le code (de la forme http://192.168.x.x:5210/appairer), saisissez le code court et touchez Appairer.

Le QR code et le code valent 10 minutes et ne servent qu'une fois chacun. Le bouton Nouveau code en donne d'autres.

Ajouter Guildmaster à l'écran d'accueil

Une fois l'appli ouverte, un bandeau propose Comment faire et donne les étapes de votre téléphone :

• iPhone (Safari) : touchez le bouton Partager (le carré avec une flèche vers le haut), choisissez Sur l'écran d'accueil, puis Ajouter. Sur iPhone, l'icône s'appaire à part : à sa première ouverture, elle demande un code. Dans l'aide de l'appli, touchez Afficher un code pour l'icône (ou prenez un nouveau code dans le lanceur) et saisissez-le dans l'icône dans les 10 minutes.
• Android (Chrome) : menu (les trois points en haut à droite), puis Ajouter à l'écran d'accueil ou Installer l'application.
• Samsung Internet : menu, puis Ajouter la page à, puis Écran d'accueil.

Sur le Wi-Fi de la maison, l'adresse commence par http : Android ouvre alors l'icône dans un onglet du navigateur, c'est normal. Par Tailscale (ci-dessous), l'adresse est en https et Guildmaster s'installe comme une vraie appli. Sur le Wi-Fi, la connexion n'est pas chiffrée : sur un réseau que vous ne maîtrisez pas, passez par Tailscale.

Tailscale est un service gratuit pour un usage personnel : il relie votre téléphone à votre PC par un réseau privé chiffré, où que vous soyez. Seuls vos appareils, connectés à votre compte Tailscale, y ont accès. Vous l'installez une fois ; comptez une quinzaine de minutes.

Étape A : créer votre compte Tailscale

1. Sur le PC, ouvrez le site officiel tailscale.com/download.
2. À la première connexion, Tailscale vous propose de vous connecter avec un compte que vous avez déjà : Google, Microsoft, Apple ou GitHub. Choisissez-en un et retenez lequel : il faudra le même sur le téléphone. Aucun mot de passe Tailscale n'est à inventer.

Étape B : Tailscale sur le PC

1. Depuis tailscale.com/download, téléchargez Tailscale pour Windows et lancez l'installeur.
2. À la fin, Tailscale ouvre une page de connexion dans votre navigateur : connectez-vous avec le compte choisi à l'étape A.
3. Une icône Tailscale apparaît près de l'horloge de Windows : le PC est connecté.

Étape C : Tailscale sur le téléphone

1. Installez l'appli Tailscale depuis l'App Store (iPhone) ou le Play Store (Android).
2. Ouvrez-la et connectez-vous avec le même compte que sur le PC.
3. Le téléphone demande d'autoriser une configuration VPN : acceptez. C'est ainsi que Tailscale fonctionne.
4. Vérifiez que Tailscale est activé sur le téléphone (interrupteur sur « connecté ») : votre PC apparaît dans la liste de ses appareils.

Étape D : partager l'appli depuis le lanceur

1. Dans le lanceur, cliquez sur Téléphone, onglet Partout (Tailscale). Le lanceur lit l'état de Tailscale ; touchez Actualiser si besoin.
2. S'il affiche Activez les certificats HTTPS du tailnet : cliquez sur Ouvrir la console Tailscale (DNS), activez MagicDNS et HTTPS Certificates, puis revenez et touchez Actualiser.
3. Cliquez sur Partager l'appli sur mon tailnet. Le lanceur vous montre la commande qu'il va lancer et vous demande de confirmer : acceptez. Rien n'est ouvert sur Internet.
4. Si Tailscale demande d'autoriser le partage : cliquez sur Ouvrir la page d'autorisation, autorisez Serve pour ce PC, puis cliquez de nouveau sur Partager l'appli sur mon tailnet.
5. Un QR code apparaît, avec une adresse sécurisée de la forme https://nom-du-pc.xxxx.ts.net. Scannez-le avec le téléphone (Tailscale activé) : le téléphone est appairé et l'appli s'ouvre.
6. Ajoutez Guildmaster à l'écran d'accueil comme plus haut : en https, il s'installe comme une vraie appli (Installer l'appli).

C'est fait : l'appli s'ouvre en Wi-Fi comme en 4G, tant que le PC reste allumé et le monde démarré. Pour arrêter le partage plus tard : tapez tailscale serve reset dans une invite de commandes.

En 4G, la page ne s'ouvre pas

Le téléphone doit être connecté à Tailscale avec le même compte que le PC. Ouvrez l'appli Tailscale sur le téléphone : votre PC doit figurer dans la liste.

Tailscale est coupé sur le téléphone

Tailscale passe par la fonction VPN du téléphone. Si l'interrupteur est sur « déconnecté », ou si un autre VPN a pris la place, réactivez Tailscale.

Le PC est éteint ou en veille

L'appli lit votre monde sur le PC : il doit être allumé, pas en veille, et le monde démarré. Si besoin, réglez la mise en veille dans les paramètres d'alimentation de Windows.

Le code est refusé

Un code vaut 10 minutes et ne sert qu'une fois. Dans le lanceur, cliquez sur Nouveau code.

Sur le Wi-Fi, la page ne s'ouvre pas

Vérifiez que le téléphone est sur le même Wi-Fi que le PC (pas un réseau invité), que la case des Paramètres est cochée, que le monde a été redémarré, et que le pare-feu de Windows autorise Guildmaster sur les réseaux privés.

Un téléphone perdu ou prêté

Dans le lanceur, Téléphone, onglet Appareils : choisissez le téléphone et cliquez sur Révoquer. Il ne peut plus ouvrir l'appli, tout de suite, sans redémarrer le monde. Tout révoquer les retire tous.

Toujours bloqué ? Demandez sur le Discord de Guildmaster, salon #aide en français.

Aucun téléphone n'ouvre l'appli sans avoir été appairé par un code à usage unique, et un téléphone perdu se révoque en un clic. Par Tailscale, tout passe chiffré entre vos seuls appareils, et Guildmaster n'ouvre jamais de port sur votre box ni sur Internet.

Once per phone.

1. In the launcher, open Settings and tick Open the app to devices on my local network (phone).
2. Restart the world: STOP THE WORLD, then START THE WORLD. The first time, Windows may ask whether to allow Node.js: allow it on private networks only.
3. Click Phone, Same Wi-Fi tab. The launcher shows a QR code and a short code, for example K7QM-4XWD.
4. Connect your phone to the same Wi-Fi as the PC (not your router's “guest” network).
5. Open the phone's camera, point it at the QR code and tap the link that appears. The phone is paired and the app opens.
6. Without a camera: on the phone, open the address shown under the code (like http://192.168.x.x:5210/appairer), enter the short code and tap Pair.

The QR code and the code are valid for 10 minutes and work once each. The New code button gives you new ones.

Add Guildmaster to your home screen

Once the app is open, a banner offers How to and gives the steps for your phone:

• iPhone (Safari): tap the Share button (the square with an upward arrow), choose Add to Home Screen, then Add. On iPhone, the icon is paired separately: the first time it opens, it asks for a code. In the app's help, tap Show a code for the icon (or get a new code from the launcher) and enter it in the icon within 10 minutes.
• Android (Chrome): menu (the three dots at the top right), then Add to Home screen or Install app.
• Samsung Internet: menu, then Add page to, then Home screen.

On your home Wi-Fi, the address starts with http: Android then opens the icon in a browser tab, which is normal. Through Tailscale (below), the address is https and Guildmaster installs like a real app. On Wi-Fi, the connection is not encrypted: on a network you do not control, use Tailscale.

Tailscale is a service that is free for personal use: it links your phone to your PC through an encrypted private network, wherever you are. Only your devices, signed in to your Tailscale account, can reach it. You set it up once; allow about fifteen minutes.

Step A: create your Tailscale account

1. On the PC, open the official website tailscale.com/download.
2. The first time, Tailscale offers to sign in with an account you already have: Google, Microsoft, Apple or GitHub. Pick one and remember which: you will need the same one on your phone. No Tailscale password to invent.

Step B: Tailscale on the PC

1. From tailscale.com/download, download Tailscale for Windows and run the installer.
2. At the end, Tailscale opens a sign-in page in your browser: sign in with the account chosen in step A.
3. A Tailscale icon appears near the Windows clock: the PC is connected.

Step C: Tailscale on the phone

1. Install the Tailscale app from the App Store (iPhone) or the Play Store (Android).
2. Open it and sign in with the same account as on the PC.
3. The phone asks you to allow a VPN configuration: accept it. This is how Tailscale works.
4. Check that Tailscale is on (switch set to “connected”): your PC appears in its list of devices.

Step D: share the app from the launcher

1. In the launcher, click Phone, Anywhere (Tailscale) tab. The launcher reads Tailscale's status; press Refresh if needed.
2. If it shows Turn on HTTPS certificates for your tailnet: click Open the Tailscale console (DNS), turn on MagicDNS and HTTPS Certificates, then come back and press Refresh.
3. Click Share the app on my tailnet. The launcher shows you the command it will run and asks you to confirm: accept. Nothing is opened to the Internet.
4. If Tailscale asks you to allow sharing: click Open the authorisation page, allow Serve for this PC, then click Share the app on my tailnet again.
5. A QR code appears, with a secure address like https://pc-name.xxxx.ts.net. Scan it with the phone (Tailscale on): the phone is paired and the app opens.
6. Add Guildmaster to your home screen as above: over https, it installs like a real app (Install the app).

That's it: the app opens on Wi-Fi and on 4G, as long as the PC stays on and the world is running. To stop sharing later, type tailscale serve reset in a command prompt.

On 4G, the page does not open

The phone must be signed in to Tailscale with the same account as the PC. Open the Tailscale app on the phone: your PC must be in the list.

Tailscale is off on the phone

Tailscale uses the phone's VPN feature. If the switch is on “disconnected”, or another VPN has taken its place, turn Tailscale back on.

The PC is off or asleep

The app reads your world on the PC: it must be on, not asleep, and the world running. If needed, change the sleep settings in Windows power options.

The code is refused

A code is valid for 10 minutes and works once. In the launcher, click New code.

On Wi-Fi, the page does not open

Check that the phone is on the same Wi-Fi as the PC (not a guest network), that the Settings box is ticked, that the world was restarted, and that Windows Firewall allows Guildmaster on private networks.

A lost or lent phone

In the launcher, Phone, Devices tab: choose the phone and click Revoke. It can no longer open the app, at once, without restarting the world. Revoke all removes every device.

Still stuck? Ask on the Guildmaster Discord, in #installation.

No phone opens the app without being paired with a single-use code, and a lost phone is revoked in one click. Through Tailscale, everything travels encrypted between your own devices only, and Guildmaster never opens a port on your router or to the Internet.