Zones

Understanding SafeZones and WarZones for server administration.

Zones

HyperFactions provides two special zone types for server administration: SafeZones and WarZones. These are admin-managed areas with special rules that can span multiple chunks.

Zone System Overview

Zones are named entities that can contain multiple chunks, providing flexible area management for server administrators.

Key features:

Named zones (e.g., "spawn", "arena", "market")
Multi-chunk support with radius claiming
25 configurable flags per zone
GUI-based management
Priority over faction claims

For Server Admins

Zone management requires the hyperfactions.admin.zones permission. Regular players cannot create or modify zones.

SafeZones

SafeZones are protected areas where PvP is disabled and players are generally safe. Ideal for spawn points, trading areas, and community spaces.

SafeZone Default Flags

Flag	Default	Description
Combat Flags
`pvp_enabled`	false	Players cannot damage other players
`friendly_fire`	false	Faction members cannot hurt each other
`projectile_damage`	false	Projectiles deal no damage
`mob_damage`	false	Mobs cannot damage players
Building Flags
`build_allowed`	false	Players cannot place or break blocks
Interaction Flags
`block_interact`	true	General block interaction allowed
`door_use`	true	Players can use doors and gates
`container_use`	false	Players cannot access chests or storage
`bench_use`	false	Players cannot use crafting tables
`processing_use`	false	Players cannot use furnaces or smelters
`seat_use`	true	Players can sit on seats and mounts
Item Flags
`item_drop`	false	Players cannot drop items (prevents littering)
`item_pickup`	true	Players can pick up items
`item_pickup_manual`	false	Manual item pickup disabled
`invincible_items`	true	Dropped items cannot be destroyed
Damage Flags
`fall_damage`	false	No fall damage
`environmental_damage`	false	No drowning or suffocation
Death Flags
`keep_inventory`	true	Players keep inventory on death
`power_loss`	false	No power loss on death
Mob Spawning Flags
`mob_spawning`	false	Master toggle - no mob spawning
`hostile_mob_spawning`	false	No hostile mob spawning
`passive_mob_spawning`	false	No passive mob spawning
`neutral_mob_spawning`	false	No neutral mob spawning
`npc_spawning`	false	No NPC spawning
Integration Flags
`gravestone_access`	false	Gravestone access disabled

Mixin-Dependent Flags

Four flags require OrbisGuard-Mixins to function: item_pickup_manual, invincible_items, keep_inventory, and npc_spawning. Without the mixin mod installed, these flags will have no effect.

Common SafeZone Uses

Server spawn areas
Server hubs and lobbies
Trading centers and markets
Event venues
Tutorial areas
NPC villages

SafeZone Design Tip

SafeZones disable item dropping by default to prevent players from littering spawn areas with unwanted items.

WarZones

WarZones are designated combat areas where PvP is always enabled but building is blocked to prevent griefing.

WarZone Default Flags

Flag	Default	Description
Combat Flags
`pvp_enabled`	true	PvP combat is enabled
`friendly_fire`	false	Faction members still protected
`projectile_damage`	true	Projectiles deal damage
`mob_damage`	true	Mobs can damage players
Building Flags
`build_allowed`	false	No block placement/breaking (anti-grief)
Interaction Flags
`block_interact`	true	General block interaction allowed
`door_use`	true	Players can use doors and gates
`container_use`	false	No container access
`bench_use`	false	No crafting table access
`processing_use`	false	No furnace/smelter access
`seat_use`	true	Players can sit on seats and mounts
Item Flags
`item_drop`	true	Players can drop items
`item_pickup`	true	Players can pick up items
`item_pickup_manual`	true	Manual item pickup enabled
`invincible_items`	false	Dropped items can be destroyed
Damage Flags
`fall_damage`	true	Fall damage applies
`environmental_damage`	true	Environmental hazards active
Death Flags
`keep_inventory`	false	Players drop inventory on death
`power_loss`	false	No power loss on death
Mob Spawning Flags
`mob_spawning`	true	Master toggle - mob spawning enabled
`hostile_mob_spawning`	true	Hostile mobs can spawn
`passive_mob_spawning`	true	Passive mobs can spawn
`neutral_mob_spawning`	true	Neutral mobs can spawn
`npc_spawning`	true	NPCs can spawn
Integration Flags
`gravestone_access`	true	Gravestone access enabled

