# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dev.vanixmc.com/customdrops/getting-started/tutorial.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.