Kuroko 1.1.0-dev

kuroko init MyPlugin
cd MyPlugin

./gradlew kurokoBuild   # .jar в build/libs/
./gradlew kurokoRun     # Paper в run/ с вашим плагином

./gradlew kurokoBuild
./gradlew kurokoRun

MyPlugin/
├── build.gradle.kts        ← плагин io.sylnora.kuroko
├── kuroko.toml             ← конфиг языка и MC-платформы
├── settings.gradle.kts
└── src/
    ├── main/
    │   ├── kuroko/
    │   │   └── MyPlugin.kr
    │   └── resources/
    │       └── config.yml  ← опционально
    └── test/
        └── kuroko/
            └── MyPluginTest.kr
└── run/                    ← тестовый сервер (gitignored)

val name = "Steve"          // String, выводится сам
var health = 20             // Int
var ratio: Float = 0.5      // явный тип

say("Игрок: $name, HP: $health")     // строковые шаблоны
say("Урон: ${health * 2}")

val speed   = 0.3 blocks_per_tick
val delay   = 100 ms
val reload  = 5 seconds
val range   = 10 blocks

fun main() {
    say(square(4))            // 16
    say(greet("Steve"))       // Привет, Steve!
    spawn(world)              // умолчания y = 64.0
}

fun square(x: Int) = x * x
fun greet(name: String) = "Привет, $name!"

fun spawn(world: World, x: Double = 0.0, y: Double = 64.0, z: Double = 0.0) {
    // ...
}

fun Player.heal(amount: Int) {
    health = min(health + amount, 20)
}

// вызов как обычный метод:
player.heal(10)

val doubled = listOf(1, 2, 3).map { it * 2 }
val evens   = listOf(1, 2, 3, 4).filter { it % 2 == 0 }

every(1 second) onlyIf { players.size > 0 } {
    players.forEach { p -> p.msg("&7Тик") }
}

class Player(val name: String, var health: Int = 20) {

    fun isAlive() = health > 0

    fun takeDamage(amount: Int) {
        health -= amount
        if (!isAlive()) say("$name погиб!")
    }
}

data class Item(val id: String, val name: String, val damage: Int)

object Config {
    val version = "1.0.0"
    val debug = false
}

class Boss(name: String) : Player(name, health = 200) {
    override fun takeDamage(amount: Int) {
        super.takeDamage(amount / 2)   // боссы получают половину урона
    }
}

// диапазоны
for i in 1..10 {
    say(i)
}

// коллекции
for item in list {
    say(item)
}

// пока
while health > 0 {
    health--
}

// when — как switch, но умнее
when material {
    DIAMOND  -> say("Алмаз!")
    GOLD     -> say("Золото!")
    is Sword -> say("Меч!")
    else     -> say("Что-то другое")
}

// when как выражение
val price = when material {
    DIAMOND -> 100
    GOLD    -> 50
    else    -> 1
}

val list = [1, 2, 3, 4, 5]        // список
val map  = {"key": "value", "hp": 20}   // словарь
val set  = {1, 2, 3}              // фигурные без пар — множество

// функциональный стиль
val names = players.map { it.name }.filter { it.startsWith("A") }

val top = Players.where { kills > 10 }.orderBy { kills }.limit(10).find()

var player: Player? = null     // может отсутствовать

player?.sendMessage("Привет")  // безопасный вызов
val name = player?.name ?: "Неизвестный"   // элвис

// в командах это избавляет от проверок:
val world = server.getWorld(home.world)
    ?: return player.msg("&cМир не найден!")

@Plugin(
    name = "HomePlugin",
    version = "1.0",
    description = "Система домов для игроков",
    authors = ["Sylnora"]
)
class HomePlugin : KPlugin() {

    on load {
        Homes.createTable()
        log("HomePlugin загружен. Дома готовы.")
    }

    on unload {
        log("HomePlugin выгружен.")
    }
}

