zephyr/horse
1
0
Fork 0
Code Issues 16 Pull Requests Actions Packages Projects Releases Wiki Activity

zenno/doc/mdb: document races
ci/woodpecker/push/horsebot Pipeline failed
Details
ci/woodpecker/push/zenno Pipeline failed
Details

Browse Source
This commit is contained in:
zephyr
2026-09-11 18:14:14 -04:00
parent 3bf17944b3
commit caa19dd85a
1 changed files with 455 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
zenno/src/routes/doc/mdb/+page.svelte
+455
View File
@@ -17,8 +17,107 @@
} }
}); });
const raceGroups = [
[1, 'Common'],
[2, 'Daily Race'],
[3, '"Training Practice"'],
[4, '"Story Condition"'],
[5, '"Team Building"'],
[6, 'Practice'],
[7, 'Career-Exclusive'],
[8, 'Legend Race'],
[9, 'Team Trials'],
[10, 'Unity Cup Team Race'],
[11, "Champions' Meet"],
[12, 'Room Match'],
[13, '"Challenge Match"'],
[14, 'League of Heroes Race'],
[61, 'Custom G1'],
] as const;
const raceGrades = [
[100, 'G1'],
[200, 'G2'],
[300, 'G3'],
[400, 'OP'],
[700, 'Pre-OP'],
[800, 'Maiden'],
[900, 'Debut'],
[999, 'Daily Race or Room Match (?)'],
[1000, 'Unity Cup Team Race (?)'],
] as const;
const raceTimes = [
[1, 'Morning (unused)'],
[2, 'Daytime'],
[3, 'Evening'],
[4, 'Night'],
] as const;
const raceInitialLanes = [
[1, 9, 0.03333333],
[2, 0, 0],
[3, 14, 0.10333333],
[4, 8, 0.03333333],
] as const;
const raceAreas = [
[0, 'Hokkaido'],
[1, 'Tohoku'],
[2, 'Kanto'],
[3, 'Western Japan'],
[4, 'Kokura'],
[5, 'France'],
[6, 'America'],
] as const;
const raceLoops = [
[1, 'None'],
[2, 'Inner'],
[3, 'Outer'],
[4, 'Outer→Inner'],
] as const;
const raceRotations = [
[1, 'Right'],
[2, 'Left'],
[3, 'Rightward Stretch (unused)'],
[4, 'Leftward Stretch'],
] as const;
const raceCourseThresholds = [
[1, 1, 0],
[2, 2, 0],
[3, 3, 0],
[4, 4, 0],
[5, 5, 0],
[6, 1, 2],
[7, 2, 3],
[8, 2, 4],
[9, 3, 5],
[10, 2, 5],
[11, 4, 5],
] as const;
const raceSaddleTypes = [
[0, 'Special'],
[1, 'G3'],
[2, 'G2'],
[3, 'G1'],
] as const;
const racePermissions = [
[1, 'Junior'],
[2, 'Classic'],
[3, 'Classic and Senior'],
[4, 'Senior'],
[5, 'Finale'],
] as const;
const skills = $derived({ const skills = $derived({
rickey: skillMap.get(100981), rickey: skillMap.get(100981),
right1: skillMap.get(200012),
left1: skillMap.get(200022),
fall2: skillMap.get(200191), fall2: skillMap.get(200191),
fall1: skillMap.get(200192), fall1: skillMap.get(200192),
fallX: skillMap.get(200193), fallX: skillMap.get(200193),
@@ -330,6 +429,362 @@
>, but a few categories that have useful strings are missing from there. >, but a few categories that have useful strings are missing from there.
</p> </p>
<Sec h={2} id="race">Races</Sec>
<p>First, some terminology, as the game uses it internally. (Some UI phrasing disagrees.)</p>
<p>
A <i>race</i> is an organized running competition, typically held annually. A <i>race instance</i> is a single holding of a
race at a specific date and time; this includes special race instances like Team Trials races, Aim for the Stars races,
&amp;c. Race instances are held on a given <i>race course</i>, which is a fixed-length segment of a physical location called a
<i>race track</i>. A <i>win saddle</i> is a given horse's victory of a race or a specific group of races, e.g. Classic Triple Crown
or Dual Grand Prix. This section will cover races, race instances, race tracks, race courses, and win saddles.
</p>
<p>
<Mono>text_data</Mono> categories relevant to races include:
</p>
<ul class="ml-4 list-disc pb-4">
<li>32 and 33 are both race names, the latter for jikkyo (the announcer's lines).</li>
<li>
28 is race instance names. 29 is abbreviated race instance names, e.g. <Mono>Mile Ch.</Mono> instead of <Mono
>Mile Championship</Mono
>.
</li>
<li>
31 and 34 are race track full names, the former for jikkyo, e.g. <Mono>Kyoto Racecourse</Mono>. 35 is race track names
without "Racecourse".
</li>
<li>111 is win saddle names.</li>
</ul>
<Sec h={3} id="race-race">Race Info</Sec>
<p>
Races are defined in <Mono>race</Mono>, which is quite a direct name innit.
</p>
<ul class="ml-4 list-disc pb-4">
<li>
Race ID is just <Mono>id</Mono>.
</li>
<li>
<Mono>group</Mono> is the game situation where the race occurs.
<table class="table-fixed border text-center">
<thead>
<tr>
<th scope="col" class="px-2">Group</th>
<th scope="col" class="px-2">Meaning</th>
</tr>
</thead>
<tbody>
{#each raceGroups as [id, name] (id)}
<tr class="even:bg-mist-300 dark:even:bg-mist-900">
<td class="px-2">{id}</td>
<td class="px-2">{name}</td>
</tr>
{/each}
</tbody>
</table>
</li>
<li>
<Mono>grade</Mono> defines the race grade.
<table class="table-fixed border text-center">
<thead>
<tr>
<th scope="col" class="px-2">Grade ID</th>
<th scope="col" class="px-2">Meaning</th>
</tr>
</thead>
<tbody>
{#each raceGrades as [id, name] (id)}
<tr class="even:bg-mist-300 dark:even:bg-mist-900">
<td class="px-2">{id}</td>
<td class="px-2">{name}</td>
</tr>
{/each}
</tbody>
</table>
</li>
<li><Mono>course_set</Mono> gives the <a href="#race-course">race course</a> where the race occurs.</li>
<li><Mono>thumbnail_id</Mono> is the resource ID of the race's thumbnail image.</li>
<li><Mono>entry_num</Mono> is the maximum number of horses that can run the race.</li>
</ul>
<p>
Some races are ostensibly defined twice to account for variant races run during some characters' careers, e.g. Maruzensky's
five opponent Spring Stakes, McQueen/Ryan/Rice's Kyoto Takarazuka Kinen, &amp;c.
</p>
<Sec h={3} id="race-instances">Race Instances</Sec>
<p>
The table is <Mono>race_instance</Mono>.
</p>
<ul class="ml-4 list-disc pb-4">
<li><Mono>id</Mono> is the race instance ID.</li>
<li><Mono>race_id</Mono> joins with <Mono>race.id</Mono>.</li>
<li>
<Mono>npc_group_id</Mono> should define the NPC racers allowed to appear in the race instance, although I haven't looked into
it.
</li>
<li>
<Mono>date</Mono> gives the month and day-of-month when the race instance occurs, expressed as M&times;100+d &ndash; 1 Jan is
101 and 31 Dec is 1231. This appears to decide the season that the race instance occurs in and thus the applicable green skill.
E.g., we can see in career that Challenge Cup is offered on the Early December turn, but its race instance has a <Mono
>date</Mono
> of 1130 (i.e. 30 Nov), so it is a fall rather than winter race. All races occur in 2019.
</li>
<li>
<Mono>time</Mono> is the time of day that the race instance is held.
<table class="table-fixed border text-center">
<thead>
<tr>
<th scope="col" class="px-2">Time</th>
<th scope="col" class="px-2">Meaning</th>
</tr>
</thead>
<tbody>
{#each raceTimes as [id, name] (id)}
<tr class="even:bg-mist-300 dark:even:bg-mist-900">
<td class="px-2">{id}</td>
<td class="px-2">{name}</td>
</tr>
{/each}
</tbody>
</table>
</li>
<li>
<Mono>clock_time</Mono> has a value of 1605 for one race and is otherwise always 0. It might be a specific hour and minute that
a race instance occurs, but I'm not sure why that would ever matter.
</li>
<li>
<Mono>race_number</Mono> takes every value between -1 and 12, but I couldn't find any explanation for it.
</li>
</ul>
<p>
Similarly to races, some race instances are ostensibly defined twice to account for variant races run during some characters'
careers.
</p>
<Sec h={3} id="race-track">Race Tracks</Sec>
<p>
Since race tracks are the physical locations where races are held, there are not many rows in <Mono>race_track</Mono>. Most of
its purpose is to define appearance characteristics, but some fields are mechanically relevant.
</p>
<ul class="ml-4 list-disc pb-4">
<li><Mono>id</Mono> is the race track ID.</li>
<li>
<Mono>initial_lane_type</Mono> describes the starting lane positions of each horse by determining the location and width of the
gap between posts.
<table class="table-fixed border text-center">
<thead>
<tr>
<th scope="col" class="px-2">ID</th>
<th scope="col" class="px-2">Gap After Gate</th>
<th scope="col" class="px-2">Gap Width (CW)</th>
</tr>
</thead>
<tbody>
{#each raceInitialLanes as [id, gate, w] (id)}
<tr class="even:bg-mist-300 dark:even:bg-mist-900">
<td>{id}</td>
<td>{gate}</td>
<td>{w}</td>
</tr>
{/each}
</tbody>
</table>
Horses in gates<i>after</i> the Gap After Gate listed in this table have the gap width added to their starting lane.
<Mono>initial_lane_type</Mono> is 2 on Oi, Kawasaki, and Funabashi; 3 on Longchamp; 4 on Morioka; and 1 elsewhere. (The race mechanics
doc's
<a
href="https://docs.google.com/document/d/15VzW9W2tXBBTibBRbZ8IVpW6HaMX8H0RP03kq6Az7Xg/edit?tab=t.0#heading=h.ohdxzwro17n5"
target="_blank"
rel="noopener noreferrer">description of initial lane</a
>
uses horse index rather than gate number and describes lanes in units of horse lanes rather than course widths.)
</li>
<li>
<Mono>area</Mono> defines the geographic region where the race track exists.
<table class="table-fixed border text-center">
<thead>
<tr>
<th scope="col" class="px-2">ID</th>
<th scope="col" class="px-2">Region</th>
</tr>
</thead>
<tbody>
{#each raceAreas as [id, name] (id)}
<tr class="even:bg-mist-300 dark:even:bg-mist-900">
<td class="px-2">{id}</td>
<td class="px-2">{name}</td>
</tr>
{/each}
</tbody>
</table>
</li>
</ul>
<Sec h={3} id="race-course">Race Courses</Sec>
<p>
Race courses are physical segments of race tracks. They are defined in <Mono>race_course_set</Mono>.
</p>
<p>
Most tracks have one or two turf loops (the "(Inner)" and "(Outer)" or sometimes "(Outer&rarr;Inner)") and one dirt loop. The
length of a race course is determined solely by the position of the gates: since the race course is a physical structure with
the audience stands in a specific location, and since said audience wants to see the race finish clearly, courses of all
lengths end at the same place on the front stretch. The straight opposite the front stretch is called the backstretch. Corners
are counted backward from the front stretch in the order 4, 3, 2, 1; all races except Ibis Summer Dash include corners 3 and
4, while long and sometimes medium races run corners multiple times. Some courses start on an extra segment of the track which
is <i>neither straight nor corner</i> (which means <Mono>straight_random==1</Mono> skills won't fire there).
</p>
<ul class="ml-4 list-disc pb-4">
<li><Mono>id</Mono> gives the race course ID.</li>
<li><Mono>race_track_id</Mono> joins with <Mono>race_track.id</Mono>.</li>
<li><Mono>distance</Mono> is the race course length in meters.</li>
<li><Mono>ground</Mono> is 1 for turf and 2 for dirt.</li>
<li>
<Mono>inout</Mono> gives the loop for the surface type where the race occurs.
<table class="table-fixed border text-center">
<thead>
<tr>
<th scope="col" class="px-2">ID</th>
<th scope="col" class="px-2">Loop</th>
</tr>
</thead>
<tbody>
{#each raceLoops as [id, name] (id)}
<tr class="even:bg-mist-300 dark:even:bg-mist-900">
<td class="px-2">{id}</td>
<td class="px-2">{name}</td>
</tr>
{/each}
</tbody>
</table>
</li>
<li>
<Mono>turn</Mono> gives the handedness of the track, i.e. the direction from horses to the rail as they round the track's corners.
<table class="table-fixed border text-center">
<thead>
<tr>
<th scope="col" class="px-2">ID</th>
<th scope="col" class="px-2">Handedness</th>
</tr>
</thead>
<tbody>
{#each raceRotations as [id, name] (id)}
<tr class="even:bg-mist-300 dark:even:bg-mist-900">
<td class="px-2">{id}</td>
<td class="px-2">{name}</td>
</tr>
{/each}
</tbody>
</table>
Stretch types have no corners and do not activate <Skill skill={skills.right1} /> or <Skill skill={skills.left1} /> or their variants.
Niigata 1000 is the only such race course in the game.
</li>
<li>
<Mono>float_lane_max</Mono> gives the <i>initial</i> race course width in units of ten thousandths of course widths. (Confusingly,
no race course has a width of 1 course width.) Some race courses have locations where the lane max changes, but these are defined
as events and are not in the mdb.
</li>
<li>
<Mono>course_set_status_id</Mono> joins with <Mono>race_course_set_status.course_set_status_id</Mono> to define the stat thresholds.
A value of 0 means no thresholds.
<table class="table-fixed border text-center">
<caption><Mono>race_course_set_status</Mono></caption>
<thead>
<tr>
<th scope="col" class="px-2"><Mono>course_set_status_id</Mono></th>
<th scope="col" class="px-2"><Mono>target_status_1</Mono></th>
<th scope="col" class="px-2"><Mono>target_status_2</Mono></th>
</tr>
</thead>
<tbody>
{#each raceCourseThresholds as [id, stat1, stat2] (id)}
<tr class="even:bg-mist-300 dark:even:bg-mist-900">
<td class="px-2">{id}</td>
<td class="px-2">{stat1}</td>
<td class="px-2">{stat2}</td>
</tr>
{/each}
</tbody>
</table>
Status of 1 is Speed, 2 is Power, and so on up to 5 for Wit. 0 means no (second) threshold.
</li>
</ul>
<p>
Characteristics like straight and corner locations, slopes, lane max changes, &amp;c. are <i>not</i> in the mdb. They are defined
as assets instead and must be extracted using special tools.
</p>
<Sec h={3} id="race-saddle">Win Saddles</Sec>
<p>
<Mono>single_mode_wins_saddle</Mono> defines the awards given to the horse (not the player) for winning a race or specific group
of races. These are the medals displayed as important wins for a horse at the end of a career. They are now purely aesthetic, but
I am documenting them anyway because I have the notes already since they used to determine affinity.
</p>
<ul class="ml-4 list-disc pb-4">
<li><Mono>id</Mono> is the win saddle ID.</li>
<li><Mono>priority</Mono> is the sort order for win saddles.</li>
<li>
<Mono>group_id</Mono> associates multiple win saddles for the same race, for horses whose careers have special versions of some
races.
</li>
<li>
<Mono>win_saddle_type</Mono> is the type of the win saddle, used to determine the color of the medal displayed.
<table class="table-fixed border text-center">
<thead>
<tr>
<th scope="col" class="px-2">ID</th>
<th scope="col" class="px-2">Type</th>
</tr>
</thead>
<tbody>
{#each raceSaddleTypes as [id, name] (id)}
<tr class="even:bg-mist-300 dark:even:bg-mist-900">
<td class="px-2">{id}</td>
<td class="px-2">{name}</td>
</tr>
{/each}
</tbody>
</table>
Special win saddles are for win saddles requiring multiple wins, e.g. Classic Triple Crown.
</li>
<li>
<Mono>race_instance_id_1</Mono> through <Mono>race_instance_id_8</Mono> define the race instance IDs that must be won to be awarded
the win saddle. Columns beyond <Mono>race_instance_id_3</Mono> are unused.
</li>
</ul>
<Sec h={3} id="race-program">Single Mode Program</Sec>
<p>
The table <Mono>single_mode_program</Mono> defines the race instances offered each turn in a career. Confusingly, races that permit
both classic and senior year horses are only defined here once.
</p>
<ul class="ml-4 list-disc pb-4">
<li><Mono>race_instance_id</Mono> joins with <Mono>race_instance.id</Mono>.</li>
<li>
<Mono>race_permission</Mono> gives the career years that offer the race. (More precisely, it gives the age ranges of horses that
are permitted to enter.)
<table class="table-fixed border text-center">
<thead>
<tr>
<th scope="col" class="px-2">ID</th>
<th scope="col" class="px-2">Meaning</th>
</tr>
</thead>
<tbody>
{#each racePermissions as [id, name] (id)}
<tr class="even:bg-mist-300 dark:even:bg-mist-900">
<td class="px-2">{id}</td>
<td class="px-2">{name}</td>
</tr>
{/each}
</tbody>
</table>
</li>
<li><Mono>month</Mono> and <Mono>half</Mono> give the turn that the race is held.</li>
</ul>
<p>
I was unable to identify whether any of the columns indicate maiden races, despite the UI restrictions on when they can
appear.
</p>
<Sec h={2} id="skills">Skills</Sec> <Sec h={2} id="skills">Skills</Sec>
<p> <p>
Relevant <Mono>text_data</Mono> categories include 47 for skill names and 48 for skill descriptions. Otherwise, info for skills Relevant <Mono>text_data</Mono> categories include 47 for skill names and 48 for skill descriptions. Otherwise, info for skills