Files
wiki/Catalogue-Self-Hosted/apps/app-foundry-virtual-tabletop.md
T
2026-06-09 18:40:21 +02:00

134 lines
7.2 KiB
Markdown

---
title: Foundry Virtual Tabletop
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, gaming, jdr, tabletop, nodejs]
confidence: medium
contested: false
sources: [https://selfh.st/apps/?search=Foundry+Virtual+Tabletop]
---
# Foundry Virtual Tabletop 🎲
> Plateforme premium de jeu de rôle sur table (JDR/JJT) auto-hébergeable — donjons, cartes, jets de dés, musique ambiante, automatismes de feuilles de personnage.
| Métadonnée | Valeur |
| :--- | :--- |
| **Site web** | https://foundryvtt.com |
| **GitHub** | https://github.com/foundryvtt/foundryvtt (mirror non officiel) |
| **License** | Propriétaire (licence par instance) |
| **Langage** | JavaScript / Node.js |
| **Étoiles** | 15 |
| **Dernière MAJ** | 2025 |
| **Catégorie** | [[cat-gaming]] |
## Description
Foundry Virtual Tabletop (souvent abrégé Foundry VTT ou FVTT) est une application web de **Virtual Tabletop** pensée pour les maîtres de jeu de rôle (D&D 5e, Pathfinder, Call of Cthulhu, Shadowrun, etc.). Contrairement à ses concurrents historiques, Foundry se distingue par son modèle **one-time-purchase** : une licence par instance coûte environ 50 USD et donne droit à toutes les mises à jour ultérieures de la version stable, sans abonnement récurrent. Le produit n'est pas open source — le code source est fermé et distribué sous forme de tarball/zip nodalisé.
L'application est écrite en JavaScript (Node.js côté serveur, Mithril.js et PIXI.js côté client) et embarque un serveur HTTP/HTTPS complet, un système d'extension modulaire via une marketplace tierce, un moteur de rendu de cartes (JPEG, PNG, WebP, tiles WebGL), un moteur d'éclairage dynamique, de la gestion audio (musique d'ambiance multi-pistes, sons positionnels), des outils de mesure (règles, cônes, templates AOE), un chat enrichi (markdown, dés, whispers), des feuilles de personnage extensibles, une gestion de la vision (line of sight, fog of war) et un système de macros/hooks pour automatiser les jets et l'inventaire.
Foundry tourne en auto-hébergement : un binaire (Linux/Windows/macOS) ou un conteneur Node.js expose le service sur un port configurable (par défaut 30000) et accepte les connexions WebSocket des joueurs via navigateur. Les parties peuvent être hébergées sur un simple Raspberry Pi 4 pour quelques joueurs, ou sur un serveur musclé pour des parties massives avec cartes en très haute résolution. L'instance d'un MJ peut être partagée à des joueurs du monde entier, sans intermédiaire ni cloud imposé.
## Installation
### Prérequis
- **Licence valide** : achat sur https://foundryvtt.com/store/user pour récupérer la clé de licence et l'URL de téléchargement.
- **Droits utilisateurs** : l'utilisateur qui exécute Foundry doit pouvoir écrire dans le répertoire `Data` (mondes, modules, systèmes).
- **Node.js 18+** ou image Docker Node-based.
- **Licence officielle** obligatoire, sinon l'application ne démarrera pas.
### Docker Compose (méthode communautaire la plus stable)
```yaml
version: "3.8"
services:
foundryvtt:
image: felddy/foundryvtt:latest
container_name: foundryvtt
restart: unless-stopped
ports:
- "30000:30000"
environment:
- FOUNDRY_USERNAME=admin@example.com
- FOUNDRY_PASSWORD=changeme_secure_pwd
- FOUNDRY_ADMIN_KEY=some-random-secret
- FOUNDRY_LICENSE_KEY=votre-cle-licence
- FOUNDRY_WORLD=
- FOUNDRY_SSL_CERT=
- FOUNDRY_SSL_KEY=
volumes:
- ./data:/data
- ./resources:/foundryvtt/resources
- ./logs:/foundryvtt/logs
```
### Installation manuelle (Linux)
```bash
# Télécharger la release depuis le site officiel
wget -O foundryvtt.zip "https://foundryvtt.com/releases/download/<version>/FoundryVTT-linux-x64.zip"
unzip foundryvtt.zip -d /opt/foundryvtt
cd /opt/foundryvtt
# Lancer
node resources/app/main.js
# Ouvrir http://localhost:30000 et coller la licence
```
Un service systemd peut être créé pour démarrer Foundry au boot.
## Configuration
- **Licence** : collée à la première connexion, stockée chiffrée localement.
- **Worlds** : dossiers de mondes (cartes, jets, persos, historique) dans `Data/worlds/`.
- **Systems** : systèmes de règles (D&D 5e, Pathfinder 2, SWADE...) dans `Data/systems/`.
- **Modules** : extensions tierces (~3000+) dans `Data/modules/`, activables par monde.
- **Audio** : playlists ambiantes par scène, partage de dossiers, crossfade.
- **Sécurité** : MJ unique, multi-joueurs anonymes ou authentifiés (mots de passe, invite links), pas d'auth intégrée pour le serveur web lui-même (gérée en amont par reverse proxy).
- **Performance** : ajustement de la résolution de carte, fog of war, animation rate, token limit per scene, GPU acceleration côté client (WebGL).
- **Sauvegardes** : `Data/worlds/` est le cœur — sauvegarder quotidiennement (borgbackup, restic).
## Alternatives
### Open Source
- **Astral** — VTT web open source prometteur, plus simple que Foundry, en cours de développement.
- **MapTool** — open source ancien, Java, plus austère, orienté tactique.
- **Roll20** (gratuit + abonnements, fermé) — pionnier du genre, navigateur, pas auto-hébergeable.
### Propriétaires
- **The Forge** — hébergement cloud officiel de Foundry, mensuel, clé en main (alternative à l'auto-hébergement).
- **Fantasy Grounds** — Windows, plus ancien, achat + modules payants.
- **Owlbear Rodeo** — gratuit + Pro, simple et rapide, navigateur uniquement, pas auto-hébergeable.
- **D&D Beyond** — orienté 5e, pas VTT à proprement parler, plus un compendium + feuille de perso.
- **Alchemy** (ex Alchemy VTT) — payant, web, focus sur cartes multijoueurs.
- **TaleWeaver**, **TablePlonk** — petits acteurs web.
## Sécurité
- **Reverse proxy obligatoire** en exposition WAN : Caddy, Traefik ou Nginx avec TLS Let's Encrypt. Foundry supporte aussi le TLS natif via les variables `FOUNDRY_SSL_CERT` et `FOUNDRY_SSL_KEY`.
- **Authentification** : activer le mot de passe admin (et idéalement 2FA si plugin installé) ; créer des comptes nominatifs par joueur, éviter le mode « ouvert » où quiconque connaît l'URL rentre.
- **Lien d'invitation** : générer un lien à durée limitée plutôt que d'exposer l'URL racine.
- **Fail2ban** sur le port 30000 et sur le reverse proxy pour bloquer les scans de brute force.
- **Firewall** : n'ouvrir que les IP des joueurs (ou VPN WireGuard/Tailscale).
- **Mises à jour** : suivre les releases stables ; chaque update de Foundry peut casser la compatibilité de certains modules, lire les notes avant upgrade.
- **Permissions fichiers** : exécuter Foundry avec un utilisateur dédié non-root, isoler le conteneur Docker.
## Ressources
- Site officiel : https://foundryvtt.com
- Wiki officielle : https://foundryvtt.com/article
- Forums : https://forums.forgevtt.com
- Subreddit : https://reddit.com/r/FoundryVTT
- Discord Foundry : https://discord.gg/foundryvtt
- Module Browser : https://foundryvtt-hub.com
- Tutoriels français : https://tritagonistes.com
- The Forge (hébergement clé en main) : https://forge-vtt.com
- Image Docker communautaire : https://github.com/felddy/foundryvtt
## Pages Liées
- [[cat-gaming]]
- [[recettes-docker-compose]]
- [[app-traefik]]
- [[app-crafty-controller]]
- [[app-nextcloud]]