Tutla's CCS Editor

ClickCrystals Script lets you build powerful in-game modules without having to learn goofy java. Automate anything within this editor.

Full Editor

Requires ClickCrystals >=1.4.0.

How to use

text editor

Download the mod: Download the mod from Modrinth and put it into your mods folder
Download ClickCrystals: Download it from the website or Curseforge and put it in your mods folder
Open the editor with the keybind: The default keybind is j
Drag Nodes from the Palette onto the Editor
Copy the script from Text Mode: Copy it from the text mode on the top of the screen
Paste it into ClickCrystals: Open the ClickCrystals Menu and go to Scripting. From there click paste to paste your script. Or just save it using the in game file manager.

You need to know how to use CCS to understand basic functionality before writing scripts.

Text Editor: The text editor lets you edit the raw script. Includes syntax highlighting and basic error detection
Node Editor: Drag nodes from the palette onto the editor to draft your script
Generative AI: The AI tab lets you generate scripts by just describing it. For more information read the section below

Syntax highlighting for keywords, commands, conditions, strings, numbers, and comments
Auto-close brackets — typing { inserts {} with the cursor placed inside
Bracket pair highlighting — matching { / } pairs are highlighted when the cursor is near one
Tab autocomplete — press Tab to complete the current keyword or command
Find (Ctrl+F) — search bar at the top of the editor; Enter / Shift+Enter to step through matches, Escape to dismiss
Find & Replace (Ctrl+H) — adds a replace bar; replace one (Enter) or all (Ctrl+Enter) occurrences
Auto-beautify on save (Ctrl+S) — reformats the script with consistent 3-space indentation before writing to disk, matching the formatter at ccs.tutla.net
Problems panel — collapsible bottom bar showing all detected syntax errors with line numbers; click any error to jump straight to that line

Full VS Code-style file explorer for your .clickcrystals/scripts directory
Create, rename, and delete files and folders — including nested subfolders
Right-click context menu — New File, New Folder, Rename, Delete on any item
All deletes require a confirmation dialog; deleting a folder removes all its contents
Closing a file automatically closes its open editor tab
Tab titles show the relative path (e.g. workflows/door instead of just door)

Multi-tab editing — open several scripts at once; tabs show unsaved-change indicators
Untitled scripts — new files are Untitled until first saved with Ctrl+S (triggers Save As)
Run button (▶) — green button in the header sends ,ccs reload-scripts to chat, reloading your scripts in-game without leaving the editor

The AI tab lets you generate scripts by just describing it. To use it, go to the top right of your screen and click "AI" to open up the menu.

In the menu you will be presented with 4 options:

Claude: Get your API key here. Claude does let you use the API for free under strict usage limits unless your paying for it. Therefore, only use if you're willing to pay for it but get higher quality scripts.
GPT: Get your API key here
Gemini: Get your API key here
Ollama: Let's you run AI locally on your system without the internet (requires a competent GPU). Preferred model is llama3.1:8b but you can definetly use a better model. Install ollama and make sure its serving (serve by running ollama serve in terminal). If your first response is taking too long, make sure llama3.1:8b or the model you want is already installed. Install it via ollama run llama3.1:8b.

If you're not running it locally via ollama then put the API key in it's respective input in the AI panel within the editor.

While using AI keep in mind to:

Be concise: It's an AI, not ItzRealMe. Think of it as a 47 year old professional developer who plays Minecraft whenever free. Of course he wouldn't know what a "one-cycle" or a "d-tap" is! Specify step by step what to do instead of giving a vague explanation, lower end models and most local models tend to hallucinate. Some models such as gemini-2.5-flash will straight up reject your request if you don't be specific enough.
Clear chat when you're done with a task: Too much context build up will use up tokens quickly and will hit usage limits faster than an F1 Car. Make sure to clear your chat whenever you're done with a specific task such as the part of your script where you open a door. Clear it out whenever everything previous in the script doesn't need to be worked on. Your current script is sent to the AI anyways.
"Unknown node! What do I do?"- Don't panick: If AI generates an unknown node then tell it the name of what it got wrong and specify its unkown. For example: It shows "play_Sound" is unknown. Please fix it by using the correct defintion. Specify if it doesn't exist. If AI can't resolve even after repeated prompting then try looking up the node yourself, afterall: Humans are superior (but Claude Opus can definitely get it done)