Widgets
Widgets are the visual building blocks of your layout. Each widget type displays specific game information.
Widget Types
| Type | Purpose |
|---|---|
| text | Scrollable game text |
| tabbedtext | Multiple streams in tabs |
| progress | Health, mana, stamina bars |
| countdown | Roundtime, cast time timers |
| compass | Available exits |
| hand | Items in hands |
| indicator | Status conditions |
| dashboard | Multi-indicator panel |
| room | Room name, description, exits |
| injury_doll | Body part injuries |
| active_effects | Buffs and debuffs |
| targets | Creatures in room |
| players | Players in room |
| items | Items on ground |
| inventory | Carried items |
| spells | Known spells |
| container | Container contents |
Common Properties
All widgets share these properties:
[[windows]]
name = "my_widget" # Unique identifier
widget_type = "text" # Widget type
row = 0 # Top position
col = 0 # Left position
rows = 10 # Height
cols = 40 # Width
visible = true # Show/hide
show_border = true
border_style = "single" # single, double, rounded, thick
border_color = "#808080"
title = "Custom Title"
Adding Widgets
- Via Menu: F1 → Windows → Add Window → [Category] → [Widget]
- Via Command:
.addwindow widgetname - Via Config: Edit layout.toml directly
Categories
Widgets are organized into categories in the Add Window menu:
| Category | Widgets |
|---|---|
| Text Windows | text, tabbedtext |
| Status | progress, countdown, hand, indicator, dashboard |
| Navigation | compass, room |
| Entity | targets, players, items |
| Lists | inventory, spells, container |
| Other | injury_doll, active_effects |