Documentation
Troubleshooting
Speed up the project preparation
The ranchecking can take a long time due to your scene. When you press ‘Prepare Project’, RANCHecker does:
- Save the original scene
- Check your scene/assets/settings
- Save the ranchecked scene
- Open the log window of the project.
- Pack the project (a zip containing your scene, assets and some files needed by the farm)
- Load the original scene
Thus, if you scene takes time to save/load, it will considerably increase the preparation time. But:
- to lower the saving time, you can use xref files. The main scene will be lighter and will be saved quicker.
- by using the option ‘Do not reload’ in RANCHecker, the original scene (your scene) won’t be reloaded. Keep in mind that if the log contains an error you will have to reload the original scene yourself.
My C drive is full
By default, RANCHecker uses the C drive in order to prepare the project. If your C drive is full, you can simply change the archive directory and the export directory to use another drive in the advanced settings of RANCHecker.
I have black rendered frames
It’s possible the your camera moves through an object (wall, pole, etc.).
The VU3 archive is not generated
If during the preparation by RANCHecker you get a message regarding .Net 3.5, you may need to do the following steps:
- Right-click Start, and click Run
- Type regedit.exe and click OK
- Go to the following registry key: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\WindowsUpdate\AU
- In the right-pane, if the value named UseWUServer exists, set its data to 0
- Exit the Registry Editor
- Restart Windows
- Right-click Start, and click Run
- Type regedit.exe and click OK
- Open CMD.exe and click OK
- Exit CMD
- Type optionalfeatures in CMD and press Enter (it will open the Windows Features window)
- Activate the case named “.NET Framework 3.5” or something similar then press OK
RANCHecker has crashed
You will notice this if there is a popup window during the project preparation.
RANCHecker is written in MAXScript so any crash will add an error log in the MAXScript Listener Window (Press F11 from your keyboard in 3dsmax to open it).
Please send us the full error log contained in this window in order to fix the crash. We can fix most problems within 1-3 hours during our working hours.
I have missing Actors with Anima
Anima may sometimes have errors when it renders on the farm. The AXYZ team is aware of this anomaly and this is why they have added a warning in their documentation.
https://docs45.axyz-design.com/article/sharing-anima-resources-on-a-network/
Speed up the project preparation
The ranchecking can take a long time due to your scene. When you press ‘Prepare Project’, RANCHecker does:
- Save the original scene
- Check your scene/assets/settings
- Save the ranchecked scene
- Open the log window of the project.
- Pack the project (a zip containing your scene, assets and some files needed by the farm)
- Load the original scene
Thus, if you scene takes time to save/load, it will considerably increase the preparation time. But:
- to lower the saving time, you can use xref files. The main scene will be lighter and will be saved quicker.
- by using the option ‘Do not reload’ in RANCHecker, the original scene (your scene) won’t be reloaded. Keep in mind that if the log contains an error you will have to reload the original scene yourself.
My C drive is full
By default, RANCHecker uses the C drive in order to prepare the project. If your C drive is full, you can simply change the archive directory and the export directory to use another drive in the advanced settings of RANCHecker.
I have black rendered frames
It’s possible the your camera moves through an object (wall, pole, etc.).
The VU3 archive is not generated
If during the preparation by RANCHecker you get a message regarding .Net 3.5, you may need to do the following steps:
- Right-click Start, and click Run
- Type regedit.exe and click OK
- Go to the following registry key: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\WindowsUpdate\AU
- In the right-pane, if the value named UseWUServer exists, set its data to 0
- Exit the Registry Editor
- Restart Windows
- Right-click Start, and click Run
- Type regedit.exe and click OK
- Open CMD.exe and click OK
- Exit CMD
- Type optionalfeatures in CMD and press Enter (it will open the Windows Features window)
- Activate the case named “.NET Framework 3.5” or something similar then press OK
RANCHecker has crashed
You will notice this if there is a popup window during the project preparation.
RANCHecker is written in MAXScript so any crash will add an error log in the MAXScript Listener Window (Press F11 from your keyboard in 3dsmax to open it).
Please send us the full error log contained in this window in order to fix the crash. We can fix most problems within 1-3 hours during our working hours.
I have missing Actors with Anima
Anima may sometimes have errors when it renders on the farm. The AXYZ team is aware of this anomaly and this is why they have added a warning in their documentation.
https://docs45.axyz-design.com/article/sharing-anima-resources-on-a-network/