Asset GUIDs

Started by solwllms · one month ago · 12 replies · 1,427 views

solwllms
Facepunch
JoinedJul 2022 Posts1 Score1,625
We're giving assets a stable GUID, and moving to use these for references instead of relying on paths. The goal is to let you freely move and rename the assets in your project without breaking existing references. This is a lot like how Unity and Godot do it. 

As part of this, every asset in your project will now get a .meta file alongside it, e.g. citizen.vmdl.meta. A lot of asset types already had one of these, but now they each carry a per-asset GUID. It's important you include these in your source control. If you don't, everyone on your repo will end up with different GUIDs for the same asset, and that's not what you want. 

The first part is live now on staging, but doesn't cover everywhere a resource can be referenced yet. The Scene system, Prefabs, and GameResources in general are furthest along. References from Valve's formats (such as .vmaps, .vmdls, .vmats, etc) are still to-do.

We'll keep expanding support until it's complete. Just don't go restructuring your whole project just yet. 

As always, if you have any issues, please report them on GitHub. Shout questions here or at me on discord. 

Cheers x 

ceitine
Member
JoinedMay 2021 Posts37 Score1,410
sol be like: i'm gonna be awesome and cool
matt
Facepunch
JoinedApr 2021 Posts273 Score2,450
Daryl Winters
Member
JoinedMay 2021 Posts38 Score2,080
When I close and re-open my project I have +3400 .meta files with GUID re-generating. I though GUID would only be generated once :')

SuperCoolNinja
Member
JoinedJan 2023 Posts8 Score1,290
                                                                                                                   https://klipy.com/gifs/sol-fox-3
LVJohnFreeman
Member
JoinedJul 2023 Posts2 Score1,730
When I close and re-open my project I have +3400 .meta files with GUID re-generating. I though GUID would only be generated once :') image.png 93.05 KB
Damn this needs to be looked at, because pushing this all the time is not a realistic ask when working with a team
Titanovsky
Member
JoinedSep 2021 Posts351 Score5,088
yeah
ダークフェイト
Member
JoinedSep 2021 Posts19 Score375
 Good 
Jammie
Member
JoinedOct 2021 Posts17 Score5,555
It seems like orphaned _c files can still create a .meta file at the moment.
TheDimin
Member
JoinedJul 2022 Posts22 Score5,310
When could we expect this to be on the main branch ?
I been working on staging and it seems people that try to play my build on main fail to load any component/resource now.. make sense, just wonder if it would land wednesday, or if I should revert make project to pre-guid.


matt
Facepunch
JoinedApr 2021 Posts273 Score2,450
Tomorrow
Skylor Beck
Member
JoinedJan 2023 Posts16 Score3,307
Oh this kicks ass. I just ran into this very issue in my entry for the jam. I renamed a file and broke the entire game. Had to rebuild a ton of prefab connections.
barry
Member
JoinedAug 2024 Posts4 Score1,105
Great addition thank you. Now please make the sausage people less judgy x
people
Log in to reply
You can't reply if you're not logged in. That would be crazy.