Usage Guide - IzzatFirdaus/uma_musume_race_planner GitHub Wiki

This guide explains how to use the main features of the Uma Musume Race Planner.

Viewing Plans

The main page displays a list of all your training plans. Each entry shows the trainee's name, their status, the next race, and mini stat bars. As of v1.4.0, you will also see a trainee image thumbnail for each plan, providing a quick visual reference. The list is sorted to show Active, Planning, and Draft plans first.

Creating a New Plan

  1. Click the "Create New" button on the main plan list or "New Plan" in the navbar.
  2. The "Quick Create Plan" modal will appear.
  3. Fill in the Trainee Name, Next Race Name, Career Stage, and Class.
  4. Click "Create Plan". A new plan with a "Planning" status and default attributes will be created.

Viewing and Editing a Plan

There are two ways to view and edit the full details of a plan:

  1. Edit (Modal View):

    • Click the "Edit" button (pencil icon) next to any plan in the list.
    • This opens a large, comprehensive modal with multiple tabs.

  2. View Details (Inline View):

    • Click the "View" button (eye icon).
    • This opens a slide-out panel on the same page, allowing you to edit all plan details without a popup.

In both views, you can manage the following:

  • General: Update the plan title, status, and other core details.
  • Trainee Image: On the "General" tab, click the file input to upload an image for your trainee. A preview will appear instantly. You can change or clear the image at any time.
  • Attributes: Adjust the core stat values.
  • Aptitude Grades, Skills, Predictions, Goals: Fill out details in their respective tabs.
  • Progress Chart: Click this tab to see a line graph of your trainee's stat growth over time.
  • Remember to click "Save Changes" to update the plan.

Deleting a Plan

  • Click the trash can icon next to any plan.
  • Confirm the deletion in the browser prompt.
  • This performs a "soft delete," marking the plan as deleted in the database (deleted_at timestamp) but not permanently removing it immediately.

Exporting a Plan

  • When viewing or editing a plan, click the "Export Plan" button.
  • This will copy a fully formatted, space-padded text summary of the entire plan to your clipboard.
  • This text is optimized for sharing or for use with AI assistants.