Common WarZone Uses

PvP arenas
Event battlegrounds
Resource competition areas
King of the Hill zones
Boss fight arenas

Arena Design

WarZones are perfect for designated PvP arenas. Deaths in WarZones still cause power loss by default, but this creates consequences for reckless fighting.

Zone Flags Reference

All 25 zone flags organized into 8 categories:

Combat Flags (4)

Flag	Description	Server Event
`pvp_enabled`	Player vs player damage	Damage event with player source
`friendly_fire`	Same-faction damage	Damage event with faction check
`projectile_damage`	Arrow/projectile damage	Damage event with projectile source
`mob_damage`	Mob to player damage	Damage event with entity source

Building Flags (1)

Flag	Description	Server Event
`build_allowed`	Block place/break	BreakBlockEvent, PlaceBlockEvent

Interaction Flags (6)

Flag	Description	Server Event
`block_interact`	General block interaction (parent)	UseBlockEvent
`door_use`	Doors and gates	DoorInteraction
`container_use`	Chests, backpacks	OpenContainerInteraction
`bench_use`	Crafting tables	OpenBenchPageInteraction
`processing_use`	Furnaces, smelters	OpenProcessingBenchInteraction
`seat_use`	Seats, chairs, mounts	MountInteraction

Item Flags (4)

Flag	Description	Server Event
`item_drop`	Dropping items	DropItemEvent
`item_pickup`	Picking up items	InteractivelyPickupItemEvent
`item_pickup_manual`	Manual item pickup*	Manual pickup interaction
`invincible_items`	Prevent item destruction*	Item damage event

Damage Flags (2)

Flag	Description	Server Event
`fall_damage`	Fall damage	Damage with DamageCause.FALL
`environmental_damage`	Drowning, suffocation	Damage with EnvironmentSource

Death Flags (2)

Flag	Description	Server Event
`keep_inventory`	Keep items on death*	PlayerDeathEvent
`power_loss`	Faction power loss on death	PlayerDeathEvent

Mob Spawning Flags (5)

Flag	Description	Server Event
`mob_spawning`	Master toggle (parent)	SpawnEvent
`hostile_mob_spawning`	Hostile mob spawning	SpawnEvent with hostile type
`passive_mob_spawning`	Passive mob spawning	SpawnEvent with passive type
`neutral_mob_spawning`	Neutral mob spawning	SpawnEvent with neutral type
`npc_spawning`	NPC spawning*	SpawnEvent with NPC type

Integration Flags (1)

Flag	Description	Server Event
`gravestone_access`	Access gravestones	GravestoneInteraction

* Requires OrbisGuard-Mixins mod to be installed.

Parent-Child Flag Relationships

Some flags have parent-child relationships where the parent flag acts as a master toggle:

block_interact is the parent of door_use, container_use, bench_use, processing_use, and seat_use. If block_interact is set to false, all child interaction flags are effectively disabled regardless of their individual settings.
mob_spawning is the parent of hostile_mob_spawning, passive_mob_spawning, neutral_mob_spawning, and npc_spawning. If mob_spawning is set to false, no mobs of any type will spawn regardless of child flag settings.

Zone Management

Creating a Zone

Create the named zone:
```
/f admin zone create <safe|war> <name>
```
Example: /f admin zone create safe spawn
Claim chunks for the zone:

Stand in each chunk and run:
```
/f admin zone claim <name>
```
Or use radius claiming:
```
/f admin zone radius <name> <radius> [circle]
```

Radius Claiming

Claim multiple chunks efficiently:

Square radius:

/f admin zone radius spawn 5

Claims an 11×11 chunk area (5 chunks in each direction from center).

