name: "color"
category: "Options"
description: |
  Color output customization.

  The "color" command lets you customize the color of various game
  elements on an account-wide basis. Colors are shared by all
  characters on the same account.

  Usage:
    color                     List all targets and their current values
    color <target>            Show current color for a target
    color <target> <spec>     Set a custom color
    color <target> reset      Reset to server default
    color <target> off        Disable color for this target entirely

  Color spec format (space-separated tokens):
    <0-255>      Foreground color (xterm-256 palette index)
    bg:<0-255>   Background color
    g:<a>,<b>    Gradient between two or more colors
    bold         Bold text
    dim          Dim text
    underline    Underlined text

  Examples:
    color room_name 6 bold
    color fire 208
    color death 1 bold
    color broadcast 214 bg:0

  Gradients interpolate across characters in RGB space:
    color item g:196,82           Red to green
    color room_name g:45,39,59    Three-stop gradient

  Use 'colortable' to see all 256 colors and their indices.

  Colors use the xterm-256 palette (0-255). When a player's color
  mode is set to "ansi", extended colors (16-255) automatically
  downgrade to the nearest of the 16 standard ANSI colors.

  Standard colors (0-15):
    0 black     1 red       2 green     3 yellow
    4 blue      5 magenta   6 cyan      7 white
    8-15 bright variants of the above

  Inline color tags in room descriptions:
    {<spec>}colored text{/}
    {182 bold}mysterious vase{/}
    {g:196,82}gradient text{/}

  Color targets:
    room_name      Room name headers
    room_number    Room number display (#id)
    room_desc      Room description text (default for untagged text)
    direction      Movement direction text
    exit_direction Exit direction labels
    exit_name      Exit destination room names
    protected_mob   Protected mob names
    mob             Mob names (combat, room listings, etc.)
    damage         Damage numbers
    xp             XP gain messages
    level_up       Level-up announcements
    item           Item names (default)
    player_name    Player names in broadcasts
    death          Death message
    victory        Combat victory message
    miss           Missed attack messages
    error          Error messages
    say            Player chat text
    dialog         NPC conversation text
    broadcast      Room-wide event messages
    fire           Firemaking messages
    eat_food       Eating/healing messages
    drop_message   Mob loot drops
    credits_pickup Currency/credit messages

  Visual tick colors:
    visual_tick      Visual tick marker text (dim blue)
    visual_first_tick First tick in a numbered cycle (bright red)

  Resolution order:
    1. Account override (set via "color" command)
    2. Server default (set in config.yaml)
    3. Built-in fallback

  The "color" option (option color none/ansi/xterm256) controls
  whether ANSI codes are emitted. "none" strips all color.
  In "ansi" mode, extended palette colors (16-255) are
  automatically downgraded to the nearest ANSI color.

  You can use color blocks in your prompt:
    prompt {2 bold}Ready>{/} %h/%Hhp
  See 'help prompt' for full prompt customization.