Project Setup Guide

After installing Gamecraft, you'll need to configure your Unity project to work seamlessly with the AI-powered development environment.

This guide will walk you through the essential setup steps to enable full C# IntelliSense and ensure scripts open in Gamecraft by default.

Prerequisites

Before starting, make sure you have:

• ✅ Gamecraft installed - See our Installation Guide

• ✅ Beta access approved - You should be able to launch Gamecraft without errors

• ✅ Unity project ready - Open an existing Unity project within Unity and Gamecraft

Setup Process

Step 1: Install the Gamecraft Unity Plugin

The Gamecraft Unity Plugin enables deep integration between your Unity project and the AI development environment.

1. Open your Unity project in the Unity Editor

2. Launch Gamecraft and open the same project folder

3. Locate the Onboarding page - This should appear automatically when you first open a project

4. Install the plugin by following the instructions on the Onboarding page

If the Onboarding Page is Closed

If you've accidentally closed the Onboarding page or need to access it again:

1. Open the Command Palette in Gamecraft:

   • Windows: Ctrl+Shift+P

   • Mac: Cmd+Shift+P

2. Type: Gamecraft: Reload Onboarding View

3. Press Enter to reopen the Onboarding page

4. Press the Install Gamecraft Unity Plugin button

   • A popup will open asking you to confirm installation

Step 2: Generate Project Files for IntelliSense

To enable full C# IntelliSense support in Gamecraft, Unity needs to generate the proper project files.

1. In Unity Editor, go to the top menu and select:

   • Windows: Edit > Preferences

   • Mac: Unity > Settings

2. Navigate to External Tools:

   • In the Preferences/Settings window, click on "External Tools" in the left sidebar

3. Set VS Code as External Script Editor:

   • Find the "External Script Editor" dropdown

   • Select "Visual Studio Code" from the list

   • If VS Code isn't listed, you may need to browse for it manually or install it as a package. To install the VS Code package, go to the top menu and open Window > Package Manager, then search for "Visual Studio Code" in the top right search bar. Select "Visual Studio Code Editor" and press "Install" in the top right.

4. Regenerate Project Files:

   • Click the "Regenerate project files" button below the External Script Editor dropdown

   • Wait for Unity to generate the necessary .csproj and .sln files

   • This process may take a few moments depending on your project size

Note: This step is crucial for enabling proper C# IntelliSense, code completion, and error detection in Gamecraft IDE.

Step 3: Set Gamecraft as Default Script Editor

Configure Unity to open C# scripts in Gamecraft by default instead of other editors.

1. Keep the External Tools tab open from Step 2

2. Browse for Gamecraft:

   • Click "Browse" next to the External Script Editor dropdown

   • Navigate to your Gamecraft installation:

Windows

• Browse to your Gamecraft installation directory (usually C:\Program Files\Gamecraft\)

• Select Gamecraft.exe

Mac

• Navigate to your Applications folder

• Select the Gamecraft application

1. Confirm the selection:

   • Click "Open" to set Gamecraft as your external script editor

   • You should see the path to Gamecraft displayed in the External Script Editor field

2. Test the setup:

   • In Unity's Project window, double-click any C# script

   • The script should now open in Gamecraft instead of other editors

Verification

Confirm Everything is Working

1. Double-click a C# script in Unity's Project window

2. Verify the script opens in Gamecraft

3. Check for IntelliSense:

   • Start typing in the script editor

   • You should see code completion suggestions

   • Hover over Unity types (like GameObject, Transform) to see documentation

4. Test AI Integration:

   • With a script open, access the AI Agent

     • Click the Gamecraft tab in the right sidebar, or

     • Use the Command Palette (Cmd/Ctrl + Shift + P) and search for "Gamecraft: Focus on Gamecraft Agent View"

   • Try a simple request like: "Explain what this script does"

   • The AI should understand your Unity context and provide relevant assistance

Troubleshooting

Common Issues

IntelliSense Not Working

• Cause: Project files weren't generated properly

• Solution:

  1. Return to Unity's External Tools settings

  2. Click "Regenerate project files" again

  3. Restart the Gamecraft IDE

  4. Ensure you're opening the project root folder in Gamecraft

Scripts Still Open in Wrong Editor

• Cause: External Script Editor setting didn't save properly

• Solution:

  1. Re-select Gamecraft in Unity's External Tools

  2. Make sure you selected the correct executable/application

  3. Close and reopen Unity if the setting doesn't persist

Gamecraft Plugin Not Found

• Cause: Plugin installation failed or was interrupted

• Solution:

  1. Use the Command Palette: Gamecraft: Reload Onboarding View

  2. Try the plugin installation process again

  3. Check your internet connection

  4. Contact support in Discord if installation continues to fail

Unity Files are Not Compiled to Gamecraft Format (or vice versa)

• Cause: Plugin not properly installed or loaded

• Solution:

  1. Verify the Gamecraft plugin is installed

  2. Ensure the project is open with Unity

  3. If still not working, restart Unity

Getting Help

If you encounter issues during setup:

1. Check Discord #support channel for similar issues

2. Verify all prerequisites are met before troubleshooting

3. Provide specific details when asking for help:

   • Unity version

   • Operating system

   • Error messages or screenshots

   • Which step failed

Next Steps

With your project properly configured, you're ready to experience AI-powered Unity development:

1. Interface Overview - Learn the Gamecraft IDE layout and features

2. Gamecraft Agent Overview - Discover what your AI assistant can do

3. Your First Task - Start your first AI-assisted development session

---

Your Unity project is now supercharged with AI! Time to start building amazing games. 🎮✨