# Configurations

**orbs.yml**

```yaml
Invalid_Argument: "&cInvalid argument, &cplease do &a/orbs give <player> <type> <amount>"
Unable_To_Find_Player: "&cUnable to find &o%player%"
Given_Orbs: "&7You have given %player% %amount%x &b%orb% orbs(s)"
Received_Orbs: "&7You have been given %amount%x &b%orb% orbs(s)"
Invalid_Amount: "&cInvalid amount."

#This only attempts to give prior effects back - we recommend to disable this and have custom enchants give old effects back where possible
# If your using Advanced Enchantments please disable
Give_Old_Effect: false

Activated_Message: "&b&l%type% ACTIVATED FOR %time%s!"
Cooldown_Message: "&cYou are on a cooldown! (%time%s left)"

#For the Potion Effect use: https://helpch.at/docs/1.11/index.html?org/bukkit/potion/PotionEffectType.html
Orbs:
  Example_Strength:
    Material: "INK_SACK"
    Damage: 1
    Glow: true
    Name: "&c&lStrength Orb"
    Lore:
      - "&7&oRight Click to activate!"
      - "&7&oDuration is 10 seconds!"
    Potion_Effect: "INCREASE_DAMAGE"
    Amplifier: 2
    Cooldown: 15
    Duration: 10
  Example_Speed:
    Material: "INK_SACK"
    Damage: 12
    Glow: true
    Name: "&b&lSpeed Orb"
    Lore:
      - "&7&oRight Click to activate!"
      - "&7&oDuration is 10 seconds!"
    Potion_Effect: "SPEED"
    Amplifier: 3
    Cooldown: 15
    Duration: 10
  Example_Jump:
    Material: "INK_SACK"
    Damage: 10
    Glow: true
    Name: "&b&lJump Orb"
    Lore:
      - "&7&oRight Click to activate!"
      - "&7&oDuration is 10 seconds!"
    Potion_Effect: "JUMP"
    Amplifier: 3
    Cooldown: 15
    Duration: 10
  
```

**switcherball.yml**

```yaml
Invalid_Argument: "&cInvalid argument, &cplease do &a/switcherball give <player> <amount>"
Unable_To_Find_Player: "&cUnable to find &o%player%"
Received_Switcher_Ball: "&3You been given &a%amount%x &fSwitcher Ball(s)&3."
Given_Switcher_Ball: "&3You have given &b%player% &b%amount%x &3Switcher Ball(s)."
Invalid_Amount: "&cInvalid amount."

#Cooldown between uses
Switcher_Ball_Cooldown: 10
Cooldown_Message: "&cYou cannot use a Switcher Ball for another %time%s!"

Switcher_Ball_Name: "&b&lSWITCHER BALL"
Switcher_Ball_Lore:
  - "&7&oUse this to switch positions with someone!"
  - "&7&oBe careful!"

Been_Swapped_Message: "&f&l%shooter% &bused a switcher ball on you and have switched locations!"
Shooter_Hit_Message: "&bYou have used your switcher ball and switched locations with &f&l%player%&b!"
Cannot_Use_On_Self: "&cYou cannot use a Switcher Ball on yourself - you have been refunded."

Blocked_Region_Message: "&cSwitcher Balls cannot be used in at this region."

Blocked_Regions:
  - "example_region_1"
Blocked_Worlds:
  - "example_world_1"
```

**throwablecobweb.yml**

```yaml
Invalid_Argument: "&cInvalid argument, &cplease do &a/throwablecobweb give <player> <amount>"
Unable_To_Find_Player: "&cUnable to find &o%player%"
Received_Item: "&3You been given &a%amount%x &fThrowable Cobweb(s)&3."
Given_Item: "&3You have given &b%player% &b%amount%x &3Throwable Cobweb(s)."
Invalid_Amount: "&cInvalid amount."

#All time is in seconds
Material: "WEB"
Damage: 0
Name: "&7&lThrowable Cobweb"
Lore:
  - "&7&oRight Click to throw!"
  - "&7&oWill automatically remove after 10 seconds!"
Glow: true

#Automatic_Removal_Time is the time between when it lands on the ground and when it is removed
Automatic_Removal_Time: 10
Cooldown: 60
Cooldown_Message: "&cYou cannot use Throwable Cobweb's again for another %time% second(s)!"

Landed_Message: "&aYour Throwable Cobweb has successfully landed - it will be automatically removed in %time% seconds"
Refunded_Message: "&cYour Throwable Cobweb was unable to land at that position - you have been refunded."


Blocked_Region_Message: "&cYou cannot use Throwable Cobweb's in this region!"
Blocked_World_Message: "&cYou cannot use Throwable Cobweb's in this world!"
Blocked_Regions:
  - "example_region_1"
Blocked_Worlds:
  - "example_world_1"

```

