[1.21] SoundEvent and ParticleType Utilities

[Notenoughmail]

Description

Adds asset generation capabilities for SoundEvents and ParticleTypes and adds an event for registering particle providers

A port of #836 for 1.21

Example Script

Startup:

StartupEvents.registry('sound_event', e => {
  e.create('test')
    .sounds(g => {
      g.subtitle('kubejs.sound.test')
      g.sounds('minecraft:item/bucket/empty1', 'minecraft:item/bucket/empty2', 'minecraft:item/bucket/empty3')
  })
})

StartupEvents.registry('particle_type', e => {
  e.create('test')
    .textures([
      'minecraft:big_smoke_0',
      'minecraft:big_smoke_1',
      'minecraft:big_smoke_2',
      'minecraft:big_smoke_3'
    ])
  e.create('kubejs:mod')
    .texture('minecraft:big_smoke_11')
  e.create('kubejs:custom')
  e.create('special')
})

Client:

const HugeExplosionSeedParticle$Provider = Java.loadClass('net.minecraft.client.particle.HugeExplosionSeedParticle$Provider')

ClientEvents.particleProviderRegistry(event => {
  // Registers a default, simple provider for kubejs:test
  event.register('kubejs:test')
  // Registers a default, simple provider for kubejs:mod and allows users to edit the particle
  event.register('kubejs:mod', particle => {
    // Modify particle's options
    particle.friction = 1
    particle.gravity = 0.5
    particle.color = 0xFF4545
    particle.fasterWhenYMotionBlocked = true
  })
  // Registers a custom provider
  event.register('kubejs:custom', (type, clientlevel, x, y, z, spriteSet, xSpeed, ySpeed, zSpeed) => {
    var kube = clientLevel.kubeParticle(x, y, z, spriteSet);
    kube.color = 0xDD232D
    kube.onTick(particle => {
      particle.speed = [0, particle.ySpeed * 1.1, 0]
    })
    return kube
  })

  // Register a 'special' provider (does not have a SpriteSet provided)
  event.registerSpecial('kubejs:special', new HugeExplosionSeedParticle$Provider())
})

ClientEvents.lang('en_us', event => {
  event.add('kubejs.sound.test', 'Test Sound')
})

Other details

There is a new method in ClientLevelKJS which enables the create of new KubeAnimatedParticles, it may be better to put it (and other particle classes?) into a generic Particle wrapper