2-7 SpawnPoints System

### Welcome to P27 Economy & Spawn Points System!

This mod introduces a robust, secure, and fully automated currency system for Arma Reforger servers. By bridging player performance (XP) with asset availability, it changes how players deploy vehicles and resources, bringing a tactical progression layer to your operations.


####  Key Features:
**Dynamic XP-to-SP Conversion:** Players earn custom Spawn Points (SP) automatically as they gain experience points. Fully adjustable multiplier allows server owners to fine-tune the economy.

**Strict Server-Authoritative Security:** Exploits are impossible. The server runs a non-compromising validation check upon asset creation. If a player attempts to spawn a vehicle they cannot afford, the vehicle is instantly deleted from the world.

**Native UI Integration:** No clunky menus! The mod seamlessly hooks into the standard Content Browser / Campaign Spawner asset cards, replacing vanilla budget values with custom SP prices.

**Live Wallet Display:** Includes a script component for a persistent HUD widget showing players their precise current SP balance in real-time.

**Smart Persistence & Protection:** Player balances are automatically saved to individual JSON files inside the server profile. If a player crashes or disconnects, their hard-earned points are safely restored upon reconnection.

**Automated Match Cleanup:** Keeps the server fresh. Balances are automatically wiped from the disk and memory immediately upon match completion (Win/Loss/Timeout) or hard server resets, ensuring a level playing field for the next game.

###  Configuration & Implementation Manual

To make the economy system work flawlessly on your custom mission or server, follow these component placement guidelines:


#### 1. Player Setup (Wallet & Persistence) (already used in release)

**Where to attach:** Add the `P27_SpawnPointManagerComponent` to your server's **PlayerController** component list (or player prefab).

**Attributes to configure:**
  * `Update Interval`: Time in seconds between auto-saves and sync loops.
  * `Multiplier`: How many Spawn Points (SP) a player receives for every 1 earned XP (e.g., `0.5` means 100 XP = 50 SP).

#### 2. Pricing Assets (Vehicles & Supplies)
* **Where to attach:** Add your custom `P27_ItemPriceComponent` to any vehicle or asset prefab that you want to put a price tag on.

* **Attributes to configure:**
  * `m_fPrice`: Enter the desired SP cost for that specific vehicle.


#### 3. HUD Wallet UI (example included in /UI)

**Where to attach:** Add the `P27_WalletUIComponent` to your custom HUD layout or screen overlay widget.

**Requirement:** Ensure that the text widget responsible for displaying the points is named exactly `PS_PreciseSPValue`. The script will automatically find it and update the text to `SP: [Balance]`.


#### 4. Spawner Cards UI (example included in /UI)

* The UI modification works automatically out of the box via the modded `SCR_AssetCardFrontUIComponent`. 

* It will search for `CostValue` (the vanilla budget text widget) and overwrite it. If you are using a custom asset card layout, make sure your custom text widget is named `PS_SPValue`.


#### 5. Gamemode & Spawner Logic (Automated)

* The `SCR_BaseGameMode` (handling game over wipinigs) and `SCR_CampaignBuildingManagerComponent` (handling server-side vehicle deletion) are injected globally via Enforce Script. As long as your mission uses a gamemode inheriting from `SCR_BaseGameMode`, no manual setup is required for these two elements.

For any questions - dm me on Discord: edexus1k