wPlayerReferrals | Advanced Referrals v1.0.0

A fully automatic, abuse-protected referral system for Minecraft servers.
referral1.png
wplayerreferals.png
ayy1.jpg

config.yml
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
# wPlayerReferrals - Configuration
# Author: wulnrydev
# Version: 1.0.0
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
# -------------------------------------------------------------
# DATABASE SETTINGS
# -------------------------------------------------------------
database:
# Type can be: SQLITE, MYSQL
type: SQLITE

# MySQL Settings (Only if type is MYSQL)
host: "localhost"
port: 3306
database: "minecraft"
username: "root"
password: "password"

# Connection Pool Settings (HikariCP)
pool-settings:
max-pool-size: 10
min-idle: 2
max-lifetime: 1800000 # 30 minutes
connection-timeout: 30000 # 30 seconds
# -------------------------------------------------------------
# REFERRAL SETTINGS
# -------------------------------------------------------------
referral:
# Code formatting
code-length: 8
# Minimum playtime required to use a referral code (in seconds)
# Set to 0 to disable.
min-playtime-to-use: 300 # 5 minutes

# Minimum playtime required to CREATE a referral code
min-playtime-to-create: 0

# Cooldown between referral usages (global or per IP check?)
# This is mainly for command spam prevention.
command-cooldown: 5
# -------------------------------------------------------------
# ANTI-ABUSE PROTECTION
# -------------------------------------------------------------
protection:
# Prevent players from referring themselves from the same IP?
block-same-ip: true

# Block if the referring player and new player have the same IP?
# This prevents Alt-Account farming.
prevent-same-ip-referral: true

# Log suspicious activity to console/file?
log-suspicious-activity: true
# -------------------------------------------------------------
# REWARDS
# -------------------------------------------------------------
rewards:
# Rewards for the person being referred (The new player)
referred-player:
# Commands to execute from console.
# Placeholders: %player%
commands:
- "eco give %player% 500"

# Sound to play (Bukkit sound name)
sound: "ENTITY_PLAYER_LEVELUP"

# Rewards for the referrer (The owner of the code)
referrer:
commands:
- "eco give %player% 1000"
sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
# -------------------------------------------------------------
# MESSAGES
# Supports HEX colors (e.g., &#FF0000) and legacy (&c)
# -------------------------------------------------------------
messages:
prefix: "&8[&bwReferrals&8] &7"
no-permission: "&cYou do not have permission to use this."
unknown-command: "&cUnknown command. Type /referral help."
only-players: "&cOnly players can use this command."

# Help
help-header: "&8&m-----------------&r &bReferral Help &8&m-----------------"
help-footer: "&8&m--------------------------------------------------"
usage: "&cUsage: %usage%"

# Referral flow
code-created: "&aYour referral code is: &b%code%&a. Share it with friends!"
code-already-exists: "&cYou already have a referral code: &b%code%"
invalid-code: "&cThat referral code does not exist."
cannot-refer-self: "&cYou cannot use your own referral code!"
already-referred: "&cYou have already redeemed a referral code."
referral-success: "&aSuccessfully redeemed code &b%code%&a!"
referral-success-target: "&aSuccessfully redeemed code from &e%owner%&a!"
same-ip-block: "&cYou cannot use a referral code from the same IP address."
min-playtime-error: "&cYou must play for at least %time% before using a referral."

# Stats
stats-header: "&8&m-----------------&r &bYour Statistics &8&m-----------------"
stats-code: "&7Your Code: &f%code%"
stats-footer: "&8&m--------------------------------------------------"

# Admin
reload-success: "&aConfiguration reloaded successfully."
admin-reset: "&aReset referral data for &e%player%&a."
admin-set-success: "&aSet referral code for &e%player% &ato &b%code%&a."
admin-delete-success: "&aDeleted referral code for &e%player%&a."

admin-top-header: "&8&m-----------------&r &bTop Referrers &8&m-----------------"
admin-top-entry: "&e#%rank% &7- &b%player% &7- &f%count% referrals"
admin-top-footer: "&8&m--------------------------------------------------"

