OpenMLBB SDK Docs

OpenMLBB Endpoint

SDK call mapping, request requirements, and Python example.

Every card documents the SDK call from OpenMLBB and mirrors API path/query/body requirements.

GET Battle Spells

/openmlbb/academy/spells

Open Only This

API Path: /api/academy/spells

List all battle spells with details. Supports query parameters for pagination and localization.

Query parameters:

  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • lang: Language code for localized content (default: en).

The response includes battle spell data:

  • records: Array of spell entries, each containing:
      • _id: Unique record identifier.
      • _createdAt: Creation timestamp.
      • _updatedAt: Last update timestamp.
      • data:
          • battleskillid: Battle spell ID.
          • skillid: Skill ID.
          • skillname: Spell name (e.g., 'Arrival').
          • skillicon: Spell icon URL.
          • skillshortdesc: Short description (e.g., 'Long-range Support').
          • skilldesc: Full description of spell effects.
          • skilldescemblem: Emblem-specific description (if applicable).
          • skillvideo: Video reference (if available).
      • id: Internal record ID.
      • sourceId: Source reference ID.

This endpoint is useful for:

  • Displaying the complete catalog of battle spells.
  • Explaining spell effects and mechanics.
  • Guiding players in spell selection and strategy.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.spells(size=20, index=1, lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
size query integer no 20
index query integer no 1
lang query string no en