Compatibility
Minecraft: Java Edition
26.1.x
1.21.x
1.20.x
1.19.x
1.18.x
Platforms
Tags
Creators
Details
Licensed Primly Documentation
Published last year
Valentines
Original Valentines plugin. Everything in one.
Let your players be together!
Features (2026+1.4.6)
- GUI: Keep it simple with only
/vguior/valentinescommands - Marriages: Marry your favorite person
- Friends system: No friends in real life? Don't worry
- Achievements: Unlock them while playing or trying new functions
- Mood: You're sad? Happy? Or just something in between?
- Effects: You look better with particles around you
- Kiss, Hug, Like: Valentines without this? Imagine
- PlaceholdersAPI: You can use Valentines stats everywhere
- More features: Let's download it to see it's full potential
Commands & Permissions (2026+1.4.6)
| Command | Alias | Description | Permission |
|---|---|---|---|
/valentines |
/vgui, /val |
Opens main GUI | valentines.use |
/vreload |
- | Reloads configuration | valentines.reload |
Placeholders (2026+1.4.6)
| Placeholder | Meaning |
|---|---|
%valentines_name% |
Player name from Valentines data |
%valentines_hugs% |
How many hugs the player received |
%valentines_hugs_received% |
How many hugs the player received |
%valentines_kisses% |
How many kisses the player received |
%valentines_kisses_received% |
How many kisses the player received |
%valentines_likes% |
How many likes the player received |
%valentines_likes_received% |
How many likes the player received |
%valentines_hugs_given% |
How many hugs the player gave to others |
%valentines_kisses_given% |
How many kisses the player gave to others |
%valentines_likes_given% |
How many likes the player gave to others |
%valentines_total_received% |
Total received interactions (hugs + kisses + likes) |
%valentines_total_given% |
Total given interactions (hugs + kisses + likes) |
%valentines_total_score% |
Player's total score |
%valentines_mood% |
Localized/formatted mood text (e.g. Very Good) |
%valentines_mood_raw% |
Raw saved mood key (e.g. very-good) |
%valentines_is_married% |
true if player is currently married, otherwise false |
%valentines_partner% |
Partner name if married; otherwise None |
%valentines_days_married% |
Number of days since marriage date |
%valentines_relationship_status% |
single, engaged, or married |
%valentines_is_engaged% |
true if player has an active engagement |
%valentines_engaged_with% |
The other player in the active engagement; otherwise None |
%valentines_engagement_days% |
Days elapsed since engagement started |
%valentines_engagement_hours% |
Hours elapsed since engagement started |
%valentines_achievements_unlocked% |
Number of achievements unlocked by the player |
%valentines_achievements_total% |
Total number of achievements available |
%valentines_achievements_remaining% |
Number of locked achievements |
%valentines_achievements_progress% |
Achievement completion percentage (e.g. 46.7) |
%valentines_has_achievement_<key>% |
Returns true or false depending on whether the player has unlocked the specified achievement |
%valentines_top_name_<position>% |
Player name at leaderboard position 1-100 |
%valentines_top_score_<position>% |
Total score at leaderboard position 1-100 |
%valentines_top_hugs_<position>% |
Received hugs at leaderboard position 1-100 |
%valentines_top_kisses_<position>% |
Received kisses at leaderboard position 1-100 |
%valentines_top_likes_<position>% |
Received likes at leaderboard position 1-100 |
%valentines_top_hugs_given_<position>% |
Given hugs at leaderboard position 1-100 |
%valentines_top_kisses_given_<position>% |
Given kisses at leaderboard position 1-100 |
%valentines_top_likes_given_<position>% |
Given likes at leaderboard position 1-100 |
Achievement Keys
| Key |
|---|
first_kiss_received |
first_hug_received |
first_like_received |
first_kiss_given |
first_hug_given |
first_like_given |
reach_10_kisses |
reach_10_hugs |
reach_10_likes |
marriage |
divorce |
married_30_days |
married_365_days |
married_2_years |
first_mood_set |
TOP Values
Format:
%valentines_top_<type>_<position>%
Types
namescorehugskisseslikeshugs_givenkisses_givenlikes_given
Positions
1to100
Images / Screenshots (2026+1.4.6)
Section "Gallery"
Files
config.yml
# ╔════════════════════════════════════════════════════════════════════╗
# ║ VALENTINES PLUGIN CONFIG ║
# ║ Update: June 3, 2026 ║
# ╚════════════════════════════════════════════════════════════════════╝
# ╔════════════════════════════════════════════════════════════════════╗
# ║ CHAT ║
# ╚════════════════════════════════════════════════════════════════════╝
# Plugin prefix
Prefix: "&d&lValentines &7»&r "
# Allows changing "words" with "symbol"
symbol-change: true
symbol-color: "&c"
symbol: "♥"
words:
- "<3"
- "valentines"
- "heart"
# ╔════════════════════════════════════════════════════════════════════╗
# ║ PARTICLE EFFECT SETTINGS ║
# ╚════════════════════════════════════════════════════════════════════╝
effect:
enabled: true
# Number of particles spawned per effect tick
particle-density: 2
# How often effects update in ticks (20 ticks = 1 second)
update-rate: 3
# Maximum height particles can reach above player (in blocks)
max-height: 2.5
# Starting height of particles above player's feet (in blocks)
start-height: 0.1
# Horizontal radius of particle effects (in blocks)
radius: 1.0
# Enable/disable specific action particle effects
kiss-effect: true
hug-effect: true
marriage-effect: true
# ╔════════════════════════════════════════════════════════════════════╗
# ║ WORLD SETTINGS ║
# ╚════════════════════════════════════════════════════════════════════╝
# List of worlds where the plugin features are active
enabled-worlds:
- "world"
- "world_nether"
- "world_the_end"
# ╔════════════════════════════════════════════════════════════════════╗
# ║ COOLDOWN SETTINGS ║
# ╚════════════════════════════════════════════════════════════════════╝
# Cooldowns for each action (in seconds)
cooldowns:
hug: 45
kiss: 60
like: 240
# ╔════════════════════════════════════════════════════════════════════╗
# ║ MARRIAGE SYSTEM SETTINGS ║
# ╚════════════════════════════════════════════════════════════════════╝
marriage:
# How long a marriage proposal stays valid (in seconds)
proposal-timeout: 45
# Cooldown between sending marriage proposals (in seconds)
proposal-cooldown: 30
# If false, proposals are instantly accepted
require-confirmation: true
# Broadcast marriage announcements to the entire server
announcement: true
# ╔════════════════════════════════════════════════════════════════════╗
# ║ ANNIVERSARY SYSTEM SETTINGS ║
# ╚════════════════════════════════════════════════════════════════════╝
anniversary:
enabled: true
# Who sees announcement: "global" (everyone), "couple" (only the couple), "world" (specific worlds)
announcement-type: "global"
announcement-worlds:
- "world"
check-interval: 300
# ╔════════════════════════════════════════════════════════════════════╗
# ║ LEADERBOARD SETTINGS ║
# ╚════════════════════════════════════════════════════════════════════╝
leaderboard:
# Enable the love leaderboard showing top players by hugs/kisses/likes
enabled: true
# ╔════════════════════════════════════════════════════════════════════╗
# ║ DATA MANAGEMENT ║
# ╚════════════════════════════════════════════════════════════════════╝
# How often to automatically save all player data to disk (in minutes)
auto-save: 30
# ╔════════════════════════════════════════════════════════════════════╗
# ║ ACHIEVEMENT SYSTEM ║
# ╚════════════════════════════════════════════════════════════════════╝
achievements:
enabled: true
# Broadcast achievement unlocks to all players on the server
broadcast: true
# Uses Minecraft's UI_TOAST_CHALLENGE_COMPLETE sound when unlocked
sound-enabled: true
# ╔════════════════════════════════════════════════════════════════════╗
# ║ PLACEHOLDERAPI SETTINGS ║
# ╚════════════════════════════════════════════════════════════════════╝
placeholderapi:
# Registers %valentines_*% placeholders when PlaceholderAPI is installed
enabled: true
# ╔════════════════════════════════════════════════════════════════════╗
# ║ VERSION CHECKER SETTINGS ║
# ╚════════════════════════════════════════════════════════════════════╝
config-version: "2026+1.4.6"
version-checker:
enabled: true
check-on-startup: true
minimum-interval-seconds: 600
# ╔════════════════════════════════════════════════════════════════════╗
# ║ FRIENDS SETTINGS ║
# ╚════════════════════════════════════════════════════════════════════╝
friends:
# Messaging when your friends join/leave the server
join-leave-notifications: true
# ╔════════════════════════════════════════════════════════════════════╗
# ║ GUI SETTINGS ║
# ╚════════════════════════════════════════════════════════════════════╝
gui:
background:
enabled: true
material: "PINK_STAINED_GLASS_PANE"
name: "&7"
items:
main:
stats: "BOOK"
marriages: "CAKE"
marriage: "SUNFLOWER"
settings: "REDSTONE"
leaderboard: "GOLDEN_APPLE"
achievements: "ROSE_BUSH"
player-search: "COMPASS"
close: "BARRIER"
stats:
mood-display: "TOTEM_OF_UNDYING"
lang/en.yml
plugin:
reload: "&aValentines plugin has been reloaded successfully!"
general:
no-permission: "&cYou don't have permission to use this command!"
player-offline: "&cThat player is not online right now!"
cooldown: "&cYou can use &d{command}&c again in &d{time}&c seconds!"
hug:
sent: "&fYou gave &d{player} &fa hug!"
received: "&d{player} &fgave you a hug!"
kiss:
sent: "&fYou kissed &d{player}&f!"
received: "&d{player} &fkissed you!"
like:
already-liked: "&cYou've already liked &d{player}&c!"
sent: "&fYou liked &d{player}&f!"
received: "&d{player} &flikes you!"
marry:
self: "&cYou can't marry yourself!"
proposal-sent: "&fMarriage proposal sent to &d{player}&f! Good luck!"
proposal-received: "&d{player} &fwants to marry you! \n&fOpen &d/vgui &fand use the &eMarriage &fmenu to accept or deny."
already-married: "&cYou're already married to &d{partner}&c!"
target-already-married: "&d{player}&c is already taken!"
no-pending-proposals: "&cYou have no pending marriage proposals!"
proposer-offline: "&cThe person who proposed is no longer online!"
proposal-cooldown: "&cYou can propose again in &d{time}&c seconds!"
accept-sender: "&d{player} &aaccepted your proposal! You're now married!"
accept-receiver: "&aYou married &d{player}&a!"
decline-sender: "&d{player} &cdeclined your proposal."
decline-receiver: "&cYou declined &d{player}'s &cproposal."
announcement: "&d{player1} &fand &d{player2} &fjust got married! &d Congratulations!"
divorce-announcement: "&c{player1} &fand &c{player2} &fhave divorced."
chat-propose-prompt: "&fType the name of the player you want to propose to."
chat-propose-not-found: "&cPlayer &d{player} &cis not online!"
requests-disabled: "&d{player} &cis not accepting marriage requests."
active-proposal: "&cYou or that player already have an active marriage proposal."
anniversary:
global-announcement: "&d&5ANNIVERSARY CELEBRATION! &d{player1} &fand &d{player2} &fcelebrate &d{years} &fyear(s) of marriage!"
couple-message: "&d&5Happy Anniversary! &fYou and &d{partner} &fhave been married for &d{years} &fyear(s)!"
world-announcement: "&d{player1} &fand &d{player2} &fcelebrate their &d{years} &fyear anniversary!"
mood:
updated: "&fYour mood has been updated to: &d{mood}"
unknown: "&7Unknown"
very-good: "&aVery Good"
good: "&eGood"
neutral: "&fNeutral"
bad: "&cBad"
very-bad: "&4Very Bad"
player-search:
prompt: "&fPlease type the name of the player you want to search for:"
not-found: "&cPlayer '&d{player}&c' not found or is not online!"
searching: "&fSearching for player: &d{player}&f..."
gui:
main-menu-title: "&d❤ Valentines Menu ❤"
stats-menu-title: "&d❤ &5Player Stats &d❤"
leaderboard-title: "&d❤ &5Love Leaderboard &d❤"
marriages-title: "&d❤ &5Married Couples &d❤"
marriage-menu-title: "&d❤ &5Marriage &d❤"
marriage-proposals-menu-title: "&d❤ &5Marriage Proposals &d❤"
settings-title: "&d❤ &5Effect Settings &d❤"
mood-title: "&d❤ &5Mood Settings &d❤"
achievements-menu-title: "&d❤ &5Achievements &d❤"
player-profile-title: "&d❤ &5{player}'s Profile &d❤"
stats-button-title: "&dYour Stats"
stats-button-lore:
- "&fView your statistics"
- "&7See what and from who you received"
leaderboard-button-title: "&dLeaderboard"
leaderboard-button-lore:
- "&fSee the most loved players"
- "&7Compete for the top spot!"
marriages-button-title: "&dMarried Couples"
marriages-button-lore:
- "&fView all marriages on the server"
- "&7See who is really married!"
marriage-button-title: "&eMarriage"
marriage-button-lore:
- "&fManage proposals and requests"
- "&7Find someone to marry!"
settings-button-title: "&dSettings"
settings-button-lore:
- "&fCustomize your particle effects"
- "&7Just don't forget to allow animations!"
achievements-button-title: "&dAchievements"
achievements-button-lore:
- "&fView your achievements"
- "&7Track your progress!"
player-search-button-title: "&dPlayer Search"
player-search-button-lore:
- "&fSearch for other players"
- "&7Find and interact with players!"
enabled-state: "&aEnabled"
disabled-state: "&cDisabled"
marriage-find-title: "&dFind Someone to Marry"
marriage-find-lore:
- "&fClick and type a player name in chat"
- "&7Sends a proposal if neither of you have one active"
marriage-requests-toggle-title: "&dMarriage Requests"
marriage-requests-toggle-lore:
- "&fCurrent state: {state}"
- "&7Click to toggle marriage requests"
marriage-proposals-title: "&dActive Proposals"
marriage-proposals-lore:
- "&fPending proposals: &d{count}"
- "&7Click to accept or deny incoming proposals"
no-marriage-proposals-title: "&cNo Active Proposals"
no-marriage-proposals-lore:
- "&7You do not have any pending marriage proposals."
marriage-accept-title: "&aAccept {player}"
marriage-accept-lore:
- "&fAccept &d{player}&f's marriage proposal"
marriage-deny-title: "&cDeny {player}"
marriage-deny-lore:
- "&fDecline &d{player}&f's marriage proposal"
hugs-title: "&dHugs Received"
hugs-lore:
- "&fYou've received &d{count} &f hugs"
- "&7Do you actually like it?"
kisses-title: "&dKisses Received"
kisses-lore:
- "&fYou've received &d{count} &fsweet kisses"
- "&7Maybe you should do your first move?"
likes-title: "&dLikes Received"
likes-lore:
- "&fYou've received &d{count} &flikes"
- "&7People really appreciate you!"
marriage-title: "&dMarriage Status"
marriage-lore:
- "&fYou are married to &d{partner}"
- "&fFor &d{days} &fdays"
- "&7True love never dies!"
single-title: "&dRelationship Status"
single-lore:
- "&fYou are currently single"
- "&7Don't worry, somebody is out there!"
mood-display-title: "&dYour Mood"
mood-display-lore:
- "&fCurrent mood: &d{mood}"
- "&7Click to change your mood"
leaderboard-entry-title: "&a{rank} &d{player}"
marriage-couple-title: "&d{player1} &f♥ &d{player2}"
marriage-couple-lore:
- "&fMarried since: &d{date}"
- "&fDays together: &d{days}"
- "&7A beautiful love story!"
hug-button-title: "&dHug {player}"
hug-button-lore:
- "&fGive them a hug"
- "&7Feels good?"
kiss-button-title: "&dKiss {player}"
kiss-button-lore:
- "&fSend them a kiss"
- "&7That's good move!"
like-button-title: "&dLike {player}"
like-button-lore:
- "&fShow your appreciation"
- "&7Let them know you care!"
marry-button-title: "&dMarry {player}"
marry-button-lore:
- "&fPropose marriage"
- "&7Just hope for the best!"
mood-very-good-title: "&aVery Good"
mood-very-good-lore:
- "&fSet your mood to Very Good"
- "&7You're feeling amazing!"
mood-good-title: "&eGood"
mood-good-lore:
- "&fSet your mood to Good"
- "&7You're doing well!"
mood-neutral-title: "&fNeutral"
mood-neutral-lore:
- "&fSet your mood to Neutral"
- "&7You're feeling okay!"
mood-bad-title: "&cBad"
mood-bad-lore:
- "&fSet your mood to Bad"
- "&7What happened?"
mood-very-bad-title: "&4Very Bad"
mood-very-bad-lore:
- "&fSet your mood to Very Bad"
- "&7Why?"
effect-spiral: "&dSpiral Effect"
effect-heart: "&dHeart Effect"
effect-rainbow: "&dRainbow Effect"
effect-selected: "&aSelected"
effect-disabled: "&cDisabled"
age-title: "&dProfile Age"
age-lore:
- "&fYour age: &d{age}"
- "&7Click to edit (13-99)"
age-editor-title: "&d❤ &5Age Editor &d❤"
age-decrease-title: "&c-1 Age"
age-current-title: "&dCurrent Age: {age}"
age-increase-title: "&a+1 Age"
age-save-title: "&aSave Age"
age-unset-title: "&cRemove Age"
my-friends-title: "&dMy Friends"
my-friends-lore:
- "&fFriends count: &d{count}"
- "&7Click to view"
friend-requests-toggle-title: "&dFriend Requests"
friend-requests-toggle-lore:
- "&fCurrent: &d{state}"
- "&7Click to toggle"
friend-chat-add-title: "&aAdd Friend (Chat)"
friend-chat-add-lore:
- "&fClick and type a player's name in chat"
- "&7A friend request will be sent automatically"
profile-friends-title: "&dFriends List"
profile-friends-lore:
- "&fThis player has &d{count} &ffriends"
- "&7Click to view"
friends-menu-title: "&d❤ &5{player}'s Friends &d❤"
friend-entry-title: "&d{friend}"
friend-entry-lore:
- "&fFriends since: &d{since}"
friend-add-title: "&aAdd Friend"
friend-add-lore:
- "&fSend a friend request to &d{player}"
friend-accept-title: "&aAccept Friend Request"
friend-accept-lore:
- "&fAccept &d{player}'s &ffriend request"
friend-deny-title: "&cDeny Request"
friend-deny-lore:
- "&fDecline &d{player}'s &ffriend request"
friend-remove-title: "&cRemove Friend"
friend-remove-lore:
- "&fRemove &d{player} &ffrom your friends"
back-button: "&c⬅ Back"
achievements:
unlocked: "&a&Achievement Unlocked! &d{achievement}"
broadcast: "&d{player} &fhas unlocked the achievement: &d{achievement}&f!"
first_kiss_received:
name: "First Kiss Received"
description: "Received your first kiss from another player"
first_hug_received:
name: "First Hug Received"
description: "Received your first hug from another player"
first_like_received:
name: "First Like Received"
description: "Received your first like from another player"
first_kiss_given:
name: "First Kiss Given"
description: "Gave your first kiss to another player"
first_hug_given:
name: "First Hug Given"
description: "Gave your first hug to another player"
first_like_given:
name: "First Like Given"
description: "Gave your first like to another player"
reach_10_kisses:
name: "Kissable"
description: "Received 10 kisses"
reach_10_hugs:
name: "Huggable"
description: "Received 10 hugs"
reach_10_likes:
name: "Likeable"
description: "Received 10 likes"
marriage:
name: "Just Married"
description: "Got married to another player"
divorce:
name: "It's Complicated"
description: "Got divorced from your partner"
married_30_days:
name: "One Month Together"
description: "Been married for 30 days"
married_365_days:
name: "One Year Anniversary"
description: "Been married for 365 days"
married_2_years:
name: "Two Years Strong"
description: "Been married for 2 years"
first_mood_set:
name: "Mood Setter"
description: "Set your mood for the first time"
make_a_friend:
name: "New Bestie"
description: "Become friends with another player"
friends_for_3_months:
name: "3-Month Bond"
description: "Stay friends for at least 3 months"
friends:
already-friends: "&cYou are already friends with this player."
requests-disabled: "&cThat player has disabled friend requests."
max-reached: "&cMaximum friends reached (50)."
request-already-sent: "&eYou already sent a friend request to this player."
request-sent: "&aFriend request sent to &d{player}&a."
request-received: "&d{player} &fsent you a friend request. Open their profile to accept/deny."
request-accepted: "&aYou are now friends with &d{player}&a."
accept-notify: "&d{player} &aaccepted your friend request."
request-denied: "&cFriend request denied."
request-denied-notify: "&d{player} &cdeclined your friend request."
no-pending: "&cYou don't have a pending request from this player."
not-friends: "&cYou are not friends with this player."
removed: "&eYou removed &d{player} &efrom your friends."
toggle-enabled: "&aYou now accept friend requests."
toggle-disabled: "&cYou no longer accept friend requests."
join-notify: "&fYour friend &d{friend} &fjoined the server."
leave-notify: "&fYour friend &d{friend} &fleft the server."
chat-add-prompt: "&fType the player's name in chat to send a friend request."
chat-add-not-found: "&cPlayer '&d{player}&c' not found or is not online."
chat-add-self: "&cYou can't send a friend request to yourself."
age:
updated: "&aYour age is now set to &d{age}&a."
removed: "&eYour age was removed from your profile."
Note: This plugin is AI optimized but wont ever be rewritten by it or dramatically changed. Because sometimes bug/problem appears and I don't know everything, help is needed.