admin-info-header: "&8&m-----------------&r &bInfo: %player% &8&m-----------------"
admin-info-code: "&7Code: &f%code%"
admin-info-count: "&7Referrals: &f%count%"
admin-info-list: "&7List: &f%list%"
admin-info-footer: "&8&m--------------------------------------------------"
# -------------------------------------------------------------
# UPDATE CHECKER
# -------------------------------------------------------------
update-checker:
enabled: true
notify-admins: true
# -------------------------------------------------------------
# DISCORD WEBHOOK
# -------------------------------------------------------------
discord-webhook:
enabled: false
url: ""
# Events to log
events:
referral-success: true
suspicious-activity: true
ChatGPT Image 26 Oca 2026 01_15_53.png
Buy a license now
$4.99
EULA
Standard EULA
Use on any projects you own with attribution
Support
Standard
Includes:
Download the resource
Access new updates
Support from the creator
Support duration
Lifetime
Share and earn
Refer this resource and earn a 10% commission.
236 Views
1 Purchases
3 Downloads
Jan 31, 2026 Published
N/A Updated
Not yet rated
1.5 MB File size
Open source
  1. No
DRM-free
  1. No
Unobfuscated
  1. Yes
Type
  1. Gameplay
  1. Economy
  1. Reward
Game mode
  1. Survival
  1. Skyblock
  1. Prison
Supported software
  1. Bukkit
  1. Spigot
  1. Paper
Supported versions
  1. 1.21.11
  1. 1.21.8
  1. 1.21.5
  1. 1.21.4
  1. 1.21.2
  1. 1.21
  1. 1.20
Supported languages
  1. English
Creator
Struggling to cover the costs of your server? Set up your own webstore with Tebex in under 30 seconds.
Host a lag-free Minecraft or Hytale server in minutes.
Get 25% off your first order with our link.
Recommended for you
Timed Nether access with tickets, entry rules, placeholders, and SQLite/MySQL support.
Not yet rated
5 purchases
wAutoRank is a fully automated rank management plugin designed to handle player rank progression.
5.00 star(s) 1 ratings
2 purchases
#1 BuiltByBit Plugin ~ Protects your server from crash packet exploits ~ Folia Support
5.00 star(s) 141 ratings
4,215 purchases
Create items, blocks, mobs, emojis, and more with automatic resourcepack generation!
5.00 star(s) 54 ratings
3,186 purchases
Protect your server from crash/dupe/packet exploits with the ultimate security fix plugin.
5.00 star(s) 44 ratings
3,103 purchases
Share and earn
Refer this resource and earn a 10% commission.
236 Views
1 Purchases
3 Downloads
Jan 31, 2026 Published
N/A Updated
Not yet rated
1.5 MB File size
Open source
  1. No
DRM-free
  1. No
Unobfuscated
  1. Yes
Type
  1. Gameplay
  1. Economy
  1. Reward
Game mode
  1. Survival
  1. Skyblock
  1. Prison
Supported software
  1. Bukkit
  1. Spigot
  1. Paper
Supported versions
  1. 1.21.11
  1. 1.21.8
  1. 1.21.5
  1. 1.21.4
  1. 1.21.2
  1. 1.21
  1. 1.20
Supported languages
  1. English
Creator
Struggling to cover the costs of your server? Set up your own webstore with Tebex in under 30 seconds.
Host a lag-free Minecraft or Hytale server in minutes.
Get 25% off your first order with our link.
Recommended for you
Timed Nether access with tickets, entry rules, placeholders, and SQLite/MySQL support.
Not yet rated
5 purchases
wAutoRank is a fully automated rank management plugin designed to handle player rank progression.
5.00 star(s) 1 ratings
2 purchases
#1 BuiltByBit Plugin ~ Protects your server from crash packet exploits ~ Folia Support
5.00 star(s) 141 ratings
4,215 purchases
Create items, blocks, mobs, emojis, and more with automatic resourcepack generation!
5.00 star(s) 54 ratings
3,186 purchases
Protect your server from crash/dupe/packet exploits with the ultimate security fix plugin.
5.00 star(s) 44 ratings
3,103 purchases
Top