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
15 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
`block_interact`	true	General block interaction allowed
Interaction Flags
`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
Damage Flags
`fall_damage`	false	No fall damage
`environmental_damage`	false	No drowning or suffocation

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)
`block_interact`	true	General block interaction allowed
Interaction Flags
`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
Damage Flags
`fall_damage`	true	Fall damage applies
`environmental_damage`	true	Environmental hazards active

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 15 zone flags organized by category:

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 (2)

Flag	Description	Server Event
`build_allowed`	Block place/break	BreakBlockEvent, PlaceBlockEvent
`block_interact`	General block interaction	UseBlockEvent

Interaction Flags (5)

Flag	Description	Server Event
`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 (2)

Flag	Description	Server Event
`item_drop`	Dropping items	DropItemEvent
`item_pickup`	Picking up items	InteractivelyPickupItemEvent

Damage Flags (2)

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

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 (15)	Yes (15)	Limited

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 (2)

Interaction Flags (5)

Item Flags (2)

Damage Flags (2)

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