Map Rotation Builder

Overview

The Map Rotation Builder allows you to create custom sequences of maps and game modes for your server. Players will cycle through your rotation automatically, creating a dynamic gameplay experience.

Accessing the Rotation Builder

Navigate to Server Host

Open the Server Host section in the Kyber Launcher.

Open Map Rotation Tab

Click the “Map Rotation” tab to access the builder.

View Current Rotation

Your current rotation is displayed in the main area, with available maps on the right.

Building a Rotation

Adding Maps

Select Game Mode

Choose a game mode from the mode list on the right side.

Browse Available Maps

View all maps compatible with the selected mode.

Add to Rotation

Click or drag a map to add it to your rotation.

Repeat

Continue adding map/mode combinations until your rotation is complete.

Reordering Maps

The rotation order determines the sequence players experience:

Drag and drop entries to reorder
Maps play from top to bottom
After the last map, rotation loops back to the first

Place popular maps at strategic intervals to maintain player engagement throughout the rotation.

Removing Maps

To remove a map from your rotation:

Hover over the map entry
Click the remove/delete button
The entry is immediately removed

You must have at least one map in your rotation before starting a server.

Rotation Format

Rotations are stored in a simple text format from source/Launcher/lib/features/map_rotation/helper/map_rotation_helper.dart:9-17:

MODE:MAP_PATH

Example:

HeroesVersusVillains:S5_1/Levels/MP/Geonosis_01/Geonosis_01
Supremacy:S5_1/Levels/MP/Geonosis_01/Geonosis_01
GalacticAssault:S6/Levels/MP/Scarif_01/Scarif_01
Blast:S2/Levels/MP/Theed_01/Theed_01

The format uses colons (:) to separate mode from map path. Empty lines and lines starting with # are ignored.

Importing Rotations

From File

Click Import

In the Map Rotation tab, click the Import button.

Select File

Choose a .txt or .kbrotation file.

Validate Entries

The launcher validates each map/mode combination.

Load Rotation

Valid entries are loaded into your rotation builder.

From source/Launcher/lib/features/server_host/widgets/create_server/map_rotation_page.dart:127-179, the import process:

final rotation = <Map<String, String>>[];

for (final line in lines) {
  if (line.trim().isEmpty || line.startsWith('#')) {
    continue;
  }

  final parts = line.split(':');
  if (parts.length == 2) {
    rotation.add({
      'mode': parts[0],
      'map': parts[1],
    });
  }
}

From URL

Kyber supports protocol URLs for sharing rotations:

kyber://rotation?file=/path/to/rotation.kbrotation

Clicking this link in a browser automatically imports the rotation into the launcher.

Validation

During import, the launcher:

Checks if mode names are valid
Verifies maps exist for each mode
Filters out invalid entries
Reports any errors

Custom maps from mods will be marked as invalid if the mod isn’t in your currently selected collection.

Exporting Rotations

Export Dialog

Open Export

Click the Export button in the Map Rotation tab.

Choose Format

Select between:

.txt format (universal, CLI compatible)
.kbrotation format (Kyber native, includes metadata)

Select Location

Choose where to save the file.

Save

The rotation is exported and ready to share.

From source/Launcher/lib/features/map_rotation/dialogs/export_rotation_dialog.dart:102-105:

final rotation = context.read<MapRotationCubit>().state.maps;

for (final entry in rotation) {
  buffer.writeln('${entry.mode}:${entry.map}');
}

Exported rotations can be shared:

Upload to file sharing services
Share via Discord/forums
Include in mod collection packages
Distribute with server announcements

Custom Maps and Modes

Mod-Based Maps

When you select a mod collection with custom maps:

Custom maps appear in the map list
They’re marked with a special indicator
Rotation builder validates against the selected collection
Custom map metadata is loaded from mod files

From source/Launcher/lib/features/server_host/widgets/create_server/map_rotation_page.dart:384:

Custom map not found, this can happen if the map is not part of 
the current mod collection. This map will be ignored when starting 
the server.

