Starting a New Project

Four ways to start a project: Quick Create, AI Guided, Advanced Mode and Import from ZIP. Which one suits you, and why simpler project types show three.

Four doors, same room

Pressing New project does not drop you straight into a prompt. It asks how you want to start, and the four answers suit very different moods:

One caveat before the table: all four doors appear for plugins, mods and bots. Simpler project types — configs, datapacks, READMEs, web apps, Skript and the like — have no features to hand-pick, so Advanced Mode is not offered for them and you get three doors instead.

How do you want to start?

Option	What happens	Best when
Quick Create	Describe it once and the AI builds it	You know what you want and want it now
AI Guided	A step-by-step wizard that asks as it goes	You want to think it through with help
Advanced Mode	You pick the features by hand	You have built this before and want it exactly so
Import from ZIP	Upload a project archive you already have	The code exists — it just is not here yet

Two things worth knowing about the first two doors

In AI Guided, you do not have to answer everything. A plugin wizard opens its questions step with one Let AI Fill In The Blank switch that hands the whole set over at once. The Skript, datapack, config, game and web-app wizards go finer: every question there carries its own ✨ Let AI choose button, and everything the AI picked is listed on the Plan step marked (chosen by AI) before you spend anything.

The Plan step also shows an Estimated cost line: a range of credits such as ≈ 120–300 credits (estimate), with Your balance right under it. It is a range on purpose — the price per word is known, how big the build turns out is not. When no estimate can be made for that tool it says Shown under the first reply instead, and the real charge appears there.

Quick Create sends your description exactly as you typed it — there is no rewrite step any more. The free tidy-up of your wording survives only in the AI Guided wizard, as its Optimise step.

Import from ZIP

This is how a project that lives on your own machine becomes a VyroAI project. Upload the .zip and its source files come in, within the limits below.

What it will take: a .zip of up to 50 MB (a bigger one is refused with a message), and up to 2000 files and about 50 MB of code once unpacked. Past either of those the import stops there: the files after that point are left out, and the preview says so — "The ZIP has more than 2000 files, so the files after that were not read." Any text file over 500 KB is left out too (see below), and so are the folders nobody wants imported — node_modules, .git, .idea and the junk your operating system leaves behind. Images, jars and other binaries are left out too: this brings in source.

When the upload lands you get a Project Analysis Complete report before you start working: what kind of project it was detected as, the build files it found, any token placeholders (spots where a Discord token or key still needs filling in), and the entry point. Click a file named in the report and it opens — it is the fastest way to check the import took what you expected.

Files over 500 KB are left out, and named

Any text file bigger than 500 KB is left out of the import whole — it is never cut short. The preview names each one with its size: "1 file was over 500 KB and left out, not cut short: …"

Most source files are far smaller, so this hits the big ones: a long language file, a data dump, a library pasted in as source. Keep the full copies on your computer, and split a file up if you need it in the project. Apply ZIP Update works the same way: a file that is too big is left out and named, and the copy already in your project is not changed — see Adding, Moving and Deleting Files.

A .zip works here, when you are starting a project, and in Apply ZIP Update inside an open project. It is not what the Import button on the projects drawer wants — that one takes the .json project file VyroAI writes when you export. See Storage & Limits.

When it says "Project Creation Failed"

Occasionally the wizard finishes and the save does not. You get a red Project Creation Failed box which, unusually for an error, is worth reading: it turns the machine's message into a plain one — a permissions problem, a sign-in that has gone stale, a network drop, or a project limit you have reached — and shows the project name, the time, and whether you were signed in.

Two buttons matter:

Retry — tries the same save again, with the same files and the same name. Nothing the wizard made has been thrown away, so this is the first thing to press; a network blip usually goes through second time.
Copy Debug Info — puts the whole technical picture on your clipboard: the exact error, its code, the time, the project name, your account id, your browser and the page you were on. Paste it straight into the contact form or a Discord message.

Copy Debug Info is the fastest thing you can send us about a failed creation — faster than Export Logs, which is the chat history and does not exist yet for a project that never got made. See Getting Help.

Every new project is made on your account

The wizard only opens inside the Code Studio, and the Code Studio sends anyone who is not signed in to the sign-in page first. So a project you start here is saved to your account or not at all — it is never kept in your browser alone.

(If you have read elsewhere about a Project created locally message or a Create Locally Instead button on the failure box: both are written into the app for a signed-out person, and a signed-out person never reaches the wizard. The buttons you get are Retry and Copy Debug Info.)

Coming from GitHub? You can use this door — download the repository as a ZIP from GitHub's green Code button and import that — or skip the download and use Import from GitHub in the ⋯ menu beside New, which builds the project from the repository itself. See Importing a GitHub Repository.

Where to next

If nothing gets created: Getting Help — Where the Copy Debug Info text should be pasted.
Finding it again later: Your Projects List — Where a project that did save turns up.
If your zip is big: Storage & Limits — The ZIP size and file-count ceilings in full.

1 of 37 in Code Studio (IDE) · Last checked 17 September 2026 · Previous: Sharing