# CuteInteractions

**Made by tyhawkey**

CuteInteractions adds moderated, configurable social interaction commands to your Paper or Purpur server. Players can hug, kiss, slap, pat, and boop each other with colourful broadcast messages, sounds, and particles.

## Requirements

- **Paper** or **Purpur** server (API **26.x+**)
- **Java 21**

> This plugin is built for Paper/Purpur. It is not compatible with vanilla Spigot or CraftBukkit.

## Features

- `/hug`, `/kiss`, `/slap`, `/pat`, `/boop` commands with player tab completion
- Per-command cooldowns (configurable)
- Full permission control for every command
- No self-targeting
- Customisable broadcast messages, sounds, and particles per interaction
- Players can opt out of incoming interactions with `/ci toggle`
- Admin tools: reload, inspect, cooldown clear, mute, audit log, version
- Persistent player settings (`player-data.yml`)
- Daily audit logs (`audit/YYYY-MM-DD.log`)

## Installation

1. Download **CuteInteractions-2.1.0.jar**
2. Place it in your server's `plugins/` folder
3. Restart the server
4. Edit `plugins/CuteInteractions/config.yml` to customise messages and effects

## Commands

| Command | Description |
|---------|-------------|
| `/hug <player>` | Hug another player |
| `/kiss <player>` | Kiss another player |
| `/slap <player>` | Slap another player |
| `/pat <player>` | Pat another player |
| `/boop <player>` | Boop another player |
| `/ci` | Settings and admin commands (alias: `/cuteinteractions`) |

### Admin subcommands (`/ci`)

- `/ci toggle` — Toggle whether others can interact with you
- `/ci toggle <player> <on|off>` — Admin: change a player's setting
- `/ci reload` — Reload config
- `/ci inspect <player>` — View player state
- `/ci cooldown clear <player> [action|all]` — Clear cooldowns
- `/ci mute <player> <duration|off>` — Mute from using interactions
- `/ci audit [player] [page]` — View recent audit entries
- `/ci version` — Plugin version info

## Permissions

- `cuteinteractions.command.hug` (default: true)
- `cuteinteractions.command.kiss` (default: true)
- `cuteinteractions.command.slap` (default: true)
- `cuteinteractions.command.pat` (default: true)
- `cuteinteractions.command.boop` (default: true)
- `cuteinteractions.toggle` (default: true)
- `cuteinteractions.cooldown.bypass` (default: op)
- `cuteinteractions.admin.*` (default: op)

## Configuration

All messages, cooldowns, sounds, and particles are editable in `config.yml`. Sound names use Minecraft registry IDs (e.g. `ENTITY_PLAYER_LEVELUP`). Particle names use Bukkit enum names (e.g. `HEART`).

## Links

- **GitHub:** https://github.com/hawk0151/CuteInteractions
- **Releases:** https://github.com/hawk0151/CuteInteractions/releases

## Author

Made by **tyhawkey**

## License

MIT