Plugin_config

📄 PluginConfig.cs – centralna konfiguracja wtyczki

🎯 Cel

PluginConfig przechowuje wszystkie ustawienia, które są ładowane z pliku config.yml i używane przez pozostałe komponenty wtyczki. Obejmuje:

• aktywację poszczególnych funkcji,

• parametry czasowe (np. interwały),

• listę efektów aktywowanych przez system monetek,

• mechanizmy walidacji i domyślnych wartości.

---

🧱 Struktura klasy

public class PluginConfig

• Każda właściwość odpowiada jednemu wpisowi w pliku config.yml

• Domyślne wartości są określone przy deklaracji (= true, = 60, itp.)

---

🔗 Sekcje konfiguracji

🔘 Ogólne

public bool IsEnabled { get; set; } = true;

• Aktywacja lub dezaktywacja całej wtyczki

---

🗣️ LosoweKomunikaty.cs

public bool RandomMessagesEnabled { get; set; }
public int RandomMessagesMinIntervalSeconds { get; set; }
public int RandomMessagesMaxIntervalSeconds { get; set; }

• Umożliwia kontrolę częstotliwości komunikatów systemowych od C.A.S.S.I.E.

---

🚪 OkresoweZamykanieDrzwi.cs

public bool DoorLockdownEnabled { get; set; }
public int DoorLockdownMinIntervalSeconds { get; set; }
public int DoorLockdownMaxIntervalSeconds { get; set; }
public int DoorLockdownDurationSeconds { get; set; }

• Określa, czy lockdown drzwi ma działać oraz jego harmonogram.

---

⌛ LateJoinSystem.cs

public bool LateJoinEnabled { get; set; }
public int LateJoinTimeSeconds { get; set; }

• Steruje dopuszczaniem graczy do rundy po jej rozpoczęciu.

---

🪙 Monetki.cs

public bool CoinsEnabled { get; set; }
public bool CoinEffectTeleportPlayer { get; set; }
...
public bool CoinEffectTimeShiftPlayers { get; set; }

• Lista przełączników aktywujących konkretne efekty monet.

• Dobrze przemyślana architektura pozwala dynamicznie budować listę efektów w runtime.

---

🧍 Lobby.cs

public bool LobbySystemEnabled { get; set; }

• Włącza lub wyłącza pre-game lobby.

---

📜 DefaultConfigTemplate – automatyczny YAML z komentarzami

• Gotowy do zapisania na dysku jako config.yml

• Zawiera opisy i domyślne wartości każdej opcji

• Idealne jako plik wyjściowy przy pierwszym uruchomieniu

public static string DefaultConfigTemplate => @"
# Czy wtyczka jest włączona?
IsEnabled: true

# Czas między komunikatami CASSIE
RandomMessagesMinIntervalSeconds: 60
...
";

---

🛠️ CreateDefault() – domyślna konfiguracja w kodzie

Zwraca nowy obiekt PluginConfig z wartościami domyślnymi. Używane np. w sytuacjach, gdy plik konfiguracyjny nie istnieje lub nie można go sparsować.

---

🧪 ValidateAndFix() – walidacja konfiguracji

public (PluginConfig fixedConfig, List<string> warnings) ValidateAndFix()

• Sprawdza poprawność wartości (np. Max >= Min, > 0, itp.)

• Zwraca poprawioną kopię konfiguracji + listę ostrzeżeń

• Zapobiega crashom lub błędnemu zachowaniu pluginu w przypadku złej konfiguracji YAML