> For the complete documentation index, see [llms.txt](https://alex-plugins.gitbook.io/nebula/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alex-plugins.gitbook.io/nebula/items/nebula-items/collectors.md).

# Collectors

Collectors are items players can place on weapons or tools to collect points. Then it will be possible to exchange these points against amount of experience using the [collector command](/nebula/commands/collector.md).

## Values related to collector

Everything related to collector (inventory name, rates, collect values etc..) can be modified in the **COLLECTOR** section in the main configuration file

## Creating a collector

Collectors can be created in the `collector.yml` file located in the `/plugins/Nebula/` folder.

The **root** can be whatever you want (it will be the name of the collector) but cannot contains spaces or uppercase characters.

The mandatory parameters are :

**name** : It will be the displayed name of the collector.

**applicable\_to** : This is items that can receive the collector, authorized values are :

* **all** : can be applied to every item (weapons, tools, armor, shield)
* **weapons** : all axes, swords and trident
* **distance\_weapons** : bow, crossbow, trident
* **tools** : all pickaxes, shovels, hoes, axes, fishing rod and shears
* **swords** : all swords
* **axes** : all axes
* **armor** : all boots, chestplates, helmets, leggings
* **boots** : all boots
* **shovels** : all shovels
* **pickaxes** : all pickaxes
* **helmets** : all helmets
* **leggings** : all leggings
* **chestplates** : all chestplates
* **hoes** : all hoes
* **mana\_holders** : all weapons, distance\_weapons and tools
* **\<every\_material>** : a particular item material, list can be found [here](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html)

**trigger** : This is the trigger that will have to be verified to get the points on the item. Authorized triggers for collectors are **break\_block** and **kill**. See [triggers documentation](/nebula/main-mechanics/triggers.md) to see how to set up the triggers parameters.

**points\_earned** : This is the amount of points the item will receive when the trigger is verified.

**message\_subtitle** : This is a subtitle message that will be displayed to the player when the trigger is verified.

**villager\_emerald\_price** : This is the emerald price of the collector when sold by a villager.

#### Example :

```
block_breaker: # root
  name: "&3Block breaker" 
  applicable_to: pickaxes 
  trigger: break_block<stone> 
  points_earned: 1 
  message_subtitle: "&aCollector +1" 
  villager_emerald_price: 10
```