User Tools

Site Tools


en:faq:troubleshooting:troubleshooting_general

General Troubleshooting Guide

novice resident

Common problems and solutions for Caprica Virtual Worlds.

Connection Issues

Can't Connect to Grid

Symptoms: * Viewer gets stuck at “Connecting…” * “Login failed” error * “Could not connect to grid” message

Solutions:

1. Check Internet Connection

  • Verify you're online
  • Try loading a website in your browser
  • Check if other internet applications work

2. Verify Grid URL

3. Check Login Credentials

  • Use “FirstName LastName” format (with space)
  • Don't use “FirstNameLastName” or “FirstName_LastName”
  • Verify password is correct (case-sensitive)
  • Check caps lock

4. Check Firewall

  • Ensure ports 9000, 8002, 8003 are not blocked
  • Add viewer to firewall exceptions
  • Temporarily disable firewall to test

5. Disable VPN/Proxy

  • VPNs can sometimes block connections
  • Disable temporarily to test
  • Configure VPN to allow viewer if needed

6. Update Viewer

  • Download latest version from official site
  • Old versions may have compatibility issues

7. Check Grid Status

  • Visit Caprica website for status updates
  • Check if grid is undergoing maintenance
  • Try again later if grid is down

Login Fails with "Incorrect Password"

Solutions: 1. Check caps lock (passwords are case-sensitive) 2. Ensure correct avatar name format 3. Use “Forgot Password” on registration page 4. Reset password via email 5. Contact support if email access is lost

"Protocol Error" or "Handshake Failed"

Solutions: 1. Update viewer to latest version 2. Check grid URL is correct 3. Disable VPN/proxy 4. Clear viewer cache 5. Reinstall viewer if problem persists

Performance Issues

Viewer is Slow/Laggy

Symptoms: * Low FPS (frames per second) * Choppy movement * Delayed responses * Textures load slowly

Solutions:

1. Lower Graphics Settings

  • Open Preferences (Ctrl+P)
  • Go to Graphics tab
  • Reduce Draw Distance (try 128m or 64m)
  • Disable or lower shadows
  • Reduce particle count
  • Lower terrain and object detail
  • Disable Atmospheric Shaders

2. Close Other Applications

  • Close browser tabs
  • Close other running programs
  • Free up system resources
  • Check Task Manager for high CPU/memory usage

3. Check Network

  • Use wired connection instead of WiFi
  • Check network speed
  • Close other network-intensive applications
  • Restart router if needed

4. Update Graphics Drivers

5. Visit Less Crowded Regions

  • High avatar count affects performance
  • Check region avatar count on map
  • Try quieter regions

6. Clear Cache

  • Preferences → Network → Clear Cache
  • This clears downloaded assets
  • Next login will re-download assets

Viewer Crashes

Symptoms: * Viewer closes unexpectedly * “Viewer has stopped working” error * Random crashes during use

Solutions:

1. Update Graphics Drivers

  • Outdated drivers are a common cause
  • Download latest from manufacturer

2. Lower Graphics Settings

  • High settings can overload GPU
  • Reduce to minimum to test
  • Gradually increase if stable

3. Clear Cache

  • Corrupted cache can cause crashes
  • Preferences → Network → Clear Cache

4. Disable Overlays

  • Discord overlay
  • Steam overlay
  • GeForce Experience overlay
  • Other screen capture software

5. Run as Administrator (Windows)

  • Right-click viewer icon
  • Select “Run as administrator”
  • Helps with permission issues

6. Check for Conflicting Software

  • Antivirus software
  • Firewall software
  • Other virtual world viewers
  • System optimization tools

7. Reinstall Viewer

  • Uninstall completely
  • Download fresh copy
  • Install with default settings

High Memory Usage

Symptoms: * System becomes slow * Viewer uses excessive RAM * Computer becomes unresponsive

Solutions: 1. Lower graphics settings 2. Reduce draw distance 3. Close other applications 4. Restart viewer periodically 5. Restart computer if needed

Display & Graphics Issues

Textures Not Loading / Gray Appearance

Symptoms: * Objects appear gray/blank * Textures missing * Avatar looks like a “newbie” gray cloud

Solutions: 1. Wait for Loading

  • First login takes time
  • Wait 2-3 minutes
  • Check if viewer is still downloading

2. Check Internet Connection

  • Slow connection delays texture loading
  • Ensure stable connection

3. Lower Graphics Settings

  • High settings may overwhelm connection
  • Reduce texture detail

4. Clear Cache

  • Corrupted cache causes issues
  • Preferences → Network → Clear Cache
  • Re-login

5. Re-log

  • Log out and log back in
  • Forces fresh texture download

Graphics Glitches / Artifacts

Symptoms: * Visual glitches * Flashing textures * Strange colors * Geometry errors

Solutions: 1. Update graphics drivers 2. Lower graphics settings 3. Disable shaders 4. Reduce draw distance 5. Check GPU temperature (overheating)

Can't See Other Avatars

Symptoms: * Other avatars appear as gray clouds * Avatars don't render * Only see yourself

Solutions: 1. Disable Avatar Impostors

  • Preferences → Graphics
  • Uncheck “Avatar Impostors”
  • This performance feature causes rendering issues

2. Increase Draw Distance

  • Avatars beyond draw distance don't render
  • Increase to 128m or higher

3. Check Network

  • Slow connection delays avatar downloads
  • Ensure stable connection

