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

Download kiss-plugin-1.0.0.jar
Place in server's plugins folder
Restart server or run /plugman load Kiss
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