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

- **Clean Start**: Vorhandene Gruppen werden beim Start gelöscht
- **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
{
  "groups": [
    {
      "groupName": "Alpha Squad",
      "faction": "US",
      "maxMembers": 8,
      "allowedPlayerUIDs": [
        "76561198012345678",
        "76561198087654321"
      ],
      "radioFrequencies": [
        { "frequency": 50.0 },
        { "frequency": 51.5 }
      ]
    },
    {
      "groupName": "Bravo Squad",
      "faction": "US",
      "maxMembers": 8,
      "radioFrequencies": [
        { "frequency": 52.0 }
      ]
    },
    {
      "groupName": "Charlie Squad",
      "faction": "USSR",
      "maxMembers": 10,
      "radioFrequencies": [
        { "frequency": 60.0 },
        { "frequency": 61.0 }
      ]
    }
  ]
}
```


### Parameter


- **groupName** (string): Der Name der Gruppe (wird geschützt und kann nicht geändert werden)
- **faction** (string): Der Fraktionsschlüssel (z.B. "US", "USSR", "FIA")
- **maxMembers** (int): Maximale Anzahl der Gruppenmitglieder
- **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