Common interfaces

package your.plugin.package

import org.bukkit.plugin.java.JavaPlugin

class YourPlugin : JavaPlugin() {
    override fun onEnable() {
        logger.info("${description.name} v${description.version} enabled")
        // Initialize plugin
    }
    
    override fun onDisable() {
        logger.info("${description.name} disabled")
        // Cleanup
    }
}

import org.bukkit.command.Command
import org.bukkit.command.CommandExecutor
import org.bukkit.command.CommandSender
import org.bukkit.entity.Player

class YourCommand : CommandExecutor {
    override fun onCommand(
        sender: CommandSender,
        command: Command,
        label: String,
        args: Array<out String>
    ): Boolean {
        if (sender !is Player) {
            sender.sendMessage("This command can only be used by players")
            return true
        }
        
        // Command logic
        return true
    }
}

import org.bukkit.command.Command
import org.bukkit.command.CommandSender
import org.bukkit.command.TabCompleter

class YourTabCompleter : TabCompleter {
    override fun onTabComplete(
        sender: CommandSender,
        command: Command,
        alias: String,
        args: Array<out String>
    ): List<String>? {
        return when (args.size) {
            1 -> listOf("option1", "option2", "option3")
                .filter { it.startsWith(args[0], ignoreCase = true) }
            else -> null
        }
    }
}

import org.bukkit.event.EventHandler
import org.bukkit.event.Listener
import org.bukkit.event.player.PlayerJoinEvent

class YourListener : Listener {
    @EventHandler
    fun onPlayerJoin(event: PlayerJoinEvent) {
        val player = event.player
        // Handle event
    }
}

import org.bukkit.configuration.file.FileConfiguration
import org.bukkit.configuration.file.YamlConfiguration
import java.io.File

class ConfigManager(private val plugin: JavaPlugin) {
    private lateinit var config: FileConfiguration
    private lateinit var configFile: File
    
    fun loadConfig() {
        configFile = File(plugin.dataFolder, "config.yml")
        if (!configFile.exists()) {
            plugin.saveResource("config.yml", false)
        }
        config = YamlConfiguration.loadConfiguration(configFile)
    }
    
    fun reloadConfig() {
        config = YamlConfiguration.loadConfiguration(configFile)
    }
    
    fun saveConfig() {
        config.save(configFile)
    }
}

// build.gradle.kts
dependencies {
    compileOnly(libs.purpur.api)
}

name: YourPlugin
version: 1.0.0
main: your.plugin.package.YourPlugin
api-version: "1.21"
authors: [Author1, Author2]
website: "https://github.com/OyasaiServer"
description: "Plugin description"

commands:
  yourcommand:
    description: "Command description"
    usage: "/yourcommand [args]"
    aliases: [yc, ycmd]
    permission: your.plugin.command

permissions:
  your.plugin.command:
    description: "Permission description"
    default: true
  your.plugin.admin:
    description: "Admin permission"
    default: op

import org.bukkit.entity.Player
import org.mockito.Mockito.mock

val mockPlayer = mock(Player::class.java)

nix run .#oyasai-minecraft-minimal