Tutorials/Riding Setup

2026-09-15T11:10:48Z

Jerzykv: updated riding setup page for 1.8

{{TOC|right}}
== Preface ==
This tutorial will teach you how to add custom ride Pokémon to Cobblemon. The process is relatively simple to accomplish, but it is recommended to have the minimum basic knowledge of Blockbench's controls and the ability to read json's.
== Step 1: Adding a Locator ==
To allow the player to sit on the Pokémon, you need to add a locator (which is shown visually like an anchor) named <code>seat_1</code> to your model. If you want to add multiple seats to your Pokémon, you can add more locators named <code>seat_2</code>, <code>seat_3</code>, and so on. you can find the "Add Locator" tool in the Blockbench toolbar customization. The model should be placed in <code>assets/cobblemon/bedrock/pokemon/models/[folder named after your Pokémon]</code> as a <code>[pokemon].geo.json</code> file.

=== One seat (Charizard model example) ===
[[File:One Seat Locator Example.png|150px]]
[[File:One Seat Viewport Example.png|250px]]

=== Two Seats (Dewgong model example) ===
[[File:Two Seat Locator Example.png|150px]]
[[File:Two Seat Viewport Example.png|250px]]

=== Six Seats (Camerupt model example) ===
[[File:Six Seat Locator Example.png|150px]]
[[File:Six Seat Viewport Example.png|250px]]

== Step 2: Adding Ride Data ==
In the <code>species</code> file of the Pokémon (or by species additions) you must add riding behaviours.

=== Example from Arcanine ===

"riding": {
"<abbr title="This is where you define how a Pokémon should behave while riding. You add how your Pokémon can move.">behaviours</abbr>": {
"<abbr title="The type of movement in that category. LAND is for moving on ground, AIR is for moving in air, and LIQUID is for moving in liquids">LAND</abbr>": {
"<abbr title="The movement style in that category. This is very important as it chooses which ride style the Pokémon will use; for example, if it hovers above the ground like Minecraft creative flight, or flies like a bird">key</abbr>": "cobblemon:land/horse",
"<abbr title="The sound that plays when riding. See 'Extra Notes' below for more information.">rideSounds</abbr>": [],
"<abbr title="Similar to a Pokémon's base stats, but for riding. Each stat does something different for each ride style.">stats</abbr>": {
"<abbr title="How fast the Pokémon can reach the maximum speed.">ACCELERATION</abbr>": "<abbr title="A range of values for the stat written as min-max. Should be kept in range of 0-100.">70-90</abbr>",
"<abbr title="How high the Pokémon can jump. For air style mounts, this has other effects, such as gliding effectiveness for Bird style mounts.">JUMP</abbr>": "45-65",
"<abbr title="How fast the Pokémon can turn. For Hover style mounts, this affects the rate of deceleration.">SKILL</abbr>": "40-80",
"<abbr title="The maximum speed the Pokémon can reach.">SPEED</abbr>": "45-70",
"<abbr title="The length of time the Pokémon may be ridden in its specific style, such as sprinting duration for Land mounts.">STAMINA</abbr>": "35-80"
}
}
},
"<abbr title="How many seats a Pokémon will have, along with their locator. See 'Extra Notes' below for more information.">seats</abbr>": [
{
"<abbr title="The seat locator on your model.">locator</abbr>": "seat_1"
}
]
}

=== Extra Notes===
==== rideSounds====
The sounds and the configuration of the volume of the sounds. Mainly used for air mounts.
An example of the configurations (Dragapult example):
"rideSounds": [
{
"<abbr title="Whether sound muffling is enabled or not">muffleEnabled</abbr>": true,
"<abbr title="A molang expression of the pitch of the sound">pitchExpr</abbr>": "math.max(1.0 ,0.2 + math.pow(math.min(q.ride_velocity() / 1.5, 1.0),2))",
"<abbr title="Whether the ride sounds should play for players that currently aren't riding the Pokémon or not">playForNonPassengers</abbr>": true,
"<abbr title="The sound that plays whilst riding. Loop sounds have 4 different options: leather, plumage, chitin and wind, all are listed as cobblemon:ride.loop.[option]">soundLocation</abbr>": "cobblemon:ride.loop.wind",
"<abbr title="A molang expression for the volume of the sound">volumeExpr</abbr>": "math.pow(math.min(q.ride_velocity() / 1.5, 1.0),2)"
}
]

==== seats====
How many seats a Pokémon will have, along with their locator. You should list as many seat locators as you have on your model.

A Pokémon with one seat:
"seats": [
{
"locator": "seat_1"
}
]

A Pokémon with two seats:
"seats": [
{
"locator": "seat_1"
},
{
"locator": "seat_2"
}
]

