开发一个 Voidkit 插件

package org.voidkit.myplugin

@Mod(VoidkitMyPlugin.MODID)
class VoidkitMyPlugin(bus: IEventBus, container: ModContainer) {

    init {
        // ⚠️ 构造期只做纯内存登记
        PluginRegistry.register(MyFeature(), MODID)

        // 需要读配置的话：注册服务端启动监听，不要在这里读文件
        NeoForge.EVENT_BUS.addListener { _: ServerAboutToStartEvent ->
            MyConfig.load()
        }
    }

    companion object {
        const val MODID = "voidkit_myplugin"
    }
}

class MyFeature : Feature() {

    override val id = "my-feature"              // 写进配置的开关名
    override val displayName = "我的功能"
    override val description = "一句话说明。"
    override val defaultEnabled = true          // 可被配置文件覆盖

    /** 注册命令。服务端启动早期调用。 */
    override fun registerCommands(dispatcher: CommandDispatcher<CommandSourceStack>) {
        dispatcher.register(
            Commands.literal("hello")
                .requires { VoidkitServices.permission().has(it, "voidkit.command.hello") }
                .executes {
                    Msg.ok(it.source, "你好")
                    Command.SINGLE_SUCCESS
                }
        )
    }

    /** 注册管理 API 路由。纯数据登记，不涉及 HTTP。 */
    override fun registerApi(router: ApiRouter) {
        router.get("/api/myplugin/status") { _ ->
            VoidkitServer.onServer {              // 切回主线程
                ApiJson.obj("ok", true, "value", 42)
            }
        }
    }

    /** 配置在这里读 —— 已被启用、目录已就绪、命令还没注册。 */
    override fun onServerAboutToStart(server: MinecraftServer) {
        MyConfig.load()
    }

    /** 服务端完全启动。 */
    override fun onServerStart(server: MinecraftServer) {}

    /** 服务端正在关闭，应在此落盘。 */
    override fun onServerStop(server: MinecraftServer) {}

    /** 每秒一次（不是每 tick）。周期性逻辑写这里，别用 ServerTickEvent。 */
    override fun onSecond(server: MinecraftServer) {}

    /** `/vk reload` 时调用。 */
    override fun onReload(server: MinecraftServer) {}

    /** 需要监听 NeoForge 事件就在类里写 @SubscribeEvent 方法，框架会自动挂载。 */
}

// 提供方（在自己的 @Mod 构造里）
VoidkitServices.register(MyService::class.java, MyServiceImpl())

// 消费方
val svc = VoidkitServices.getOrNull(MyService::class.java)
if (svc != null) {
    // 用了这个服务
} else {
    // 插件没装，走降级逻辑 —— 这个分支必须有
}

if (VoidkitServices.permission().has(player, "voidkit.command.home")) { ... }

object MyConfig {
    private const val FILE = "myplugin/config.json"

    var enabled: Boolean = true
    var greeting: String = "你好"

    fun load() {
        val v = ConfigFiles.load(FILE, MyConfig::class.java, COMMENTS) { MyConfig() }
        enabled = v.enabled
        greeting = v.greeting
    }

    fun save() = ConfigFiles.save(FILE, this, COMMENTS)

    private val COMMENTS = mapOf(
        "enabled" to "是否启用。",
        "greeting" to "问候语，支持 & 颜色码与 %变量%。",
    )
}