# Spears Skill Support

{% hint style="danger" %}
If this is your first time using McmmoGui, you can skip this guide. This guide is mainly for server owners who are already using McMMO and McmmoGui and want to upgrade to 1.21.11 and use the Spears skill with their existing McmmoGui configuration.
{% endhint %}

#### Video tutorial:

{% file src="/files/4QvHS8q2QgxGCUC7jlaQ" %}

#### Text tutorial:

1. Update **SkillOverview\.yml** for **Spears** button:

   ```yaml
   Spears:
     Material: IRON_SPEAR
     Slots: [28]
     Flags: ["*"]
   ```
2. Update **settings.yml** for the **spears** command:<br>

   ```yaml
   SPEARS:
     Main: spears
   ```
3. Update your current language file (example: en-us.yml):\
   **Under Skills section:**

   ```yaml
     SPEARS:
       Name: Spears
       Type: ᴄᴏᴍʙᴀᴛ sᴋɪʟʟ
       Description:
       - <dark_gray>◘ <white>Enhance the power of the
       - <#fd9644>Spear<white>, break your limits, and
       - <white>deal extra damage.
       Abilities:
         MOMENTUM:
           Hide: false
           Type: ᴘᴀssɪᴠᴇ
           Name: Momentum
           Description:
           - <dark_gray>◘ <gray>When attacking the enemy,
           - <gray>there is a chance to increase
           - <gray>your movement speed.
           UnlockedStats:
           - '<dark_gray>⭘ <white>Active Chance: <#6ab04c>%mcmmogui_skill_spears_ability_momentum%%'
           - ''
           - '<dark_gray>⏳ <white>Duration <dark_gray>(ᴘᴠᴘ): <#fbc531>%mcmmogui_skill_spears_ability_momentum_duration%
             (s)'
         SPEARS_LIMIT_BREAK:
           Hide: false
           Type: ᴘᴀssɪᴠᴇ
           Name: Spears Breaker
           Description:
           - <white>◘ <gray>Breaking your limits. Increased
           - <gray>speark damage against strong
           - <gray>opponents (High Armor Points).
           UnlockedStats:
           - '<dark_gray>🗡 <white>Max Damage Bonus: <#fbc531>%mcmmogui_skill_spears_ability_spears-limit-break%'
         SPEAR_MASTERY:
           Hide: false
           Type: ᴘᴀssɪᴠᴇ
           Name: Spear Mastery
           Description:
           - <white>◘ <gray>Adds bonus damage to your
           - <gray>attacks with a spear weapon.
           UnlockedStats:
           - '<dark_gray>🗡 <white>Bonus Damage: <#fbc531>%mcmmogui_skill_spears_ability_spear-mastery%'
   ```

   \
   **Under Gui section:**

   ```yaml
     Spears:
       Title: '        sᴘᴇᴀʀs ᴀʙɪʟɪᴛɪᴇs'
       FeatureButtons:
         DefaultAbilityFormat:
           Name: <#dff9fb>%name% <reset><dark_gray>(Spears)
           Lore:
           - <dark_gray>%type%
           - ''
           - '%description%'
           - ''
           - '%stats%'
   ```


---

# 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://wiki.hyronic.dev/plugins/mcmmogui/spears-skill-support.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.