The spawns module is required in a complete map XML because it specifies where players and observers can spawn. Default and observer spawns are defined with the <default> element and all other spawns in <spawn> elements. Only one default spawn element may be defined per map.

Multiple spawns from the same team can be grouped inside of a single <regions> element inside <spawns team="team-id">. Spawn positions are picked randomly inside of the defined regions. Since the plugin will not validate the spawn position by default, regions should be checked to make sure that they don’t intersect with solid objects or are midair. Spawns can also be defined with the safe="true" attribute, PGM will then check that the player spawns on a solid object and not midair.

The regions element accepts more than one region or region area. If they are not inside a <union> element one region will be picked at random for each spawn event.

Respawn behavior such as delays, etc. can be customized with the respawn module.

Spawn & Default Element Attributes

Spawn & Default Element Sub-elements

Regions Element Attributes

TIP: Copy the yaw and pitch from the F3 screen in minecraft (the Facing: Direction (Axis) (Yaw/Pitch) line).

Example

<spawns>
    <spawn team="red" kit="red">
        <regions yaw="90">
            <cuboid min="-2,13,71" max="-9,13,78"/>
        </regions>
    </spawn>
    <spawn team="blue" kit="blue">
        <regions yaw="-90">
            <cuboid min="2,13,-71" max="9,13,-78"/>
        </regions>
    </spawn>
    <default>
        <regions yaw="0">
            <cuboid min="-1,16,-1" max="2,20,2"/>
        </regions>
    </default>
</spawns>

Examples

<!-- Example spawns from Assualt -->
<spawns>
    <spawn team="blue" kit="blue">
        <regions yaw="-90">
            <region id="blue-spawn"/>
        </regions>
    </spawn>
    <spawn team="red" region="red-spawn" kit="red">
        <regions yaw="90">
            <region id="red-spawn"/>
        </regions>
    </spawn>
    <default kit="obs">
        <regions yaw="-135">
            <region id="obs-spawn"/>
        </regions>
    </default>
</spawns>
  
<spawns safe="true" sequential="true">
    <spawn team="blue" kit="blue" yaw="180">
        <regions>
            <cuboid min="-10,71,5" max="12,126,27"/> <!-- Players will spawn here first -->
            <cuboid min="-10,6,5" max="12,6,27"/> <!-- Secondary spawn if the first isn't available -->
            <point>1,8,0</point> <!-- Tertiary spawn if all other team spawns aren't safe -->
        </regions>
    </spawn>
    <spawn team="red" kit="red" yaw="0">
        <regions>
            <cuboid min="-10,71,-27" max="12,126,-5"/>
            <cuboid min="-10,6,-27" max="12,6,-5"/>
            <point>1,8,0</point>
        </regions>
    </spawn>
</spawns>

Respawn Module

The respawn module allows the map creator to adjust the respawn time and if players are automatically respawned. The respawn time must be greater than 1 second (20 ticks), if the respawn time is less it will automatically default to one second, allowing the death to fully complete and the player to be reset properly.

To allow players to spawn at a bed set the bed attribute to true. Players spawning at beds will not spawn with a kit even if there is one specified. If a player has a bed spawn location set it overrides all other spawn regions for that player.

Respawn Attributes

Respawn Sub-elements

<!-- Default auto respawn of 2 seconds -->
<respawn auto="true"/>

<!-- Allow players to respawn after 3 seconds, blackout the player when they die -->
<respawn delay="3s" blackout="true"/>

<!-- Allow respawning after 5s, display translatable waiting on flag drop respawn message -->
<respawn delay="5s" spectate="true">
    <message>{translate: "death.respawn.confirmed.waiting.flagDropped"}</message>
</respawn>