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

prefix: ""

database:
  # sqlite, h2 or mysql
  type: h2
  host: localhost
  port: 3306
  name: salaires
  user: root
  password: ""

update-notifier:
  enabled: true
  on-join: true
  notify-console: true

salary:
  # Time unit for payment: SECONDS, MINUTES, HOURS
  payment-unit: "HOURS"
  # Interval between each payment (in the specified unit)
  payment-interval: 1
  # Automatic payment enabled
  auto-payment: true
  # Use LuckPerms for groups/salaries
  use-luckperms: true
  # Use the group system
  use-groups: true
  # Pay offline players
  offline-payment: false
  # Delay before the first payment (in seconds)
  payment-delay: 0
  # Minimum online time before receiving a salary (in seconds)
  min-online-time: 0
  # Exclude AFK players from payment
  afk-exclude: false
  # Worlds where salaries do not apply
  world-blacklist: []

bonus:
  permission:
    enabled: true
    permission-node: "salaire.bonus"
    multiplier: 1.5

booster:
  enabled: true
  global:
    enabled: true
    multiplier: 1.0
    permission: ""
  hourly:
    enabled: true
    multiplier: 1.2
    start-hour: 16
    end-hour: 00
    days: [MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY]
  weekly:
    enabled: false
    day: "MONDAY"
    multiplier: 1.2
    time: "20:00"
  monthly:
    enabled: false
    day: 1
    multiplier: 2.0
  special:
    enabled: false
    events:
      christmas:
        days: ["12-24", "12-25", "12-26"]
        multiplier: 2.0
      newyear:
        days: ["12-31", "01-01"]
        multiplier: 1.8

luckperms:
  use-groups: true
  default-salary: 1500
  groups:
    default: 2000
    admin: 5000

---

📦 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.