Frequently Asked Questions
Quick answers to common questions about the Gamecraft Agent and Unity development workflows.
Getting Started
What is Gamecraft Agent?
Gamecraft Agent is an AI-powered coding assistant specifically designed for Unity game development. It provides intelligent code generation, Unity-specific guidance, and seamless integration with Unity projects through advanced features like bi-directional compilation and tilde file synchronization.
Do I need an API key to use Gamecraft Agent?
No, Gamecraft Agent provides API access to built-in large language models without requiring you to enter an API key. Join the Discord to get beta access to the agent.
How do I get started with my first task?
Check out the Your First Task guide for a step-by-step walkthrough of creating and completing your first development task with Gamecraft.
Unity Integration
What are tilde files and why should I use them?
Tilde files (.unity~) are Unity-compatible text files that sync automatically with your C# scripts. They enable seamless collaboration between the AI and Unity's development environment. Learn more in our Unity Tilde Files documentation.
Does Gamecraft work with all Unity versions?
Gamecraft is designed to work with modern Unity versions. It has built-in knowledge of Unity's APIs and best practices, with special optimizations for Unity 2022.3 LTS and newer versions.
Can I use Gamecraft with existing Unity projects?
Absolutely! Gamecraft can analyze and work with existing codebases. It automatically understands your project structure and adapts its suggestions to match your existing patterns and architecture.
Features and Functionality
How does bi-directional compilation work?
Bi-directional compilation automatically synchronizes changes between your Unity C# scripts and tilde files. When you edit either file, the changes are reflected in both, ensuring your codebase stays consistent. See Bi-Directional Unity Compilation for details.
What are Code Actions and how do I use them?
Code Actions provide instant AI assistance through Visual Studio Code's lightbulb system. Right-click on code or use the lightbulb icon to access features like code explanation, improvement suggestions, and error fixing. Learn more in Code Actions.
How do I optimize my prompts for better results?
Check our Prompt Engineering Guide for comprehensive strategies on crafting effective prompts that leverage Gamecraft Agent's Unity expertise.
Context and Performance
What is context and why does it matter?
Context refers to the information the AI can "see" and remember during your conversation. Understanding context helps you optimize performance and get better results. Read our Understanding Context guide for detailed information.
How can I avoid context poisoning?
Context poisoning occurs when incorrect information contaminates the AI's understanding. Our Context Poisoning guide explains how to identify, prevent, and recover from context contamination.
Why is my task running slowly?
Slow performance can result from context overload, large file operations, or network limitations. Check your context usage in the UI and consider breaking large tasks into smaller chunks.
Team Collaboration
How do teams work together with the Gamecraft Agent?
Teams can establish coding standards through custom prompts and use checkpoints to review and approve AI-generated changes collaboratively.
Troubleshooting
The Gamecraft Agent isn't responding. What should I check?
Check your internet connection
Ensure you have sufficient API credits/quota
Try refreshing the Gamecraft window
Check the Gamecraft output panel for error messages
My Unity scripts aren't syncing with tilde files. What's wrong?
Ensure both files are in the same directory
Check that file names match (except for the
.unity~extension)Verify Unity isn't blocking file modifications
Restart Gamecraft and Unity if synchronization appears stuck
How do I reset my configuration if something goes wrong?
Use the Reset Settings button in the Gamecraft Agent settings to return to default configuration. Warning: This permanently deletes all non-defaut settings
Advanced Usage
Can I customize the AI's behavior for my project?
Yes! You can create project-specific instructions to tailor the Gamecraft Agent's responses to your needs. See Custom Instructions for details.
Does the Gamecraft Agent support other programming languages besides C#?
While optimized for Unity and C#, the Gamecraft Agent can assist with other languages commonly used in game development, including JavaScript, Typescript, Python, C, C++, shader languages, and more.
How do I provide feedback or report issues?
Use the feedback mechanisms within the extension or contact the development team through the official support channels. Include specific details about your Unity version, project setup, and the issue you're experiencing.
Need More Help?
If your question isn't answered here, check our comprehensive documentation:
Gamecraft Agent Overview - Complete feature overview
Your First Task - Getting started guide
If you still cannot find the answer to your question, for technical support, or feature requests, reach out on our Discord.
Last updated