Cfx.re lansează Catalyst, un editor gratuit de efecte de particule pentru FiveM

Cfx.re a lansat Catalyst pe 12 noiembrie 2026. Este un editor complet și gratuit pentru crearea și modificarea efectelor de particule din GTA V, iar creatorii FiveM îl pot descărca deja din Cfx Portal.

Efectele de particule sunt focul, fumul, scânteile, praful, apa, luminile și decalurile care dau viață unei scene. În GTA V, ele sunt stocate în fișiere .ypt. Catalyst le permite dezvoltatorilor să construiască aceste efecte ca graf de noduri, să vadă rezultatul în timp real și să exporte fișiere finale pentru GTAV Legacy, GTAV Enhanced sau ambele, dintr-un singur proiect. Serverele de roleplay care vor efecte vizuale proprii nu mai trebuie să pornească jocul de fiecare dată doar ca să verifice o mică ajustare.

Ce aduce Catalyst creatorilor

Trei idei îl deosebesc de editarea manuală a valorilor. Majoritatea modificărilor pot fi previzualizate fără a lansa jocul. Proprietățile urmează curbe, nu valori fixe. Iar fiecare componentă a unui efect este un nod separat, pe care îl poți inspecta, redenumi și refolosi.

• Un flux de lucru bazat pe noduri: efectele se construiesc prin conectarea nodurilor.
• O fereastră de previzualizare în timp real, cu modurile Editor, Preview, Wireframe și Simulation. Simulation afișează fiecare particulă ca un punct colorat, ca să poți urmări cum apare, cum se mișcă și cum dispare.
• Curbe cu keyframe-uri pentru culoare, dimensiune și rotație pe durata de viață a particulei.
• Import și export de fișiere .ypt existente, ca efectele actuale să poată fi deschise și refăcute.
• Un format propriu de proiect, .ctlst, pentru salvarea progresului și lucrul în echipă.
• Acces la texturile și modelele jocului printr-un pool Global doar pentru citire, plus posibilitatea de a importa texturi .dds și modele .ydr proprii.

Cum se construiește un efect

Efectele se construiesc în cinci straturi. Particle Effect Rule este efectul declanșat în joc și stabilește durata, repetarea, nuanța, scara, culling-ul și coliziunile. Event Emitter-ele stau pe o linie temporală. Fiecare leagă un Emitter Rule, care controlează felul în care apar particulele, de un Particle Rule, care controlează cum arată și cum se mișcă ele ulterior. Deasupra se pot adăuga Behaviours opționale, printre care Color, Size, Rotation, Acceleration, Collision, Light și Decal.

Începătorii trebuie să evite câteva capcane. Un Particle Rule are nevoie de un nod Draw (Draw Sprite, Draw Trail sau Draw Model), altfel particulele rămân invizibile. Unele comportamente au nevoie și de un partener: Attractor cere un Attractor Domain, iar Decal cere Collision. Fără partener, ele pur și simplu nu fac nimic și nu afișează nicio eroare. Evolutions sunt glisoare de la 0 la 1 care trec treptat valorile spre keyframe-uri alternative. Fiecare Particle Rule are și o evoluție LOD integrată, controlată de distanța față de cameră.

Instalare și primii pași

Catalyst funcționează pe Windows 10 și 11, se instalează pentru fiecare utilizator, fără drepturi de administrator, și merge offline. Implicit se instalează în %LOCALAPPDATA%\Cfx\Catalyst. Salvează proiectele în altă parte, pentru că dezinstalarea șterge acel folder. GTA V nu este obligatoriu, dar este recomandat. La pornire, Catalyst găsește jocul și încarcă core.ypt ca pool Global. Dacă nu reușește, o fereastră îți permite să indici manual GTA5.exe sau core.ypt. Proiectele au extensia .ctlst. La clic dreapta pe un fișier .ypt apare opțiunea Import in Catalyst, dar Catalyst nu devine programul implicit pentru aceste fișiere.

De la editor la server

Exportul se face din File > Export YPT (Ctrl+E). Fiecare colecție bifată devine un fișier .ypt. Dacă alegi ambele ținte, Catalyst scrie fișiere separate, cu sufixele _legacy și _enhanced, ca să nu se suprapună. Toate erorile din lista de validare trebuie corectate înainte. Ghidul oficial pune apoi efectul în funcțiune pe FiveM în câțiva pași:

• Creează un folder de resursă cu un subfolder stream care conține fișierul .ypt exportat. Pentru resursele exclusive Enhanced, folosește în schimb un folder stream_enhanced.
• Adaugă un fxmanifest.lua cu fx_version 'cerulean', game 'gta5' și un script de client.
• În script, apelează RequestNamedPtfxAsset, așteaptă HasNamedPtfxAssetLoaded, apoi folosește UseParticleFxAssetNextCall înainte de StartParticleFxLoopedAtCoord.