Ludo.ai
Ludo.ai
Pricing
Features
Blog
Docs
What's New
Contact

You've got questions? We've got answers!

Explore our comprehensive documentation for in-depth information about Ludo.ai and its powerful features.
API & MCPAudio GeneratorSprite GeneratorVideo GeneratorPlayable Generator3D Asset GeneratorFAQUser Account and SubscriptionProjectImage GeneratorStep-by-Step Game IdeationGame IdeatorAsk Ludo

Project

  • Getting Started with Projects

    The Project tool in Ludo.ai offers multiple ways to begin crafting your game idea. Here are the most common approaches:

    1. Starting from a Generated Idea:

      • Use the Game Ideator or the Idea Pathfinder to generate game concepts.
      • When you find an idea you like, click the "Create Project" button on the idea card.
      • This automatically creates a new Project pre-filled with the generated idea's title, description, art style, perspective, platform, and a starting set of content sections.

    2. Importing a Project from the Homepage:

      • On the Ludo.ai homepage, click the Import Project tile in the showcase gallery to open the import dialog.
      • Choose one of three import sources using the tabs at the top:
        • PDF — drag and drop (or browse to) a PDF of an existing game design document. Ludo will extract the content into a new Project.
        • Text — set the Platform, Art Style, Perspective, and Genres, enter a title and description (up to 1,000 words), and optionally drag and drop reference images. Click Import Project to create the document.
        • Game Search — search for an existing game by title and select it. Ludo will create a Project seeded from that game's information.

    3. Starting from Scratch:

      • Click the purple plus sign (+) in the top menu bar to start a new blank Project.
      • Give your project a title and write a brief description.
      • Use the options at the top to specify your game's style, perspective, genre, and platform. These choices help tailor AI suggestions and refine your project's focus.
      • Add an icon and header image by clicking the placeholders at the top.

    Once your Project is created, you can begin building it out:

    • Hover your mouse in the space between sections to reveal the floating Add Content bar. Use the plus (+) button or click on a suggested section type (like Mechanics, Objectives, etc.) to add new content to your document.

    Your Project is a living document. You can always return to it later to make changes or additions as your idea evolves.

  • Default Content in Project from Generated Idea

    When you choose to create a Project from a Ludo-generated idea, your new document begins a dynamic creation process. You will see a loading bar at the bottom of the screen as Ludo populates the document with several key elements:

    1. Title and Description: The game's title and a brief description are automatically filled in.
    2. Visual Elements: An icon and a header image that capture the essence of the game idea are included.
    3. Game Parameters: Key details like Platform, Art Style, Perspective, and Genres are pre-selected based on the generated idea.
    4. Core Sections: Depending on the idea, initial sections such as Gameplay, Game World, and Art & Mockups are created and filled with AI-generated text and images.

    This pre-populated content serves as a starting point. From here, you can use Ludo's AI-assisted tools to edit, expand, and refine your project further.

  • Adding Content to Your Project

    Expanding your Project is done using the new block-based editor. The primary way to add new content is with the floating Add Content bar.

    1. Hover your mouse in the space between any two sections in your document. A floating bar with a plus (+) button and several common section types (e.g., Mechanics, Objectives, Rules) will appear.
    2. Click the plus (+) button to open the Add New Content modal. Here you can browse all available content types, categorized for convenience (AI Suggestions, Mechanics, Game World, Art & Production, etc.).
    3. Alternatively, click directly on one of the suggested section types on the floating bar (e.g., "Mechanics") to instantly add a new block of that type.
    4. You can add different kinds of content blocks:
      • Content Sections: For detailed descriptions like Mechanics, Storyline, or Playable Characters. These can be generated by AI or written manually.
      • Section Headers: Use these to organize your GDD into larger, collapsible parts (e.g., a header for "Character Design" followed by multiple Playable Character sections).

    This modular approach allows you to structure your document logically and build it piece by piece.

  • Generating and Editing Content

    When you add a new content block (like "Enemies" or "Mechanics"), you are presented with three initial options for how to populate it:

    1. Generate New: This is the primary way to use Ludo's AI. Clicking it opens one of two interfaces:

      • Suggestion Input: A small text box appears. You can leave it blank for general AI suggestions based on your game's context, or you can type a specific prompt (e.g., "a rival surfer who uses technology") to guide the AI.
      • AI Suggestions Sidebar: For more complex content like characters or enemies, a sidebar will open on the right. Ludo will provide multiple, fully-formed options with both text and images. You can browse these suggestions and click "Add to Project" to insert your chosen one into the document.

    2. Edit Manually: This option adds a blank, untitled section to your document. You can then add your own title, text, and media, giving you complete manual control.

    3. Delete Content: If you decide you don't need the new block, simply click this to remove it.

    This workflow provides flexibility, allowing you to choose between AI-driven creation and manual input for every piece of your GDD.

  • Using the Ask Ludo AI Assistance

    The "Ask Ludo" feature is your AI co-pilot, now more powerful and context-aware than ever.

    1. Overall Project Assistance: Use the "Ask Ludo" button in the main header at the top of your document to have a conversation about the entire project. This is great for high-level feedback, brainstorming, or market analysis.

    2. Context-Specific Assistance: Every section and content block in your GDD now has its own Ask Ludo button (a small chat bubble icon).

      • Clicking this button opens the Ludo AI Chat Assistant with the conversation already focused on that specific block of content.
      • For example, if you click "Ask Ludo" on your main character's section, the AI will know you're talking about that character and provide targeted suggestions.
      • When you switch context by clicking "Ask Ludo" on a different section, a "CONTEXT SWITCHED" message will appear in the chat, indicating the AI's focus has shifted.

    This allows you to have highly focused, productive conversations about individual elements of your game without losing the broader context.

  • Adding and Managing Media

    Visuals are now integrated directly into your content sections, offering greater flexibility than a separate gallery.

    1. Adding Media to a Section:

      • Within any content block (like a character, mechanic, or custom section), you can add media. AI-generated sections often come with images automatically.
      • To add more, hover over the media area and click the Add Media button (a square with a plus sign).
      • A menu will appear allowing you to add an Image, Video, 3D Asset, Sprite, or Game.

    2. Generating Media:

      • For each media type, you can choose to Generate. This will open the AI Suggestions sidebar, where you can enter a prompt (e.g., "a futuristic surfboard") to generate new visuals.
      • Ludo will provide several options. Click on one to add it directly to your section.

    3. Managing Multiple Media Items:

      • You can add multiple media items to a single section to create a gallery-like feel.
      • Reorder media within a section by simply clicking and dragging it to a new position.
      • Move media to a different section by dragging it and dropping it into the designated "Drop media here" area of another section.
      • Hover over any media item to access options to zoom, edit, add to favorites, or delete.

  • Using Version History

    The Project tool now automatically saves a history of your changes, allowing you to review and revert to previous versions of your document at any time.

    1. Accessing Version History:

      • Click the Version History icon (a clock with a counter-clockwise arrow) in the header bar at the top right of your screen.
      • A modal window will open, displaying a timeline of all saved edits on the right side. Each entry shows what was changed (e.g., "Updated Enemies," "Added Section") and when.

    2. Previewing and Restoring:

      • Click on any version in the timeline on the right. A read-only preview of how the document looked at that point in time will load in the main part of the window.
      • You can browse through different versions to track the evolution of your ideas.
      • If you want to revert your document to an older state, select the desired version and click the purple "Restore to this version" button.
      • A confirmation will appear, warning you that this action will undo all subsequent changes. Click "Proceed" to restore.

    This feature is invaluable for tracking progress, recovering accidentally deleted content, or exploring different creative directions without fear of losing your work.

  • Refining Your Project

    Game development is an iterative process, and your project should evolve over time:

    1. Return to your saved document whenever you have new ideas or insights.
    2. Regularly use the contextual "Ask Ludo" feature within specific content blocks for targeted suggestions.
    3. Review each section critically, ensuring it's clear, focused, and aligned with your overall vision.
    4. Use the Version History feature to look back at previous ideas or revert changes if a new direction isn't working out.
    5. Consider exporting your project to PDF and sharing it with trusted peers for external feedback.
    6. Don't be afraid to remove or dramatically alter content blocks using the options menu (...) on each block.

    Remember, refining your project is about enhancing your core idea, not completely changing it with every iteration.

  • Personalized Tutorial Generation

    The Tutorial tab, located within your Project interface next to the Edit tab, provides access to an AI-powered feature that generates a personalized, step-by-step development guide based directly on the contents of your Project.

    Accessing and Generating the Guide:

    1. Navigate: Click the Tutorial tab within your opened Project.
    2. Customize (First Generation): Before generating the initial guide, configure the following options:
      • Experience Level: Select either Beginner (providing more detailed explanations and foundational code examples) or Advanced (focusing on optimizations, complex patterns, and assuming prior knowledge). This adjusts the depth and complexity of the instructions.
      • Select Game Engine: Choose from the supported engines: Unity, Unreal, Godot, Roblox, Cocos2d-x, Buildbox, or Solar2D. This selection determines the specific APIs, code syntax, and workflow steps presented in the tutorial.
      • Customize Your Guide (Optional): Enter text to guide the AI on specific areas to focus on (e.g., "focus on the inventory system and AI behavior") or leave blank for a comprehensive tutorial covering all aspects derived from your Project's Edit tab.
    3. Generate: Click the Generate New Development Guide button. The AI analyzes your Project's content (mechanics, features, assets described in the Edit tab) and generates the structured guide based on your selected settings.

    Understanding the Generated Guide:

    • Structure: The tutorial is organized hierarchically into major development Sections (e.g., "Project Setup", "Core Gameplay Mechanics", "UI Implementation"), which contain relevant Topics (e.g., "Player Movement", "Enemy Spawning"), further broken down into specific Steps (e.g., "Create Player Input Script", "Implement Collision Detection").
    • Step Content: Each step provides:
      • A description of the task and its purpose within the game.
      • Detailed, sequential instructions for implementation within the chosen game engine.
      • Illustrative code snippets or pseudo-code relevant to the engine and task. Note: These are starting points and may require adaptation.
      • Potential considerations regarding performance, design, or integration with other systems mentioned in your Project.
    • Navigation: Use the Back to Topics link to return to the topic overview or the Next: [Step Name] → button to proceed sequentially through the steps within a topic.

    Interactive Assistance:

    • Integrated Ask Ludo: Each detailed step page includes an Ask Ludo chat interface at the bottom. This AI assistant is context-aware, understanding the specific step you are viewing and your overall Project. Use it to ask for clarifications, alternative approaches, explanations of code, or troubleshooting advice related to that step.

    Regenerating the Guide:

    • If a guide already exists, the Start New Guide button appears at the top right. Clicking this allows you to re-configure the options (Experience Level, Engine, Focus) and generate a completely new guide.
    • The current guide is automatically saved and easily accessible from the Tutorial tab, so you can generate as many tutorials as you need, focusing on different subjects.
    • It is recommended to regenerate the guide after making significant updates to your Project in the Edit tab to ensure the tutorial reflects the latest design.

    This feature aims to provide a structured, actionable roadmap derived from your specific game design, helping to accelerate the transition from project to development by offering engine-specific, personalized implementation guidance.

  • Exporting and Sharing

    Once you're satisfied with your project, you may want to share it:

    1. Click the "Share" button at the top right of your document.
    2. Choose to export as a PDF file. This creates a professionally formatted document of your entire project.
    3. If you're a Studio subscriber, you have the option to share directly to Slack. To use this feature:
      • Ensure your Slack integration is set up correctly in your Ludo.ai account settings.
      • Select the Slack option when sharing.
      • Choose the appropriate Slack channel or direct message to send your project to.
    4. Use your exported project to:
      • Distribute to team members or stakeholders
      • Import into other game development tools
      • Present your idea to potential publishers or investors

    Remember, your project is a living blueprint. Even after exporting, continue to refine and update it as your game development progresses.

    <br>

  • Troubleshooting

    Here are some common problems and their solutions for the Project interface:

    1. Problem: AI suggestions aren't what I want.
      • Solution: Be more specific. When using the Generate New option, provide a detailed prompt in the input box or the suggestions sidebar. Instead of "enemy," try "a rogue AI drone that shoots ice shards."
    2. Problem: I can't find the "Add Section" button.
      • Solution: The button is part of a floating bar. Simply hover your mouse in the space between any two content blocks, and the bar with the plus (+) button will appear.
    3. Problem: I want to add more images/videos to one section.
      • Solution: Hover over the existing media in a section and click the Add Media button (a square with a plus sign) that appears. You can add as many media items as you need to a single block.
    4. Problem: I want to revert a change I made.
      • Solution: Use the Version History feature by clicking the clock icon in the top-right header. You can preview and restore any previous version of your document.
    5. Problem: I uploaded or generated media for this Project but it doesn't appear in any section.
      • Solution: Check the Asset Vault at the bottom of your Project. Assets you create in other tools (Image Generator, Sprite Generator, 3D Asset Generator, etc.) and save to the Project land here, along with any media you upload directly to the Project without placing it in a section. Drag items out of the vault and drop them into the section where you want them to live.
    6. Problem: Ask Ludo or the AI suggestions don't seem to "see" assets I added to the Project.
      • Solution: The AI deliberately ignores everything inside the Asset Vault. If you want a character render, mockup, or reference image to inform Ludo's suggestions for a section, move it out of the vault and into the relevant content section. Once it lives inside a section, the AI will use it as context.

    If you encounter persistent issues not covered here, don't hesitate to contact Ludo.ai's support team for assistance, or join our Discord server: https://discord.gg/FmTPyugsrR

  • Asset Vault

    Every Project includes an Asset Vault — a permanent container that holds any media you've uploaded or generated for the project but haven't placed into a specific content section.

    Where to find it:

    • The Asset Vault appears as its own collapsible section in your Project, marked with a 🔒 icon and the label "Asset Vault."
    • On a newly created Project with no other sections yet, the vault is forced open so you don't miss it. Once your Project has other sections, you can collapse or expand the vault using the chevron on the left of its header — your choice is remembered between visits.

    What it's for:

    • Collecting assets generated elsewhere. When you create something in another tool — an image in the Image Generator, a sprite in the Sprite Generator, a 3D model in the 3D Asset Generator, an audio clip, a video, etc. — and save it to the Project, it lands here. The Asset Vault is the default destination for any asset attached to the Project that hasn't been placed into a specific content section.
    • Holding loose media. Media you upload directly to the Project (rather than to a particular section) is also collected here under "Unused Assets."
    • Staging assets before placing them. Drag any item out of the vault and drop it into the "Drop media here" area of a content section to attach it where it belongs.

    Important behavior:

    • Excluded from PDF export. Anything left in the Asset Vault will not appear when you export your Project to PDF.
    • Ignored by the AI. Ludo's AI does not read the Asset Vault as part of your design context. To make sure an asset informs AI suggestions or appears in your shared Project, move it into a relevant content section.

    Think of the Asset Vault as a holding area: it keeps useful references close at hand without cluttering your design, but assets only become "part of" your Project once you place them into a section.