Serveurs de jeu PlayDrop : Colyseus, MongoDB et SDK serveur
Multijoueur hébergé facultatif pour les jeux PlayDrop : envoyez un server.js Colyseus avec stockage MongoDB, testez-le avec des joueurs de test et utilisez le SDK serveur facultatif pour les amis et l’IA.
Un serveur de jeu est facultatif. Votre jeu peut appeler n’importe quel serveur que vous gérez vous-même. Si vous préférez, PlayDrop héberge pour votre jeu un serveur Colyseus standard avec une base de données MongoDB : envoyez-le sous le nom server.js, à côté de index.html, via PlayDrop Connector, ou demandez à PlayDrop Cloud de le créer. Le paquet @playdrop/server est lui aussi facultatif.
Écrivez un serveur Colyseus standard
import { Room, defineRoom } from "colyseus";
import { MongoClient } from "mongodb";
class GameRoom extends Room {
async onCreate() {
this.mongo = new MongoClient(process.env.PLAYDROP_MONGO_URL);
await this.mongo.connect();
}
onJoin(client) {
// client.auth is the verified PlayDrop player, for example client.auth.userId.
}
async onDispose() { await this.mongo?.close(); }
}
export const rooms = { game: defineRoom(GameRoom) };Exportez un mappage rooms depuis server.js et listez les noms de ses salles dans catalogue.json sous la forme "server": { "rooms": ["game"] }. PlayDrop exécute le serveur : ne le démarrez pas vous-même. Stockez les données avec le pilote MongoDB standard via PLAYDROP_MONGO_URL, pendant le cycle de vie de la salle.
Règles du serveur hébergé
- Colyseus 0.17 (
colyseus0.17.10,@colyseus/schema4.0.30), le pilote MongoDB 7.5 et Node 22. - Un seul module ES autonome de 2 MiB maximum. Il ne peut importer que
colyseus,@colyseus/core,@colyseus/schema,mongodbet@playdrop/server; intégrez tout autre code dans le fichier. - Jusqu’à 2 types de salles, 8 joueurs par salle, 4 heures par salle, 30 messages par seconde par joueur et 512 KiB par message.
- Aucun accès à Internet depuis le serveur : seuls MongoDB et les services PlayDrop sont accessibles.
- Les joueurs doivent être connectés. PlayDrop vérifie chaque joueur lorsqu’il rejoint la salle ; n’implémentez pas
onAuth. - Une base de données MongoDB par jeu, conservée d’une version à l’autre et comptabilisée dans votre quota de stockage. N’envoyez jamais ses identifiants au navigateur.
Connectez le navigateur et testez
Dans le navigateur, sdk.multiplayer.getConnection() du SDK client renvoie l’adresse du serveur et le jeton du joueur ; rejoignez la partie avec le client Colyseus (@colyseus/sdk 0.17). Pendant le développement, exécutez Colyseus 0.17 et MongoDB 8 en local et connectez-vous directement à votre serveur local. Pour tester le serveur hébergé, envoyez une version privée, puis ouvrez https://www.playdrop.ai/create/games/<slug>/test?v=<version>&player=1 et le même lien avec player=2 dans une seconde fenêtre : chaque fenêtre joue avec un compte de test distinct. Lorsque tout fonctionne, rendez la version publique depuis la page du jeu.
SDK serveur facultatif : amis et IA
@playdrop/server ajoute playdrop.social (les amis qui jouent à ce jeu et les cartes de jeu dans PlayDrop Chat) et playdrop.ai (génération de texte, d’images, de 3D, de vidéos, de sons, de voix et de musique, payée par le créateur). Ces appels ne fonctionnent que dans les jeux envoyés sur PlayDrop, pas en développement local. Téléchargez les médias privés générés côté serveur avec playdrop.ai.tasks.downloadFile et ne transmettez les octets qu’au joueur destinataire ; les requêtes de synthèse vocale acceptent 40 mots au maximum.