Placing Players, Ball & Objects

Placing Players

1. In the left panel, click Player under Field Objects.
2. Click anywhere on the pitch to place the player.
3. The player is added to the currently selected team (Home or Away).
4. New players are added to all phases — they'll appear in every phase of your scenario.

Player Focus (Look Direction)

Each player has a facing direction — which way they're looking. When a player is selected, a Focus panel appears on the right side of the screen with three modes:

Manual Mode

1. Select a player on the pitch.
2. In the Focus panel on the right, click Manual.
3. Click anywhere on the pitch to set the look direction. A locator pin appears at the chosen spot.
4. The player rotates to face that point. Click again to change it.

Attach Mode

1. Select a player on the pitch.
2. In the Focus panel on the right, click Attach.
3. Click any item on the pitch (another player, the ball, a cone, or a target).
4. The player now continuously faces that item — the facing updates every frame, even during animation playback.
5. The Focus panel shows which item the player is looking at. Click Change to pick a different target.

Player Actions (Overlay Animations)

Each player can have overlay animations — actions like waving, kicking, or shouting that play on top of their base movement pose (stand/walk/jog/run). When a player is selected, an Action panel appears on the right side below the Focus panel.

Adding an Action

1. Select a player on the pitch.
2. In the Action panel, click + Add. A new action appears with a default "Wave Left" animation and trigger point at 0.50.
3. Click the action's icon to open the action picker modal.
4. Choose from the available actions: Wave Left, Wave Right, Kick Left, Kick Right, Header Left, Header Right, Header Straight, or Shout.

Setting the Trigger Point

Each action has a trigger slider (0.0–1.0) that determines when during the phase transition the action plays:

When the playback reaches the trigger point, the action animation plays once through its full clip duration, mixed additively on top of the base movement pose. So a player can run and wave at the same time — the movement pose continues underneath the overlay action.

Deleting an Action

Click the red trash icon next to any action to remove it.

Moving Items

There are two ways to move an item:

• Drag — Click and hold an item, then drag it to a new position. Orbit controls are disabled while dragging.
• Select + Click — Click an item to select it (blue ring appears), then click the destination on the pitch.

Placing Balls

KickViz supports multiple balls in a single scenario. Each scenario stores a balls array, and every ball has its own unique id.

1. Click Ball in the Field Objects menu.
2. Click on the pitch to place a ball. Each new ball gets its own id.
3. The placed ball is automatically selected — you can immediately click again to reposition it, or place additional balls.
4. Repeat to add as many balls as your drill requires (e.g. one per station in a rotation).

Placing Cones

1. Click Cone in the Field Objects menu.
2. Click on the pitch to place an orange cone.
3. Cones are added to all phases (like players). Each cone gets a unique ID.

Placing Targets

1. Click Target in the Field Objects menu.
2. Click on the pitch to place a red target marker.
3. Targets are added to all phases (like players and cones).

Placing Zones

Zones are colored polygon areas for highlighting tactical regions (defensive blocks, pressing triggers, passing lanes, etc.).

1. Click Zone in the Field Objects menu.
2. Click on the pitch to add vertices one by one.
3. Double-click (or press confirm) to close the polygon.
4. Use the color picker and opacity slider to style the zone.

Selecting Items

• Single click on any item to select it. A blue glowing ring appears underneath.
• Click on empty pitch to deselect.
• Click the same item again to toggle selection off.

Removing Items

1. Select Remove mode from the action menu.
2. Click on any item to remove it.
3. Removing a player, cone, target, or zone removes it from all phases.
4. Removing a ball only affects the current phase (other balls remain).

Copy & Paste Between Phases

You can copy an item's full data (position, look direction, path settings, etc.) and paste it into other phases. This is useful for carrying a player or ball setup across phases without manually recreating it.

1. Select an item on the pitch.
2. Click Copy. The selected item's complete data is captured. A confirmation toast appears: "Copied phase state for [item name]".
3. Click Paste. A menu appears offering three target options:
   • Previous — paste into all phases before the current one.
   • Current — paste into the current phase (overwrites the selected item's current data).
   • Next — paste into all phases after the current one.

Adjusting Height

When an item is selected, use the Height slider in the right panel to set its Y position. This is useful for showing aerial balls or elevated positions.