WeFriends

# We-Friends (https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) (https://img.shields.io/badge/Java-17+-orange.svg)](https://www.oracle.com/java/) (https://img.shields.io/badge/Paper-1.21.1+-blue.svg)](https://papermc.io/) (https://img.shields.io/badge/Folia-Supported-green.svg)](https://github.com/PaperMC/Folia) A comprehensive friend and party management system for Minecraft servers with cross-server support, built for Paper/Spigot and Folia. ## ✨ Features ### 🤝 Friend System - **Friend Requests**: Send, accept, and deny friend requests - **Friend List**: View online/offline friends with status indicators - **Friend Chat**: Private messaging and group chat with friends - **Join/Quit Notifications**: Get notified when friends join or leave - **Request Toggle**: Enable/disable receiving friend requests - **Cross-Server Support**: Friends can interact across multiple servers ### 🎉 Party System - **Party Creation**: Create and manage parties with friends - **Party Invites**: Invite friends to join your party - **Party Chat**: Dedicated party chat channel - **Party Roles**: Leader and member roles with permissions - **Party Management**: Kick, promote, transfer leadership, and disband - **Cross-Server Parties**: Party members can be on different servers ### 🌐 Cross-Server Support - **Multi-Server Network**: Connect multiple servers with Redis - **Real-time Sync**: Instant notifications across servers - **Server Identification**: See which server friends/party members are on - **Seamless Experience**: Chat and interact across the entire network ### 🔧 Advanced Features - **Database Support**: SQLite and MySQL support - **Redis Integration**: For cross-server communication - **PlaceholderAPI**: Custom placeholders for other plugins - **Folia Support**: Full compatibility with Folia servers - **Chat Spy**: Staff can monitor friend/party chats - **Chat Modes**: Toggle between normal, friend, and party chat ## 📋 Requirements - **Java**: 17 or higher - **Server Software**: Paper 1.21.1+ or Folia - **Database**: SQLite (included) or MySQL - **Redis**: Required for cross-server functionality (optional) ## 🚀 Installation 1. **Download** the latest release from (https://github.com/WeThink25/We-Friends/releases) 2. **Place** the JAR file in your server's `plugins` folder 3. **Start** your server to generate the configuration files 4. **Configure** the plugin (see Configuration section) 5. **Restart** your server ## ⚙️ Configuration ### Basic Setup (Single Server) ```yaml # config.yml database: type: sqlite # Use SQLite for single server server: name: lobby # Your server name cross-server: enabled: false # Disable for single server redis: enabled: false # Not needed for single server ``` ### Multi-Server Setup ```yaml # config.yml database: type: mysql # Required for multi-server mysql: host: localhost port: 3306 database: wefriends username: root password: "your_password" server: name: lobby # Unique name for each server cross-server: enabled: true # Enable cross-server features sync-interval: 30 notification-timeout: 5 redis: enabled: true # Required for cross-server host: localhost port: 6379 password: "" channel: wefriends:events limits: max-friends: 200 max-party-size: 8 ``` ### Database Setup (MySQL) ```sql CREATE DATABASE wefriends; CREATE USER 'wefriends'@'%' IDENTIFIED BY 'your_password'; GRANT ALL PRIVILEGES ON wefriends.* TO 'wefriends'@'%'; FLUSH PRIVILEGES; ``` ## 🎮 Commands ### Friend Commands - `/friend add <player>` - Send a friend request - `/friend accept <player>` - Accept a friend request - `/friend deny <player>` - Deny a friend request - `/friend remove <player>` - Remove a friend - `/friend list` - View your friends list - `/friend requests` - View pending requests - `/friend toggle` - Toggle friend requests on/off - `/fchat <message>` - Send a message to all friends - `/fmsg <friend> <message>` - Send a private message to a friend ### Party Commands - `/party create` - Create a new party - `/party invite <player>` - Invite a friend to your party - `/party accept <player>` - Accept a party invite - `/party deny <player>` - Deny a party invite - `/party leave` - Leave your current party - `/party kick <player>` - Kick a member from the party (leader only) - `/party promote <player>` - Promote a member to leader (leader only) - `/party transfer <player>` - Transfer leadership (leader only) - `/party disband` - Disband the party (leader only) - `/pc <message>` - Send a message to party members ### Chat Mode Commands - `/fchatmode` - Toggle friend chat mode - `/pchatmode` - Toggle party chat mode - `/chatmode` - View current chat mode ### Admin Commands - `/fchatspy` - Toggle friend chat spy (permission required) - `/partyspy` - Toggle party chat spy (permission required) - `/wefriends reload` - Reload the plugin configurati