# JoinSound

## Con questo plugin puoi avviare un suono quando un player entra nel tuo server.

### Info

Per impostare i permessi avrai bisogno di un plugin di come [LuckPerms](https://luckperms.net/).\
Puoi modificare il suono da config.yml. \
Con l'opzione "first join sound" puoi avere un suono personalizzato per il player che entra per la prima volta e il ritardo del suono.

### **Comandi e permessi**

|        Comando        |  Permesso |
| :-------------------: | :-------: |
|    /joinsound help    | joinsound |
|   /joinsound reload   | joinsound |
| /joinsound normalJoin | joinsound |
|  /joinsound firstJoin | joinsound |

#### **Permessi aggiuntivi:**

`joinsound.personalized`

Ti abilita il permesso aggiuntivo per il suono personalizzato.

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

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

```yaml
########################################################################
#                             JoinSound                                #
########################################################################


#A list of supported sounds can be found here: https://www.digminecraft.com/lists/sound_list_pc.php

#First Join
firstJoinSound: entity.ender_dragon.growl
firstJoinVolume: 3
firtsJoinPitch: 1.0

#Normal Join
sound: entity.player.levelup
volume: 3
pitch: 1.0

# Personalized join sound ( E.s sound when owner joins )
personalized-sound:
  enabled: false
  play-to-all-players: true
  sound: ui.toast.challenge_complete
  volume: 3
  pitch: 1.0
  permission: joinsound.personalized # Works with permission plugins

# Do you want a sound to be played to all online players when a player join?
sound-to-all-on-join:
  enabled: true
  sound: block.note_block.harp
  volume: 3
  pitch: 1.0

# Do you want a sound to be played to all online players when a player leave?
sound-to-all-on-leave:
  enabled: true
  sound: block.note_block.bass
  volume: 3
  pitch: 1.0


#Delay Time
#If necessary, write a delay value if the sound is not listened to completely ( accept numbers with dot ) ( is in milliseconds )
# E.g. delay: 100
delay: 0


#Messages

#Reload message
reload-message: "&6[&9JoinSound&6]&a&l Reload completed!"

#Message in the console when the plugin is turned on
plugin-start: "&2JoinSound has been activated!"

#Message in the console when the plugin is turned off
plugin-stop: "&4JoinSound has been disabled!"

#Help message ( /joinsound help )
help-message:
  - "&6&nList of commands:"
  - "&a&l/joinsound help &r&b-->&r &9&oView this menu&r"
  - "&a&l/joinsound reload &r&b-->&r &9&oReload config.yml&r"
  - "&a&l/joinsound normalJoin &r&b-->&r &9&oView and play the current sound&r"
  - "&a&l/joinsound firstJoin &r&b-->&r &9&oView and play the current sound for a player who joins for the first time\n&r"

# /joinsound normalJoin
normaljoin-message: "&3&lSound name: &r&c&o"

# /joinsound firstJoin
firstjoin-message: "&3&lSound name: &r&c&o"

# Wrong usage message ( /joinsound )
wrongusage-message: "&9&oIncorrect use of the command:\nFor a list of commands type &r&b--> &r&a&l/joinsound help"
```

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


---

# Agent Instructions: 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:

```
GET https://wiki.ax3lt.com/plugins/joinsound.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.