> For the complete documentation index, see [llms.txt](https://changelog.matrixemulator.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://changelog.matrixemulator.com/welcome/server/muserver/data/custom/custompick.md).

# CustomPick

<mark style="color:green;">Registers filter nicknames for the</mark> <mark style="color:green;"></mark><mark style="color:green;">`/pick`</mark> <mark style="color:green;"></mark><mark style="color:green;">command, which enables automatic item collection of a specific item type when walking over it. Maximum of 20 lines.</mark>

```
//CID	ARG	CAT	ITE	Comment
  0	"soul"	14	14	//Collect Soul
  1	"bless"	14	13	//Collect Bless
  2	"chaos"	12	15	//Collect Chaos
  3	"zen"	14	15	//Collect Zen
  4	"life"	14	16	//Collect Life
end
```

| **Column** | **Accepted values**      | **What it is**                                                                          |
| ---------- | ------------------------ | --------------------------------------------------------------------------------------- |
| CID        | Number, one per line     | Identifies the entry internally.                                                        |
| ARG        | Text in quotation marks  | Word that the player types after the command, e.g., `/pick soul` uses the `ARG "soul"`. |
| CAT        | Number from `0` to `15`  | Item group (`Sect`), together with `ITE` it forms the item to be filtered.              |
| ITE        | Number from `0` to `511` | Item index within the group (`Type`).                                                   |

### <mark style="color:yellow;">Notes</mark>

* In addition to the nicknames registered here, the command also accepts 4 fixed modes that do not come from this file: `/pick exc` (excellent items), `/pick socket` (items with sockets), `/pick setitem` (ancient items), and `/pick all` (enables all registered filters at once).
* Each use of the command toggles that specific filter on/off — using `/pick soul` again disables the automatic collection of that item.
* The `ARG` is case-insensitive during comparison.
