> For the complete documentation index, see [llms.txt](https://dev.vanixmc.com/customdrops/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.vanixmc.com/customdrops/getting-started/tutorial.md).

# Tutorial

<mark style="color:red;">**IMPORTANT**</mark> | **The tutorial sections are&#x20;**<mark style="color:purple;">**labeled in purple**</mark> if you want to skip the other stuff:

* [<mark style="color:purple;">**Creating a Region**</mark>](#region-creation)
* [<mark style="color:purple;">**Creating a Drop**</mark>](#creating-a-drop)

## How It Works

CustomDrops is fully region-based, so, drops do not work unless they have a region added to them. This was done to add the ability to drop different things in different places.

***

### Regions

There are currently two types of regions: User Created Regions, and **Global Regions.**

{% hint style="info" %}
*Global regions aren't really regions and don't have to be created at all. They're recognized as regions in the region add menu and if they are added to a drop, the plugin will recognize that and allow the drop to work anywhere in any* [*unblacklisted*](broken://pages/no8ZJ0MpQK5Vg77rVqid) *world!*
{% endhint %}

<details>

<summary><mark style="color:purple;">Creating a Region</mark></summary>

1. Obtain a region wand with the command: <mark style="color:blue;">`/cd region wand`</mark>
2. <mark style="color:red;">**Left-Click**</mark>**&#x20;the first corner to set the first corner** of the region, and <mark style="color:red;">**Right-Click**</mark>**&#x20;the opposite corner to complete the selection.**
3. [**After creating a selection**](#user-content-fn-1)[^1], create a region with the command: <mark style="color:blue;">`/cd region create <id>`</mark>
4. Now you've created your first region! You can view the currently created regions with the command:  [<mark style="color:blue;">`/cd`</mark>](#user-content-fn-2)[^2]  or   <mark style="color:blue;">`/cd region list`</mark>

</details>

***

### Drops

There are currently two types of Drops: Block Drops, and Mob Drops.

{% hint style="warning" %}
Have **either the block, or spawn egg of the mob**, and the new **drop items in your inventory** before following the steps below!\
\
\&#xNAN;*If mob doesn't have a spawn egg, consider the table below.*
{% endhint %}

<figure><img src="/files/cAXfr74aXm3Kr885riNS" alt=""><figcaption><p>Thanks ChatGPT for this table!</p></figcaption></figure>

<details>

<summary><mark style="color:purple;">Creating a Drop</mark></summary>

* There are multiple ways for you to create drops, you can either:
  1. <mark style="color:yellow;">Use the command:</mark> [<mark style="color:yellow;">`/cd`</mark>](#user-content-fn-3)[^3]
  2. <mark style="color:yellow;">Use the command:</mark> [<mark style="color:yellow;">`/cd list`</mark>](#user-content-fn-4)[^4]
  3. <mark style="color:yellow;">Use the command:</mark> <mark style="color:yellow;"></mark><mark style="color:yellow;">`/cd create <id>`</mark>
* Once the creation menu is open, select one of the options (either the BlockDrop or MobDrop).
  1. <mark style="color:yellow;">For BlockDrops,</mark> <mark style="color:yellow;"></mark><mark style="color:yellow;">**shift-click the block that you want to edit into the menu and click next.**</mark>
  2. <mark style="color:yellow;">For MobDrops,</mark> <mark style="color:yellow;"></mark><mark style="color:yellow;">**shift-click the spawn egg of the mob you want to edit into the menu and click next.**</mark>
* After clicking next, you should be prompted with a new menu. In this menu, **go ahead and insert the new items that you want the Mob or Block to drop**, then click next. **(You can also leave the menu empty).**
* If you've completed all the above steps correctly, you should now be at the Drop editing menu. Now all you have to do is add the region you created, or a global region, to do so:
  1. <mark style="color:yellow;">Click the beacon, and</mark> <mark style="color:yellow;"></mark><mark style="color:yellow;">**click on the Redstone dust or the clock that will be located at the bottom right of the menu.**</mark>
  2. <mark style="color:yellow;">Look for the region you created and</mark> <mark style="color:yellow;"></mark><mark style="color:yellow;">**click to add it, if it disappears, then it's been added!**</mark>
* <mark style="color:red;">**IMPORTANT**</mark> | Lastly, click the back button twice, **and click the map located in the bottom right of the editing menu to save your changes to the server files!** This may cause some lag.
* You're DONE! Now close the menu, and test it out!

</details>

***

<mark style="color:red;">**IMPORTANT**</mark> | To save all plugin data to files, you can either restart the server properly or click the save button on the bottom right corner of the portal (<mark style="color:blue;">`/cd`</mark> command opens portal menu). &#x20;

## Next Steps

Now, if you're ready to get into the more complex stuff, you can try to customize your drop even further by changing its [settings](/customdrops/settings/drop-settings.md) or changing the [Loot settings](broken://pages/YYBzSREH02LVq8iyBrQY) for the items you've added. You can even add [actions](/customdrops/actions-and-conditions/actions.md) or [conditions](/customdrops/actions-and-conditions/conditions.md) to your drops!

[^1]: Go back to step 2 if you get an error saying:

    ```
    You need to create a region selection first! Use /cd region wand to get a selection wand.
    ```

[^2]: opens up a main portal, click the beacon icon.

[^3]: Opens the main portal, click on the grass block.

[^4]: Click the clock in the bottom right corner to the menu.