Checkerboard Textures: Difference between revisions

From Resonite Wiki
add alt text to images
cleanup + redo headings
Line 1: Line 1:
<!--T:1-->
If you're running Resonite and seeing that all textures or assets in the world are checkerboard like the picture below:
If you're running Resonite and seeing that all textures or assets in the world are checkerboard like the picture below:


<!--T:2-->[[File:Null Texture.jpg|center|thumb|367x367px|alt=Grey and black checkerboard]]
[[File:Null Texture.jpg|center|thumb|367x367px|alt=Grey and black checkerboard]]


= Troubleshooting Steps = <!--T:3-->
== Troubleshooting Steps ==
Before trying these steps, please do not delete any local files, as that can break things more.
Before trying these steps, please do not delete any local files, as that can break things more.


<!--T:13-->
When following these steps, each time you try restarting Resonite, ensure you are waiting a few minutes to see if stuff will actually load.  
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 == <!--T:4-->
=== Quick Steps ===
# Try restarting Resonite
# Try restarting Resonite
# Try restarting your computer and then running Resonite again
# Try restarting your computer and then running Resonite again
Line 16: Line 14:
# Try running Resonite again
# Try running Resonite again


== Database Repair == <!--T:14-->
=== 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.
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 <code>-RepairDatabase</code> to your [[Command Line Arguments]].
To attempt to fix this, you can temporarily add <code>-RepairDatabase</code> to your [[Command Line Arguments]].
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
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


== Computer Settings == <!--T:5-->
=== Computer Settings ===
=== Drives ===
==== Drives ====
# Verify That your main computer drive(usually C:) has enough free space
# Verify That your main computer drive(usually C:) has enough free space


=== Internet Settings === <!--T:6-->
==== Internet Settings ====
# Go to your Windows Settings
# Go to your Windows Settings
# Select Network & Internet, Proxy  
# Select Network & Internet, Proxy  
Line 33: Line 31:
# Try running Resonite again
# Try running Resonite again


=== Disabling IPV6 === <!--T:7-->
==== Disabling IPV6 ==== <!-- Doing that is completely useless but if I remove this step, people are gonna scream at me - j4 -->
* For Windows 10:
* For Windows 10:
** Go to Windows Settings
** Go to Windows Settings
Line 52: Line 50:
** Click OK
** Click OK


<!--T:8-->
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.
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.


<!--T:12-->
If this IPv6 step did not work for you, please revert your changes.
If this IPv6 step did not work for you, please revert your changes.


== Final Steps == <!--T:9-->
==== Final Steps ====
If you're still having trouble, these additional steps may help.  
If you're still having trouble, these additional steps may help.  
* Follow the steps on our [[Database repair]] guide.
* Follow the steps on our [[Database repair]] guide.
* [[Clear your Cache|Clearing your cache]]
* [[Clear your Cache|Clearing your cache]]


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

Revision as of 21:17, 13 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. Note: 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