Guide

These guides describe the script-facing parts of Katton. Start with script packs, then jump to the feature area you need.

For platform support, see Platforms. For reload, pack synchronization, and registry lifecycle, see Architecture.

Script PacksPack layout, manifest fields, entrypoints, local state, client sync.EventsCross-platform event categories and argument model.Play NetworkingExchange binary messages through reloadable script channels on Fabric and NeoForge.Entrypoint LifecycleChoose phases, use invocation contexts, and control world replay.Mods and PluginsDeclare dependencies and call Fabric, NeoForge, or Paper APIs.Script Pack DependenciesShare Kotlin types and state between packs with explicit exports.RegistryRegister items, blocks, entities, tabs, components, and renderers.Modify Existing ContentMutate items, blocks, recipes, loot tables, attributes, and trades.Datapack MigrationMove mcfunction logic into Kotlin without losing hot reload.RenderingHUD/world callbacks, item markers, and post effects.AudioPlay pack files, resources, and sound events; basic sound everywhere.Code InjectionRuntime ByteBuddy/ASM injection on Fabric/NeoForge.Script Pack UIIn-game pack management on Fabric/NeoForge clients.