⚔️ SwordFight API

What is this?

The SwordFight API provides pre-calculated outcomes for every possible move combination in the SwordFight game engine. All outcomes are deterministic and pre-generated as static JSON files.

This API is:

• Stateless - No server-side computation, just file lookups
• Fast - Served from CDN, cached indefinitely
• Open Source - Built with the SwordFight Engine

Quick Start

Get all characters:

fetch('https://api.swordfight.me/characters/index.json')
  .then(r => r.json())
  .then(data => console.log(data.characters));

Get a specific character:

fetch('https://api.swordfight.me/characters/human-fighter.json')
  .then(r => r.json())
  .then(character => console.log(character));

Get a round outcome:

fetch('https://api.swordfight.me/rounds/human-fighter/goblin/24/30.json')
  .then(r => r.json())
  .then(outcome => console.log(outcome));

API Endpoints

Documentation

Resources

• GitHub Repository - Engine source code and documentation
• API Client Guide - How to use this API
• Engine Documentation - Full game engine docs
• NPM Package - Install the engine