@Command("sethome", description = "Установить точку дома", usage = "/sethome [название]")
@Permission("homeplugin.sethome")
@Cooldown(3 seconds, message = "&cПодожди ещё {remaining} сек!")
fun cmdSetHome(player: Player, args: Array) {
    val name = args.getOrElse(0) { "home" }
    val loc = player.location

    Homes.set(player = player.uniqueId, name = name, world = loc.world.name,
              x = loc.x, y = loc.y, z = loc.z)

    player.msg("&aДом '&e$name&a' установлен!")
}

@Command("home", description = "Телепортироваться домой")
@Permission("homeplugin.home")
@Cooldown(5 seconds)
fun cmdHome(player: Player, args: Array) {
    val name = args.getOrElse(0) { "home" }
    val home = Homes.find(player.uniqueId, name)
        ?: return player.msg("&cДом '&e$name&c' не найден!")
    player.tp(Location(server.getWorld(home.world), home.x, home.y, home.z))
    player.msg("&aТелепорт к дому '&e$name&a'!")
}

@On
fun onJoin(event: PlayerJoinEvent) {
    event.player.msg("&6Добро пожаловать, &e${event.player.name}&6!")
    event.joinMessage = null          // убрать системное сообщение
}

@On
fun onBreak(event: BlockBreakEvent) {
    if (event.block.type == DIAMOND_ORE) {
        log("${event.player.name} добыл алмаз")
    }
}

every(20 ticks) {              // каждую секунду
    players.forEach { p ->
        if (p.health < 5) p.msg("&cОпасно! Мало HP!")
    }
}

after(5 seconds) {             // через 5 секунд
    log("Прошло 5 секунд")
}

async {                        // не блокируем главный поток
    val data = fetchFromDatabase()
    player.msg("Загружено: $data")
}

// с условием
every(1 second) onlyIf { players.size > 0 } {
    log("кто-то онлайн")
}

table Homes {
    player: UUID primary
    name: String primary
    world: String
    x: Double; y: Double; z: Double
}

on load { Homes.createTable() }

// CRUD без SQL:
Homes.set(player.uniqueId, "home", loc)
val home = Homes.find(player.uniqueId, "home")
val list = Homes.where { player == player.uniqueId }.find()
Homes.delete(player.uniqueId, "home")

@Command("menu")
fun cmdMenu(player: Player) {
    val gui = GUI("&6Меню", rows = 3) {
        slot(1, 1) {
            item = DIAMOND
            name = "&bАлмаз"
            onClick { p ->
                p.giveItem(DIAMOND, 1)
                p.msg("&aПолучен алмаз!")
            }
        }
        slot(2, 2) {
            item = BARRIER
            name = "&cЗакрыть"
            onClick { it.closeInventory() }
        }
    }
    player.openInventory(gui)
}

config("settings") {
    "max_players" default 100
    "prefix" default "&6[MyPlugin] "
    "debug" default false
}
val maxPlayers = config["max_players"].int

val sword = smartItem(DIAMOND_SWORD) {
    name = "&6Экскалибур"
    lore = ["&7Легендарный меч", "&8Урон: &c+50"]
    undroppable = true
    onRightClick { p -> p.msg("&bМеч дрожит...") }
}

var health: Int = null

var health: Int? = null     // значение может отсутствовать
var health2: Int = 20       // или просто присвой число

[language]
version = "1.0"
target-jvm = 17

[minecraft]
api = "paper"          # paper / spigot / purpur / fabric / forge / neoforge
version = "1.21.4"
auto-import = true

[compiler]
warnings-as-errors = false
language-errors = "ru"   # язык сообщений: ru / en
incremental = true
optimize = true

[runtime]
debug = false

kurokoc compile src/        # компиляция всех .kr
kurokoc check src/          # только проверка
kurokoc run Main.kr         # запуск скрипта
kurokoc explain KR001       # объяснение ошибки
kurokoc build               # полная сборка через Gradle