# Informations

## 🗳️ Informations

### Présentation

> FoxVotes est un système de votes avancé compatible avec DeluxeMenus.
>
> Il permet de compter les votes de vos joueurs en jeu à travers plusieurs compteurs, et de leur attribuer des récompenses sous forme de paliers, augmentant ainsi l’engagement des joueurs et la visibilité de votre serveur sur les sites de vote.

***

### Fonctionnalités

* Fonctionne de la 1.20 à la 1.21+
* Intégration directe avec **DeluxeMenus**
* Trois systèmes de comptage indépendants :
  * Récompense de palier (petite récompense)
  * Récompense jackpot (grosse récompense)
  * Classement top vote en jeu (ajLeaderboards requis)
* Réinitialisation des votes via commandes

***

### Placeholders disponibles

À utiliser dans **DeluxeMenus** ou ailleurs via **PlaceholderAPI** :

| Placeholder                      | Description                                    |
| -------------------------------- | ---------------------------------------------- |
| `%foxvotes_votes_small_rewards%` | Total de votes pour les récompenses de paliers |
| `%foxvotes_votes_big_rewards%`   | Total de votes pour les récompenses jackpot    |
| `%foxvotes_votes_total%`         | Total global de votes du joueur                |

***

### Commandes

| Commande                                       | Description                                          |
| ---------------------------------------------- | ---------------------------------------------------- |
| `/votes add small_rewards <joueur> <quantité>` | Ajoute X votes pour les récompenses classiques       |
| `/votes add big_rewards <joueur> <quantité>`   | Ajoute X votes pour les récompenses majeures         |
| `/votes add total <joueur> <quantité>`         | Ajoute X votes au compteur total                     |
| `/votes add all <joueur> <quantité>`           | Ajoute X votes dans tous les compteurs en même temps |

## Fichiers de configuration

<details>

<summary>config.yml</summary>

{% code lineNumbers="true" %}

```yaml
# Do not edit this part if you don't know what you are doing
database:
  type: 'sqlite'  # 'sqlite' or 'mysql'
  address: 'localhost:3306'
  database: 'foxvotes'
  username: 'root'
  password: 'password'

counters:
  small_rewards:
    display_name: '&aPetites Récompenses'
    messages: # if message string is empty, it won't be sent
      add_admin: '&7Vous avez ajouté %amount% vote(s) &a[small_rewards]&7 à %player%.'
      add_player: '&7Vous avez reçu %amount% vote(s) pour &a[small_rewards]&7 !'
      reset_admin: '&7Vous avez réinitialisé les votes &a[small_rewards]&7 de %player%.'
      reset_player: '&7Vos votes &a[small_rewards]&7 ont été réinitialisés.'

  big_rewards:
    display_name: '&cGrosses Récompenses'
    messages: # if message string is empty, it won't be sent
      add_admin: '&7Vous avez ajouté %amount% vote(s) &c[big_rewards]&7 à %player%.'
      add_player: '&7Vous avez reçu %amount% vote(s) pour &c[big_rewards]&7 !'
      reset_admin: '&7Vous avez réinitialisé les votes &c[big_rewards]&7 de %player%.'
      reset_player: '&7Vos votes &c[big_rewards]&7 ont été réinitialisés.'

  total:
    display_name: '&eVotes Totaux'
    messages: # if message string is empty, it won't be sent
      add_admin: '&7Vous avez ajouté %amount% vote(s) &e[total]&7 à %player%.'
      add_player: '&7Vous avez reçu %amount% vote(s) pour &e[total]&7 !'
      reset_admin: '&7Vous avez réinitialisé les votes &e[total]&7 de %player%.'
      reset_player: '&7Vos votes &e[total]&7 ont été réinitialisés.'

messages:
  no_permission: "&cVous n'avez pas la permission de faire ça."
  invalid_counter: "&cLe compteur &e%counter% &cn'existe pas. Liste des compteurs : &f%counters%"
  invalid_number: "&cCet argument doit être un nombre entier positif."
  player_not_found: "&cLe joueur &e%player% &cn'a pas été trouvé ou n'est pas en ligne."
  all_reset_for_player: "&aTous les compteurs ont été réinitialisés pour &e%player%&a."
  all_my_counters_reset: "&aTous vos compteurs ont été réinitialisés."
  all_reset_specific_counter: "&aLe compteur %counter% a été réinitialisé pour tous les joueurs."
  all_added_for_player: "&aTous vos compteurs ont été incrémentés de %amount%."
  all_added_for_admin: "&aTous les compteurs de %player% ont été incrémentés de %amount%."
  commands:
    - "&cListe des commandes :"
    - "&c/votes add <player> <counter/all> [quantity] &7- &fAjoute un vote à un joueur sur un compteur ou sur tous."
    - "&c/votes reset <player> <counter> &7- &fRéinitialise un compteur pour un joueur."
    - "&c/votes resetallcounters <player> &7- &fRéinitialise tous les compteurs pour un joueur."
    - "&c/votes resetall <counter> &7- &fRéinitialise un compteur pour tous les joueurs."

# Placeholders to use in scoreboards, GUIs, etc.
# (Do not declare/uncomment them, they are automatically registered)
# %foxvotes_votes_<counter_id>% - Shows the player votes for the given counter
```

{% endcode %}

</details>