Spawns
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.
Element | Description | Value/Children |
---|---|---|
A node containing the spawns for this map. | ||
Sub-elements | ||
An individual spawn where a team will spawn | ||
UniqueThe spawn for observers and teams without a spawn. Only one default spawn element is allowed per map. |
Spawn & Default Element Attributes
Attribute | Description | Value | Default |
---|---|---|---|
The team this spawn applies to. Not needed for team-less gamemodes. | Team ID | ||
Validate that the player spawns in a safe location. | true/false | false | |
Spawns players at the next region in a list if the one prior to it isn't safe. Requires the attribute set to true. | true/false | false | |
Spawn players as far away as possible from enemy players. | true/false | false | |
Spawn regions are assigned exclusively to one player or team and only they will spawn there. | true/false | false | |
Once a player has been assigned a spawn they will spawn there even if they leave and rejoin the game. | true/false | false | |
PropertyThe kit to apply to players when they are spawned in this spawn. | Kit ID | ||
PropertyFilter when this spawn is used. | Filter |
Spawn & Default Element Sub-elements
Element | Description | Value/Children |
---|---|---|
The region or regions where players will spawn. | Regions |
Regions Element Attributes
Attribute | Description | Value | Default |
---|---|---|---|
The exact block coordinates that the player looks at when spawned. This attribute will negate any angles set by the and attributes. | X,Y,Z | ||
The horizontal angle the player looks to when spawned. South 0, East -90, North 180 and West 90. | -180 to 180 | 0 | |
The vertical angle the player looks to when spawned. -90 is straight up 90 is straight down. | -90 to 90 | 0 |
TIP:
Copy the yaw and pitch from the F3 screen in minecraft (the Facing: Direction (Axis) (Yaw/Pitch)
line).
Examples
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.
Element | Description |
---|---|
Node specifying the default respawn settings for this map. | |
Node specifying multiple respawn options for this map. |
Respawn Attributes
Attribute | Description | Value | Default |
---|---|---|---|
Delay a players respawn for this duration. | Time Period | 2s | |
Filters when the respawn is used. | Filter | ||
Auto respawn the player after the delay time has elapsed. | true/false | false | |
Dead players get a blindness effect applied. | true/false | false | |
Allow dead players to fly around. | true/false | false | |
N/AAllow players to respawn from beds. | true/false | false | |
PropertyMessage to display on the respawn screen to respawning players. | Formatted Text |
Respawn Sub-elements
Element | Description | Value/Children |
---|---|---|
PropertyMessage to display on the respawn screen to respawning players. | Formatted Text |