===Available Ride Keys ===
For more in-depth information, see [https://wiki.cobblemon.com/index.php/Pok%C3%A9mon/Riding#Riding_Styles Riding Styles]

LAND 
<code>land/horse</code> (also known as standard) 

AIR 
<code>air/bird</code> 
<code>air/jet</code> 
<code>air/hover</code> (also known as ufo) 
<code>air/rocket</code> 

LIQUID 
<code>liquid/boat</code> 
<code>liquid/submarine</code> 
<code>liquid/dolphin</code> 

To make your Pokémon unable to jump, you can add a <code>"canJump": false</code> line. To make it unable to sprint, you add a <code>"canSprint": false</code> line, as shown below (Dragapult example):
"LAND": {
"key": "cobblemon:land/horse",
"rideSounds": [],
"canJump": false,
"canSprint": false,
"stats": {
"ACCELERATION": "10-40",
"JUMP": "10-40",
"SKILL": "80-100",
"SPEED": "10-40",
"STAMINA": "10-40"
}
}

==Step 3: Animations ==

Small Note: Ride animations are optional and not required for riding to work.

Ride Pokémon have additional animations, mainly overlays, jumps and run animations.

Overlays play on top of the ride animation, allowing dynamic movement using molang.
They use the variables feature of Blockbench. To make a variable slider, copy this text and replace yaw_change with whatever you want your slider to control.

<code><abbr title="q means query. This should be left as is">q</abbr>.<abbr title="This should be left as is">r</abbr>.<abbr title="Left and right movement. 1 is moving right, -1 is moving left">yaw_change</abbr> = slider('yaw_change', 0.02, -1.0, 1.0)</code>

<code><abbr title="up and down movement. 1 is moving up, -1 is moving down">pitch_change</abbr></code>
<code><abbr title="jump up and down movement, 1 is upwards motion, and -1 is downwards">velocity_y</abbr></code>
<code><abbr title="air diving motion. 0 is no dive, 1 is diving at full velocity.">dive</abbr></code>

For example, to make the slider affect yaw, you need to add <code>q.r.yaw_change</code> to a keyframe. If you would put <code>q.r.yaw_change(0)*7</code> in a rotation keyframe, it will cause the part to rotate 7 degrees left or right, depending on the value of yaw_change on the slider.

Land rides usually use:
<code>ride_ground_run</code>
<code>ride_ground_walk</code>
<code>ride_jump</code>

Air rides usually use:
<code>ride_air_fly</code>
<code>air_glide</code>
<code>ride_air_dive</code>

Liquid rides usually use:
<code>ride_water_swim</code>

====Posers====
The poser is how you set up the ride animations. You need to add a condition animation in the <code>"animations": []</code> bracket with the condition <code>q.is_ridden</code>. This will cause the animation to only play whilst riding (Charizard's ride run overlay).
{
"condition": "q.is_ridden",
"animation": "q.bedrock('charizard', 'ride_ground_run')"
}

When adding a run to a Pokémon, you need to add a <code>q.is_sprinting</code> condition to your run pose and a <code>!q.is_sprinting</code> anticondition to your walk pose. To make a jump, you need to add a <code>q.in_air</code> condition to your jump pose and a <code>!q.in_air</code> to your grounded poses, so run, walk and idle. (Wyrdeer poser example)

"in-air": {
"poseTypes": ["STAND", "WALK"],
"isBattle": false,
"condition": "q.in_air && q.is_ridden",
"animations": ["q.look('head')", "q.bedrock('wyrdeer', 'ride_jump')"],
"transformTicks": 2,
"transformToTicks": 2
},
"walk": {
"poseName": "walk",
"poseTypes": ["WALK"],
"isBattle": false,
"condition": "!q.in_air && !q.is_sprinting",
"animations": [
"q.look('head')",
"q.bedrock('wyrdeer', 'ground_walk')",
{
"condition": "q.is_ridden",
"animation": "q.bedrock('wyrdeer', 'ride_ground_run')"
}
],
"quirks": [
"q.bedrock_quirk('wyrdeer', 'blink')"
],
"transformTicks": 10
},
"run": {
"poseName": "run",
"poseTypes": ["STAND","WALK"],
"isBattle": false,
"condition": "!q.in_air && q.is_sprinting",
"animations": [
"q.look('head')",
"q.bedrock('wyrdeer', 'ground_run')",
{
"condition": "q.is_ridden",
"animation": "q.bedrock('wyrdeer', 'ride_ground_run')"
}
],
"quirks": [
"q.bedrock_quirk('wyrdeer', 'blink')"
],
"transformTicks": 10
}

{{Addon Creation}}
[[Category:Tutorial]]

Cobblemon Wiki - User contributions [en]

Tutorials/Riding Setup