Complex Door Gate Setup

Configure animated start gates (Complex Door) on duel arenas. Players spawn behind fence barriers, ready up by hitting the gate, then the doors open when the match begins.

Video Tutorial

The walkthrough below follows the same setup flow as this video. The physical build steps (where to click corners, where to stand, how gates behave in a match) are identical in ShyamDuels. Only the command prefix differs: use /shyamduels gate instead of the commands shown in the video.

Play gate setup tutorial

Open on YouTube if the player does not load.

ShyamDuels command prefix

All gate commands run under /shyamduels gate (not /practice gate or other prefixes from older plugins). You also need permission shyamduels.practice.gate.setup or shyamduels.admin.

Prerequisites

The arena is already created and linked to a kit (Arena Setup).
Door animation is enabled in config.yml:
```
door-animation:
  enabled: true
```
You are standing inside the arena world at the gate you want to configure.

Quick Setup (Follow the Video)

Get the gate selection wand:
```
/shyamduels gate wand
```
With the wand in hand, left-click the bottom corner of the doorway opening (Corner 1).
Right-click the opposite top corner of the doorway opening (Corner 2). Both corners must form a flat wall (same X or same Z), not a diagonal selection.
Walk to the arena floor side of the gate (where players stand before the match). Your position here becomes the eject point if a player ends up on the wrong side when the gate closes.
Save the gate to your arena:
```
/shyamduels gate addgate <arenaName>
```
Repeat steps 1-5 for each additional gate on the same arena (for example one gate per spawn side in a team map).
Verify gates are registered:
```
/shyamduels gate list
```
Start a test duel. Players should see a ready-up prompt, hit the gate barrier to ready, and the doors open when all players are ready or when the countdown finishes.

Gate Commands Reference

All commands are subcommands of /shyamduels gate. Permission: shyamduels.practice.gate.setup.

Command	Syntax	Description
`/shyamduels gate`	`/shyamduels gate`	Displays the full gate command help list in chat.
`/shyamduels gate wand`	`/shyamduels gate wand`	Gives you the Gate Selection Wand (Blaze Rod). Left-click sets Corner 1, right-click sets Corner 2.
`/shyamduels gate addgate`	`/shyamduels gate addgate <arena>`	Saves the wand selection as a gate on the specified arena. Must be run while standing on the arena floor side. Sets the eject point to your current location.
`/shyamduels gate delete`	`/shyamduels gate delete <arena>`	Deletes all gates linked to the arena and removes spawned gate entities.
`/shyamduels gate list`	`/shyamduels gate list`	Lists every arena that has gates and how many gates each arena has.
`/shyamduels gate reload`	`/shyamduels gate reload`	Reloads gate data from disk (`plugins/ShyamDuels/data/complex-door-data/`) without restarting the server.

How Gates Work in Matches

When a duel starts, fence barriers spawn inside your selected region and block the doorway.
If door-animation.gate.ready_up.enabled is true, players are prompted to hit the gate to ready up. When every fighter is ready, gates open early (before the countdown ends).
Otherwise, gates open automatically when the fight countdown completes.
After opening, gates close again after a short delay. Players caught on the wrong side are teleported to the eject point you set when running addgate.
Gate definitions are stored per arena under plugins/ShyamDuels/data/complex-door-data/<arena>.yml.

Configuration Options

Gate timing and ready-up messages are controlled in config.yml under door-animation:

door-animation:
  enabled: true
  animation_ticks: 20
  fence_material: "OAK_FENCE"
  gate:
    close_delay_seconds: 3
    eject_check_radius: 10
    open_speed_ticks: 20
    close_speed_ticks: 20
    ready_up:
      enabled: true
      prompt: "&#FFAA00&l⚡ &eHit the gate to ready up!"
      player_ready: "FB52✔ &a{player} is ready!"
      all_ready: "�FFFF&l⚡ &bAll players ready! Opening gates!"

See Configuration Files for other plugin settings.

Tips and Common Mistakes

Flat wall only: Corner 1 and Corner 2 must share the same X coordinate or the same Z coordinate. Diagonal selections are rejected.
Stand on the correct side: Run addgate from the arena floor where players should stand. The plugin uses your position to determine which side is "outside" and where to eject players.
Multiple gates: Run wand → select corners → addgate again for each separate doorway on the same arena.
Arena name must match: Use the exact arena name from /arena list, including clone suffixes like Arena1_1 if configuring gates on a cloned world copy.
Copypaste copies gates: /arena copypaste offsets gate regions to the new location automatically (Arena Setup).
Feature disabled: If commands say door animation is disabled, set door-animation.enabled: true in config.yml and restart.