SoulFire LogoSoulFire

Get script registry data

Gets Minecraft registry data for autocomplete and validation. Returns blocks, entities, items, and biomes that can be used in scripts. This endpoint is cacheable - registry data only changes between server versions.

GET
/v1/scripts/registry

Gets Minecraft registry data for autocomplete and validation. Returns blocks, entities, items, and biomes that can be used in scripts. This endpoint is cacheable - registry data only changes between server versions.

Authorization

AuthorizationBearer <token>

Preferred API authentication. Use a JWT with the api audience.

In: header

Query Parameters

registry?string

Optional: specific registry to fetch. If empty, returns all registries. Valid values: "blocks", "entities", "items", "biomes"

Response Body

application/json

application/json

application/json

application/json

curl -X GET "http://127.0.0.1:38765/v1/scripts/registry"
{
  "blocks": [
    {
      "id": "string",
      "display_name": "string",
      "icon": "string",
      "category": "string"
    }
  ],
  "entities": [
    {
      "id": "string",
      "display_name": "string",
      "icon": "string",
      "category": "string"
    }
  ],
  "items": [
    {
      "id": "string",
      "display_name": "string",
      "icon": "string",
      "category": "string"
    }
  ],
  "biomes": [
    {
      "id": "string",
      "display_name": "string",
      "icon": "string",
      "category": "string"
    }
  ]
}
{
  "code": 0,
  "grpc-code": "string",
  "message": "string",
  "stack-trace": "string",
  "details": [
    {}
  ]
}
{
  "code": 0,
  "grpc-code": "string",
  "message": "string",
  "stack-trace": "string",
  "details": [
    {}
  ]
}
{
  "code": 0,
  "grpc-code": "string",
  "message": "string",
  "stack-trace": "string",
  "details": [
    {}
  ]
}

How is this page?

Get node types GET

Gets all available node types with their metadata. This enables clients to render the node editor without hardcoded knowledge of specific node types. The response includes port definitions, categories, display names, and all other information needed to render and validate nodes. This endpoint is cacheable - node types only change between server versions.

Get script status GET

Gets the current status of a script. Returns whether the script is active, which node is executing, and activation count.