Checkerboard Textures: Difference between revisions

From Resonite Wiki
cleanup + redo headings
Marked this version for translation
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
If you're running Resonite and seeing that all textures or assets in the world are checkerboard like the picture below:
<languages/>


[[File:Null Texture.jpg|center|thumb|367x367px|alt=Grey and black checkerboard]]
<translate><!--T:1--> If you're running Resonite and seeing that all textures or assets in the world are checkerboard like the picture below:</translate>


== Troubleshooting Steps ==
[[File:Null Texture.jpg|center|thumb|367x367px|alt=<translate><!--T:2--> Grey and black checkerboard</translate>]]
Before trying these steps, please do not delete any local files, as that can break things more.


When following these steps, each time you try restarting Resonite, ensure you are waiting a few minutes to see if stuff will actually load.  
== <translate><!--T:3--> Troubleshooting Steps</translate> ==
<translate><!--T:4--> Before trying these steps, please do not delete any local files, as that can break things more.</translate>


=== Quick Steps ===
<translate><!--T:5--> When following these steps, each time you try restarting Resonite, ensure you are waiting a few minutes to see if stuff will actually load.</translate>
# Try restarting Resonite
# Try restarting your computer and then running Resonite again
# Try [[ Synchronize your Clock|Synchronizing your Clock]]
# Try running Resonite again


=== Database Repair ===
=== <translate><!--T:6--> Quick Steps</translate> ===
Sometimes the local database can corrupt, resulting in checkerboard textures. This can manifest as checkerboard textures for world objects, menus, selection lasers, and skyboxes. Resonite files failing local validation repeatedly may also be a symptom of this problem.
# <translate><!--T:7--> Try restarting Resonite</translate>
To attempt to fix this, you can temporarily add <code>-RepairDatabase</code> to your [[Command Line Arguments]].
# <translate><!--T:8--> Try restarting your computer and then running Resonite again</translate>
Note: If you uninstall then reinstall Resonite, then by default the database is not deleted and may need to be repaired with the <code>-RepairDatabase</code> command line argument even after a reinstallation
# <translate><!--T:9--> Try [[ Synchronize your Clock|Synchronizing your Clock]]</translate>
# <translate><!--T:10--> Try running Resonite again</translate>


=== Computer Settings ===
=== <translate><!--T:11--> Database Repair</translate> ===
==== Drives ====
<translate><!--T:12--> Sometimes the local database can corrupt, resulting in checkerboard textures. This can manifest as checkerboard textures for world objects, menus, selection lasers, and skyboxes. Resonite files failing local validation repeatedly may also be a symptom of this problem.</translate>
# Verify That your main computer drive(usually C:) has enough free space
<translate><!--T:13--> To attempt to fix this, you can temporarily add <code>-RepairDatabase</code> to your [[Command Line Arguments]].</translate>
<translate><!--T:14--> If you uninstall then reinstall Resonite, then by default the database is not deleted and may need to be repaired with the <code>-RepairDatabase</code> command line argument even after a reinstallation</translate>


==== Internet Settings ====
=== <translate><!--T:15--> Computer Settings</translate> ===
# Go to your Windows Settings
==== <translate><!--T:16--> Drives</translate> ====
# Select Network & Internet, Proxy
# <translate><!--T:17--> Verify That your main computer drive(usually C:) has enough free space</translate>
# Verify that all proxy settings are disabled.
# Double check that you don't have an anti-virus, firewall etc that's blocking Resonite
# If you're running a VPN please disconnect it
# Try running Resonite again


==== Disabling IPV6 ==== <!-- Doing that is completely useless but if I remove this step, people are gonna scream at me - j4 -->
==== <translate><!--T:18--> Internet Settings</translate> ====
* For Windows 10:
# <translate><!--T:19--> Go to your Windows Settings</translate>
** Go to Windows Settings
# <translate><!--T:20--> Select Network & Internet, Proxy</translate>
** Go to Network & Internet
# <translate><!--T:21--> Verify that all proxy settings are disabled.</translate>
** Click "Change Adapter Options"
# <translate><!--T:22--> Double check that you don't have an anti-virus, firewall etc that's blocking Resonite</translate>
** Double click on the ethernet or wifi that you are using
# <translate><!--T:23--> If you're running a VPN please disconnect it</translate>
** Click properties
# <translate><!--T:24--> Try running Resonite again</translate>
** Scroll down until you see "Internet Protocol Version 6 (TCP/IPv6)" and turn it off.
** Click OK
* Windows 11:
** Go to Windows Settings
** Click Network & Internet
** Click Advanced Network Settings
** Click "More network adapter options" (A new window will pop up)
** Double click on the ethernet or wifi you are using
** Click properties
** Scroll down until you see "Internet Protocol Version 6 (TCP/IPv6)" and turn it off.
** Click OK


