Project

FAQ

Short answers, with a link to the page that has the details.

Making mods

Do I need to know Java?

No. CraftScript covers most mods, from ten lines up to multi-file projects with classes and types. Kotlin is for when the mod is large or needs something only available there. See CraftScript and Kotlin and Java.

What can I do with CraftScript today?

Items, blocks and recipes; react to every event; commands with permissions; timers; change the world and manage players; blocks of any shape, custom creatures with their own models, ores, trees, plants and structures in world generation, sounds and particles; forms, boss bars and a sidebar. Also data that survives a restart, settings files, and networking between client and server. Also biomes and dimensions of your own.

When do I use Kotlin?

When you need background work or Java libraries, or when you prefer static types and a full IDE for a large mod. Everything else is available in both languages.

How do I keep a mod from becoming unmanageable?

One file per responsibility, folders by topic (content/, events/, commands/, lib/), content kept apart from behavior, and an entry point that only lists the parts. See Organizing a mod.

Is it safe to install other people's scripts?

A CraftScript script can only use the Crafting API: it doesn't read files, doesn't open connections and doesn't use Java, and an infinite loop is cut off automatically. A .jar mod is native code: install it only if you trust whoever made it.

Versions

Which Minecraft version do I need?

Minecraft Java 26.3.

Will my mod keep working when a new Minecraft comes out?

That's the promise: your mod talks to Crafting, and Crafting is what adapts to the game. Details in Your mod doesn't break.

And when a new version of Crafting comes out?

Same thing: the API only grows. Anything being replaced is marked deprecated first and keeps working; only a major version can remove something, and it is announced along with its replacement.

Playing

Is there a ready-made download?

Not yet. Crafting is at version 0.1.0 and is built from source. See Installation.

I get command not found: crafting

The executable isn't on your PATH. See CLI and editors.

Can players without mods join my server?

Yes, if the server only has plugins or server-side mods. If there are mods that add blocks or items, the player sees exactly what is missing. See Config and networking.

Does a buggy mod crash the server?

No. An error in an event or a command is logged with the mod name and everything else keeps running. A script with type errors doesn't load and says where the error is.

Do mods made for other modding platforms work?

Not for now. Crafting runs mods written for Crafting, in CraftScript, Kotlin or Java; they are the only ones guaranteed to keep working when the game changes.