Valentines

Version: 2.0-Experimental-2
Status: Experimental
Tested on: 1.16.x - 1.21.x
Last updated: May 10, 2025

This plugin let you spread love on your server. Using marriages, leaderboards and even hugs or kisses.

Features

  • Marriages - Players can marry or divorce with someone
  • Kisses/Hugs/Likes - If you like someone you can always make them more happier
  • Leaderboard - Get into Leaderboard and be first with the most hugs/kisses/likes
  • Effects - Three special effects around player
  • Customizable - Change everything from messages to effects to how you like it
  • Multi-Language - Allows admins to change language to: DE, IT, RU, EN
  • Chat Formatting - Able to automatically change custom words into custom symbols
  • GUI - Leaderboard, married ones, effects settings and more..

Commands

Valentines provides a lots of commands to help it make it even better:

All commands used in plugin:

Command Alias Description Permission
/valentines /val Displays help command valentines.use
/vgui - Opens GUI valentines.use
/valentinesplayer (player) /vstats Displays player's stats valentines.use
/valentinesleaderboard /vlb Displays leaderboard valentines.use
/couples - Displays all married players valentines.use
/marry (player) - Marry another player valentines.marry
/divorce - Divorce your partner valentines.divorce
/hug (player) - Hugs player valentines.use
/kiss (player) - Kisses player valentines.use
/like (player) - Likes player valentines.use

Permissions

This plugin uses few permissions to control acces to commands and features:

Permission Groups

  • valentines.use - Allows to use default commands
  • valentines.effect - Allows players to have effect around them
  • valentines.marry - Allows to marry someone
  • valentines.divorce - Allows divorce with partner
  • valentines.admin - Allows access to administrative commands

Configuration

Every part of Valentines plugin is customizable in files.

Main Configuration (config.yml)

config.yml
# Plugin prefix
Prefix: "&c❤&f&lValentines&c❤&r "

# Language (de, en, it, ru)
language: "en"

# Symbol replacement in chat
symbol-change: true
symbol-color: "&c"
symbol: "♥"
words:
  - "love"
  - "valentines"
  - "heart"

# Effects
effect:
  enabled: true
  particle-density: 2
  update-rate: 2
  max-height: 2.0
  start-height: 0.1
  radius: 0.85

  # Individual effect toggles
  player-effects: true
  kiss-effect: false
  marriage-effect: false

# Enabled Worlds for effects
enabled-worlds:
  - "world"
  - "world_nether"
  - "world_the_end"

# Cooldowns (in seconds)
cooldowns:
  hug: 60
  kiss: 60
  like: 300

# Permission Messages
NoPermissionMessage: "&cYou do not have permission to use this command."

Language Configuration (e.g. "lang_en.yml")

lang_en.yml
# English language file for Valentines plugin
plugin:
  enabled: "Valentines plugin has been enabled!"
  disabled: "Valentines plugin has been disabled!"

general:
  no-permission: "&cYou do not have permission to use this command."
  player-offline: "&cPlayer must be online for this command!"
  player-not-found: "&cPlayer not found or has never played before!"
  partner-offline: "&cYour partner is not online!"
  cooldown: "&cYou can only {command} once every &d{time}&c seconds!"

help:
  header: "&d❤ &5Valentines Commands &d❤"
  valentines: "&d/valentines &f- Displays this message"
  stats: "&d/valentinesplayer  &5[/vstats ] &f- Displays player's stats"
  leaderboard: "&d/valentinesleaderboard &5[/vlb] &f- Displays leaderboard"
  hug: "&d/hug  &f- Hugs a player"
  kiss: "&d/kiss  &f- Kisses a player"
  like: "&d/like  &f- Likes a player"
  marry: "&d/marry  &f- Marry a player"
  divorce: "&d/divorce &f- Divorce your partner"
  couples: "&d/couples &f- Display all married couples"
  gui: "&d/vgui &f- Opens the Valentines GUI"

hug:
  usage: "&cUse: &d/hug "
  self: "&cYou cannot hug yourself!"
  sent: "&fYou hugged &d{player} ❤"
  received: "&d{player} &fhugged you&d! ❤"

kiss:
  usage: "&cUse: &d/kiss "
  self: "&cYou cannot kiss yourself!"
  sent: "&fYou kissed &d{player} ❤"
  received: "&d{player} &fkissed you&d! ❤"