Always select your mod collection before building a rotation with custom maps.

Custom Game Modes

Mods can also add custom game modes:

Modes appear in the mode selector
Custom mode icons are displayed
Max player counts are validated
Mode-specific rules are applied

Using Rotations with Servers

In the Launcher

When hosting from the launcher:

Build your rotation in the Map Rotation tab
The rotation is automatically used when you click “Start Server”
No export is necessary

With the CLI

Export your rotation and use it with the CLI:

kyber_cli start_server \
  --server-name "Rotating Maps" \
  --rotation-file /path/to/rotation.txt \
  --credentials "username:password"

With Docker

For Docker deployments, encode your rotation as base64:

cat rotation.txt | base64

Then set as an environment variable:

environment:
  KYBER_MAP_ROTATION: "SGVyb2VzVmVyc3VzVmlsbGFpbnM7UzVfMS9MZXZlbHMvTVAvR2..."

From source/CLI/lib/commands/start_server_command.dart:185-191:

if (Platform.environment.containsKey('KYBER_MAP_ROTATION')) {
  data = utf8
      .decode(base64.decode(Platform.environment['KYBER_MAP_ROTATION']!))
      .split('\n');
}

Available Game Modes

Standard Battlefront II modes supported:

Mode	Description	Players
Galactic Assault	Large-scale objective battles	40
Supremacy	Capital ship battles	40
Heroes vs Villains	4v4 hero combat	8
Hero Showdown	2v2 hero duels	4
Blast	Team deathmatch	20
Strike	Small-scale objectives	16
Extraction	Shipment escort	16
Ewok Hunt	Survival mode	20
Starfighter Assault	Space battles	24
Hero Starfighters	Hero ships only	24

Custom modes added by mods may support different player counts and have unique rules.

Map Selection Tips

Balanced Rotations

Create diverse rotations by:

Mixing eras: Include Prequel, Original, and Sequel trilogy maps
Varying modes: Alternate between large and small modes
Pacing: Balance intense modes with more casual ones
Length: Consider match duration when ordering

Popular Combinations

Effective rotation patterns:

GalacticAssault:S5_1/Levels/MP/Geonosis_01/Geonosis_01
HeroesVersusVillains:S2/Levels/MP/Kashyyyk_01/Kashyyyk_01
Supremacy:S6/Levels/MP/Scarif_01/Scarif_01
Blast:S1/Levels/MP/DeathStar02_01/DeathStar02_01

This provides:

Large-scale combat (GA)
Hero focus (HvV)
Another large mode (Supremacy)
Quick matches (Blast)

Era-Specific Rotations

Create themed rotations: Clone Wars Only:

Supremacy:S5_1/Levels/MP/Geonosis_01/Geonosis_01
GalacticAssault:S2/Levels/MP/Kashyyyk_01/Kashyyyk_01
Supremacy:S3/Levels/MP/Naboo_01/Naboo_01

Galactic Civil War:

GalacticAssault:S1/Levels/MP/Hoth_01/Hoth_01
Supremacy:S1/Levels/MP/Tatooine_01/Tatooine_01
GalacticAssault:S1/Levels/MP/DeathStar02_01/DeathStar02_01

Advanced Features

Map Rotation State

The rotation state is persisted using Hive storage from source/Launcher/lib/features/map_rotation/models/map_rotation_entry.dart:5-20:

@HiveType(typeId: 21)
class MapRotationEntry extends HiveObject {
  @HiveField(0)
  final String map;

  @HiveField(1)
  final String mode;

  @HiveField(2)
  final bool isCustom;
}

This allows:

Rotation to persist between sessions
Undo/redo functionality
Quick rotation switching

Collection-Based Filtering

Maps are filtered based on your selected collection from source/Launcher/lib/features/server_host/widgets/create_server/map_rotation/map_list.dart:56-62:

final collection = context
    .read<HostCollectionCubit>()
    .state
    .selectedModCollection;

