Salaires

!Features

!Version !Spigot !Java

Automatic salary plugin with LuckPerms group integration, a full boost system, PlaceholderAPI support, and multi-database storage.

---

✨ Features

• 💰 Automatic salary payment at a configurable interval (seconds / minutes / hours)
• 🏷️ LuckPerms group-based salaries with per-group amounts
• 🚀 Boost system — hourly, weekly, monthly, and special event boosts
• 🎁 Permission-based bonus multiplier for VIP players
• 💤 Offline payment — players receive missed salaries on next login
• 🌍 World blacklist — disable salaries in specific worlds
• ⏱️ Minimum online time before first payment
• 🔌 PlaceholderAPI integration (11 placeholders)
• 🔄 Hot-reload without server restart
• 💾 H2, SQLite, and MySQL database support

---

!Commands

Command	Description
/salaires help	Show the help menu
/salaires time	Time until next salary
/salaires check [player]	Check your or another player's salary
/salaires reload	Reload the configuration
/salaires set <player> <amount>	Set a player's custom salary
/salaires give <player> <amount>	Give money to a player
/salaires reset [confirm]	Reset all salary data

Aliases: /salary, /sal

---

!Perms

Permission	Description	Default
salaire.*	All permissions	op
salaire.user	Basic user permissions	true
salaire.user.time	Check time until next salary	true
salaire.admin	All admin permissions	op
salaire.admin.reload	Reload configuration	op
salaire.admin.check	Check other players' salaries	op
salaire.admin.set	Set a player's salary	op
salaire.admin.give	Give money to a player	op
salaire.admin.reset	Reset salary data	op
salaire.admin.boost	Manage boosts	op
salaire.bonus	Receive the bonus multiplier	false

---

!Placeholders

Placeholder	Description
%salaires_amount%	Calculated salary the player will receive
%salaires_time%	Formatted time until next payment
%salaires_time_seconds%	Seconds until next payment
%salaires_time_minutes%	Minutes until next payment
%salaires_time_hours%	Hours until next payment
%salaires_next_payment%	Timestamp (ms) of next payment
%salaires_last_payment%	Timestamp (ms) of last payment
%salaires_total_received%	Total money received from salaries
%salaires_booster%	Current boost multiplier (e.g. 1.5)
%salaires_booster_multiplier%	Boost as percentage (e.g. +50.00%)
%salaires_prefix%	Plugin prefix with colors

---

!Configs

salary:
  payment-unit: "MINUTES"   # SECONDS, MINUTES, HOURS
  payment-interval: 10
  auto-payment: true
  use-luckperms: true
  offline-payment: true
  min-online-time: 0         # seconds
  world-blacklist: []

luckperms:
  default-salary: 1000
  groups:
    admin: 5000
    vip: 2000
    member: 1000

booster:
  hourly:
    enabled: true
    multiplier: 1.2
    start-hour: 18
    end-hour: 22
  weekly:
    enabled: true
    day: "MONDAY"
    multiplier: 1.5
    time: "20:00"
  special:
    enabled: true
    events:
      christmas:
        days: ["12-24", "12-25", "12-26"]
        multiplier: 2.0

database:
  type: h2   # h2, sqlite, mysql

---

📦 Dependencies

• Required: Vault
• Optional: LuckPerms — for group-based salaries
• Optional: PlaceholderAPI — for placeholders

---

🐛 Support

Found a bug or have a suggestion? Open an issue on the project page.