Skip to content

Character Customization

The "Character Customization" feature changes the visuals used in the Source Selection and Tutorial parts of the LIQA interface. It is managed through the character and tutorial-character attributes and can be enabled as shown below:

html
<hautai-liqa license="LICENSE_KEY" character="1" tutorial-character="8"></hautai-liqa>
<hautai-liqa license="LICENSE_KEY" character="1" tutorial-character="8"></hautai-liqa>
javascript
new Liqa({
  target: "#selector",
  license: "LICENSE_KEY",
  character: 1,
  tutorialCharacter: 8,
})
new Liqa({
  target: "#selector",
  license: "LICENSE_KEY",
  character: 1,
  tutorialCharacter: 8,
})

Differences

  • character changes the Source Selection screen and the built-in tutorials.
  • tutorial-character changes the built-in tutorials only.
  • When both attributes are provided, tutorial-character takes precedence for the tutorial, while Source Selection still uses character.
  • If character is not provided, LIQA keeps the default Source Selection screen.
  • If the selected character does not have the required assets for a specific screen, LIQA falls back to the default built-in character with ID 0.
  • Most characters support both image and video tutorials.

How it works

  1. LIQA reads character and tutorial-character as numeric zero-based character IDs.
  2. If character is provided, LIQA uses that character on the Source Selection screen and also uses it for tutorials by default.
  3. If tutorial-character is also provided, LIQA keeps character for Source Selection and overrides the tutorial visuals with tutorial-character.
  4. If only tutorial-character is provided, LIQA keeps the default Source Selection screen and applies the selected character only to the built-in tutorials.
  5. If a selected character is missing the assets required for the currently displayed screen, LIQA falls back to the default built-in character with ID 0 for that screen.

Character Visual Examples

Source Selection examples

Character 0 source selection example
Character ID: 0
Character 1 source selection example
Character ID: 1
Character 2 source selection example
Character ID: 2
Character 3 source selection example
Character ID: 3
Character 4 source selection example
Character ID: 4
Character 5 source selection example
Character ID: 5
Character 6 source selection example
Character ID: 6
Character 7 source selection example
Character ID: 7
Character 8 source selection example
Character ID: 8
Character 9 source selection example
Character ID: 9

Tutorial examples

Character 0 tutorial example
Character ID: 0
Character 1 tutorial example
Character ID: 1
Character 2 tutorial example
Character ID: 2
Character 3 tutorial example
Character ID: 3
Character 5 tutorial example
Character ID: 5
Character 8 tutorial example
Character ID: 8
Character 9 tutorial example
Character ID: 9