4. Re-log

  • Forces fresh avatar data download

Audio Issues

No Sound

Symptoms: * Can't hear anything * Music doesn't play * Voice chat doesn't work

Solutions:

1. Check System Volume

  • Ensure system volume is up
  • Check speaker/headphone connection
  • Test with other applications

2. Check Viewer Audio Settings

  • Preferences → Audio & Voice
  • Ensure volume sliders are up
  • Check correct output device selected
  • Enable “Play Streaming Music When Available”
  • Enable “Enable Voice Chat”

3. Check Region Settings

  • Some regions disable audio
  • Look for audio icons in region info
  • Try a different region

4. Update Audio Drivers

  • Download latest from manufacturer
  • Install and restart

Voice Chat Not Working

Solutions: 1. Enable voice in Preferences → Voice Chat 2. Check microphone is connected 3. Test microphone in OS settings 4. Ensure microphone not muted 5. Check if region allows voice 6. Restart viewer

Movement & Controls Issues

Can't Move Avatar

Symptoms: * Avatar won't walk/fly * Movement keys don't respond * Stuck in place

Solutions: 1. Check if Sitting

  • Press “Stand Up” (Ctrl+Shift+S)
  • Right-click yourself → Stand Up

2. Enable WASD

  • Preferences → Move & View → Movement
  • Check “WASD affects movement”

3. Check Scripted Attachments

  • Some attachments restrict movement
  • Right-click yourself → Detach All
  • Re-attach items one by one

4. Teleport

  • Teleport to different location
  • May be region-specific issue

5. Re-log

  • Log out and back in

Camera Stuck or Glitchy

Solutions: 1. Press Esc to reset camera 2. Zoom in/out with mouse wheel 3. Teleport to different location 4. Re-log 5. Check for conflicting input devices

Chat & Communication Issues

Can't Type in Chat

Solutions: 1. Press Enter to focus chat bar 2. Check if chat is enabled in region 3. Re-log 4. Check keyboard functionality

Can't Hear/See Chat

Solutions: 1. Check chat history window is open 2. Check chat opacity settings 3. Check if muted 4. Re-log

Inventory Issues

Inventory Not Loading

Solutions: 1. Wait longer (large inventories take time) 2. Check internet connection 3. Clear cache 4. Re-log

Can't Find Items in Inventory

Solutions: 1. Use search function in inventory 2. Check correct folder 3. Look in “Lost and Found” folder 4. Check if items were in a folder you deleted

Can't Wear/Use Items

Solutions: 1. Check item permissions 2. Check if item is copyable 3. Right-click → Wear/Add 4. Check if scripts are enabled in region

Region-Specific Issues

Can't Enter Region

Solutions: 1. Check if region is online 2. Check if you have access (age verification, group membership) 3. Check if region is full 4. Try teleporting to adjacent region then walking

Kicked from Region

Solutions: 1. Check region rules 2. Contact region owner 3. Check if you violated community standards 4. Apologize if appropriate

Objects Don't Work in Region

Solutions: 1. Check if scripts are enabled in region 2. Check if objects have permission 3. Re-rez the object 4. Try different region

Account Issues

Forgot Password

Solutions: 1. Use “Forgot Password” on login page 2. Check email for reset link 3. Contact support if email inaccessible

Account Suspended

Solutions: 1. Check email for suspension notice 2. Review community standards 3. Contact support for details 4. Appeal if you believe suspension is wrong

Can't Change Display Name

Solutions: 1. Check if recently changed (cooldown period) 2. Check if name violates naming policy 3. Contact support if system issue

When All Else Fails

Complete Reinstall

If nothing works:

1. Uninstall Viewer

  • Use official uninstaller
  • Delete remaining folders manually

2. Delete Viewer Data

  • Windows: %APPDATA%\[ViewerName]
  • macOS: ~/Library/Application Support/[ViewerName]
  • Linux: ~/.config/[ViewerName]

3. Download Fresh Copy

  • From official website only
  • Don't use third-party downloads

4. Install Fresh

  • Use default settings
  • Add Caprica grid again
  • Test with minimal settings

Contact Support

If you've tried everything:

1. Document the Problem

  • What were you doing when it happened?
  • Error messages (exact text)
  • Steps to reproduce
  • Your system specs

2. Check Known Issues

  • Caprica website status page
  • Viewer release notes
  • Community forums

3. Contact Support

  • Use Caprica website contact form
  • Include all documentation
  • Be patient - response may take time

4. Ask Community

  • Post in forums
  • Ask in-world helpers
  • Check Discord/IRC if available

Prevention Tips

Regular Maintenance: * Keep viewer updated * Keep graphics drivers updated * Clear cache periodically * Restart viewer occasionally * Restart computer weekly

Good Practices: * Don't overload system with other apps * Use stable internet connection * Don't modify viewer files * Back up important landmarks/notecards * Use strong, unique password

Performance: * Adjust settings for your hardware * Visit appropriate regions for your system * Don't run multiple viewers simultaneously * Monitor system resources

* WASD Activation - Movement key issues * Client Selection - Viewer-specific issues * Community Standards - Behavioral issues * FAQ for New Users - Common questions

Still having problems? Don't hesitate to ask for help in the community!

en/faq/troubleshooting/troubleshooting_general.txt · Last modified: 2026/10/04 19:11 (external edit)

Page Tools