Circular radius:

/f admin zone radius spawn 5 circle

Claims a circular area with 5-chunk radius.

Radius Calculation

A radius of N creates a square of (2N + 1) × (2N + 1) chunks, or a circle inscribed within that area.

Managing Zones

Remove a single chunk from current position:

/f admin zone unclaim

Delete an entire zone:

/f admin zone delete <name>

This removes the zone definition and unclaims all its chunks.

List all zones:

/f admin zone list

List zones by type:

/f admin zone list safe
/f admin zone list war

Immediate Effect

Zone changes take effect immediately. Players in the area will be subject to new rules instantly.

Modifying Zone Flags

Via Admin GUI:

/f admin

Navigate to Zones → Select zone → Configure Flags

Screenshot Needed

Screenshot: admin-zones.png

Description: Admin zone management interface showing zone list and flag configuration

Key elements to capture:

Zone list with safe/war indicators
Flag toggle interface
Radius claim controls

Zone Priority

Zone rules override faction claims:

SafeZone > WarZone > Faction Claim > Wilderness

Priority Override

If a chunk is marked as a SafeZone, previous faction claims are effectively suspended. SafeZone rules apply regardless of prior ownership. The faction still "owns" the claim, but zone rules take precedence.

Visual Indicators

Zones appear on the faction map with distinct markers:

Zone Type	Color	Map Symbol
SafeZone	Bright Green	S
WarZone	Bright Red	W
Your Faction	Your Color	F
Enemy	Red	E
Ally	Green	A
Neutral	Yellow	N
Wilderness	Gray	.

Use /f map to see zone boundaries visually.

Zone Storage

Zone data is stored in:

mods/com.hyperfactions_HyperFactions/zones.json

This file contains all named zones with their chunk lists and flag configurations.

Strategic Zone Placement

Server Spawn

Create a SafeZone around spawn:

Create the zone: /f admin zone create safe spawn
Use radius: /f admin zone radius spawn 3 circle
Consider a buffer zone around the core area

Spawn Buffer

Consider creating a small SafeZone buffer around spawn exits to prevent spawn camping. A 2-3 chunk radius usually works well.

PvP Arena

Create a WarZone for dedicated PvP:

Build your arena structure
Create zone: /f admin zone create war arena
Mark arena chunks: /f admin zone radius arena 2

Resource Areas

Consider WarZones for contested resources:

Encourages PvP conflict over valuable areas
Creates natural PvP hotspots
Building disabled prevents griefing

Market/Trading Areas

Create SafeZones for trading:

Create zone: /f admin zone create safe market
Claim the trading area
Players can trade safely without PvP risk
Consider enabling container_use if you have shop NPCs

Comparison Table

Feature	SafeZone	WarZone	Faction Claim
PvP	No	Yes	Configurable
Building	No	No	Owner only
Power loss on death	Yes	Yes	Yes
Can be claimed by factions	No	No	N/A
Admin only	Yes	Yes	No
Multi-chunk	Yes	Yes	Yes
Named entity	Yes	Yes	No
Custom flags	Yes (25)	Yes (25)	Limited

Territories - Regular faction claims
Admin Commands - Zone management commands
Power System - Power and death penalties
Configuration Reference - Zone-related settings

Edit this page on GitHub

Zones

Zones

Zone System Overview

SafeZones

SafeZone Default Flags

Common SafeZone Uses

WarZones

WarZone Default Flags

Common WarZone Uses

Zone Flags Reference

Combat Flags (4)

Building Flags (1)

Interaction Flags (6)

Item Flags (4)

Damage Flags (2)

Death Flags (2)

Mob Spawning Flags (5)

Integration Flags (1)

Parent-Child Flag Relationships

Zone Management

Creating a Zone

Radius Claiming

Managing Zones

Modifying Zone Flags

Zone Priority

Visual Indicators

Zone Storage

Strategic Zone Placement

Server Spawn

PvP Arena

Resource Areas

Market/Trading Areas

Comparison Table

Related Topics