Kiss Plugin - README

English

📋 Description

A fun social interaction plugin that allows players to express emotions through kisses, hugs, and licks. Perfect for community servers looking to add some fun interactions!

✨ Features

• 💋 Kiss - Show your love with heart particles
• 🤗 Hug - Warm hugs with cute sounds
• 👅 Lick - Playful interaction with slime sounds
• 🎨 Particle Effects - Heart particles floating between players
• 🔊 Custom Sounds - Each action has unique sound effects
• ⏱️ Cooldown System - Prevent spam (default 3 seconds)
• 📢 Action Bar Messages - Real-time feedback
• 🎬 Title Animations - Epic title display on interaction
• 🌍 Broadcast - Everyone nearby sees the interaction

📋 Commands

Command	Description	Permission
/kiss <player>	Kiss another player	kiss.use
/hug <player>	Hug another player	kiss.use
/lick <player>	Lick another player	kiss.use

🔐 Permissions

Permission	Description	Default
kiss.use	Use all interaction commands	true
kiss.*	All permissions	op

🎮 Usage Examples

# Kiss someone
/kiss Steve

# Hug your friend  
/hug Alex

# Playful lick
/lick Bob

⚙️ Configuration

File: plugins/Kiss/config.yml

# Particle settings
particles:
  enabled: true
  type: "HEART"  # HEART, CLOUD, NOTE, END_ROD

# Sound settings  
sounds:
  enabled: true
  kiss: "ENTITY_VILLAGER_YES"
  hug: "ENTITY_LLAMA_EAT"
  lick: "ENTITY_SLIME_SQUISH"

# Cooldown (seconds)
cooldown: 3

🎯 Effects Preview

Action	Particle	Sound	Title
Kiss	💖 HEART	Villager Yes	KISS!
Hug	💝 HEART	Llama Eat	HUG!
Lick	💗 HEART	Slime Squish	LICK!

📦 Installation

1. Download kiss-plugin-1.0.0.jar
2. Place in server's plugins folder
3. Restart server or run /plugman load Kiss
4. Configure in plugins/Kiss/config.yml

🔌 PlaceholderAPI Support

Variable	Description
%kiss_count%	Total kisses given
%hug_count%	Total hugs given
%lick_count%	Total licks given

💾 Requirements

• Minecraft: 1.17 - 1.21.11
• Java: 17 or higher
• Server: Paper / Purpur / Spigot

📌 Notes

• Players cannot kiss themselves
• Configurable cooldown to prevent spam
• All messages support color codes (&a, &c, etc.)
• Particles work across all Minecraft versions

---

中文

📋 插件介绍

一个有趣的社交互动插件，让玩家可以通过亲吻、拥抱、舔来表达情感。非常适合需要增添趣味互动的社区服务器！

✨ 功能特点

• 💋 亲吻 - 用爱心粒子表达爱意
• 🤗 拥抱 - 温暖的拥抱加上可爱的音效
• 👅 舔 - 有趣的互动，史莱姆音效
• 🎨 粒子效果 - 玩家之间飘浮的爱心粒子
• 🔊 自定义音效 - 每个动作都有独特的声音
• ⏱️ 冷却系统 - 防止刷屏（默认3秒）
• 📢 动作栏消息 - 实时反馈
• 🎬 标题动画 - 炫酷的标题展示
• 🌍 广播 - 附近所有玩家都能看到互动

📋 命令列表

命令	描述	权限
/kiss <玩家>	亲吻其他玩家	kiss.use
/hug <玩家>	拥抱其他玩家	kiss.use
/lick <玩家>	舔其他玩家	kiss.use

🔐 权限节点

权限	描述	默认值
kiss.use	使用所有互动命令	true
kiss.*	所有权限	op

🎮 使用示例

# 亲吻某人
/kiss Steve

# 拥抱朋友
/hug Alex

# 淘气地舔一下
/lick Bob

⚙️ 配置说明

配置文件：plugins/Kiss/config.yml

# 粒子设置
particles:
  enabled: true
  type: "HEART"  # HEART, CLOUD, NOTE, END_ROD

# 音效设置
sounds:
  enabled: true
  kiss: "ENTITY_VILLAGER_YES"
  hug: "ENTITY_LLAMA_EAT"
  lick: "ENTITY_SLIME_SQUISH"

# 冷却时间（秒）
cooldown: 3

🎯 效果预览

动作	粒子	音效	标题
亲吻	💖 爱心	村民赞同	亲吻！
拥抱	💝 爱心	羊驼吃草	拥抱！
舔	💗 爱心	史莱姆挤压	舔！

📦 安装方法

1. 下载 kiss-plugin-1.0.0.jar
2. 放入服务器的 plugins 文件夹
3. 重启服务器或运行 /plugman load Kiss
4. 在 plugins/Kiss/config.yml 中配置

🔌 PlaceholderAPI 支持

变量	说明
%kiss_count%	总亲吻次数
%hug_count%	总拥抱次数
%lick_count%	总舔次数

💾 环境要求

• Minecraft: 1.17 - 1.21.11
• Java: 17 或更高
• 服务端: Paper / Purpur / Spigot

📌 注意事项

• 不能亲吻自己
• 可配置冷却时间防止刷屏
• 所有消息支持颜色代码（&a, &c 等）
• 粒子效果在所有 Minecraft 版本都能工作

---

📝 Version History

v1.0.0 (2026-05-13)

• Initial release
• Added kiss, hug, lick commands
• Particle effects and sounds
• Cooldown system
• Configurable messages

Spread love on your server! 💕