GTG Groups and Radios

# GTG Groups and Radios

Ein Arma Reforger Mod für erweiterte Gruppen- und Funkfrequenz-Verwaltung.

## Übersicht

GTG Groups and Radios erweitert das Standard-Gruppensystem von Arma Reforger um automatische Gruppenerstellung und Funkfrequenz-Zuweisung basierend auf einer JSON-Konfigurationsdatei. Der Mod ermöglicht es Server-Administratoren, vordefinierte Gruppen mit spezifischen Namen, Fraktionen, Mitgliederanzahl und Radio-Frequenzen zu erstellen.

## Features

- **Löschen aller vorhandenen Gruppen**: Optional beim Serverstart alle vorhandenen Gruppen löschen (konfigurierbar)
- **Automatische Gruppenerstellung**: Gruppen werden beim Serverstart aus einer Konfigurationsdatei im Profilordner geladen
- **Funkfrequenz-Management**: Automatische Zuweisung von Radio-Frequenzen an Spieler beim Gruppenbeitritt
- **Nur Autorisierte Spieler**: Man kann über ein Property in der Config steuern wer einer Gruppe beitreten darf
- **Multi-Transceiver Unterstützung**: Unterstützt mehrere Radio-Kanäle pro Gruppe
- **Gruppennamen-Schutz**: Verhindert das Umbenennen von vordefinierten Gruppen
- **Fraktionsbasiert**: Unterstützt alle Standard-Fraktionen von Arma Reforger
- **Persistente Gruppen**: Gruppen werden nicht automatisch gelöscht, wenn keine Spieler mehr drin sind

## Konfiguration

### Beispiel group-config.json

```json
{
  "options": {
    "deleteExistingGroupsOnStart": true,
    "debugLogging": true
  },
  "groups": [
    {
      "groupName": "Alpha Squad",
      "description": "Hauptangriffstrupp - Frontkämpfer",
      "faction": "US",
      "maxMembers": 8,
      "allowedPlayerUIDs": [
        "76561198012345678",
        "76561198087654321"
      ],
      "radioFrequencies": [
        { "frequency": 50.0 },
        { "frequency": 51.5 }
      ]
    },
    {
      "groupName": "Bravo Squad",
      "description": "Unterstützungstrupp",
      "faction": "US",
      "maxMembers": 8,
      "radioFrequencies": [
        { "frequency": 52.0 }
      ]
    },
    {
      "groupName": "Charlie Squad",
      "description": "Aufklärung und Sicherung",
      "faction": "USSR",
      "maxMembers": 10,
      "radioFrequencies": [
        { "frequency": 60.0 },
        { "frequency": 61.0 }
      ]
    }
  ]
}
```

### Options Parameter

- **deleteExistingGroupsOnStart** (bool): Wenn `true`, werden beim Serverstart alle vorhandenen Gruppen gelöscht (Default: `true`)
- **debugLogging** (bool): Wenn `true`, werden detaillierte Debug-Ausgaben im Server-Log angezeigt (Default: `true`)

### Groups Parameter

- **groupName** (string): Der Name der Gruppe (wird geschützt und kann nicht geändert werden)
- **description** (string, optional): Beschreibung der Gruppe (z.B. Rolle oder Aufgabe)
- **faction** (string): Der Fraktionsschlüssel (z.B. "US", "USSR", "FIA")
- **maxMembers** (int): Maximale Anzahl der Gruppenmitglieder
- **allowedPlayerUIDs** (array, optional): Liste von Steam-IDs die dieser Gruppe beitreten dürfen
- **radioFrequencies** (array): Liste der Radio-Frequenzen in MHz
  - **frequency** (float): Frequenz in MHz (wird automatisch in kHz für das Funksystem konvertiert)

## Funktionsweise

### Serverstart

Beim Start des Game Modes:
1. Die Konfigurationsdatei wird aus `$profile:group-config.json` geladen
2. Alle definierten Gruppen werden automatisch erstellt
3. Gruppennamen und Frequenzen werden intern gespeichert

### Spieler-Gruppenbeitritt

Wenn ein Spieler einer Gruppe beitritt:
1. Das System prüft, ob für diese Gruppe Frequenzen definiert sind
2. Nach 1 Sekunde Verzögerung (damit der Spieler vollständig gespawnt ist)
3. Werden die Radio-Frequenzen auf alle verfügbaren Transceiver des Spieler-Radios verteilt
4. Die erste Frequenz wird als Standard-Gruppenfrequenz gesetzt

### Gruppennamen-Schutz

- Der Mod verhindert das Umbenennen von vordefinierten Gruppen
- Änderungsversuche werden automatisch rückgängig gemacht
- Dies stellt sicher, dass die Gruppenstruktur konsistent bleibt

## Bekannte Einschränkungen

- Die Konfigurationsdatei muss sich im Server-Profil-Ordner befinden
- Änderungen an der Konfiguration erfordern einen Server-Neustart
- Die Anzahl der Frequenzen ist auf die Anzahl der Transceiver des verwendeten Radios begrenzt

## Support

Bei Fragen, Bugs oder Feature-Requests öffnen Sie bitte ein Issue im Repository.

## Projekt-Status

Aktiv in Entwicklung