SH Staging Phase

SH STAGING PHASE

SH Staging Phase is a server-authoritative staging and main-base protection system for Spearhead Servers

The mod creates protected zones around active faction headquarters, keeps teams inside their own MOB during the opening staging phase, blocks weapons inside protected bases, and eliminates enemy players who ignore all warnings.

Only active main bases are affected by default. Normal objectives, capture points, neutral locations, and purple points remain unchanged.


STAGING PHASE

At the beginning of the match, players must remain inside their own Main Operating Base until the staging timer expires. A high-visibility English banner displays the remaining deployment time. Leaving the friendly MOB during staging results in immediate death.

The banner automatically hides while an arsenal, vehicle-spawn interface, dialog, or command-tent construction interface is open. Server-side protection continues while the banner is hidden.


MAP ZONES

- Friendly main base: bright blue circle with strong transparent blue shading.
- Enemy main base: red circle with transparent shading and diagonal warning stripes.
- Terrain, roads, buildings, and map symbols remain visible.
- Overlays remain aligned while moving or zooming the map.
- Late joiners automatically receive all active zones.
- Duplicate zones are prevented and overlays are cleared when the scenario ends.


ENEMY MAIN-BASE PROTECTION

Entering an enemy MOB starts a configurable warning sequence. After the final warning, the player receives one additional warning interval to leave. Remaining inside causes an immediate lethal lightning strike. Leaving the zone resets the warning sequence.


WEAPON RESTRICTIONS

All player-controlled weapons can be disabled inside protected main bases, including infantry weapons, vehicle main guns, coaxial weapons, mounted machine guns, helicopter weapons, turrets, and stationary weapons.

The system dynamically detects registered firing inputs instead of using a fixed vehicle list. Vanilla and additional modded vehicles are supported automatically when they use the standard Arma Reforger input and weapon framework.

Blocked firing attempts display:

MAIN BASE: You cannot shoot inside a main base.

The notification has a 15-second cooldown per player. Holding the trigger does not create repeated messages.


SUMMARY

- Server-authoritative main-base protection
- Configurable staging duration and protection radius
- Immediate death for leaving the friendly MOB during staging
- Enemy-base warnings followed by a lethal lightning strike
- Dynamic infantry, vehicle, helicopter, turret, and stationary weapon blocking
- No vehicle-specific configuration required
- Blue friendly and red striped enemy map zones
- Interface-aware English warning banners
- Late-join synchronization
- Normal and purple objectives are unaffected

-------------------------------------------------------------------------------

SERVER CONFIGURATION

The server automatically creates:

$profile:SH-Spawnprotection.json

{
    "m_bEnabled": true,
    "m_fRadius": 150.0,
    "m_iPreLobbySeconds": 180,
    "m_fCheckIntervalSeconds": 1.0,
    "m_iEnemyWarnings": 3,
    "m_fEnemyWarningIntervalSeconds": 3.0,
    "m_fDamagePerTick": 0.18,
    "m_bDisableFirearms": true,
    "m_bShowMapBoundary": true,
    "m_iMapBoundaryPoints": 24,
    "m_bIncludeHQCandidates": false,
    "m_bDebugLogging": false
}


CONFIGURATION DESCRIPTION

m_bEnabled
Enables or disables the complete system.

m_fRadius
Protection radius around each main base in meters. Default: 150. Minimum: 10.

m_iPreLobbySeconds
Staging duration in seconds. Default: 180. Set to 0 to disable staging.

m_fCheckIntervalSeconds
Standard server evaluation interval. Default: 1.0. Minimum: 0.2. Critical staging checks automatically run up to five times per second.

m_iEnemyWarnings
Number of warnings before the final escape interval. Default: 3.

m_fEnemyWarningIntervalSeconds
Time between warnings and duration of the final escape period. Default: 3.0. Minimum: 0.5.

m_fDamagePerTick
Legacy compatibility value. The current system uses an immediate lethal strike, so this setting does not alter the punishment. Accepted range: 0.0-1.0.

m_bDisableFirearms
Enables dynamic infantry and vehicle weapon blocking inside protected main bases.

m_bShowMapBoundary
Shows or hides the blue friendly and red striped enemy map zones.

m_iMapBoundaryPoints
Controls circle smoothness. Default: 24. Range: 8-48.

m_bIncludeHQCandidates
When true, valid potential HQ locations are also protected. Default: false.

m_bDebugLogging
Enables additional diagnostic logs. Default: false.

Configuration changes require a server or scenario restart.