Collaboration

There are several considerations when collaborating on complex scenes with other people. We will go over some generic, as well as polygoniq addon specific, topics.

Blender Versions

It will save you a lot of headaches if you all use exactly the same version of Blender. Same version number, same build, same branch. If possible use exactly the same installer or portable ZIP.

Verify which version you are using

The version you are using is displayed on the splash screen when Blender starts and in the bottom right corner of the main Window.

Blender versions are "backward compatible". If you save in Blender 2.93, you will be able to open the .blend file in Blender 3.0. If you save in Blender 3.0 and then try to open in an older version, you may run into trouble. You could be using a datablock or just a field of it that is not supported in the older version. In a best-case scenario you will get something that is noticeable, like "Undefined Shader Nodes". Worst case your Blender crashes immediately when loading the .blend or randomly while having the .blend open. tl;dr: If you value your time do not mix Blender versions on the same project. The headaches are not worth it.

Operating System (if possible)

We heavily recommend using the same OS if you are cooperating on a project. Operating Systems have subtle differences that can bite you. For example paths are case insensitive on Windows (texture.jpg and Texture.jpg are the same file), can be case sensitive on OSX (those two would be different files!) and definitely are case sensitive on Linux.

Use correct path cases even on Windows

Use correctly cased paths even if you do not have to. That way you will not run into issues when sending your render to a render farm. It can vary but most render farms will use Linux which is a case sensitive operating system.

Paths

Most addons including aquatiq use asset linking. When you spawn assets, the mesh data will be linked from another .blend file and your scene will remember the path to it. If you collaborate on that file with others and they have the addons in various places the filepaths will not match and you will get missing textures and missing blends. In aquatiq you can fix this by clicking "Find missing files", saving the file and reverting. But it is really annoying to have to click this every time you open the file. By clicking it you are fixing the paths for yourself but breaking it for your colleagues.

If you are using the same operating systems you can achieve consistent paths with the custom path method in installation documentation.

File Sharing

Close co-location and Samba or NFS are superior to most cloud file sharing solutions but not a viable option for all organizations.

You can use Google Drive, Microsoft OneDrive, Dropbox or a similar solution to share files. We recommend turning on Blender's file compression to minimize file sizes.

Do not use a shared folder for addon installation

Using cloud file sharing for installing addons is usually a bad idea. These services are not 100% reliable, you will run into issues that can be avoided by having the addons installed locally.