---
description: Guía para crear un nuevo fuego artificial
---

# Crear Fuego Artificial

{% hint style="warning" %}
En este apartado solo se hablará sobre <mark style="color:blue;">`firework_type`</mark>, no se hablará sobre las demás secciones, por lo que si quieres saber más, da [clic aquí](modificar-menu).
{% endhint %}

## material\_no\_permission

Este material se mostrará cuando un jugador que no tiene el permiso necesario para el mensaje. Para saber más a detalle sobre los materiales y como debes usarlo, da [clic aquí](../modificar-menu#material).

{% code title="fireworks.yml" lineNumbers="true" %}
```yaml
Menu:
 material_no_permission: 'BARRIER'
```
{% endcode %}

<figure><img src="https://1804475110-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FchuWInciGAIrzxPTLHGa%2Fuploads%2FiNd8LVBC9eeny96rf5sN%2Fmaterial_no_permission.png?alt=media&#x26;token=8c4fd86e-568b-483b-8425-51e8a8e8f28c" alt=""><figcaption><p>No permisos</p></figcaption></figure>

## Crear nuevo fuego artificial

Abajo tienes el modelo para poder copiar y pegar en tu archivo de configuración, es importante que modifiques el nombre <mark style="color:blue;">`"key_name"`</mark> para evitar errores con el plugin.

{% hint style="danger" %}
Es importante que sigas correctamente el paso de <mark style="color:orange;">`firework_type`</mark>, debe ir acomodando tal cual se muestra, no cambiar el orden de este apartado.
{% endhint %}

{% code title="fireworks.yml" lineNumbers="true" %}
```yaml
  key_name:
   material: 'NOMBRE_MATERIAL'
   display_name: 'NOMBRE_FUEGO_ARTIFICIAL'
   slot: 1
   lore:
    - 'Aquí ingresa el texto que usted guste'
    - 'Recuerda que también puedes usar variables de PlaceholderAPI'
    - 'y variables especiales de los fuegos artificiales'
    - ''
   firework_type: 'Type:<TYPE>;Colors:<COLOR1>,<COLOR2>;Fade:<COLOR1>,<COLOR2>;Power:<PODER>;Amount:<CANTIDAD>'
   permission: 'PERMISOS'
```
{% endcode %}

## firework\_type

### Type

Los tipos de fuegos artificiales son los siguientes. Colocar el nombre correctamente para evitar errores.

<mark style="color:green;">**`1) CREEPER`**</mark>

<mark style="color:green;">**`2) BURST`**</mark>

<mark style="color:green;">**`3) STAR`**</mark>

<mark style="color:green;">**`4) BALL`**</mark>

<mark style="color:green;">**`5) BALL_LARGE`**</mark>

### Colores

La lista de colores disponibles, son los siguientes:

`BLUE`, `RED`, `GREEN`, `AQUA`, `BLACK`, `FUCHSIA`, `GRAY`, `LIME`, `MAROON`, `WHITE`, `SILVER`, `YELLOW`, `OLIVE`, `TEAL`, `NAVY`, `PURPLE`, `ORANGE`

{% hint style="info" %}
Estos colores también los puedes usar para <mark style="color:green;">`Fade`</mark>
{% endhint %}

### Power

El poder es con la fuerza que será lanzado el fuego artificial, entre más grande el número más lejos será lanzado el fuego artificial. Se recomienda solo usar hasta <mark style="color:purple;">`4`</mark>. Esto para que los usuarios puedan visualizarlo.

### Amount

La cantidad es cuantos fuegos artificiales será lanzado a la vez cuando un jugador ingrese. Solo se recomienda <mark style="color:purple;">`3`</mark> para evitar que sea algo molestoso y que ocasione lag.

## permission

Este apartado es opcional, si quieres que todos los usuarios puedan seleccionar este fuego artificial sin tener el permiso, solo coloca <mark style="color:blue;">`"none"`</mark>, debería quedar:&#x20;

<pre class="language-yaml" data-title="fireworks.yml" data-line-numbers><code class="lang-yaml"><strong>permission: 'none'
</strong></code></pre>

Pero si gustas, puedes colocarle un permiso, esto para que solo los usuarios con este permiso pueda seleccionarlo.

{% code title="fireworks.yml" lineNumbers="true" %}
```yaml
permission: 'customjoin.firework_name'
```
{% endcode %}

## Ejemplos

Bueno, aquí hay algunos ejemplos de fuegos artificiales, si gustas, puedes copiarlos y colocarlos en tu archivo de configuración.

{% hint style="warning" %}
Recuerda cambiar el nombre del <mark style="color:green;">`path`</mark> (solo si hay alguno repetido) y el lugar donde está ubicado.
{% endhint %}

{% tabs %}
{% tab title="Ejemplo 1" %}
{% code title="fireworks.yml" lineNumbers="true" %}
```yaml
  poderoso:
   material: 'FIREWORK_ROCKET'
   display_name: '&9&lPoderoso'
   slot: 1
   lore:
    - ''
    - '&9&nCaracterísticas:'
    - ''
    - ' &a&l‣ &fTipo: &b%firework_type%'
    - ' &a&l‣ &fColores: &b%firework_colors%'
    - ' &a&l‣ &fDesvanecido: &b%firework_fade%'
    - ' &a&l‣ &fEstado: %firework_status_selected%'
    - ''
    - '%firework_status_locked%'
   firework_type: 'Type:CREEPER;Colors:GREEN,ORANGE;Fade:AQUA,WHITE;Power:4;Amount:3'
   permission: 'customjoinevents.firework.poderoso'
```
{% endcode %}
{% endtab %}

{% tab title="Ejemplo 2" %}
{% code title="fireworks.yml" lineNumbers="true" %}
```yaml
  magnifico:
   material: 'FIREWORK_ROCKET'
   display_name: '&a&lMagnífico'
   slot: 2
   lore:
    - ''
    - '&9&nCaracterísticas:'
    - ''
    - ' &a&l‣ &fTipo: &b%firework_type%'
    - ' &a&l‣ &fColores: &b%firework_colors%'
    - ' &a&l‣ &fDesvanecido: &b%firework_fade%'
    - ' &a&l‣ &fEstado: %firework_status_selected%'
    - ''
    - '%firework_status_locked%'
   firework_type: 'Type:BALL;Colors:BLACK,TEAL;Fade:LIME,MAROON;Power:2;Amount:1'
   permission: 'customjoinevents.firework.magnifico'
```
{% endcode %}
{% endtab %}

{% tab title="Ejemplo 3" %}
{% code title="fireworks.yml" lineNumbers="true" %}
```yaml
  zeus:
   material: 'FIREWORK_ROCKET'
   display_name: '&d&lZeus'
   slot: 3
   lore:
    - ''
    - '&9&nCaracterísticas:'
    - ''
    - ' &a&l‣ &fTipo: &b%firework_type%'
    - ' &a&l‣ &fColores: &b%firework_colors%'
    - ' &a&l‣ &fDesvanecido: &b%firework_fade%'
    - ' &a&l‣ &fEstado: %firework_status_selected%'
    - ''
    - '%firework_status_locked%'
   firework_type: 'Type:BALL_LARGE;Colors:FUCHSIA,OLIVE;Fade:LIME,PURPLE;Power:1;Amount:3'
   permission: 'customjoinevents.firework.zeus'
   
```
{% endcode %}
{% endtab %}

{% tab title="Ejemplo 4" %}
{% code title="fireworks.yml" lineNumbers="true" %}
```yaml
  estrella:
   material: 'FIREWORK_ROCKET'
   display_name: '&9&lEstrellita'
   slot: 4
   lore:
    - ''
    - '&9&nCaracterísticas:'
    - ''
    - ' &a&l‣ &fTipo: &b%firework_type%'
    - ' &a&l‣ &fColores: &b%firework_colors%'
    - ' &a&l‣ &fDesvanecido: &b%firework_fade%'
    - ' &a&l‣ &fEstado: %firework_status_selected%'
    - ''
    - '%firework_status_locked%'
   firework_type: 'Type:STAR;Colors:YELLOW,GREEN;Fade:ORANGE,NAVY;Power:2;Amount:2'
   permission: 'customjoinevents.firework.estrella'
   
```
{% endcode %}
{% endtab %}
{% endtabs %}

## Firework variables

Aquí están las variables que se pueden ocupar únicamente en este evento (lore), pero también puedes ocupar variables de PlaceholderAPI.

|           Variable           |                                                                                                                         Descripción                                                                                                                         |
| :--------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|       `%firework_name%`      |                             Muestra el nombre del fuego artificial, dependiendo la opción que tenga <mark style="color:green;">`(key/display_name)`</mark>. Ejemplo: `estrella` o <mark style="color:blue;">`Estrellita`</mark>                             |
|       `%firework_type%`      |                                                         Muestra el tipo de fuego artificial que se definió en el apartado <mark style="color:orange;">`firework_type`</mark>. Ejemplo: `BALL_LARGE`                                                         |
|      `%firework_colors%`     |                                  Muestra los colores colocados en el apartado <mark style="color:orange;">`firework_type`</mark>. Ejemplo: <mark style="color:red;">`RED`</mark>`,`<mark style="color:blue;">`BLUE`</mark>                                  |
|       `%firework_fade%`      |                             Muestra los colores colocados en el apartado <mark style="color:orange;">`firework_type`</mark>. Ejemplo: <mark style="color:orange;">`ORANGE`</mark>`,`<mark style="color:yellow;">`YELLOW`</mark>                             |
|      `%firework_power%`      |                                                                         Muestra la cantidad colocado en el apartado <mark style="color:orange;">`firework_type`</mark>. Ejemplo: `3`                                                                        |
|      `%firework_amount%`     |                                                                         Muestra la cantidad colocado en el apartado <mark style="color:orange;">`firework_type`</mark>. Ejemplo: `2`                                                                        |
|  `%firework_status_locked%`  | Muestra el estado del fuego artificial, si el usuario tiene el permiso correspondiente le aparecerá el mensaje que usted configuró en translations. Ejemplo: <mark style="color:green;">`Desbloqueado`</mark> o <mark style="color:red;">`Bloqueado`</mark> |
| `%firework_status_selected%` |     Muestra el estado del fuego artificial, si el usuario tiene seleccionado le aparecerá el mensaje que usted configuró en translations. Ejemplo: <mark style="color:green;">`Seleccionado`</mark> o <mark style="color:red;">`No Seleccionado`</mark>     |
|          `%player%`          |                                                                                     Muestra el nombre del jugador que está interactuando con el menú. Ejemplo: `_ImJona`                                                                                    |
