@playt/client NPM

PLAYT Client

An API client for PLAYT, written in Typescript.

Features

Support authentication
Full support for all endpoints
Fully typed request and response objects

Usage

npm install @playt/client

API Client

When you want to connect an application to our API you must generate an API Key first.

You can then use the client as follows:

import PlaytApiClient from '@playt/client';

// Create a new client with API Key and optional API URL
const apiClient = PlaytApiClient({
  apiUrl: '<API_URL>',
  apiKey: '<API_KEY>',
});
await apiClient.initialize({
  gameVersion: '<Ideally SemVer number of your game>',
});

Browser Client

For a web-based game, you also need to load the browser client in the browser when the user is playing the game. Among other optional features, it tracks user inputs for cheat detection using Anybrain. Use the browser client as follows:

import PlaytBrowserClient from '@playt/client/browser';

const browserClient = PlaytBrowserClient({
  gameId: '<usually from iframe query param>',
  apiUrl: '<API_URL>',
});
await browserClient.initialize({
  gameVersion: '<Ideally SemVer number of your game>',
});

// When the game starts
await browserClient.startMatch('<USER_ID>', '<MATCH_ID>', '<PLAYER_TOKEN>');

// When the game ends
await browserClient.stopMatch();

API

The API is documented on Swagger and OpenAPI. The client is generated from the OpenAPI specification and is fully typed.

Example

// Submits a score
const { ok, data, status, statusMessage } = await client.submitScore({
  playerToken: 'PLAYER_TOKEN',
  score: 1000,
  finalSnapshot: true,
});

Development

The API types in this repository are generated based on our OpenAPI and its corresponding types in @playt-net/clashparadise`. If the clashparadise OpenAPI changes, this project needs to be updated as well. You can do this with a few simple steps:

Generate new types
```
npm run generate
```
This will access all OpenAPI endpoints and generate changes based on changes to the API.
Check if src/index.ts needs to be adjusted. In case of bigger changes, for example changes to the method of an endpoint or a new endpoint, you need to update the corresponding methods.
☝ You may need to update test/fetch.test.ts if there are significant changes to src/index.ts
Commit changes and open a PR on GitHub
Once changes have been approved and merged it might be time for a release
Create a release by running npm version with the correct argument to bump the repository's version
Push tags, generated by the previous command
```
git push --tags
```
Create a release on GitHub

Browser client in Webpack 4

As of the beginning of 2023, Webpack 4 is highly outdated and misses out-of-the-box support for plenty of standards such as package.json exports, new Worker, and ?? syntax. We suggest that you upgrade to Webpack 5. However, if you choose to continue using Webpack 4, we have found that the following workarounds (extremely hacky and likely not universal) might enable you to import the browser client in Webpack 4: