# 🎲 Custom Multipliers

**Custom Multipliers** allows you to dynamically adjust amount of dropped currency from all or certain objectives depends on **placeholder value** of the player!

You can create as many multipliers as you want and assign them to different objectives!

For example, by default there is `level` multiplier using `%player_level%` placeholder. When assigned to an objective, amount of dropped currency will be multiplied by the player xp level provided by that placeholder.

{% hint style="warning" %}
This feature requires [PlaceholderAPI](https://www.spigotmc.org/resources/6245/) to be installed!

All used placeholders **must** return **numeric** values! Expressions/formulas are <mark style="color:orange;">**not allowed**</mark>!
{% endhint %}

## Setup

1. Go to **LootConomy** directory and open the `config.yml`.
2. Make sure that `Objectives` -> `Custom_Multipliers` -> `Enabled` is set on `true`.
3. Look at `Objectives` -> `Custom_Multipliers` -> `List` section.
4. It should contain one default multiplier named `level`.
5. Create another one below or above it with the choosen name and placeholder (**keep placeholders in single quotes!**).
6. Now go to `/objectives/` directory and open some objective config file.
7. Select the objective to assign multiplier for.
8. Under `Drops` -> `Currency` section of the objective select a currency for which you would like to set a multiplier.
9. And set your multiplier name (**not placeholder!**) in `Custom_Multiplier` option.
10. Reload the plugin: `/lc reload`.
11. Done! See config examples below if you're confused or have issues.

{% code title="config.yml Example" %}

```yaml
Custom_Multipliers:
  Enabled: true
  List:
    level: '%player_level%' # 'level' is multiplier name for objective configs.
```

{% endcode %}

{% code title="Example of objective config" %}

```yaml
spider:
  ActionType: kill_entity
  Objects:
  - spider
  Drops:
    Currency:
      economy:
        Chance: 100.0
        Amount:
          Min: 5.0
          Max: 10.0
        Portions:
          Min: 1
          Max: 3
        Custom_Multiplier: 'level' # <== Used 'level' multiplier from the config.yml
```

{% endcode %}


---

# 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://nightexpress.gitbook.io/lootconomy/features/custom-multipliers.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.
