API Reference

Complete reference for Browser and Server SDKs.

Browser

<script src="https://www.modd.io/js/moddio.js"></script>

new Moddio({ appId })Create client — auto-mounts login widget and tracks sessions

No other public methods needed. The widget handles login automatically and notifies your game server via WebSocket when a player joins.

Server

npm install moddio

const { Moddio } = require('moddio/server')

Setup

new Moddio({ appId, appSecret })Connect to Moddio and start receiving player events

Events

moddio.on('playerJoin', (player) => {})Called when a player logs in. player has id, name, data, highScore, permissions.

Player Data

moddio.getPlayerData(playerId)Load all saved data for a player. Returns Promise<object>.
moddio.savePlayerData(playerId, data)Replace all data for a player. Returns Promise<void>.
moddio.updatePlayerData(playerId, data)Merge fields into existing data (partial update). Returns Promise<void>.

Types

Player

{
  id: string
  name: string
  data: Record<string, unknown>
  highScore: number
  permissions: Record<string, boolean>
}