# Riding

<p class="callout success">Information targets the latest **supported** release. For legacy (older) versions and bug fixes, read the changelogs.</p>

<p class="callout danger">This page is a **WORK IN PROGRESS** and may contain inaccurate or placeholder information or links.</p>

#### **Introduction**

Horses have expanded riding functionality including gaits, swimming and dual riding.

---

#### **Requirements**

- Tamed
- [Trust status](https://wiki.swequestrian.com/books/star-worm-equestrian/page/interaction#bkmrk-usage) allows interaction
- [Equipped](https://wiki.swequestrian.com/books/star-worm-equestrian/page/interaction#bkmrk-tacking-up) with core tack items

---

#### **Riding**

<p class="callout info">Keybinds can conflict with other functions or mods. If you experience issues controlling a horse, check your controls.</p>

Horses require both bridle **and** saddle to control direction and speed ([configurable](https://wiki.swequestrian.com/books/star-worm-equestrian/page/server-config#bkmrk-bridle-requirement)). There are two control types - standard or tank controls.

##### Standard (Default)

`W` to move forward and mouse controls direction. `A/D` keys control lateral left and right movement without affecting camera angle.   
`S` resets the gait to walk.

##### Tank Controls `N TO TOGGLE`  


`W` to move forward, and `A/D` to turn smoothly left or right. If held, the horse will make a perfect circle movement - the size depends on the current gait (faster gait, wider circle). Camera angle can be freely controlled using the mouse without affecting horse movement. Tank controls are great for precision riding with dressage or coordinated group routines.

<p class="callout info">Enabling tank controls notifies the player over the hotbar, and highlights a small tank symbol in the [horse inventory](https://wiki.swequestrian.com/books/star-worm-equestrian-lite/page/horse-overview#bkmrk-horse-inventory) menu.</p>

##### Gait (Speed)

Horse speed is determined by their current "gait" and <span style="color: rgb(224, 62, 45);">speed skill</span>. Use `G` to decrease (slower), and `H` to increase (faster).

- Walk
- Trot
- Canter
- Extended Canter
- Gallop

<p class="callout info">Current gait displays next to hotbar if `gaitHudEnabled = true` in [configs](https://wiki.swequestrian.com/books/star-worm-equestrian/page/client-config#bkmrk-adjustable-values---). Gait resets to walk if `S` is used, or `W` released.</p>

<p class="callout warning">Gait increase restrictions ("debuffs") may occur when a horse is in poor condition due to low [hunger](https://wiki.swequestrian.com/books/star-worm-equestrian/page/feed-system) or [thirst](https://wiki.swequestrian.com/books/star-worm-equestrian/page/thirst-system).</p>

---

#### **Jumping**

Horse <span style="color: rgb(224, 62, 45);">jump height</span> is determined by <span style="color: rgb(224, 62, 45);">jump skill</span>, and the jump "charge".  Hold `space` to charge the meter, and release it to jump.

---

#### **Swimming**

Horses automatically begin swimming in 2B+ deep water. Swimming has a single speed, and uses normal `WASD` riding controls.

---

#### **Flight**

Horses must be equipped with a [bridle](https://wiki.swequestrian.com/books/star-worm-equestrian/page/bridle), [saddle](https://wiki.swequestrian.com/books/star-worm-equestrian/page/saddle) and <span style="color: rgb(224, 62, 45);">amethyst tier armor</span> (any with wings) to allow flight.

<table border="1" id="bkmrk-key-action-descripti" style="border-collapse: collapse; width: 100%; height: 359.438px;"><colgroup><col style="width: 12.3957%;"></col><col style="width: 12.3957%;"></col><col style="width: 75.2086%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td class="align-center" style="background-color: rgb(52, 5, 93); height: 29.7969px;">**<span style="color: rgb(255, 255, 255);">Default Key</span>**</td><td class="align-center" style="background-color: rgb(52, 5, 93); height: 29.7969px;">**<span style="color: rgb(255, 255, 255);">Action</span>**</td><td class="align-center" style="background-color: rgb(52, 5, 93); height: 29.7969px;">**<span style="color: rgb(255, 255, 255);">Description</span>**</td></tr><tr style="height: 30.1094px;"><td class="align-center" style="height: 30.1094px;"><code>J</code></td><td class="align-center" style="height: 30.1094px;">Launch</td><td style="height: 30.1094px;">Initiate flight and launch horse <code>7B</code> into the air.</td></tr><tr style="height: 29.7969px;"><td class="align-center" style="height: 29.7969px;">  
</td><td class="align-center" style="height: 29.7969px;">Glide</td><td style="height: 29.7969px;">Default state with no controls active - slow forward and downward motion towards the ground.</td></tr><tr style="height: 30.1094px;"><td class="align-center" style="height: 30.1094px;"><code>W</code></td><td class="align-center" style="height: 30.1094px;">Accelerate</td><td style="height: 30.1094px;">Increases speed (up to max) without increasing altitude.</td></tr><tr style="height: 30.1094px;"><td class="align-center" style="height: 30.1094px;"><code>A</code></td><td class="align-center" style="height: 30.1094px;">Bank Left</td><td style="height: 30.1094px;">Rotates the horse in a gradual left turn - altitude is decreased **unless** moving forward <code>W</code></td></tr><tr style="height: 30.1094px;"><td class="align-center" style="height: 30.1094px;"><code>D</code></td><td class="align-center" style="height: 30.1094px;">Bank Right</td><td style="height: 30.1094px;">Rotates the horse in a gradual right turn - altitude is decreased **unless** moving forward <code>W</code></td></tr><tr style="height: 30.1094px;"><td class="align-center" style="height: 30.1094px;"><code>Space</code></td><td class="align-center" style="height: 30.1094px;">Elevate</td><td style="height: 30.1094px;">Increases the altitude without forward movement.</td></tr><tr style="height: 30.1094px;"><td class="align-center" style="height: 30.1094px;"><code>Space &#43; W</code></td><td class="align-center" style="height: 30.1094px;">Rise</td><td style="height: 30.1094px;">Increases the altitude while moving forward.</td></tr><tr style="height: 29.7969px;"><td class="align-center" style="height: 29.7969px;"><code>LShift</code></td><td class="align-center" style="height: 29.7969px;">Flutter</td><td style="height: 29.7969px;">Decreases the altitude without moving forward - useful for precise landings.</td></tr><tr style="height: 29.7969px;"><td class="align-center" style="height: 29.7969px;"><code>LShift &#43; W</code></td><td class="align-center" style="height: 29.7969px;">Dive</td><td style="height: 29.7969px;">Decreases the altitude while moving forward.</td></tr><tr style="height: 29.7969px;"><td class="align-center" style="height: 29.7969px;"><code>S</code></td><td class="align-center" style="height: 29.7969px;">Float</td><td style="height: 29.7969px;">Decreases speed to a stop and holds position without losing altitude (hover).</td></tr><tr style="height: 29.7969px;"><td class="align-center" style="height: 29.7969px;">  
</td><td class="align-center" style="height: 29.7969px;">Land</td><td style="height: 29.7969px;">Landing occurs when a horse touches a block. **This includes collision with blocks (terrain).**</td></tr><tr><td colspan="3"><p class="callout info">**Summary:** <code>J</code> Launch <code>W</code> Move <code>A&#47;D</code> Steer <code>Space</code> Up <code>Shift</code> Down <code>S</code> Hover. *Think creative flying but no mouse steering!*</p>

</td></tr></tbody></table>

---

#### **Combat Commands**

Horses equipped with Adventure tack can use special combat moves if their <span style="color: rgb(224, 62, 45);">affinity</span> skill is high enough.

<table border="1" id="bkmrk-default-key-action-a" style="border-collapse: collapse; width: 100%; height: 89.7032px;"><colgroup><col style="width: 13.5822%;"></col><col style="width: 11.4376%;"></col><col style="width: 14.6545%;"></col><col style="width: 33.4789%;"></col><col style="width: 13.3439%;"></col><col style="width: 13.4631%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td class="align-center" style="background-color: rgb(52, 5, 93); height: 29.7969px;">**<span style="color: rgb(255, 255, 255);">Default Key</span>**</td><td class="align-center" style="background-color: rgb(52, 5, 93); height: 29.7969px;">**<span style="color: rgb(255, 255, 255);">Action</span>**</td><td class="align-center" style="background-color: rgb(52, 5, 93); height: 29.7969px;">**<span style="color: rgb(255, 255, 255);">Affinity Level</span>**</td><td class="align-center" style="background-color: rgb(52, 5, 93); height: 29.7969px;">**<span style="color: rgb(255, 255, 255);">Description</span>**</td><td class="align-center" style="background-color: rgb(52, 5, 93);">**<span style="color: rgb(255, 255, 255);">Area Of Effect</span>**</td><td class="align-center" style="background-color: rgb(52, 5, 93); height: 29.7969px;">**<span style="color: rgb(255, 255, 255);">Damage</span>**</td></tr><tr><td class="align-center"><span style="background-color: rgb(224, 62, 45);"><code>Unbound</code></span></td><td class="align-center">Bite</td><td class="align-center">Affinity VII</td><td>Horse bites out in front of them</td><td class="align-center"><span style="color: rgb(255, 255, 255); background-color: rgb(224, 62, 45);"> **TBC** </span></td><td class="align-center" style="height: 30.1094px;">2 **![D7Nimage.png](https://wiki.swequestrian.com/uploads/images/gallery/2023-08/scaled-1680-/GRod7nimage.png)**</td></tr><tr style="height: 30.1094px;"><td class="align-center" style="height: 30.1094px;"><code>Unbound</code>  
</td><td class="align-center" style="height: 30.1094px;">Kick</td><td class="align-center" style="height: 30.1094px;">Affinity VIII</td><td style="height: 30.1094px;">Horse kicks out behind them</td><td class="align-center"><span style="color: rgb(255, 255, 255); background-color: rgb(224, 62, 45);"> **TBC** </span></td><td class="align-center" style="height: 30.1094px;">4 **![D7Nimage.png](https://wiki.swequestrian.com/uploads/images/gallery/2023-08/scaled-1680-/GRod7nimage.png)**</td></tr><tr style="height: 29.7969px;"><td class="align-center" style="height: 29.7969px;"><code>Unbound</code>  
</td><td class="align-center" style="height: 29.7969px;">Stomp</td><td class="align-center" style="height: 29.7969px;">Affinity IX </td><td style="height: 29.7969px;">Horse rears up and stomps with front legs</td><td class="align-center"><span style="color: rgb(255, 255, 255); background-color: rgb(224, 62, 45);"> **TBC** </span></td><td class="align-center" style="height: 29.7969px;">1 ![D7Nimage.png](https://wiki.swequestrian.com/uploads/images/gallery/2023-08/scaled-1680-/GRod7nimage.png)</td></tr><tr><td colspan="6"><p class="callout info"><code>&#34;You can&#39;t do that right now&#34;</code> means wrong or partial equipment, inadequate level or using a gait above halt or walk.</p>

</td></tr></tbody></table>

---

#### **Additional**

##### Dual Riding

<p class="callout info">If a player cannot mount your horse, check the [Trust](https://wiki.swequestrian.com/books/star-worm-equestrian/page/interaction#bkmrk-usage) status allows them to interact. </p>

Horses support two riders, with the primary rider (front) controlling the horse. If the primary dismounts, the secondary becomes primary rider.

##### Mounted Entities

<p class="callout info">Mounting entities can be a bit temperamental, particularly entities with small hitboxes.</p>

`[Sprint Key]` + `Right Click` a **passive** or **neutral** entity while riding to mount it on your horse.

- `Ctrl` is the default key, but this depends on your individual keybinding.
- Entities occupy the spot of a second rider behind the primary rider.
- Entities move into primary position when a rider dismounts, but automatically adjust when you remount.

`Shift` + `Right Click` an entity while dismounted to remove them from a horse, or use a lead on them.

##### Refusals

Horses may buck or rear when requesting gait changes or jumps. The frequency of refusals is determined by their <span style="color: rgb(224, 62, 45);">affinity</span> skill.

##### Frost Walk

**Gold** tier [Horse Armor](https://wiki.swequestrian.com/books/star-worm-equestrian/page/horse-armor) grants a horse "Frost Walk", turning nearby water to ice blocks, unless toggled with `Middle Mouse Button`

##### Lava Walk

**Diamond** tier [Horse Armor](https://wiki.swequestrian.com/books/star-worm-equestrian/page/horse-armor) grants "Lava Walk", turning nearby lava sources to magma blocks.

- Horses will not take damage from either the magma blocks, or lava if they are submerged.
- Riders will not be affected unless the horse is submerged in lava deeper than 1B.
- Horse Armor does **not** sustain damage, so a horse in lava will be safe indefinitely until rescued.

##### Gait Restrictions

- Horses with `1/5` hunger or thirst are restricted to walking and experience `+30%` refusals.
- Horses with `2/5` hunger or thirst are restricted to canter, have `-20%` speed and `+20%` refusals.
- Horses with `3/5` hunger or thirst are not gait restricted but have `-10%` speed and `+10%` refusals.

---


#### **Gallery**

**![image-1686789061708.png](https://wiki.swequestrian.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686789061708.png)**

---

#### **Known Issues**

You can report any mod issues to our bugs forum on **[Discord](https://discord.com/channels/715626418893095012/1123695058496000240)** - please check for duplicate reports first!

- Using the kick combat move will harm and potentially kill mounted entities. [**Bug Report**](https://discord.com/channels/715626418893095012/1572752906417864826/1572752906417864826)
- Secondary rider mounting or dismounting the horse resets the gait to walk. [**Bug Report**](https://discord.com/channels/715626418893095012/1572743170943619105)
- Pressing `S` accidentally will bring the horse to a sudden stop from any gait.
- Horses may fall through into water or lava when lag delays frost or lava walk.

---

#### **Changelog**

<details id="bkmrk-view-changes-this-is"><summary>View Changes</summary>

<p class="callout info">This is not a complete list of changes or features. It is a log of wiki-related version information and may be outdated.</p>

<table border="1" style="border-collapse: collapse; width: 100%; height: 384.344px;"><colgroup><col style="width: 11.7429%;"></col><col style="width: 10.8776%;"></col><col style="width: 77.3795%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td class="align-center" style="background-color: rgb(52, 5, 93); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">**MC Version**</span></td><td class="align-center" style="background-color: rgb(52, 5, 93); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">**Release**</span></td><td class="align-center" style="background-color: rgb(52, 5, 93); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">**Notes**</span></td></tr><tr style="height: 29.7969px;"><td class="align-center" rowspan="2" style="height: 65.1875px;"><code>1&#46;21&#46;1</code>  
</td><td class="align-center" style="height: 29.7969px;"><code>1&#46;6&#46;12</code></td><td style="height: 29.7969px;">Page established - Information prior to <code>1&#46;6&#46;12</code> is not specifically included and may differ significantly.</td></tr><tr style="height: 35.3906px;"><td class="align-center" style="height: 35.3906px;"><code>1&#46;6&#46;8</code></td><td style="height: 35.3906px;">**[Bug Fix](https://discord.com/channels/715626418893095012/1477690919175196773)**: Crash on collision with any blocks in flight. </td></tr><tr style="height: 35.3906px;"><td class="align-center" rowspan="9" style="height: 70.7812px;"><code>1&#46;20&#46;1</code>  
</td><td class="align-center" rowspan="2" style="height: 70.7812px; width: 20.0247%;"><code>1&#46;6&#46;5</code>  
</td><td style="width: 66.6255%; height: 35.3906px;">[**Bug Fix:**](https://discord.com/channels/715626418893095012/1392830686901178470) Cannot lead a horse that has a mounted entity.</td></tr><tr style="height: 35.3906px;"><td style="width: 66.6255%; height: 35.3906px;">**[Bug Fix:](https://discord.com/channels/715626418893095012/1390464186802503701)** Cannot increase gait (speed) while in 1b water.</td></tr><tr style="height: 29.7969px;"><td class="align-center" rowspan="3" style="width: 20.0247%; height: 89.3907px;"><code>1&#46;4&#46;0</code>  
</td><td style="width: 66.6255%; height: 29.7969px;">**Tweak:** Flight launch height reduced from 11b to 7b.</td></tr><tr style="height: 29.7969px;"><td style="width: 66.6255%; height: 29.7969px;">**Bug Fix:** Speedy reversing (back up) no longer occurs when pressing S.  
</td></tr><tr style="height: 29.7969px;"><td style="width: 66.6255%; height: 29.7969px;">**Bug Fix:** Cannot dismount mid-air in flight as either primary or second rider.</td></tr><tr style="height: 29.7969px;"><td class="align-center" style="width: 20.0247%; height: 29.7969px;"><code>1&#46;3&#46;2</code></td><td style="width: 66.6255%; height: 29.7969px;">**Bug Fix:** Gait changes cannot be used in flight - no in-air refusal animations.  
</td></tr><tr style="height: 29.7969px;"><td class="align-center" rowspan="3" style="height: 89.3907px; width: 20.0247%;"><code>1&#46;3&#46;0</code>  
</td><td style="width: 66.6255%; height: 29.7969px;">**Feature:** Added Flight.</td></tr><tr style="height: 29.7969px;"><td style="width: 66.6255%; height: 29.7969px;">**Feature:** Added swimming when in lava, protection requires Diamond+ armor.</td></tr><tr style="height: 29.7969px;"><td style="width: 66.6255%; height: 29.7969px;">**Bug Fix:** Horses get stuck in swimming animation.  
</td></tr><tr style="height: 10px;"><td class="align-center" style="height: 10px; width: 13.3498%;"><code>1&#46;18&#46;2</code>  
</td><td class="align-center" style="width: 20.0247%; height: 10px;"><code>1&#46;3&#46;0&#45;15</code></td><td style="width: 66.6255%; height: 10px;">**Tweak:** Horses cannot suffocate in blocks. Resolves lag suffocation and foal deaths.

</td></tr></tbody></table>

</details>