FAQ

FAQ

Issues while deleting/duplicating items

It's really hard to make sure those features work perfectly with the system since it depends on to catch up the GUIDs of the collectables, ALWAYS try to use the Add New / Deleting by the inspector itself

Serialization

For most of the cases, you don't need these objects to be fully serialized when using the references on Save Data and other cases, I recommend taking a look into the fsCollectableScriptableObjectConverter inside the package, this uses FullSerializer to only serialize the necessary data, and rebuild the connection properly when serialize/deserialize the object

Resources Folder

Since the CollectionsRegistry is inside the Resources folder, every reference this has to a collection and to all the collectables will be inside the Unity Resources bundle, and if have a lot of references for expensive stuff, this can decrease your startup time significantly, there's 2 things you should keep in mind:

1. Use the Automatically Loaded items for items that should be available for the lifetime of your game 2.- If you want to use this for more expensive stuff, let's say all the gameplay prefabs, you can uncheck the automatic initialization of this collection, and register the collection on your loading by using CollectionsRegistry.Instance.RegisterCollection(Collection); and removing it when they are not necessary anymore.

Creating new Collection

You can use the Collection Creating Wizzard by right click on the project panel and going into: Assets/Create/Scriptable Object Collection/New Collection this will create 3 items and respective folder: YourCollectionName.cs YourCollectableName.cs and the Collection Scriptable Object

Managing your collection

When your collection it's selected you can Add/Remove items and re-organize their position on the list:

Exposing References to Collectable Items

When you add a reference to a Collectable you may choose how you want this to be displayed, there are two options for now: DropDown / AsReference, reference its exactly what you would expect, the user should assign this reference by selecting inside the project, and the default one DropDown display all the available options in a drop-down:

Static Code Generation File

You can generate a static file that will enable you to access any of your collections by code, for doing that, just click on the Generate Static File on Inspector:

For non automatically loaded items, I suggest using the TryGetAccess static generation type, you can define this on the CollectionRegistry file, this will provide TryGet methods instead of direct access to the collections itself, I think this helps since those objects can be not loaded in memory, so you are more conscious about it.

Dealing with Addressables / AssetBundles

Any addressable asset that has a reference to a scriptableObject, when is bundled a copy of that scriptable object will be created inside of the bundle, so if you are not doing anything fancy with the scriptableObject should be fine, but if you are updating references or anything else, I recommend using the indirect reference. When creating a new Collection by the wizard, make sure you let the Generate Indirect Access toggle on, and when adding references inside the scriptable objects, make sure you use the CollectableIndirectReferece this only store the GUIDs of the target collectable without the actual reference to the object, so avoiding creating a relationship between items and avoiding bundling then together.