Team Management

Creating a Team

1. Go to Manage Teams from the navigation bar or dashboard.
2. Click Create New Team and enter the team name.
3. New teams start with default kit textures — you can upload custom textures after creation (see below).
4. Each new team is pre-populated with 11 players (GK, RB, CB, CB, LB, CDM, CM, CAM, RW, ST, LW), all defaulting to style_000 for skin and hair.
5. Optionally upload a team logo and individual player photos.

Kit Textures

Each team's kit is defined by texture images rather than flat color pickers. This lets you use realistic shirt and shorts designs — stripes, patterns, sponsor logos, and numbers — on the 3D player models.

To upload custom kit textures:

1. Open a team and expand Edit Details / Kit Textures / Share / Delete.
2. Scroll to the Kit Textures section.
3. Choose an image file (PNG, JPG, GIF, WebP, or SVG) for any of the ten slots.
4. Click Upload Selected Textures.

Each slot shows a preview thumbnail. Custom textures display a ★ badge; default textures display a D badge. Use the Clear button on any slot to revert it back to the default.

Goalkeeper Kit Textures

Goalkeepers have their own separate kit textures, distinct from the outfield player kit. Each default team folder (kv_home and kv_away) contains both outfield and GK texture variants, so the home and away goalkeepers are visually distinct from each other as well as from outfield players.

• Default GK textures are shirt_front_gk.png, shirt_back_gk.png, shorts_front_gk.png, shorts_back_gk.png inside the team's folder (e.g. kv_home/shirt_front_gk.png).
• If no custom goalkeeper textures are uploaded, the appropriate home or away default GK kit is used automatically.
• Upload and clear goalkeeper textures the same way as outfield textures (see above).

Shirt Numbers

Each player's squad number is rendered on their shirt as a texture. Number textures live in viz-assets/numbers/ and are named 01.png through 99.png (zero-padded). When a player is placed on the pitch, the visualizer loads the texture matching their squad number and applies it to the "number" mesh on the 3D model.

• Numbers use alpha cutout — the transparent areas of the PNG are discarded, so only the number shape appears on the shirt.
• The number is tinted with the team's Number Colour setting (see below).
• Numbers are loaded on demand — only the squad numbers used by the selected teams are fetched, keeping load times fast.

Number Colour

Each team has a Number Colour setting that tints the shirt numbers on the 3D player models. This lets you match the number colour to your kit design — white numbers on a dark shirt, black numbers on a light shirt, or any colour you choose.

1. Open a team and expand Edit Details / Kit Textures / Share / Delete.
2. Use the Number Colour colour picker (next to the team name) to choose a colour.
3. Click Save.

Skin & Hair Styles

Every player has a skin style and a hair style that control their appearance on the 3D model. Styles are referenced by ID (e.g. style_000, style_001).

• Skin style — Choose from available skin textures via the skin style picker, a modal that displays thumbnail previews of each option.
• Hair style — Choose from available hair textures via the hair style picker, also a modal with thumbnail previews.

To set a player's skin or hair style:

1. Open the team in Manage Teams.
2. Click Edit on the player (or use the style pickers when adding a new player).
3. Open the skin or hair style picker modal.
4. Click a thumbnail to select it, then Save.

Adding Players

1. Open a team and use the Add Player row at the bottom of the roster.
2. Enter the player's squad number, position (optional), and name.
3. Pick a skin style and hair style (both default to style_000).
4. Click + Add. The player is added to the team roster.
5. Optionally upload a player photo (PNG or JPG, square recommended) using the 📷 button.

Editing Player Details

1. Go to Manage Teams and open the team.
2. Click Edit on any player.
3. Update the name, number, position, skin style, or hair style.
4. Click Save. Changes are reflected in all scenarios that use this team.

Assigning Teams to Scenarios

When you create or open a scenario in the visualizer:

1. Use the Team Selection modal to pick a Home team and Away team.
2. Players from the selected teams populate the pitch with their names, numbers, kit textures, and skin/hair styles.
3. You can also use generic players (no team) for quick drills.

Team .json Export & Import

You can download a team as a .json file for backup or transfer between accounts. The exported file includes:

• Team name
• Kit texture paths (outfield shirt front/back, shorts front/back)
• Goalkeeper texture paths (GK shirt front/back, shorts front/back)
• Number colour
• Legacy color values (kept for backwards compatibility)
• Each player's name, number, position, skin style, and hair style

To export a team:

1. Open the team and expand Edit Details / Kit Textures / Share / Delete.
2. Click Download .json.

To import a team:

1. Use the Import Team from .json option on the left panel.
2. Select a previously exported .json file.
3. The team is created in your account with all players, styles, and positions intact.

The exported JSON follows this structure:

{
  "name": "My Team",
  "shirtFront": "",
  "shirtBack": "",
  "shortsFront": "",
  "shortsBack": "",
  "gkShirtFront": "",
  "gkShirtBack": "",
  "gkShortsFront": "",
  "gkShortsBack": "",
  "numberColor": "#ffffff",
  "color1": "#ff0000",
  "color2": "#000000",
  "color3": "#ff0000",
  "color4": "#000000",
  "playerInfo": [
    {
      "name": "Player 1",
      "number": "1",
      "position": "GK",
      "skinStyle": "style_000",
      "hairStyle": "style_000"
    }
  ]
}

Empty texture paths ("") mean the team uses default kit textures (kv_home / kv_away with GK variants). The numberColor field tints the shirt number textures on the 3D models.

Deleting Players

1. Open the team in Manage Teams.
2. Click Delete (✕) on the player.
3. Confirm the deletion. The player is removed from the team roster.

Sharing & Deleting Teams

Team owners can share a team with other KickViz accounts or delete a team entirely. Both options live under Edit Details / Kit Textures / Share / Delete:

• Share — Search for an account by name, select it, and click Share. The team appears in the recipient's list (marked 🔗 Shared). Only the owner can share or delete.
• Delete Team — Permanently removes the team and all its custom textures. This cannot be undone — export the team as .json first if you want a backup.

Free Tier

Free tier users can create teams and players without limits. Team management — including texture uploads, skin/hair styles, and JSON export/import — is available to all users.