Keep in mind other programs might complain that this is off. Or some internet features in the future might not work at all without this on. Resonite has an item on its roadmap/issue list to support IPV6 Later.
==== <translate><!--T:25--> Disabling IPV6</translate> ==== <!-- Doing that is completely useless but if I remove this step, people are gonna scream at me - j4 -->
* <translate><!--T:26--> For Windows 10:</translate>
** <translate><!--T:27--> Go to Windows Settings</translate>
** <translate><!--T:28--> Go to Network & Internet</translate>
** <translate><!--T:29--> Click "Change Adapter Options"</translate>
** <translate><!--T:30--> Double click on the ethernet or wifi that you are using</translate>
** <translate><!--T:31--> Click properties</translate>
** <translate><!--T:32--> Scroll down until you see "Internet Protocol Version 6 (TCP/IPv6)" and turn it off.</translate>
** <translate><!--T:33--> Click OK</translate>
* <translate><!--T:34--> Windows 11:</translate>
** <translate><!--T:35--> Go to Windows Settings</translate>
** <translate><!--T:36--> Click Network & Internet</translate>
** <translate><!--T:37--> Click Advanced Network Settings</translate>
** <translate><!--T:38--> Click "More network adapter options" (A new window will pop up)</translate>
** <translate><!--T:39--> Double click on the ethernet or wifi you are using</translate>
** <translate><!--T:40--> Click properties</translate>
** <translate><!--T:41--> Scroll down until you see "Internet Protocol Version 6 (TCP/IPv6)" and turn it off.</translate>
** <translate><!--T:42--> Click OK</translate>


If this IPv6 step did not work for you, please revert your changes.
<translate><!--T:43--> Keep in mind other programs might complain that this is off. Or some internet features in the future might not work at all without this on. Resonite has an item on its roadmap/issue list to support IPV6 Later.</translate>


==== Final Steps ====
<translate><!--T:44--> If this IPv6 step did not work for you, please revert your changes.</translate>
If you're still having trouble, these additional steps may help.  
 
* Follow the steps on our [[Database repair]] guide.
==== <translate><!--T:45--> Final Steps</translate> ====
* [[Clear your Cache|Clearing your cache]]
<translate><!--T:46--> If you're still having trouble, these additional steps may help.</translate>
* <translate><!--T:47--> Follow the steps on our [[Database repair]] guide.</translate>
* <translate><!--T:48--> [[Clear your Cache|Clearing your cache]]</translate>
 
=== <translate><!--T:49--> How to get further help</translate> ===
<translate><!--T:50--> If you're still having an issue after trying all of these steps then:</translate>
# <translate><!--T:51--> Collect your latest set of [[Log Files]]</translate>
# <translate><!--T:52--> Ask on our [https://discord.com/invite/resonite discord] ensuring that you include these log files</translate>


=== How to get further help ===
If you're still having an issue after trying all of these steps then:
# Collect your latest set of [[Log Files]]
# Ask on our [https://discord.com/invite/resonite discord] ensuring that you include these log files
[[Category:Troubleshooting]]
[[Category:Troubleshooting]]

Latest revision as of 21:41, 26 January 2024

If you're running Resonite and seeing that all textures or assets in the world are checkerboard like the picture below:

Grey and black checkerboard

Troubleshooting Steps

Before trying these steps, please do not delete any local files, as that can break things more.

When following these steps, each time you try restarting Resonite, ensure you are waiting a few minutes to see if stuff will actually load.

Quick Steps

  1. Try restarting Resonite
  2. Try restarting your computer and then running Resonite again
  3. Try Synchronizing your Clock
  4. Try running Resonite again

Database Repair

Sometimes the local database can corrupt, resulting in checkerboard textures. This can manifest as checkerboard textures for world objects, menus, selection lasers, and skyboxes. Resonite files failing local validation repeatedly may also be a symptom of this problem. To attempt to fix this, you can temporarily add -RepairDatabase to your Command Line Arguments. If you uninstall then reinstall Resonite, then by default the database is not deleted and may need to be repaired with the -RepairDatabase command line argument even after a reinstallation

Computer Settings

Drives

  1. Verify That your main computer drive(usually C:) has enough free space

Internet Settings

  1. Go to your Windows Settings
  2. Select Network & Internet, Proxy
  3. Verify that all proxy settings are disabled.
  4. Double check that you don't have an anti-virus, firewall etc that's blocking Resonite
  5. If you're running a VPN please disconnect it
  6. Try running Resonite again

Disabling IPV6

  • For Windows 10:
    • Go to Windows Settings
    • Go to Network & Internet
    • Click "Change Adapter Options"
    • Double click on the ethernet or wifi that you are using
    • Click properties
    • Scroll down until you see "Internet Protocol Version 6 (TCP/IPv6)" and turn it off.
    • Click OK
  • Windows 11:
    • Go to Windows Settings
    • Click Network & Internet
    • Click Advanced Network Settings
    • Click "More network adapter options" (A new window will pop up)
    • Double click on the ethernet or wifi you are using
    • Click properties
    • Scroll down until you see "Internet Protocol Version 6 (TCP/IPv6)" and turn it off.
    • Click OK

Keep in mind other programs might complain that this is off. Or some internet features in the future might not work at all without this on. Resonite has an item on its roadmap/issue list to support IPV6 Later.

If this IPv6 step did not work for you, please revert your changes.

Final Steps

If you're still having trouble, these additional steps may help.

How to get further help

If you're still having an issue after trying all of these steps then:

  1. Collect your latest set of Log Files
  2. Ask on our discord ensuring that you include these log files