FF Supply Lines

PUBLIC BETA (0.10.4) - please send feedback, bugs and ideas: https://github.com/FatihHekim0glu/FF-Series-Feedback

NEW IN 0.10.4
- Road: Normal or Safer on Send, Request and flows. The safer road is longer but cuts ambush risk.

FF Supply Lines moves supplies and fuel between your Freedom Fighters bases with virtual convoys.
Build a Supply Hub, then send, request, buy at ports and gas stations, or run a flow. No AI vehicles drive: the cargo travels on the server, shows on your map, pays a fuel fee and can be ambushed.

Part of the FF series with FF Mortar (mortars and radio fire support):
https://reforger.armaplatform.com/workshop/6B02190FCAA4B6A6

WHAT YOU GET
- Supply Hub: a buildable shelter whose radio opens the Supply Panel.
- Send or request supplies and fuel between any two friendly hubs.
- Flows: up to 4 per hub, 100 or 200 supplies or litres of fuel every 15 to 90 minutes.
- Buy supplies at friendly ports and fuel at friendly gas stations.
- Live convoy and ambush markers on your faction's map.
- Ambush risk and hired escorts: Light (HMG car) or Heavy (APC).
- Toasts for trips and ambushes; all saved.

QUICK START
1. Build a Supply Hub at a military base, FOB or captured factory (300 supplies), and a second one at another base.
2. At the hub's radio: F > Open Supply Panel.
3. Send / Request > pick the other hub, the amount and an escort > Send. Watch the convoy on the map.

THE SUPPLY PANEL
- Overview: stock, production, your money, min reserve, deposit, and up to 8 convoys with their ETA.
- Send / Request: every friendly hub with distance, ETA and risk; amount (up to 1000); escort; the full cost before you confirm. Fuel: 50 to 1000 L.
- Flows: switch on or off, change rate and escort, remove. Log: the hub's last 20 events, with player names.

CONVOYS
- Travel time: 2 minutes of loading plus the road at 30 km/h (5 km: about 12 minutes).
- Under 300 m of road: a short delivery, 1 minute, no fee or risk.
- Road convoys pay a fuel fee: 50 L of base fuel, or the same value in supplies (20 on Normal); a purchase pays it in money (100 on Normal).
- No run takes a base below its reserve (the respawn reserve or your min reserve, whichever is higher).
- If the destination is lost, the convoy turns back (fees are kept).

BUYING
- Friendly ports sell supplies and friendly gas stations sell fuel at FF's own prices, listed after the hubs with "(buy)" or "(buy fuel)".
- Buy once, or as a flow paid from the hub deposit. Ports and stations always keep a reserve for players.

RISK AND ESCORTS
- Road convoys have a 2% risk, more through enemy ground, past enemy checkpoints or near battles (up to 75%). An ambush takes 25 to 75% of the cargo. The risk shows before you send.
- Road: Normal, or Safer where a safer road exists (it is longer, with less ambush risk).
- Light escort: half the risk, for 5% of the cargo value (at least 25). Heavy escort: a fifth of the risk and half the loss, for 15% (at least 75).

SERVER ADMINS
- Settings: $profile:FFSL_SupplyLines/settings.json, read at start; every key optional (speed, prices, flows, risk, escorts, markers, toasts). Bad values are logged and the default kept.
- Logs: [FFSL] lines in the server log; every order with the player's name in $profile:FFSL_SupplyLines/orders.log.
- Saves: hubs are FF build items. Convoys, flows, deposits and hub logs are the mod's own record, written with FF's autosave and shutdown save. FF's own save data is never changed.
- Clean stop: #shutdown writes the shutdown save; after a crash or kill, convoys and stocks go back to FF's last autosave with FF's data.
- Never remove the mod from a running campaign: supplies on the road exist only in its record.

COMPATIBILITY
- Requires Freedom Fighters (plus EDF and EPF).
- Runs with Freedom Fighters Plus, FF Logistic, Loot Transfer System (+ FF_Logistics_LTS_Compat), FF Freedom Engineers and FF Mortar. FF Mortar keeps its own min reserve.
- Optional (all on the Workshop): FF War Economy (https://reforger.armaplatform.com/workshop/8FF9767E026B74B3) sends deliveries as convoys, FF High Command divisions escort routes, FF Enemy Command 0.1.11+ raises the risk on enemy ground.

KNOWN LIMITS
- Tested on dedicated servers with one player and in Workbench; not yet confirmed with several players, late joiners, single player or consoles.
- Flows and convoys only move while a player is online, like FF's own clock.
- Ambushes and escorts are virtual: players cannot defend a convoy in person.
- Fuel cargo needs a fuel tank at both bases.
- English only for now.

CREDITS
- FF Reoccupation by Erdfuchs (notifications used for the toasts), Freedom Fighters by JohnnyKerner and the FF team, Arkensor (Persistence Framework), Bohemia Interactive.

LICENSE
FF Supply Lines by Fatih Hekimoglu: Arma Public License No Derivatives (APL-ND).