Capabilities

LIST_ACCOUNT_CHARACTERS

Return all characters owned by one game account

Bridge contract

JsonArray listCharacters(String accountName) throws Exception;

Return up to 30 characters for the supplied account, including offline characters. The reference implementations sort by level descending.

Each entry must match:

{
  "characterId": 268437506,
  "name": "Ravenblade",
  "level": 40,
  "classId": 88,
  "race": "human",
  "sex": "male",
  "online": true,
  "pvpKills": 3,
  "pkKills": 0,
  "clanName": null
}

Allowed race values are human, elf, darkelf, orc, and dwarf. Allowed sex values are male and female. Map database values to these protocol strings.

The account must be bound as a query parameter. Return an empty array when the account has no characters.

Reference differences

  • aCis reads the character identifier from obj_Id.
  • Mobius reads the character identifier from charId.

Verification

Connector check requests a non-existent account. A successful response with an empty array passes.

On this page