Instructions & Help

This page provides a compact, but complete overview of all features you need to run tournaments with KLUE Badminton.

Tenants (Clients)

The software is multi-tenant. This means multiple clubs can use the system in parallel without seeing each other's data. A tenant (sometimes called a client) is the isolated workspace where one club (or department) manages its tournaments.

Register a tenant

A tenant is created automatically when you register the first administrator account. Use the registration link on the start page and enter both the account details and the desired tenant name. As a tenant name, use your official club name (optionally with a department suffix). Both the tenant name and the initial account name must be unique across the service. The first account has full administrator permissions and can manage additional accounts. Optionally you can upload a club logo under "Settings".

Create tenant

Tenants cannot be created manually without going through the registration process.

Delete tenant

To delete a tenant, please use the contact form with the subject "Deletion of tenant [name]". For security reasons, the request must be sent from the email address of the tenant's primary administrator account.

Accounts

Accounts are user logins for people who access the system. They are not the same as players participating in tournaments. Accounts can either have write access (admin) or read-only access. Tournament organizers need write access; players should usually have read-only access. Players can also self-register for free (read-only by default).

Register an account

Using the registration link on the start page, users can create an account for an existing tenant (club) in order to view tournaments and results. Account names must be unique and belong to exactly one tenant. Club administrators can also create accounts and grant write permissions as needed.

Create accounts

In addition to self-registration, administrators can create accounts manually and assign read-only or write permissions.

Edit accounts

Accounts can be edited later. You can rename an account, update time zone or email address, and set a new password. Moving an account to a different tenant is not supported.

Delete accounts

If an account is no longer needed, you can delete it. Please do not delete the last account with write permissions. If this happens accidentally, please contact me via the contact form.

Lock accounts

If an account is only temporarily not needed, you can lock (and later unlock) it. Locked accounts cannot log in. Only administrators can unlock accounts.

Tournaments

The system supports multiple tournament formats. For each tournament you can configure the points per set win, the number of sets required to win a match, the team size, and whether teams are fixed or generated dynamically.

Tournament modes

Below is an overview of the supported tournament systems.

Joke tournament

A joke tournament focuses on fun and variety. The system generates new teams each round and tries to maximize variation of partners and opponents while still keeping matches as fair and balanced as possible.

There are three additional sub-modes that influence how teams and matches are created:

• Equal team strength tries to form teams with similar total strength (based on presets and current performance). This can lead to matches where two strong teams play each other.
• Random team members prioritizes random mixing, while still aiming for balanced matches (often pairing a strong player with a weaker one).
• Switch after each round alternates between the two strategies above each round.

Fixed teams are not supported in joke tournaments. Typically you play doubles (teams of two), but single-player teams are also possible.

Rankings

Ranking tournaments are typically used to represent a club ranking list. You can run them yearly or continuously. Players (or coaches) are free to decide who plays against whom. The match date matters: older matches can be devalued automatically to keep the ranking list current and encourage regular play. Rankings are based on the ratio of wins to losses (not the absolute number of wins).

KO tournaments

A KO tournament supports a bracket size of 8 or 16 teams. Teams may be single players, doubles, or mixed. If fewer teams are available, the remaining slots are filled with "dummy" entries (byes). You can play with or without a consolation bracket. With consolation, teams that lose in the main bracket get a second chance; without consolation, you play the classic stages (round of 16, quarter finals, semi finals, final). A dedicated overview helps visualize the current bracket status.

• 16-team KO with consolation: 8 rounds
• 16-team KO without consolation: 4 rounds
• 8-team KO with consolation: 6 rounds
• 8-team KO without consolation: 3 rounds

The bracket size (8 or 16) is currently determined automatically based on the number of selected teams.

Everybody against everybody

This mode is often used as a preliminary round before a KO phase. A group typically contains 3 or 4 players/teams; everyone plays against everyone. The system generates the required matches and rounds automatically.

• Number of matches: n * (n - 1) / 2

You can play either as teams or as single players.

Combined tournaments

