Создавай игры. Серверы для мультиплеера предоставим мы.

Быстрый старт

Три шага — и у вашей игры есть комнаты и реальное время.

<script src="https://cdn.jsdelivr.net/npm/colyseus.js@0.15.11/dist/colyseus.js"></script>
<script src="https://fimdi.ru/sdk/multiplayer/v1/fimdi-multiplayer.js"></script>

// ID вашей игры — из кабинета разработчика
const mp = new FimdiMultiplayer({ gameId: 123 });

// Создать публичную комнату
const room = await mp.createRoom({ maxPlayers: 2, visibility: "public", name: "Алиса" });
console.log("Код приглашения:", room.inviteCode);

// Слушать события (Colyseus-совместимый API)
room.onMessage("playerJoined", (p) => console.log("Вошёл:", p.name));
room.onMessage("playerLeft", () => console.log("Соперник вышел"));
room.onMessage("message", (msg) => console.log(msg.type, msg.data));

// Отправлять сообщения
room.send("move", { x: 100, y: 200 });

// Выйти
await room.leave();

API SDK

FimdiMultiplayer

const mp = new FimdiMultiplayer({
  gameId: 123,              // ID игры (обязательно)
  endpoint: null,           // адрес сервера (автоматически из Laravel)
  tokenUrl: "https://fimdi.ru/api/v1/multiplayer/token", // адрес Laravel (по умолчанию)
});

Методы

Комната (Colyseus-совместимый API)

Формат сообщений

room.send(type, data) отправляет сообщение. Получатель видит envelope { type, data, from, fromSession }. Отправитель не получает своё сообщение обратно — обрабатывайте его локально.

// Отправка
room.send("move", { x: 100, y: 200 });
room.send("chat", { text: "Привет!" });

// Получение
room.onMessage("message", (msg) => {
  if (msg.type === "move") {
    console.log(msg.from, "→", msg.data.x, msg.data.y);
  }
  if (msg.type === "chat") {
    console.log(msg.from, ":", msg.data.text);
  }
});

Ограничения: до 10 сообщений/сек на игрока, до 2 КБ на сообщение.

Как работает авторизация

SDK автоматически запрашивает у Laravel краткоживущий токен (2 минуты) при подключении. Colyseus проверяет подпись (HMAC-SHA256) и срок действия. Вам не нужно реализовывать ничего дополнительно.

• Игра должна быть опубликована на fimdi.ru
• Мультиплеер должен быть включён в кабинете
• Токен привязан к вашей игре — нельзя подключиться к чужой комнате
• Гости поддерживаются — регистрация не обязательна

Ограничения и стоимость

Бесплатный старт без аренды серверов. Расходы на мультиплеер учитываются прозрачно и удерживаются из будущего дохода игры по условиям платформы. Личные средства не списываются. Подробности — в кабинете разработчика.

Подключение в Phaser

В Phaser загружайте SDK и Colyseus в index.html, а используйте в сцене:

class GameScene extends Phaser.Scene {
  async create() {
    this.mp = new FimdiMultiplayer({ gameId: 123 });
    this.room = await this.mp.joinRandomRoom({ maxPlayers: 4, visibility: "public", name: "Игрок" });

    this.room.onMessage("message", (msg) => {
      if (msg.type === "move") {
        // Обновить позицию игрока msg.from
        const sprite = this.otherPlayers[msg.from];
        if (sprite) sprite.setPosition(msg.data.x, msg.data.y);
      }
    });
  }

  update() {
    // Отправлять позицию при движении
    if (this.input.keyboard.addKey("LEFT").isDown) {
      this.player.x -= 2;
      this.room.send("move", { x: this.player.x, y: this.player.y });
    }
  }
}

Частые ошибки

Примеры и материалы

• fimdi-multiplayer.js — исходник SDK
• Демо-игра «Два квадратика»
• Крестики-нолики — полноценная игра с matchmaking, именами, реваншем

Исходник крестиков-ноликов — один HTML-файл. Посмотрите его как референс host-authoritative протокола: хост обрабатывает ходы, рассылает sync гостю.