config.yml Reference – Points, Limits & Bonuses

The main configuration file is located at plugins/RankForge/config.yml. After editing it, execute /rankforge reload. Note: changes to the database section require a server restart.

`settings`

settings:
  debug-mode: false
  language: "en"
  allow-negative-points: true
  data-save:
    delay-seconds: 300
  daily-limit:
    enabled: true
    max-kills: 20
  fixed-points:
    per-kill: 2
    per-death: 2
  kill-rewards:
    enabled: true
    commands:
      - "eco give <killer> 50"

Key	Default	Description
`debug-mode`	`false`	Displays verbose `[DEBUG]` logs in the server console (point changes, bonus resets, etc.).
`language`	`"en"`	Language code: `en`, `id`, `vi`, or a custom language file. See Languages & Messages.
`allow-negative-points`	`true`	When `false`, player points will not drop below 0 upon deaths or via API calls.
`data-save.delay-seconds`	`300`	Async database auto-save frequency in seconds. Minimum enforced is 10s. Takes effect on server restart.
`daily-limit.enabled`	`true`	Enables daily kill point capping.
`daily-limit.max-kills`	`20`	Maximum number of kills per day that grant points.
`fixed-points.per-kill`	`2`	Points awarded to the killer.
`fixed-points.per-death`	`2`	Points deducted from the victim.
`kill-rewards.enabled`	`true`	Executes reward commands upon every kill.
`kill-rewards.commands`	`eco give <killer> 50`	Console command list. Supported placeholders: `<killer>`, `<victim>`.

Daily Limit Behavior

The daily counter resets automatically when the server date changes.
Upon reaching the limit, the killer receives the messages.limit-reached notification once.
Subsequent kills past the limit do not award points, increment kills, or execute kill rewards. The victim still loses points.

Kill Rewards

settings:
  kill-rewards:
    enabled: true
    commands:
      - "eco give <killer> 50"
      - "crate key give <killer> vote 1"

`first-kill-bonus`

first-kill-bonus:
  enabled: true
  min-points: 5
  max-points: 15
  reset-hour: 0

Key	Default	Description
`enabled`	`true`	Enables daily first-kill bonus points.
`min-points` / `max-points`	`5` / `15`	Bonus points chosen randomly between min and max (inclusive).
`reset-hour`	`0`	Daily reset hour (0–23 server time). `0` represents midnight.

Bonus points are added on top of per-kill, so the first kill of the day awards per-kill + bonus points.

`database`

Detailed separately in Database Configuration.

`tiers`

Detailed separately in Tiers & Rewards.