Skip to main content

Setting Up Your Race: Configuration Essentials

Now that you know how to navigate RunScore and view a sample race, it's time to set up your own event. This page covers three core concepts: creating a new race by cloning an existing one, customizing it with the Entries.ini configuration file, and understanding how RunScore manages your scoring events.

Creating your first race: cloning a sample​

The fastest way to create a new race is to clone an existing one. Cloning copies all the configuration from a sample race into a fresh folder with a new name — giving you a solid starting point without altering the original.

Let's create a practice race called Training based on the sample 5K:

  1. If the 5K sample race isn't already open, open it: File → Open Race → C:\RunScore\SampleRaces\5k\ENTRIES.FRM
  2. From the menu bar, click File.
  3. Select Save Race as... from the dropdown.
  4. When prompted, type Training as the new race folder name.
  5. RunScore will suggest saving the new folder under C:\RunScore or C:\RunScore\Races — this default location is perfect.
  6. Click OK to close race.

RunScore closes the sample race and opens your brand-new Training folder. Notice the top border immediately updates to reflect the new race name:

RunScore workspace showing the newly cloned Training race in the title bar Notice the top border immediately updates to reflect the new race — something like:

C:\RunScore\training\Entries --- 06/20/2009 - Vernon 5K

You now have your own editable copy of a complete race setup, ready for you to experiment with and learn from. The original sample race remains untouched.

Clone before every new event

Rather than building races from scratch, experienced RunScore users almost always start by cloning a previous event that's similar in format. It saves considerable setup time.

Customizing your race: the Entries.ini file​

Every race folder contains a file called Entries.ini — think of it as your race's control panel. This plain-text file defines essential details like your race name and date, as well as system-wide settings that control how RunScore processes and displays your data.

Some things you'll typically configure in Entries.ini:

  • Race name, date, and location — displayed in reports and the top border
  • Field definitions — which data fields appear in your participant database
  • Division rules — how RunScore assigns age groups and gender categories
  • Results display settings — colors, fonts, and layout preferences
  • Custom variables — your own defined values for special race requirements
You don't need to learn Entries.ini all at once

For your first events, simply update the race name, date, and location at the top of the file. The rest of the settings from your cloned race will carry over and work fine. You can learn more advanced configuration in the Entries.ini reference section.

Defining your scoring events​

Behind the scenes, RunScore tracks your race data through events — discrete categories of timing data, such as gun finish times, chip finish times, or intermediate splits. All your events for a race are stored in a file called Events.xml.

Viewing your current events​

  1. Click the Results button on the Master Menu.
  2. A dropdown list appears showing all events defined in Events.xml — for example, a Time event for gun times or a Select event for chip/select times.
  3. Clicking an event name opens a dedicated Results Screen for that event, showing bib numbers and their associated times.

Editing or adding events​

If you need to adjust which events are available — for example, to add a chip timing event or remove one that isn't needed — you can edit the list:

  1. Click the Misc. button on the Master Menu.
  2. Select Edit list of events from the options.
The two most common events

Most road races use two events:

  • Time — records raw gun times as each finisher crosses the line
  • Select — records chip/select times that are later compared against gun times to determine official finish order

This two-event setup is the foundation of the race reduction process, where RunScore reconciles your timing data into a final, accurate results set.

What's next?

With your race configured and events defined, it's time to enter your participants. Head to Participant Data.