# Lists: what you still have to gather

> Lists of items a player or their FTB team still needs, counted on their own from inventories and marked containers, made by hand or from a Create schematic, pinned to the HUD. New in 0.3, off by default.

Source: https://stygion.eu/docs/keystone/lists
Updated: 2026-10-25

New in 0.3, module `lists`, off by default. A list says what a player - or their FTB team - still has to gather, and counts itself.

## Commands (`keystone.lists`)

| Command | Does |
|---|---|
| `/lists` | your lists and your team's |
| `/lists create <name>` / `/lists team <name>` | a personal list / one for your FTB team |
| `/lists add <list> <count> <item>` | asks for that many of an item |
| `/lists remove <list> <item>` | takes an item off |
| `/lists take <list> <item>` | says you are getting it, so the others know |
| `/lists delete <list>` | removes the list |
| `/lists mark` | marks the container you look at for counting |
| `/lists schematic <name> <list>` | a list from a Create schematic you uploaded to the server |

## Counting

Every `count-every` (10 s) Keystone counts the items in the inventories of the list's players and in the containers they marked - anything whose items can be read through the loader's item handler, only in loaded chunks (`most-chests` per player, 16; `reach` 6 blocks for marking). Nothing is taken or moved; it only counts.

**Schematics** are read from where Create keeps uploaded ones (`schematics.folder`, `schematics/uploaded/<player>`), up to `schematics.most-bytes` (4 MiB uncompressed).

Limits: `most-lists` (10), `most-items` (64), `most-count`, `most-name` (32).

## With the client half

A screen with each list, what each item still needs and who is getting it, and lists pinned to the HUD (`hud-items`, 8 items each, unfinished first; HUD value `lists`). A notice when a team list changes.

`GET /v1/lists` (scope `players.read`) returns every list, its items, what was last counted and who is getting what. Addons hear `ListChanged`.