Team Randomizer

WHAT IT DOES

Team Randomizer helps you quickly and fairly divide a group of people into teams. Add participants to the list, then randomize them into teams of a specified size or a specified number of teams. The tool uses a shuffled distribution algorithm to balance team sizes as evenly as possible. You can add, edit, or remove participants at any time. The tool tracks randomization history, and you can copy team results to your clipboard with one click. Perfect for sports teams, classroom groups, project teams, or any situation requiring random group assignment.

WHERE IT RUNS

The extension runs entirely within your browser's local environment using the BotGentz framework. All randomization, team distribution, and history tracking occur on your machine without any network requests. No participant data, team assignments, or user activity is ever transmitted, uploaded, or stored externally. The tool works on any website and respects the browser's security boundaries, operating within the isolated extension sandbox. Team randomization uses the Fisher-Yates shuffle algorithm for fair distribution.

HOW TO USE

Click the extension toolbar icon to open the Team Randomizer panel. Add participants by typing a name in the "Add participant" field and clicking "Add"—the name appears in the participant list. Click the "✎" button next to any participant to edit their name. Click the "✕" button to remove a participant. Set the "Team size" to control how many members each team should have. Set the "Number of teams" (0 for auto) to control how many teams to create. Toggle "Allow uneven teams" to permit teams with different sizes when participants don't divide evenly. Click "Randomize Teams" to generate team assignments—the results appear in the output area. Click "Copy Teams" to copy the team list to your clipboard. The history panel shows past randomizations with timestamps and team counts; click "Copy" on any history entry to reuse it. Use "Clear History" to remove all history entries. Toggle "Enable history" to track your randomizations.

THE TEAM RANDOMIZATION ENGINE — WHY IT WORKS

Most team randomizers simply split lists into chunks without considering balanced distribution or team count preferences. This tool uses a Fisher-Yates shuffle to randomly permute the participant list, then distributes participants into teams using a balanced allocation algorithm. When the number of teams is specified, the engine calculates the base team size and distributes extra participants evenly across the first teams. When team size is specified, the engine chunks participants into teams of that size, with the last team containing any remaining participants if uneven teams are allowed. The randomization is performed on a copy of the participant list, preserving the original list order. Each randomization is stored in the history with a timestamp, team composition, and participant count. This approach ensures fair, balanced team distribution every time.

THE PANEL

The Team Randomizer panel is fully draggable by its title bar and remembers its position on screen per website. It snaps to the edges of your browser window for clean alignment. Collapse the panel to a compact icon strip using the minimize button, restoring it with a single click. Resize the panel by dragging any edge or corner; the participant list, team output, and controls adjust proportionally. Press the Escape key to close the panel instantly. The panel maintains independent state for each browser tab, allowing you to randomize teams in multiple tabs simultaneously.

PLEASE NOTE

This extension requires the free BotGentz extension framework to be installed and enabled. The participant list is stored locally and persists across sessions. The team randomization uses a random shuffle; results will differ each time. The uneven teams option may create teams with different sizes; disable it to require even teams. The history is stored in memory and cleared when the page is refreshed. All participant data is processed locally and is never transmitted, logged, or shared. The extension requests no network permissions and functions entirely offline. The source code is fully auditable and available for review.