Troubleshooting

Common Installation Issues

❌ Qraft Not Loading

Symptoms: Mod doesn’t appear in mod list

Solutions:

1. Check file location: Ensure .jar file is in mods folder
2. Verify version compatibility: Must be 1.20.1+
3. Check mod loader: Use correct Forge/Fabric version
4. Remove conflicting mods: Some mods may conflict
5. Review game logs: Check logs/latest.log for errors

❌ Login Issues

Symptoms: Cannot authenticate with Qraft service

Solutions:

1. Check internet connection: Stable connection required
2. Verify credentials: Ensure correct email/password
3. Account status: Check if account is active
4. Firewall settings: Ensure Minecraft can access internet
5. Try different server: Check Qraft status page

❌ Commands Not Working

Symptoms: /generate commands not recognized

Solutions:

1. Check mod loading: Verify Qraft is loaded
2. Restart Minecraft: Fresh start often helps
3. Check permissions: Ensure you have build permissions
4. World compatibility: Some worlds may have restrictions
5. Update mod: Ensure latest version installed

Building Issues

❌ “No Anchor Set” Error

Problem: Trying to build without anchor point

Solution:

/generate anchor
[Qraft] 🔴 Anchor set successfully
/generate your structure here

❌ Build Not Appearing

Possible Causes & Solutions:

1. Wrong Location:
   • Check anchor placement
   • Ensure sufficient space
2. Server Lag:
   • Wait for processing to complete
   • Check build queue status
3. Insufficient Space:
   • Clear area around anchor
   • Reduce build size in /generateUI
4. Prompt Issues:
   • Simplify description
   • Check character limit
   • Use more specific terms

❌ Partial Build Results

Problem: Structure incomplete or incorrect

Solutions:

1. Use /undo to remove
2. Refine prompt with more specific details
3. Adjust settings in /generateUI
4. Set keypoints for better positioning
5. Try shorter descriptions

Performance Issues

🐌 Slow Build Times

Optimization Steps:

1. Reduce complexity in /generateUI
2. Limit simultaneous builds (use 1-2 instead of 3)
3. Check internet speed
4. Allocate more RAM to Minecraft
5. Close other applications

🖥️ Game Performance

If Minecraft runs slowly with Qraft:

1. Lower render distance

2. Reduce graphics settings

3. Install OptiFine (Forge) or Sodium (Fabric)

4. Increase JVM memory:

   -Xmx6G -Xms3G

5. Update graphics drivers

Network Issues

🌐 Connection Problems

Error Messages:

[Qraft] ❌ Failed to connect to AI service
[Qraft] ❌ Request timeout
[Qraft] ❌ Network error

Solutions:

1. Check internet connection
2. Disable VPN temporarily
3. Configure firewall to allow Minecraft
4. Try different network
5. Check Qraft service status

🔒 Authentication Failures

Common Issues:

• Wrong credentials: Double-check email/password
• Account suspended: Contact Qraft support
• Too many attempts: Wait before retrying
• Email not verified: Check verification email