Forever Winter Mods

Creat: 3 septembrie 2026, ultima actualizare: 7 septembrie 2026

Un CLI interactiv pentru instalarea, activarea și dezactivarea tripletelor de moduri pentru The Forever Winter.

Modurile pentru The Forever Winter nu sunt fișiere individuale. Un mod jucabil este un triplet potrivit de fișiere .pak, .ucas și .utoc. Copierea manuală a fișierelor individuale poate lăsa o instalare parțială pe care jocul nu o poate folosi. Forever Winter Mods face acest contract explicit: descoperă o instalare a jocului, citește arhivele compatibile și operează doar asupra tripletelor complete.

Proiectul este publicat ca @sabinmarcu/foreverwinter.

Cum funcționează

Rulează fw-mods fără nicio comandă pentru a deschide o listă în terminal cu tripletele de moduri complete din directorul de moduri selectat. Fiecare intrare poate fi activată sau dezactivată printr-o singură operație, astfel încât cele trei fișiere necesare rămân mereu în aceeași stare.

Folosește fw-mods install <archive> pentru a inspecta o arhivă .zip, .7z sau .7zip. Un singur triplet nou se instalează imediat. Arhivele care conțin mai multe triplete, sau un mod deja prezent, deschid mai întâi un selector. Înainte de instalare, CLI-ul compară marcajele temporale ale arhivei cu tripletul instalat și etichetează fiecare intrare drept new, update, older sau installed.

CLI-ul nu extrage o arhivă cu conținut neașteptat. Fișierele de documentație sunt permise, dar alte tipuri de fișiere îl fac să se oprească și să ceară jucătorului să citească instrucțiunile de instalare ale arhivei. De asemenea, nu șterge modurile instalate. Aceasta este o limită deliberată: unealta gestionează triplete complete și refuză să ghicească cum ar trebui tratată o arhivă necunoscută sau un fișier fără legătură.

Terminologie

Triplet de mod

Un set de trei fișiere cu același nume de bază: .pak, .ucas și .utoc. De exemplu, Example_P.pak, Example_P.ucas și Example_P.utoc formează un triplet. CLI-ul listează, comută sau instalează un mod doar când toate cele trei fișiere potrivite sunt prezente.

Activat și dezactivat

Un triplet activat își păstrează numele de fișier normale. Un triplet dezactivat adaugă .disabled după fiecare extensie, precum Example_P.pak.disabled. Conținutul rămâne în același director; doar numele se schimbă.

Director de moduri

Directorul aflat sub directorul Paks al jocului, care conține tripletele de moduri. Instalarea jocului folosește în mod normal Windows/ForeverWinter/Content/Paks sub directorul său Steam. CLI-ul acceptă orice director existent atunci când este furnizat --path.

Arhivă

Un fișier .zip, .7z sau .7zip care conține unul sau mai multe triplete de moduri. Folderele din arhivă sunt permise, dar fiecare mod este identificat prin propriul triplet complet, cu același nume.

Detectarea automată a directorului de moduri

La pornire, CLI-ul verifică mai întâi un --path furnizat. Acesta rezolvă calea respectivă către un director real; o cale lipsă sau un fișier sunt respinse. Fără --path, caută în locațiile obișnuite de instalare Steam pe Windows și Linux.

Pe Windows, verifică C:\Program Files (x86)\Steam și C:\Program Files\Steam. Pe Linux, verifică ~/.steam/steam, ~/.local/share/Steam și locația Steam pentru Flatpak la ~/.var/app/com.valvesoftware.Steam/.local/share/Steam. Pentru fiecare bibliotecă Steam existentă, caută atât The Forever Winter, cât și Forever Winter sub steamapps/common, apoi verifică directorul Windows/ForeverWinter/Content/Paks al jocului.

În interiorul unui director Paks existent, fiecare subdirector al cărui nume conține mods este un candidat. Candidații sunt ordonați după nume: ~mods este preferat, apoi mods, apoi numele care se termină în mods, iar în final orice alt director potrivit, în ordine alfabetică. Primul candidat este folosit.

Aceasta este în mod intenționat o euristică bazată pe numele directorului, nu un analizor al bibliotecii Steam. Nu citește configurația Steam și nu scanează discuri arbitrare. Dacă nu poate găsi un director potrivit, cere calea completă. De asemenea, poți ocoli explicit detectarea:

yarn dlx @sabinmarcu/foreverwinter --path "/path/to/~mods"