How to Start Using the Kristal Engine (kristal.cc)

Kristal is a DELTARUNE fangame and battle engine built with LÖVE, and you can start using it by reading the official wiki, learning Lua (or committing to learn it), and studying the engine's source code. The site states plainly that you must know Lua or be willing to learn it — so if you have zero programming experience and no interest in acquiring any, this engine is not the right starting point for you.

What Kristal actually is

According to kristal.cc, Kristal is "a powerful DELTARUNE fangame and battle engine, made with LÖVE." Its stated purpose is to let you create custom DELTARUNE worlds, battles, and more. It is an engine and framework, not a finished game — the site's screenshot section shows community projects built on it rather than a single official title.

That distinction matters for how you approach it. You are not downloading a game to play; you are picking up a toolkit for building one.

The two prerequisites

1. The wiki

The site's "How do I use it?" section directs users to the Kristal wiki for information on how to use the engine. This is the official starting point for setup, structure, and usage questions. Go there first rather than guessing at how the engine is organized.

2. Lua

The site explicitly warns: "Please keep in mind that you must know Lua, or be willing to learn it!" Kristal provides its own Lua tutorial to help beginners get started, so the project anticipates users arriving without Lua experience — but it expects them to acquire it.

Lua is the scripting language you will use to define behavior in your fangame. If you have written code in any language before, the syntax will feel approachable; if you have not, budget real time for the tutorial before expecting to build anything substantial.

A practical order of operations

1. Read the wiki to understand what the engine provides and how a project is structured.
2. Work through the Lua tutorial if Lua is new to you. Do this before trying to modify engine behavior.
3. Look through the Kristal source code. The site invites this directly: "Yes! Feel free to look through the source code of Kristal and contribute if you wish." Reading existing code is how you learn the engine's conventions.
4. Study community projects for a sense of what the engine can produce and how different creators approach it.

What the community has built

The screenshots section lists real fangames made with Kristal, which doubles as a survey of what the engine supports:

These range from single-battle experiments to multi-chapter demos, which suggests the engine scales from small tests to larger projects.

Contributing

If you want to help the engine itself rather than just build with it, the site says you can look through the Kristal source code and contribute. That is a separate track from making a fangame — useful if you find bugs or want to extend engine features, and a good way to learn the internals if you are already comfortable with Lua.

Common sticking points

• Skipping Lua. The most likely reason a beginner stalls. The engine assumes scripting knowledge; there is no way around it.
• Ignoring the wiki. Setup and structural questions are answered there, and the site points to it for a reason.
• Starting too large. The listed projects vary widely in scope. Beginning with a single battle or a small room is more realistic than opening with a multi-chapter plan.
• Expecting a playable game. Kristal is an engine. What you get out of it depends on what you build.

If you already know Lua, the path is short: read the wiki, read the source, start building. If you do not, the Lua tutorial is your first real step, and everything else follows from it.