> For the complete documentation index, see [llms.txt](https://wiki.ax3lt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.ax3lt.com/plugins/joinparticles.md).

# JoinParticles

## Con questo plugin puoi spawnare delle particelle quando un player entra nel tuo server.

Per impostare i permessi delle particelle avrai bisogno di un plugin come [LuckPerms](https://luckperms.net/).

Per impostare un permesso con LuckPerms bisogna digitare questo comando in chat o da console:

`lp nome permission set joinparticles.X`

Con X che sia il numero scelto dalla config.yml

**Comandi e permessi**:

|        Comando        |    Permesso   |
| :-------------------: | :-----------: |
| /joinparticles reload | joinparticles |

#### **File di configurazione:**

{% tabs %}
{% tab title="YAML" %}
{% code title="config.yml" %}

```yaml
###############################################################
#                        JoinParticles                        #
###############################################################

# !!!THIS PLUGIN WORKS ONLY WITH A PERMISSION PLUGIN!!!

# You can choose between different types of particles and assign each one to a different role,
# for example Vip has LAVA, Vip ++ has EXPLOSION_LARGE, and you can change the number of particles generated by "particles-number".
# If you have luckperms you have to use the command:
#  lp group Vip permission set joinparticles.1 ( or whatever type of particle you want to put )
#  And when a player from the VIP group enters the server, particles visible to everyone will be spawned

#  !!!ATTENTION!!! if you insert a high number of particles your server could lag

# You can choose from one of the following particles.
#    BARRIER
#    BLOCK_CRACK
#    BLOCK_DUST
#    BUBBLE_COLUMN_UP
#    BUBBLE_POP
#    CAMPFIRE_COSY_SMOKE
#    CAMPFIRE_SIGNAL_SMOKE
#    CLOUD
#    COMPOSTER
#    CRIT
#    CRIT_MAGIC
#    CURRENT_DOWN
#    DAMAGE_INDICATOR
#    DOLPHIN
#    DRAGON_BREATH
#    DRIP_LAVA
#    DRIP_WATER
#    DRIPPING_HONEY
#    ENCHANTMENT_TABLE
#    END_ROD
#    EXPLOSION_HUGE
#    EXPLOSION_LARGE
#    EXPLOSION_NORMAL
#    FALLING_DUST
#    FALLING_HONEY
#    FALLING_LAVA
#    FALLING_NECTAR
#    FALLING_WATER
#    FIREWORKS_SPARK
#    FLAME
#    FLASH
#    HEART
#    ITEM_CRACK
#    LANDING_HONEY
#    LANDING_LAVA
#    LAVA
#    LEGACY_BLOCK_CRACK
#    LEGACY_BLOCK_DUST
#    LEGACY_FALLING_DUST
#    MOB_APPEARANCE
#    NAUTILUS
#    NOTE
#    PORTAL
#    REDSTONE
#    SLIME
#    SMOKE_LARGE
#    SMOKE_NORMAL
#    SNEEZE
#    SNOW_SHOVEL
#    SNOWBALL
#    SPELL
#    SPELL_INSTANT
#    SPELL_MOB
#    SPELL_MOB_AMBIENT
#    SPELL_WITCH
#    SPIT
#    SQUID_INK
#    SUSPENDED
#    SUSPENDED_DEPTH
#    SWEEP_ATTACK
#    TOTEM
#    TOWN_AURA
#    VILLAGER_ANGRY
#    VILLAGER_HAPPY
#    WATER_BUBBLE
#    WATER_DROP
#    WATER_SPLASH
#    WATER_WAKE

#You can put a delay to spawn the particles a little later (use it if the players don't see the particles)
delay: 5


1:
  permission: joinparticles.1
  particles: LAVA
  particles-number: 10

2:
  permission: joinparticles.2
  particles: LAVA
  particles-number: 10

3:
  permission: joinparticles.3
  particles: LAVA
  particles-number: 10

4:
  permission: joinparticles.4
  particles: LAVA
  particles-number: 10

5:
  permission: joinparticles.5
  particles: LAVA
  particles-number: 10

6:
  permission: joinparticles.6
  particles: LAVA
  particles-number: 10

7:
  permission: joinparticles.7
  particles: LAVA
  particles-number: 10

8:
  permission: joinparticles.8
  particles: LAVA
  particles-number: 10

9:
  permission: joinparticles.9
  particles: LAVA
  particles-number: 10

10:
  permission: joinparticles.10
  particles: LAVA
  particles-number: 10
```

{% endcode %}
{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://wiki.ax3lt.com/plugins/joinparticles.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.