Vsk5 Race Result.csv File Manager & Dynamic High Point Scoring

Vsk5 Race Result.csv File Manager & High Point Scoring – User Manual

Developed by: Vsk Revolution

Distributed by: Virtual Sailing Solutions

Overview

The Vsk5 Result.csv File Manager is a lightweight, purpose-built utility for Virtual Skipper 5 (VSK5) and VSK5Online.

When hosting or joining races, Vsk5 automatically generates CSV results files for every race session. This includes:

• Valid completed races
• Restarted races that generate invalid results

Over time, these files accumulate rapidly. Many represent restart races that should never be used for scoring, while valid races become difficult to organize or track.

This application automates results cleanup, organization, and cumulative scoring, keeping your results folder clean while producing reliable season or series standings.

Key Features

Automatic Detection of Restart Race Files

• Scans Result.csv files for races where all entries contain -1 in the second column
• These files represent restarted or invalid races
• Invalid restart race files are automatically deleted

This prevents bad data from polluting standings or external scoring tools.

Month-Based File Organization

• Valid Result.csv files are sorted into month folders based on timestamps in the filename
• Example folder format:
• YYYY-MM (e.g. 2025-12)
• Month folders are:
• Created dynamically
• Never duplicated
• Only created when needed

This keeps long-term archives clean and navigable.

Non-Disruptive File Management

• New race results continue saving to the main Results folder
• Subfolder creation never interferes with Vsk5 file output
• Users can manually review recent results before running the app

Cumulative High Point Scoring

In addition to file management, the application includes an integrated high-point fleet scoring system, designed specifically for Vsk5 fleet racing.

Supported Scoring Modes

• Series Results
• Processes only Result.csv files currently in the main Results folder
• Season Results
• Processes all Result.csv files in the Results folder and all subfolders recursively

High Point Scoring Logic

• Points are awarded based on fleet size
• First place receives the most points
• Last place receives the fewest points
• All valid finishers earn points

Invalid entries are always excluded, including:

• -1
• DNF
• DSQ
• DNS

This system is ideal for:

• Variable fleet sizes
• Open participation series
• Long-running seasons with changing rosters

Dynamic Standings Table

The standings table displays:

• Ranking
• Player login
• Total races entered
• Total accumulated points

Results are automatically sorted by total points.

Detailed Reporting

The live report window displays:

• Active scoring mode
• Files used for scoring
• Files deleted (restart races)
• Files moved into month folders
• Files processed in the main folder
• Total files scored

This ensures full transparency in how results were calculated.

Quick Access Buttons

• Open Vsk5 Results Folder – Opens the results directory in Windows Explorer
• Open Online Scoring Apps – Opens Vsk Revolution scoring resources
• Open User Manual – Opens this manual

Typical Workflow (How This App Is Meant to Be Used)

One of the most important design goals of the Vsk5 Race Result.csv File Manager is that it works with the way Vsk5 already saves files, not against it.

Understanding the intended workflow will help you get the most benefit from the application.

1. Normal Vsk5 Operation (Before Running the App)

• Virtual Skipper 5 always saves new race results as CSV files into the main folder:
• Documents\Vsk5\Results
• This includes:
• Valid completed races
• Restarted races
• Test races
• Over time, this main folder can become cluttered with many files, making it difficult to identify which races are valid or relevant.

At this stage, nothing is modified by the application. The game behaves exactly as designed.

2. Review New Results (Optional but Recommended)

Because all new results initially remain in the main Results folder, you can:

• Quickly review the most recent Result.csv files
• Verify race results
• Confirm no unusual or test files are present

This step is optional, but it gives you confidence before processing.

3. Run the Vsk5 Race Result.csv File Manager

When you run the application and click OK, it performs cleanup and organization in a controlled way:

• Invalid restart race files are detected and deleted
• Valid race results are moved into automatically created month folders
• Optional cumulative scoring is calculated using valid data only

Example folder structure after processing:

Results

├── 2025-11

├── 2025-12

├── 2026-01

Each folder contains only valid race results from that month.

4. What Happens After Processing

This is the key concept:

• The main Results folder becomes clean again
• It contains only:
• Newly generated race files (since the last run)
• Files you have not yet processed

Virtual Skipper 5 continues to save all future results to the same main Results folder — the app does not change or interfere with this behavior.

5. Repeat as Needed

Each time you run the app:

• New files are cleaned and organized
• Month folders grow naturally over time
• The Results folder stays manageable

This cycle allows you to:

• Always know which files are new
• Avoid reprocessing old races
• Maintain a clean, logical archive

Why This Workflow Works Well

This approach was chosen deliberately because:

• VSK5 creates many Result.csv files very quickly
• Restart races produce misleading results
• Manual sorting becomes confusing and impractical over time

By letting the game save files normally, and only organizing them afterward, you get:

• Zero disruption of the files
• Maximum clarity
• Full control over when processing occurs

How It Works

Preparation

Ensure your Vsk5 results folder is located at:

Documents\Vsk5\Results

This is the default directory monitored by the application.

Running the Application

1. Launch the Vsk5 Race Result.csv File Manager
2. Select your desired processing mode:

• Series Results
• Season Results

1. Click OK to begin processing

Processing Phase

The application performs the following steps:

1. Scans Result.csv files according to the selected mode…(Series mode calculates results from the main Result folder only. Season mode calculates results for all files in the main Results folder as well as all the files in all subfolders).
2. Filters invalid race entries
3. Calculates high-point standings
4. Deletes invalid restart race files
5. Organizes valid files into month folders

Completion Summary

Once finished, the report displays:

• Files processed
• Files deleted
• Files moved
• Total files scored

The standings table updates immediately.

Benefits

• Saves Time – No manual Result.csv review required
• Prevents Scoring Errors – Invalid restart races are removed automatically
• Fleet-Racing Optimized – High-point scoring adapts to varying fleet sizes
• Season-Ready – Supports cumulative scoring across months or entire seasons
• Safe for New Files – New results are never blocked or overwritten

Usage Tips

• Run the app regularly if you host or join many races
• Review recent files before processing if needed
• Use Season mode for championships or leagues
• Use Series mode for short events or testing

© 2026 – Vsk Revolution