# Game items

Game items are the main elements in the game used by players. Each weapon/item have different abilities included.

## Definition

### Basic weapons

Weapons that all players can receive without any skill requirement:

* :axe:`Combat Axe` - The item which can be thrown by players towards anything and deals significant amount of damage to the hit target
  * <kbd>Right</kbd> or <kbd>Left</kbd> click to throw this axe
* :knife:`Rage Knife` - The "sharp" item which can be used to deal significant damage to entities on hit
  * <kbd>Left</kbd> click to hit the target
* :bow\_and\_arrow:`Rage Bow with Rage Arrow` - "Bow with Explosion Arrow" is the improved version of an original "bow with arrow" for shooting explosive arrows and dealing damage within 10 blocks range. Use it boldly, the arrow count is unlimited
* :flashlight:`Flash` - Namely `flashbang`, used to temporarily disorient enemies with a blinding flash of darkness for a limited time without causing damage
  * <kbd>Right</kbd> or <kbd>Left</kbd> click to throw a flash
* :snowflake:`Freeze ball` - An item that can freeze entities within a specified range for a limited time
  * <kbd>Right</kbd> click to throw a ball
* :bomb:`Grenade` - A small explosive hand grenade projectile deals significant damage to nearby entities
  * <kbd>Right</kbd> click to throw a grenade
* :exploding\_head:`Pressure mine` - An unpickable, lightweight, deadly landmine
  * <kbd>Right</kbd> click to place down a landmine
* :x:`Barricade` - An unpickable barricade used to slow down and damage enemies
  * <kbd>Right</kbd> click to place down a line of barricade

{% hint style="info" %}
Items which can be placed down on blocks will be removed at the end of game.
{% endhint %}

### Special arrows

Special arrows for the `Rage Bow` weapon are made to trigger different abilities in the game when interacting with blocks or entities. These arrows can only be purchased from [Lobby shop](/ragemode-docs/guides/lobby-shop.md) and players can choose to limit how many arrows they can buy or pay extra for an unlimited amount.

* :cloud\_lightning:`Lightning Strike Arrow` - Any interaction with blocks or entities summons a lightning strike at the destination location, which deals damage to nearby entities.
* :flashlight:`Glowing Arrow` - Causes glowing effect for nearby entities for limited amount of seconds
* :fire:`Fire Arrow` - Causes entities to blow on fire
* :heart:`Healing arrow` - Causes nearby players to receive healing within 5 blocks range
* :microbe:`Poisoned Arrow` - Causes nearby entities to receive damage for x amount of seconds
  * In `classic` game mode players will get `Poison` potion effect by default
  * In `zombie` game mode players are unaffected by this, but zombies receives damage over time

{% hint style="info" %}
In order to activate one of these special arrows in game, you need to <kbd>Left click</kbd> on the arrow itself from your inventory by pressing <kbd>E</kbd> button or the assigned button for opening your inventory.
{% endhint %}

**Conditions:**

* When a player has run out of a selected type of arrow, the default arrow (RageArrow) is automatically used.
* Players can only purchase special arrows from [Lobby shop](/ragemode-docs/guides/lobby-shop.md) GUI menu for x specified amount or unlimited, depending on player preference.
* Any remaining purchased arrows are lost at the end of the game or when the player exits

<h4 align="center">Preview</h4>

<figure><img src="/files/zRvd4mEBG1GYWfZoFs0M" alt=""><figcaption></figcaption></figure>

## Configuration

Items display name, lore, slot and many related can be modified manually in `game-items.yml` file.

### Game items

* `display name` - The display name of the item
* `lore` - List of lore to display on hovering item
* `slot` - The slot number value to appear in player inventory
* `custom model data` - A custom model data value to display custom model in game
  * You can use this option as an integer value for legacy way
  * Or specify different settings
    * ```
      custom-model-data-component:
        colors:
        - colors
        strings:
        - strings
        flags:
        - flags
        floats:
        - floats
      ```

These are the items with extra options you can modify:

<table><thead><tr><th width="158">Option</th><th width="216">Item</th><th>Description</th></tr></thead><tbody><tr><td><code>min-max damage</code></td><td>RageKnife, RageArrow</td><td>Minimum and maximum RNG-based damage</td></tr><tr><td><code>item</code></td><td>CombatAxe</td><td>The item to throw on click</td></tr><tr><td><code>velocity</code></td><td>CombatAxe, Flash, FreezeBall, Grenade</td><td>Velocity (speed) of this item as projectile</td></tr><tr><td><code>thrown-sound</code>*1</td><td>CombatAxe, Grenade</td><td>The <a href="https://jd.papermc.io/paper/org/bukkit/Sound.html">sound</a> played on throwing this item</td></tr><tr><td><code>effect-settings</code></td><td>Flash, FreezeBall</td><td><p><code>radius</code> - The radius value to cause nearby entities receive this effect</p><p></p><p><code>duration</code> - The duration of this effect in ticks</p><p></p><p><code>amplifier</code> - The amplifier for this effect</p></td></tr><tr><td><code>amount</code></td><td>FreezeBall, Flash, Grenade, PressureMine, Barricade</td><td>The amount to define how much item the player receives</td></tr><tr><td><code>radius</code></td><td>FreezeBall</td><td>The radius value to cause nearby entities receive this effect</td></tr><tr><td><code>freeze-duration</code></td><td>FreezeBall</td><td>The duration of freezing for <code>FreezeBall</code> item in ticks</td></tr><tr><td><code>hit-sound</code></td><td>RageArrow, FireArrow</td><td>The hit <a href="https://jd.papermc.io/paper/org/bukkit/Sound.html">sound</a> of arrow</td></tr></tbody></table>

\*1 - Syntax: `name;soundCategory;volume;pitch`

* [List of soundCategories](https://jd.papermc.io/paper/org/bukkit/SoundCategory.html)

### Misc items

These items are only used by spectator players.

* `leave-game` - To leave the game
* `stop-game` - To stop the game (if the player has permission)
* `teleporter-item` - Item to teleport to selected player destination location for spectating

### Lobby items

Players receive these items after joining a game to simplify the process, such as leaving the game without typing the command.

* `force-start` - Used to force start the game (need permission)
* `player-options` - Configure player options from a menu
* `skills-menu-item` - Opens player skills menu
* `missions` - Opens player missions menu
* `special-arrow-switcher` - This is only used in lobby shop menu, where you can buy special arrows
* `shopitem` - The item used to buy in-game stuff from


---

# 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://mdswork.gitbook.io/ragemode-docs/guides/game-items.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.
