Katton

面向 Fabric、NeoForge 和 Paper 的可热重载 Kotlin 脚本框架

快速开始

API 文档

Katton Live Preview

Katton能做什么

这些例子或许能告诉你答案

RegistryRegister Native Blockkotlin

import net.minecraft.world.level.block.Block
import top.katton.api.ClientPhase
import top.katton.api.ClientScriptEntrypoint
import top.katton.api.ServerPhase
import top.katton.api.ServerScriptEntrypoint
import top.katton.api.registry.registerNativeBlock
import top.katton.registry.RegisterMode

@ServerScriptEntrypoint(ServerPhase.READY)
@ClientScriptEntrypoint(ClientPhase.REGISTRY_SETUP)
fun registerTestBlock() {
    registerNativeBlock(
...

脚本游戏阶段通信

Fabric 和 NeoForge 脚本可双向交换二进制消息。脚本重载时，Katton 保持数据包编解码器稳定。

镜头演出

编排镜头路径、粒子、几何效果和可复用时间线。服务端可以向指定玩家触发演出。

音频

播放包内文件、资源与声音事件，支持暂停、跳转、倍速、淡变与空间定位；三平台通用的原版安全基础声音 API。

脚本包依赖

把项目拆成核心包与消费包，共享 Kotlin 类型和状态，支持显式导出与事务式重载。

脚本包

用目录或 ZIP 包组织 Kotlin/Java 源码，支持私有库、状态文件和已签名客户端同步。

多平台支持

Fabric/NeoForge 提供完整客户端与模组能力，Paper 提供服务端 Bukkit 脚本和 Folia 调度。

热重载

事件、注册表、注入、渲染钩子、音频和数据包修改都能随开发循环快速重载。

IDE 开发连接

让 Katton IDEA 插件发现运行实例、部署世界包，并把编译诊断流回编辑器。