**blinderball.yml**

```yaml
Invalid_Argument: "&cInvalid argument, &cplease do &a/blinderball give <player> <amount>"
Unable_To_Find_Player: "&cUnable to find &o%player%"
Received_Blinder_Ball: "&3You been given &a%amount%x &fBlinder Ball(s)&3."
Given_Blinder_Ball: "&3You have given &b%player% &b%amount%x &3Blinder Ball(s)."
Invalid_Amount: "&cInvalid amount."

Blinder_Ball_Name: "&c&lBLINDER BALL"
Blinder_Ball_Glow: true
Blinder_Ball_Lore:
  - "&7&oUse this to blind and slow someone!"
  - "&7&oBe careful!"

# For example - Slowness with amplifier 2 will give Slowness III and so on
Enable_Slowness: true
Slowness_Duration: 10
Slowness_Amplifier: 2
Enable_Blindness: true
Blindness_Duration: 10
Blindness_Amplifier: 2

Been_Hit_Message: "&f&l%shooter% &bused a blinder ball on you and have given blindness and slowness!"
Hit_Message: "&bYou have used your blinder ball on &f&l%player%&b!"
Cannot_Use_On_Self_Message: "&cYou cannot use a Blinder Ball on yourself - you have been refunded."

#Cooldown between uses
Cooldown: 10
Cooldown_Message: "&cYou cannot use a Blinder Ball for another %time%s!"

Blocked_Region_Message: "&cBlinder Balls cannot be used in at this region."
Blocked_World_Message: "&cYou cannot use Blinder Balls in this world."

Blocked_Regions:
  - "example_region_1"
Blocked_Worlds:
  - "example_world_1"

```

**bones.yml**

```yaml
BONES_ITEM_NAME: '&7&lBone Item'
BONES_ITEM_LORE:
- '&7&oHit someone with this %amount% to prevent'
- '&7&ofrom placing blocks for %time%!'
BONES_ITEM_GLOW: true
BONES_CANNOT_PLACE_BLOCK: '&cYou cannot place blocks for another %time%s'
BONES_SUCCESSFULLY_HIT: '&aYou have successfully prevented %target% from placing blocks
  for %time%s!'
BONES_SUCCESSFULLY_BEEN_HIT: '&aYou have been hit with a bone item by %attacker% and
  cannot place blocks for %time%s'
BONES_BEEN_HIT: '&cYou have been hit by %attacker% with a bone item - %remaining%
  more hits until you cannot place blocks!'
BONES_HIT: '&aYou have hit %target% with a bone item - %remaining% more hits until
  they can''t place blocks!'
BONES_HIT_AMOUNT: 5
BONES_CANNOT_PLACE_SECONDS: 10
BONES_USAGE_COOLDOWN_SECONDS: 180
BONES_COOLDOWN_MESSAGE: '&cYou are currently on cooldown for another %remaining% seconds'
BONE_RECEIVED: '&aYou have been give %amount% of bone items.'

```

fakepearls.ymlam

```yaml

# +-----------------------+
# | Item Configuration    |
# +-----------------------+
item-name: '&d&lFake Pearl'
item-lore:
- '&7&oThrow this pearl to disorientate your enemies!'
item-glow: true

# +-----------------------+
# | Cooldown Configuration|
# | (in seconds)          |
# +-----------------------+
cooldown: 10

# +-----------------------+
# | Message Configuration |
# +-----------------------+
cooldown-message: '&cYou cannot use this item for another &e{time} &cseconds!'
launch-message: '&aYou have thrown a fake pearl!'
been-given-pearl: '&aYou have been given &2{0}x &aFake Pearl(s)!'

```


---

# 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://docs.mantic.dev/pvpitems/configurations.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.
