Installation Guide

This guide will walk you through installing Gamecraft and getting your development environment ready for Unity game development with AI assistance.

System Requirements

Minimum Requirements

  • Operating System: Windows 10/11 (64-bit) or macOS (Intel or Apple Silicon)

  • Memory: 4 GB RAM (8 GB recommended)

  • Storage: 2 GB available disk space (more recommended)

Installation Steps

Step 1: Download Gamecraft

  1. Visit the official Gamecraft website: https://gamecraft.ai

  2. Click the "Download" button

  3. Select your operating system:

    • Windows: Download the .exe installer

    • macOS (Intel): Download the Intel-based .dmg file

    • macOS (Apple Silicon): Download the Apple Silicon .dmg file

Step 2: Install the IDE

Windows Installation

  1. Run the downloaded .exe installer

  2. Follow the installation wizard:

    • Accept the license agreement

    • Choose installation directory (default recommended)

  3. Click "Install" and wait for the process to complete

  4. Launch Gamecraft from the Start Menu or desktop shortcut

macOS Installation

  1. Open the downloaded .dmg file

  2. Drag the Gamecraft application to your Applications folder

  3. Open Applications and double-click Gamecraft

  4. If prompted about security, go to System Preferences > Security & Privacy and click "Open Anyway"

Step 3: Request Beta Access

Gamecraft is currently in Beta. There are currently two ways to get access:

  1. Join the waitlist on the website. Then follow the instructions below:

    1. Join our Discord server: https://discord.gg/gamecraft

    2. Navigate to the #introductions channel

    3. Follow the instructions to request access:

      • Introduce yourself and your game development background

      • Explain what type of project you're working on

      • Share your Unity experience level

    4. Wait for approval - our team reviews requests regularly and will notify you via Discord

    Note: Beta access is typically granted within 24-48 hours for active developers. Having an existing Unity project or portfolio can expedite the approval process.

  2. Purchase Credits: Pay for model-use credits (at-cost from provider's APIs) to skip the line.

    1. After purchasing credits you will immediately be granted access to the beta. The credits you purchase will be used up at-cost as you make requests to AI models within the Gamecraft application.

Step 4: Unity Setup (if needed)

If you don't already have Unity installed, you'll need to set it up:

Install Unity Hub

  1. Visit https://unity.com/download

  2. Download and install Unity Hub for your operating system

  3. Sign in with your Unity account (create one if needed)

Install Unity Editor

  1. Open Unity Hub

  2. Go to the "Installs" tab

  3. Click "Add" and select a Unity version:

    • Recommended: Latest LTS (Long Term Support) version

    • Minimum: Unity 2021.3 LTS or later

  4. Select additional modules:

    • Visual Studio Code - necessary for C# Intellisense support

    • Platform build support (iOS, Android, WebGL, etc.) if needed

  5. Click "Install" and wait for completion

Create or Open a Unity Project

  1. In Unity Hub, go to the "Projects" tab

  2. Either:

    • Click "New project" to create a fresh project

    • Click "Add" to open an existing project folder

  3. For new projects, choose a template that matches your game type:

    • Universal 2D for getting started with 2D games

    • Universal 3D for getting started with 3D games

Note: The Unity Learn platform is full of courses and tutorials for getting started with Unity game development

First Launch

Initial Setup

  1. Launch Gamecraft from your applications

  2. Sign in with your approved Beta account when prompted

  3. Select your Unity project folder when asked

  4. Install the necessary Gamecraft plugin when prompted

Note: The Gamecraft plugin installation improves the IDE experience by adding C# Intellisense support and setting up the Gamecraft Unity package. The Gamecraft Unity package automatically compiles Unity scenes, prefabs, and other assets to Gamecraft's proprietary text-based language for optimal AI integration.

Verify Installation

  1. Open a C# script in your Unity project

  2. Access the AI Agent in the right-hand sidebar

  3. Test the AI with a simple request like: "Help me understand this script"

If the AI responds successfully, your installation is complete!

Troubleshooting

Common Issues

"Beta Access Required" Error

  • Cause: Your account hasn't been approved for Beta access yet

  • Solution: Check your Discord for approval notification, or request access in the #beta-access channel

No Unity projects found

  • Cause: Gamecraft can't find or access your Unity project

  • Solution:

    1. Ensure Unity Hub is installed and your project opens correctly in Unity

    2. Open Gamecraft and use "File > Open Folder" to select your Unity project root directory

    3. Make sure the folder contains Assets/, ProjectSettings/, and other required Unity folders

Unsupported Workspace

  • Cause: Gamecraft can't find your Unity project in the current folder

  • Solution:

    1. Open Gamecraft and use "File > Open Folder" to select your Unity project root directory

    2. Make sure the folder contains Assets/, ProjectSettings/, and other required Unity folders

AI Agent Not Responding

  • Cause: Network connectivity or authentication issues

  • Solution:

    1. Check your internet connection

    2. Restart Gamecraft

    3. Re-authenticate if prompted

    4. Contact support in Discord if issues persist

Performance Issues

  • Cause: Insufficient system resources

  • Solution:

    1. Close unnecessary applications

    2. Increase virtual memory/swap space

    3. Consider upgrading RAM if consistently running low on memory

Getting Help

If you encounter issues not covered here:

  1. Check our Discord #support channel for community help

  2. Search existing discussions - someone may have solved your issue

  3. Contact our team directly in Discord for technical support

  4. Provide details when asking for help:

    • Your operating system and version

    • Gamecraft version

    • Unity version

    • Error messages or screenshots

    • Steps to reproduce the issue

Next Steps

Once installation is complete, continue with the Project Setup Guide to configure your Unity project for optimal AI assistance.

Welcome to Gamecraft! Your AI-powered Unity development journey starts now. 🚀

PreviousGamecraft OverviewNextProject Setup Guide

Last updated