API

Звуки й частинки

Власні звуки й частинки постачаються всередині мода, як текстури, і ти використовуєш їх за id так само, як ігрові. Оголошуються вони, як і решта вмісту.

Звуки

content/sounds.craftCraftScript

sound "ruby_chime" { file: "ruby/chime", subtitle: "A ruby chimes", pitch: 1.2 }

sound "ruby_crumble" { files: ["ruby/crumble_1", "ruby/crumble_2"], subtitle: "Ruby ore crumbles", volume: 0.8 }

Властивість	Значення	За замовчуванням
`file`	шлях до файлу без розширення: `ruby/chime` — це `sounds/ruby/chime.ogg` мода	`sounds/<id>.ogg`
`files`	кілька шляхів; щоразу грає випадковий	—
`subtitle`	що показується, коли ввімкнено субтитри	—
`volume`	0–1	1
`pitch`	висота тону; 1 — оригінал	1

Він грає, як будь-який звук гри: player.play_sound("rubies:ruby_chime") для одного гравця, world().play_sound(location, "rubies:ruby_chime") у певному місці. Файли мають формат .ogg.

Частинки

content/particles.craftCraftScript

particle "ruby_spark" { textures: ["ruby_spark_0", "ruby_spark_1"], motion: "sparkle" }

Властивість	Значення	За замовчуванням
`textures`	зображення з `textures/particle/`, без розширення. Кілька складаються в анімацію в такому порядку	`textures/particle/<id>.png`
`motion`	`float_up`: піднімається й згасає. `flame`: майже нерухома, зменшується. `sparkle`: дрейфує й мерехтить. `drift`: ширяє на місці.	`float_up`

Ти створюєш її за id: world().spawn_particle("rubies:ruby_spark", location, 30, 1.5, 0.02), з кількістю, розкидом і швидкістю, як в ігрових частинок. Щоб відправити одну частинку в заданий бік, передай натомість швидкість: world().spawn_particle("minecraft:end_rod", location, vector(0, 0.1, 0)), у блоках за тік. Частинки, що притягуються до місця, як minecraft:enchant, починають з location + velocity і летять до location.

Справжній приклад

У прикладі мода, коли з руди випадає додатковий рубін, лунає дзвін, а там, де був блок, розлітаються іскри:

events/mining.craftCraftScript

import { give_rubies } from "/lib/rewards"
import { SETTINGS } from "/settings"

on break(e) {
    let p = e.player
    if p == null { return }
    if e.block.type == "minecraft:diamond_ore" and chance(SETTINGS["bonus_chance"]) {
        give_rubies(p, 1)
        p.play_sound("rubies:ruby_chime")
        p.world.spawn_particle("rubies:ruby_spark", e.block.location, 12, 0.4, 0.02)
    }
}

У Kotlin

content/Sounds.ktKotlin

package com.example.rubies.content

object Sounds {
    const val CHIME = "rubies:ruby_chime"

    fun register(content: ContentBuilder) {
        content.sound("ruby_chime") { file("ruby/chime"); subtitle = "A ruby chimes"; pitch = 1.2f }
        content.sound("ruby_crumble") { file("ruby/crumble_1"); file("ruby/crumble_2"); subtitle = "Ruby ore crumbles"; volume = 0.8f }
    }
}

content/Particles.ktKotlin

package com.example.rubies.content

object Particles {
    const val SPARK = "rubies:ruby_spark"

    fun register(content: ContentBuilder) {
        content.particle("ruby_spark") { texture("ruby_spark_0"); texture("ruby_spark_1"); motion = ParticleMotion.SPARKLE }
    }
}

sound(id) { file(...); subtitle; volume; pitch } і particle(id) { texture(...); motion = ParticleMotion.SPARKLE } всередині ContentBuilder. Щоб відтворити й створити: player.playSound(id), world.playSound(at, id), world.spawnParticle(id, at, count, spread, speed) і world.spawnParticle(id, at, Vector(0.0, 0.1, 0.0)).

Файли

Мод	Де
CraftScript (тека)	`mods/rubies/sounds/ruby/chime.ogg`, `mods/rubies/textures/particle/ruby_spark_0.png`
Kotlin або Java	`src/main/resources/assets/rubies/sounds/ruby/chime.ogg`, `…/assets/rubies/textures/particle/ruby_spark_0.png`