Katton

Hot-reloadable Kotlin scripting for Minecraft Fabric, NeoForge, and Paper

Quick Start

API Docs

Katton Live Preview

What can Katton do

Check out those snippets to get a quick glimpse of what Katton's capable of

Quick StartAttach JVM Debuggerkotlin

// Necessary imports for the script
import net.minecraft.network.chat.Component
import top.katton.api.ServerPhase
import top.katton.api.ServerScriptEntrypoint
import top.katton.api.event.PlayerArg
import top.katton.api.event.ServerPlayerEvent

// The function with @ServerScriptEntrypoint is the entry point of the script.
@ServerScriptEntrypoint(ServerPhase.READY)
fun main(){
   // Register an event listener for when a player joins the server
   ServerPlayerEvent.onPlayerJoin += onJoin@
...

Script Play Networking

Exchange binary messages between Fabric or NeoForge scripts. Katton keeps the packet codec stable across reloads.

Camera Scenes

Build camera paths, particle and geometry effects, and reusable timelines. A server can start scenes for selected players.

Audio

Play pack files, resources, and sound events with pause, seek, rate, fades, and spatial placement — plus a vanilla-safe basic sound API on every platform.

Script Pack Dependencies

Split a project into a core pack and consumers that share its Kotlin types and state, with explicit exports and transactional reloads.

Script Packs

Organize Kotlin and Java sources into directory or ZIP packs with manifests, private libraries, state files, and signed client sync.

Platform Aware

Use Fabric and NeoForge for full client/mod features, or Paper for server-only Bukkit scripting and Folia-aware scheduling.

Hot Reload

Reload events, registries, injections, rendering hooks, audio, and datapack mutations without restarting your workflow.

IDE Bridge

Let the Katton IDEA plugin discover a running instance, deploy world packs, and stream compiler diagnostics back into your editor.