MapHelper.getMapsForMode(
  mode,
  collection: collection,
);

This ensures only compatible maps appear for your mod setup.

Troubleshooting

Import Failures

File Format Invalid:

Ensure format is MODE:MAP_PATH
Check for proper line endings
Verify no special characters

Maps Not Found:

Switch to the correct mod collection
Download required map mods
Verify map paths are correct

Empty Rotation After Import:

No valid entries were found
Check console for error messages
Verify mode names match exactly

Server Won’t Start

If the server fails to start due to rotation issues:

“You need to add at least one map to the map rotation”

Ensure:

At least one entry exists in your rotation
All entries are valid for your mod collection
Map paths are correctly formatted

Custom Maps Missing

If custom maps don’t appear:

Verify the mod is in your selected collection
Check the mod contains map category content
Ensure mod is properly installed
Try refreshing the mod list

Example Rotations

All-Modes Variety

# Diverse gameplay rotation
GalacticAssault:S5_1/Levels/MP/Geonosis_01/Geonosis_01
HeroesVersusVillains:S2/Levels/MP/Theed_01/Theed_01
Blast:S1/Levels/MP/DeathStar02_01/DeathStar02_01
Supremacy:S6/Levels/MP/Scarif_01/Scarif_01
Strike:S2/Levels/MP/Takodana_01/Takodana_01
HeroShowdown:S2/Levels/MP/Kashyyyk_01/Kashyyyk_01

Large-Scale Combat

# Big battles only
Supremacy:S5_1/Levels/MP/Geonosis_01/Geonosis_01
GalacticAssault:S5_1/Levels/MP/Geonosis_01/Geonosis_01
Supremacy:S2/Levels/MP/Kashyyyk_01/Kashyyyk_01
GalacticAssault:S2/Levels/MP/Kamino_01/Kamino_01
Supremacy:S6/Levels/MP/Scarif_01/Scarif_01

Heroes Focus

# Hero gameplay rotation
HeroesVersusVillains:S2/Levels/MP/Theed_01/Theed_01
HeroShowdown:S2/Levels/MP/Kashyyyk_01/Kashyyyk_01
HeroesVersusVillains:S1/Levels/MP/Tatooine_01/Tatooine_01
HeroShowdown:S3/Levels/MP/Naboo_01/Naboo_01

Get Started

Features

Guides

​Overview

​Accessing the Rotation Builder

​Building a Rotation

​Adding Maps

​Reordering Maps

​Removing Maps

​Rotation Format

​Importing Rotations

​From File

​From URL

​Validation

​Exporting Rotations

​Export Dialog

​Sharing Rotations

​Custom Maps and Modes

​Mod-Based Maps

​Custom Game Modes

​Using Rotations with Servers

​In the Launcher

​With the CLI

​With Docker

​Available Game Modes

​Map Selection Tips

​Balanced Rotations

​Popular Combinations

​Era-Specific Rotations

​Advanced Features

​Map Rotation State

​Collection-Based Filtering

​Troubleshooting

​Import Failures

​Server Won’t Start

​Custom Maps Missing

​Example Rotations

​All-Modes Variety

​Large-Scale Combat

​Heroes Focus

​Next Steps

Host a Server

Installing Mods

Build docs developers (and LLMs) love

Overview

Accessing the Rotation Builder

Building a Rotation

Adding Maps

Reordering Maps

Removing Maps

Rotation Format

Importing Rotations

From File

From URL

Validation

Exporting Rotations

Export Dialog

Sharing Rotations

Custom Maps and Modes

Mod-Based Maps

Custom Game Modes

Using Rotations with Servers

In the Launcher

With the CLI

With Docker

Available Game Modes

Map Selection Tips

Balanced Rotations

Popular Combinations

Era-Specific Rotations

Advanced Features

Map Rotation State

Collection-Based Filtering

Troubleshooting

Import Failures

Server Won’t Start

Custom Maps Missing

Example Rotations

All-Modes Variety

Large-Scale Combat

Heroes Focus

Next Steps