like:
  usage: "&cUse: &d/like "
  self: "&cYou cannot like yourself!"
  already-liked: "&cYou have already liked {player}!"
  cooldown: "&cYou can only like once every &d{time}&c seconds!"
  sent: "&fYou liked &d{player} ❤"
  received: "&d{player} &fliked you&d! ❤"

marry:
  usage: "&cUse: &d/marry  or /marry "
  self: "&cYou cannot marry yourself!"

stats:
  usage: "&cUse: &d/valentinesplayer "
  header: "&5{player}'s stats:"
  kisses: "&dKisses received: &f{count}"
  hugs: "&dHugs received: &f{count}"
  likes: "&dLikes received: &f{count}"
  married: "&dMarried to: &f{partner} &d(for {days} days)"
  single: "&dRelationship status: &fSingle"

leaderboard:
  header: "&5Leaderboard:"
  entry: "&a#{rank} &d{player} &r- &d{kisses} kisses &f| &d{hugs} hugs &f| &d{likes} likes"

marriages:
  header: "&5Married Couples:"
  couple: "&f❤ &d{player1} &f& &d{player2} &f- &d{days} days"
  none: "&dThere are no married couples on the server!"

marriage:
  proposal-sent: "&fMarriage proposal sent to &d{player}"
  proposal-received: "&d{player} &fwants to marry you. Type &d/marry confirm &ffor confirmation."
  already-married: "&cYou are already married!"
  target-already-married: "&c{player} is already married!"
  no-pending-proposals: "&cYou have no pending marriage proposals!"
  proposer-offline: "&cThe player who proposed is no longer online!"
  accept-sender: "&d{player} &faccepted your marriage. You're together&d! ♥"
  accept-receiver: "&fYou married &d{player}&f! You're together&d! ♥"
  decline-sender: "&c{player} doesn't want to be with you :("
  decline-receiver: "&cYou don't want to be with {player}"
  divorce-initiator: "&cYou have divorced {player}!"
  divorce-target: "&c{player} has divorced you!"
  divorce-confirm: "&fAre you sure you want to break up with &d{player}&f? Type &d/divorce &fagain to confirm."
  not-married: "&cYou are not married!"
  not-married-to: "&cYou are not married to {player}!"
  announcement: "&d❤ &f{player1} and {player2} just got married! &d❤"
  divorce-announcement: "&c{player1} and {player2} have divorced."

gui:
  main-menu-title: "&d❤ &5Valentines Menu &d❤"
  stats-menu-title: "&d❤ &5Player Stats &d❤"
  leaderboard-title: "&d❤ &5Valentines Leaderboard &d❤"
  marriages-title: "&d❤ &5Married Couples &d❤"
  settings-title: "&d❤ &5Valentines Settings &d❤"

  stats-button-title: "&dYour Stats"
  stats-button-lore: "&fView your personal statistics"
  leaderboard-button-title: "&dLeaderboard"
  leaderboard-button-lore: "&fSee the top players"
  marriages-button-title: "&dMarried Couples"
  marriages-button-lore: "&fView all marriages on the server"
  settings-button-title: "&dSettings"
  settings-button-lore: "&fChange your preferences"

  hugs-title: "&dHugs Received"
  hugs-lore: "&fYou've received &d{count} &fhugs"
  kisses-title: "&dKisses Received"
  kisses-lore: "&fYou've received &d{count} &fkisses"
  likes-title: "&dLikes Received"
  likes-lore: "&fYou've received &d{count} &flikes"
  marriage-title: "&dMarriage Status"
  marriage-lore: "&fYou are married to &d{partner}\n&fFor &d{days} &fdays"
  single-title: "&dRelationship Status"
  single-lore: "&fYou are currently single"

  leaderboard-entry-title: "&a#{rank} &d{player}"
  leaderboard-entry-lore: "&fScore: &d{score}\n&fHugs: &d{hugs}\n&fKisses: &d{kisses}\n&fLikes: &d{likes}"

  marriage-couple-title: "&d{player1} &f❤ &d{player2}"
  marriage-couple-lore: "&fMarried since: &d{date}\n&fDays together: &d{days}"

  language-en: "&fEnglish"
  language-ru: "&fРусский"
  language-de: "&fDeutsch"
  language-it: "&fItaliano"
  language-selected: "Selected language"

  effect-spiral: "&dSpiral Effect"
  effect-heart: "&dHeart Effect"
  effect-cloud: "&dCloud Effect"
  effect-selected: "Selected effect"

  back-button: "&cBack"
  prev-page-button: "&aPrevious Page"
  next-page-button: "&aNext Page"
  page-info: "&fPage &d{current}&f/&d{total}"