Combined tournaments consist of multiple individual tournaments. A common setup is several preliminary groups followed by a final KO tournament to reduce the total number of matches. A combined tournament therefore has several "incoming" tournaments (usually of the same type) and one "outgoing" tournament of any type. You decide how many top teams advance into the final tournament. After the incoming tournaments are finished, teams are moved into the final tournament by clicking the combined tournament's "run" button.

Tournament Management

Create tournaments

In the tournaments tab you can create new tournaments. The overview lists tournaments by name, tournament type, team size and scoring settings (points per set, sets to win). You can also configure whether teams are fixed and additional expert settings for joke tournaments.

Edit tournaments

In general, you can change tournament parameters as long as the tournament has not been started yet. For example, changing the tournament mode or team size no longer makes sense once matches/results exist.

Delete tournaments

Usually you don't need to delete tournaments, but you can. Keep in mind that settings, players and match data are permanently removed (unless you exported the tournament first).

Copy tournaments

If you plan to run a similar tournament again, you can duplicate an existing one. Settings, teams and players are copied – match results are not.

Export tournaments

You can export tournaments and save them locally. This can be used as a backup and also for importing into the same or another tenant. The export contains all tournament data.

Import tournaments

With import you can restore a previously exported tournament. Importing into a different tenant is supported. Compared to duplication, import includes all data and dates (including matches). When importing into the same tenant, simply choose a new tournament name.

Player management

Players are not accounts. A player represents a badminton participant inside a tournament.

Create players

Players are identified by their name (nicknames are fine). Player names must be unique within a tournament and are assigned to exactly one tournament (except in combined tournaments). Each player can have a "preset" value (typically 0–10). A preset greater than 0 indicates above-average strength and is used for seeding in KO tournaments and for balancing in joke tournaments. Negative values are reserved for dummy/byes and should not be used manually.

Edit player

You can rename players and adjust their preset value – even during an ongoing tournament.

Delete player

You can delete a player as long as they are not assigned to a match or have already played. Otherwise you must remove that player's matches first.

Teams

Players are grouped into teams. Teams can be dynamic (generated automatically each round) or fixed (stable partners across the tournament, e.g. doubles/mixed). Dynamic teams are usually not shown directly. Fixed teams can be used in most tournament modes – joke tournaments require dynamic teams by design.

Fixed teams

Fixed teams are common for doubles and mixed. Joke tournaments are the exception and cannot use fixed teams.

Create teams

Create teams in the teams tab by selecting players and grouping them together.

Delete teams

Teams can only be deleted if they are fixed and have not played any matches.

Rounds

Tournaments are typically organized in rounds. Depending on tournament type and number of teams/players, each round contains a certain number of matches.

Create rounds

Create a round in the "Matches" tab using the corresponding button. The system then generates the matches for that round. Rankings don't have explicit rounds – each match has its own round instead.

Delete rounds

Rounds can be deleted under certain conditions. In general, you can delete the most recent round. In KO tournaments, only the last round can be deleted.

If you delete rounds in the middle, round numbers will be re-ordered.

Matches

Matches are the individual games of a tournament and belong to a round. In some modes you cannot create matches freely: in KO tournaments matches depend on previous results; in joke tournaments they are generated randomly. In rankings there are no rounds, so you create matches directly.

Create match

Creating a match means selecting the competing teams. Teams can represent single players or fixed teams.

Enter match result

After a match, enter the result. Depending on the configured number of winning sets, you record the set scores accordingly. The system automatically determines winner and loser.

Delete match

Matches can be deleted in some situations (most commonly in rankings). Deleted data is permanently removed and cannot be restored.

Running a tournament (recommended workflow)

A typical tournament flow looks like this:

1. Create the tournament with the desired parameters.
2. Add players (players tab).
3. Create rounds or matches (matches tab).
4. Enter results (matches tab).
5. Track the current standings in the players or teams tab.

Evaluate tournament

You can evaluate a tournament at any time via the players or teams tab. As soon as results exist, the system calculates standings and rankings automatically.