見出し画像

[How to make a world: Extra vol.1] What should I do now? Troubleshooting 101

Here, we will explain troubleshooting for those who are reading the tutorial, or are in the middle of installing or upgrading the SDK, and have encountered situations such as Unity not working, build and upload not working.


1. A checklist for those who want to clear quickly

Please check the following items in order.

1. Clear the Unity project and browser cache
2. Check if you are logged in with Unity and the browser
3. Restart Unity and the computer
4. The path and file name do not contain spaces or double-byte characters such as Japanese character.
5. Reinstall VketCloudSDK and Unity version
6. Recreate and port the project

2. If things don't go your way, please contact us

If you can't solve the problem after going through the checklist above, please come and discuss it on Discord!

Welcome to the Discord community!

It is accepted on the Discord "❓-質問-question" channel.
At this time, if you can ask a question with the following information, we will get closer to the solution.

・Did you come here after reading this Note article?
・If you are reading the tutorial article, what stage did the problem occur?
・SDK and Unity version where the problem occurred
・Web browser and version you are using
・Trouble what I tried to solve

Moving on, we will explain the most common causes and solutions when problems occur.

3. Clear Unity project and browser cache

If something goes wrong with your browser and project, clearing the cache may solve the problem.

Clear cache on Unity side

In the SDK, the built world data is put in a dedicated folder named Release.
You can check the contents of the folder from the following.

Select Tools→Open Release Folder
Contents of Release folder

If old build data remains in this folder, it may cause the world to malfunction. In that case, clear the cache and reset the contents of the Release folder to resolve it.

Select Clear Cache
"Are you sure you want to clear the cache?" confirmation window

A window will appear asking "Is it okay to delete the contents of the release folder?" If there is no problem, click "Accept".
Clearing the cache is now complete.
You can also set the cache clear every time you build from the following tabs.

Set Build Option→Auto Clear Cache to clear cache before every build

Clear cache on browser side

If an error occurs during build or the function does not work in the world after building, clearing the browser cache may improve it.

As an example, in the case of Chrome, it can be deleted from the following.

Delete cache via "Clear Browsing Data"

Check out Google's Troubleshooting for more info:

*The procedure for clearing the cache differs depending on the browser you are using.
Vket Cloud supports world operations in web browsers on PC/smartphones such as Chrome, Firefox, Safari, Edge, etc.

4. Check if you are logged in with a browser

browser login confirmation

When uploading the world, if you are not logged in to your Vket Cloud account from the default browser, you may experience problems.
The problem may be resolved by logging into your account from the top page of Vket Cloud and uploading again from Unity.

Carry over from beta account

If you are using the beta version of Vket Cloud, even if you have an account on the top page above, the "Go to My Page" button will not be displayed when you log in, and Unity will also behave abnormally. There are cases.
In that case, log out once and use your VketAccount to resolve it by newly registering from the top page of Vket Cloud.

The account registration method has changed significantly since the beta version, so the following article will be helpful.

Login confirmation on the Unity side

If the world upload does not work or the behavior when starting the project is strange, it is possible that you are not logged in to your Vket Cloud account on the Unity side.
You can check if you are logged in from the popup below.

If you select Account, the currently logged in user will be displayed

If you are not logged in, please restart the Unity project once and log in.
If the following window appears when Unity starts up, you have successfully logged in.

Window on successful login

When logging in, we use DeepLink to move from the web browser to Unity. Therefore, the following pop-up will appear asking "Do you want to open Unity Editor?", but you can click "Open Unity Editor".

Popup by DeepLink

Depending on your environment, the pop-up may not appear normally, or it may not work due to firewall or security software settings, so please review the settings in that case.

5. Check that the path and file name do not contain spaces or double-byte characters such as Japanese character.

The build may fail if the Unity path (folder) and file name contain spaces or double-byte characters such as Japanese.

Files with names containing Japanese characters, full-width spaces, etc.

In this case, changing the name may improve the situation.

Also, the Unity project name and the path name containing the Unity project are prone to errors if they contain double-byte characters.
The use of double-byte characters in names is basically deprecated.

It is safer not to put double-byte characters (Japanese) in the project name and path

6. Restart Unity and review build settings

Unity restart

After upgrading the SDK, the script may not start or the SDK Control Panel may not start unless you restart.

Immediately after installing the SDK, the display may look like this

If the situation like the image above occurs, save the scene and restart the Unity project.

Review build settings

When installing or restarting the SDK, in rare cases the build settings may not be set automatically, causing build problems.
Please check the following settings.

7. Reinstall the SDK, port the project, and reinstall Unity

If the above method does not fix the problem, you may be able to avoid the problem by creating a new project for world creation and moving the contents of the old project.
When moving the contents, we strongly recommend that you take a backup just in case.

Also, at the time of writing the article, the recommended version of Unity is Unity 2019.4.31f1 . If you use a version other than this, operation cannot be guaranteed, so we recommend restructuring the project.

Lastly

Vket Cloud's Discord community not only accepts questions about production, but also has a place for users to interact with each other, such as seeing what they have made, and holds study sessions for world production beginners.
If none of the above fixes have fixed your problem, feel free to ask us a question through the image link below!