Skip to content

kits & cosmetics

Jump to bottom
Atsuquipro edited this page Jul 5, 2026 · 7 revisions

Esta página explica todas las opciones disponibles de kits y hats en el archivo config.yml.

Kits

Los kits permiten entregar una colección de objetos al jugador.

Formato

kits:
  <id>:
    cooldown: <segundos>
    items:
      - MATERIAL
      - MATERIAL:cantidad

This page explains all available configuration options for kits and hats in the config.yml file.

Kits

Kits allow you to give players a collection of items.

Format

kits:
  <id>:
    cooldown: <seconds>
    items:
      - MATERIAL
      - MATERIAL:amount

Options

items

List of items the player will receive.

items:
  - DIAMOND_SWORD
  - BREAD:10
  - APPLE:5

If no amount is specified, the plugin will give 1 item.

Complete Example

kits:
  starter:
    cooldown: 3600
    items:
      - STONE_SWORD
      - BREAD:10
      - COOKED_BEEF:16

Cosmetics

Each cosmetic is represented by an item that can perform different actions when specific events occur.

Basic Format

cosmetics:
  magic_hat:
    material: PAPER
    name: "&dMagic Hat"
    lore:
      - "&7A powerful hat."

Basic Configuration

material

The item's material.

It must be a valid Bukkit/Paper material name.

Example:

material: PAPER

Complete list of materials:

https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html

name

The display name of the item.

Supports color codes using &.

name: "&6Magic Wand"

lore

The item's description.

Each line must be placed in a separate list entry.

lore:
  - "&7First line"
  - "&eSecond line"

custom_model_data

The item's Custom Model Data.

Allows you to use custom models for custom hats!

custom_model_data: 1234

This option is optional.

item_model

Minecraft's modern Item Model (1.21.4+).

Allows you to use custom models for custom hats!

item_model: "minecraft:magic_wand"

This option is optional.

Events

The following events can be used for sounds, particles, and effects.

onmove

Triggered when the player moves.

onattack

Triggered when the player attacks an entity.

ondamage

Triggered when the player takes damage.

onequip

Triggered when the cosmetic is equipped.

Sounds

Allows sounds to be played when an event occurs.

Format

sounds:
  onmove:
    cooldown: 40
    list:
      - block.anvil.use

cooldown

Cooldown in ticks.

Minecraft uses:

  • 20 ticks = 1 second

Example:

cooldown: 40

Equivalent to 2 seconds.

conditions

Optional list of conditions using PlaceholderAPI.

All conditions must be met before the action is executed.

conditions:
  - "%player_health% > 10"
  - "%player_level% >= 20"

Supported operators:

>
<
>=
<=
==
!=

list

List of sounds to play.

list:
  - block.anvil.use
  - entity.player.levelup

Complete list of sounds:

https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html

Particles

Spawns particles when an event occurs.

Format

particles:
  onmove:
    cooldown: 10
    type: CLOUD
    count: 5

cooldown

Cooldown in ticks.

conditions

Conditions using PlaceholderAPI.

conditions:
  - "%player_health% >= 10"

type

The particle type.

type: FLAME

Complete list:

https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Particle.html

count

The number of particles to spawn.

count: 20

Effects

Allows potion effects to be applied to the player.

Format

effects:
  onmove:
    cooldown: 40
    list:
      - speed:1:40

Syntax

Each effect uses the following format:

effect:amplifier:duration

Example:

speed:2:200

This means:

  • Speed II
  • 200 ticks (10 seconds)

cooldown

Cooldown in ticks.

conditions

Conditions using PlaceholderAPI.

conditions:
  - "%player_health% > 5"

list

List of effects.

list:
  - speed:1:40
  - jump_boost:2:100
  - resistance:1:200

Complete list of effects:

https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/potion/PotionEffectType.html

Conditions

Conditions use PlaceholderAPI.

Examples:

conditions:
  - "%player_health% > 10"
  - "%player_food_level% >= 15"
  - "%player_level% == 30"

Supported operators:

>
<
>=
<=
==
!=

If all conditions evaluate to true, the action will be executed.

Complete Example

cosmetics:
  magic_hat:
    material: PAPER
    name: "&dMagic Hat"
    lore:
      - "&7An example cosmetic."

    custom_model_data: 100

    sounds:
      onmove:
        cooldown: 40
        list:
          - block.amethyst_block.chime

    particles:
      onmove:
        cooldown: 5
        type: ENCHANT
        count: 10

    effects:
      onmove:
        cooldown: 40
        list:
          - speed:1:40

Opciones

items

Lista de objetos que recibirá el jugador.

