FlagController

Parametry

Wszystkie parametry przekazujesz do konstruktora jako trzeci argument (paramsOverride), albo ustawiasz w dowolnym momencie przez :SetParams({}). Poniżej każdy parametr z opisem co wizualnie zmienia.

API — jak używać

Konstruktor

local fc = FlagController.new(
    flagModel,       -- Model Instance z Roblox
    userId,          -- number, UserId gracza
    paramsOverride   -- table (opcjonalne)
)

Aktualizacja co klatkę

-- w RunService.Heartbeat lub podobnym:
RunService.Heartbeat:Connect(function(dt)
    fc:Wave(dt)
end)

Zmiana parametrów w locie

-- np. na silny wiatr podczas burzy:
fc:SetParams({
    WindStrength  = 5.5,
    GustStrength  = 3.0,
    GustFrequency = 0.1,
    Inertia       = 0.08,
})

-- powrót do normy:
fc:SetParams({
    WindStrength  = 3.2,
    GustStrength  = 1.6,
    GustFrequency = 0.05,
    Inertia       = 0.18,
})

Cheap Mode

Tryb oszczędny — uproszczona symulacja dla flag w tle, odległych lub gdy liczba flag na scenie jest duża. Brak noise, inercji i gustów. Tylko sinusoidalna fala + sag.

fc.Cheap = true   -- włącz
fc.Cheap = false  -- wyłącz (domyślnie)

Możesz przełączać dynamicznie — np. gdy gracz jest dalej niż 50 studs:

RunService.Heartbeat:Connect(function(dt)
    local dist = (flagPos - playerPos).Magnitude
    fc.Cheap = dist > 50
    fc:Wave(dt)
end)

Jak to działa — pipeline symulacji

FlagController to symulator szkieletowy oparty na kościach Roblox (Bone). Każda klatka wykonuje cztery przejścia:

Nazewnictwo kości

Kontroler rozpoznaje kości według schematu nazwy:

Bone.{kolumna}.{głębokość}

-- przykłady:
Bone.0.0   -- kolumna 0, głębokość 0 (korzeń)
Bone.0.1   -- kolumna 0, głębokość 1
Bone.1.0   -- kolumna 1, głębokość 0 (korzeń)
Bone.1.3   -- kolumna 1, głębokość 3 (końcówka)

Kolumna to pasek pionowy flagi (od góry do dołu). Głębokość to pozycja wzdłuż flagi od drzewca do wolnej krawędzi. Kość o głębokości 0 to zawsze korzeń — ma inny ruch (root hinge).

Przygotowanie modelu w Blenderze

1. Utwórz siatkę flagi
   Dodaj płaszczyznę (Mesh → Plane), przeskaluj do proporcji flagi (np. 2:1 lub 3:2). Podziel ją przez Right Click → Subdivide — tyle razy żeby uzyskać kolumny i rzędy pasujące do twojej siatki kości. Dla siatki 5×4 potrzebujesz 4 podziałów poziomych i 3 pionowych.
2. Dodaj Armaturę
   Add → Armature → Single Bone. Ustaw kość korzenia przy lewej krawędzi flagi (przy drzewcu). Następnie w Edit Mode duplikuj i układaj kości zgodnie ze schematem kolumna/głębokość. Każda kość powinna być rodzicem następnej w łańcuchu (głębokość 0 → 1 → 2…).
3. Nazwij kości według schematu
   W panelu Bone Properties zmień nazwy na format Bone.{kolumna}.{głębokość}. Roblox i FlagController identyfikują kości wyłącznie po nazwie.

   Ważne Numery zaczynają się od 0, nie od 1. Pierwsza kość to Bone.0.0.
4. Przypisz Vertex Groups
   Zaznacz siatkę, przejdź do Object Data Properties → Vertex Groups. Utwórz grupę dla każdej kości o tej samej nazwie. Przypisz wierzchołki do grup z wagą (weight painting) — kość wpływa na obszar bezpośrednio przy niej.
5. Dodaj Armature Modifier
   Na siatce dodaj Modifiers → Armature, wskaż swoją armaturę. Sprawdź czy flaga deformuje się poprawnie przesuwając kości ręcznie w Pose Mode.
6. Eksport do FBX
   File → Export → FBX. Ustawienia:

   • Apply Transform: włączone
   • Armature: Add Leaf Bones wyłączone
   • Mesh: Apply Modifiers włączone

Konfiguracja w Roblox Studio

1. Importuj FBX
   Home → Import 3D → wybierz plik FBX. Studio powinno rozpoznać siatkę i kości i zaimportować je jako MeshPart z Bone instancjami w środku.
2. Sprawdź hierarchię
   W Explorer rozwiń model. Powinna być struktura:

   Model
     └─ Plane (MeshPart)
          ├─ Front (SpecialMesh / Decal)
          ├─ Back  (SpecialMesh / Decal)
          ├─ Bone.0.0
          │    └─ Bone.0.1
          │         └─ Bone.0.2 …
          └─ Bone.1.0 …

3. Sprawdź nazwy kości
   Upewnij się że kości mają nazwy w formacie Bone.X.Y. Jeśli Blender dodał prefiks (np. Armature_Bone.0.0) — zmień ręcznie lub użyj skryptu BatchRename.
4. Skonfiguruj FlagController
   Umieść skrypt (LocalScript lub Script) i wywołaj konstruktor:

   local FlagController = require(
       game.ReplicatedStorage.Flags.Flag.FlagController
   )
   local RunService = game:GetService("RunService")
   
   local fc = FlagController.new(
       script.Parent,
       12345678,  -- userId
       { WindStrength = 3.2 }
   )
   
   RunService.Heartbeat:Connect(function(dt)
       fc:Wave(dt)
   end)

5. Tekstury awatara
   Konstruktor automatycznie pobiera tekstury przez Players:GetUserThumbnailAsync. Wymaga że Plane.Front i Plane.Back to obiekty z właściwością .Texture (np. Decal lub SpecialMesh).