name: "prompt"
category: "General"
description: |
  Customize your command prompt. Prompts are per-character.

  Usage:
    prompt              Show current prompt
    prompt <value>      Set a custom prompt
    prompt none         Set prompt to blank
    prompt reset        Restore default "> "

  Your prompt string can include variables and color blocks.

  Variables:
    %h           Current HP
    %H           Maximum HP
    %c           Credits
    %m           Current mob HP (blank unless in combat)
    %M           Mob max HP (blank unless in combat)
    %s           Attack style shorthand (acc, agg, def, bal)
    %S           Attack style longform (accurate, aggressive, defensive, balanced)
    %i           Free inventory slots
    %x_<skill>   XP to next level for a skill (e.g. %x_mining)
    %X_<skill>   Total XP for a skill (e.g. %X_attack)

  Use %% for a literal % sign.

  Color blocks:
    {<0-255> [bold] [dim] [underline]}text{/}
    {g:<a>,<b>[,<c>...]}gradient text{/}

  A color block starts with {color_spec} and ends with {/}.

  Examples:
    prompt > 
    prompt {6}%h/%Hhp $%c %s{/} >
    prompt <{2}%h{/}/{1}%H{/}hp> 
    prompt {208 bold}%h/%Hhp{/} >