items:
  - DIAMOND_SWORD
  - BREAD:10
  - APPLE:5

Si no se especifica una cantidad, el plugin entregará 1 objeto.

Ejemplo completo

kits:
  starter:
    cooldown: 3600
    items:
      - STONE_SWORD
      - BREAD:10
      - COOKED_BEEF:16

Cosméticos

Cada cosmético corresponde a un objeto que ejecutará diferentes acciones cuando ocurra un evento.

Formato básico

cosmetics:
  sombrero_magico:
    material: PAPER
    name: "&dSombrero mágico"
    lore:
      - "&7Un poderoso sombrero."

Configuración básica

material

Material del objeto.

Debe utilizar un nombre válido de Bukkit/Paper.

Ejemplo:

material: PAPER

Lista completa de materiales:

https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html

name

Nombre visible del objeto.

Acepta códigos de color utilizando &.

name: "&6Varita Mágica"

lore

Descripción del objeto.

Cada línea debe ir en una entrada distinta.

lore:
  - "&7Primera línea"
  - "&eSegunda línea"

custom_model_data

Custom Model Data del Resource Pack. Permite utilizar modelos personalizados para los sombreros custom!

custom_model_data: 1234

Este valor es opcional.

item_model

Modelo moderno de Minecraft (1.21.4+). Permite utilizar modelos personalizados para los sombreros custom!

item_model: "minecraft:magic_wand"

Este valor es opcional.

Eventos

Los siguientes eventos pueden utilizarse en sonidos, partículas y efectos.

onmove

Se ejecuta cuando el jugador se mueve.

onattack

Se ejecuta cuando el jugador golpea una entidad.

ondamage

Se ejecuta cuando el jugador recibe daño.

onequip

Se ejecuta cuando el jugador equipa el cosmético.

Sonidos

Permite reproducir sonidos cuando ocurre un evento.

Formato

sounds:
  onmove:
    cooldown: 40
    list:
      - block.anvil.use

cooldown

Tiempo de reutilización en ticks.

Minecraft utiliza:

  • 20 ticks = 1 segundo

Ejemplo:

cooldown: 40

Equivale a 2 segundos.

conditions

Lista opcional de condiciones utilizando PlaceholderAPI.

Todas las condiciones deben cumplirse para ejecutar la acción.

conditions:
  - "%player_health% > 10"
  - "%player_level% >= 20"

Operadores soportados:

>
<
>=
<=
==
!=

list

Lista de sonidos que se reproducirán.

list:
  - block.anvil.use
  - entity.player.levelup

Lista completa de sonidos:

https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html

Partículas

Genera partículas cuando ocurre un evento.

Formato

particles:
  onmove:
    cooldown: 10
    type: CLOUD
    count: 5

cooldown

Tiempo de reutilización en ticks.

conditions

Condiciones utilizando PlaceholderAPI.

conditions:
  - "%player_health% >= 10"

type

Tipo de partícula.

type: FLAME

Lista completa:

https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Particle.html

count

Cantidad de partículas que aparecerán.

count: 20

Efectos

Permite aplicar efectos de poción al jugador.

Formato

effects:
  onmove:
    cooldown: 40
    list:
      - speed:1:40

Sintaxis

Cada efecto utiliza el siguiente formato:

efecto:nivel:duración

Ejemplo:

speed:2:200

Significa:

  • Speed II
  • 200 ticks (10 segundos)

cooldown

Tiempo de reutilización en ticks.

conditions

Condiciones utilizando PlaceholderAPI.

conditions:
  - "%player_health% > 5"

list

Lista de efectos.

list:
  - speed:1:40
  - jump_boost:2:100
  - resistance:1:200

Lista completa de efectos:

https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/potion/PotionEffectType.html

Condiciones

Las condiciones utilizan PlaceholderAPI.

Ejemplos:

conditions:
  - "%player_health% > 10"
  - "%player_food_level% >= 15"
  - "%player_level% == 30"

Operadores disponibles:

>
<
>=
<=
==
!=

Si todas las condiciones son verdaderas, la acción se ejecutará.

Ejemplo completo

cosmetics:
  magic_hat:
    material: PAPER
    name: "&dSombrero mágico"
    lore:
      - "&7Un cosmético de ejemplo"

    custom_model_data: 100

    sounds:
      onmove:
        cooldown: 40
        list:
          - block.amethyst_block.chime

    particles:
      onmove:
        cooldown: 5
        type: ENCHANT
        count: 10

    effects:
      onmove:
        cooldown: 40
        list:
          - speed:1:40

Clone this wiki locally