{"id":169470,"date":"2026-06-09T23:14:31","date_gmt":"2026-06-09T20:14:31","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/wefriends\/"},"modified":"2026-06-09T23:14:31","modified_gmt":"2026-06-09T20:14:31","slug":"wefriends","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/wefriends\/","title":{"rendered":"WeFriends"},"content":{"rendered":"

# We-Friends<\/p>\n

![License: MIT](https:\/\/opensource.org\/licenses\/MIT)
\n![Java](https:\/\/www.oracle.com\/java\/)
\n![Paper](https:\/\/papermc.io\/)
\n![Folia](https:\/\/github.com\/PaperMC\/Folia)<\/p>\n

A comprehensive friend and party management system for Minecraft servers with cross-server support, built for Paper\/Spigot and Folia.<\/p>\n

## \u2728 Features<\/p>\n

### \ud83e\udd1d Friend System
\n– **Friend Requests**: Send, accept, and deny friend requests
\n– **Friend List**: View online\/offline friends with status indicators
\n– **Friend Chat**: Private messaging and group chat with friends
\n– **Join\/Quit Notifications**: Get notified when friends join or leave
\n– **Request Toggle**: Enable\/disable receiving friend requests
\n– **Cross-Server Support**: Friends can interact across multiple servers<\/p>\n

### \ud83c\udf89 Party System
\n– **Party Creation**: Create and manage parties with friends
\n– **Party Invites**: Invite friends to join your party
\n– **Party Chat**: Dedicated party chat channel
\n– **Party Roles**: Leader and member roles with permissions
\n– **Party Management**: Kick, promote, transfer leadership, and disband
\n– **Cross-Server Parties**: Party members can be on different servers<\/p>\n

### \ud83c\udf10 Cross-Server Support
\n– **Multi-Server Network**: Connect multiple servers with Redis
\n– **Real-time Sync**: Instant notifications across servers
\n– **Server Identification**: See which server friends\/party members are on
\n– **Seamless Experience**: Chat and interact across the entire network<\/p>\n

### \ud83d\udd27 Advanced Features
\n– **Database Support**: SQLite and MySQL support
\n– **Redis Integration**: For cross-server communication
\n– **PlaceholderAPI**: Custom placeholders for other plugins
\n– **Folia Support**: Full compatibility with Folia servers
\n– **Chat Spy**: Staff can monitor friend\/party chats
\n– **Chat Modes**: Toggle between normal, friend, and party chat<\/p>\n

## \ud83d\udccb Requirements<\/p>\n

– **Java**: 17 or higher
\n– **Server Software**: Paper 1.21.1+ or Folia
\n– **Database**: SQLite (included) or MySQL
\n– **Redis**: Required for cross-server functionality (optional)<\/p>\n

## \ud83d\ude80 Installation<\/p>\n

1. **Download** the latest release from Releases
\n2. **Place** the JAR file in your server’s `plugins` folder
\n3. **Start** your server to generate the configuration files
\n4. **Configure** the plugin (see Configuration section)
\n5. **Restart** your server<\/p>\n

## \u2699\ufe0f Configuration<\/p>\n

### Basic Setup (Single Server)<\/p>\n

“`yaml
\n# config.yml
\ndatabase:
\n type: sqlite # Use SQLite for single server<\/p>\n

server:
\n name: lobby # Your server name<\/p>\n

cross-server:
\n enabled: false # Disable for single server<\/p>\n

redis:
\n enabled: false # Not needed for single server
\n“`<\/p>\n

### Multi-Server Setup<\/p>\n

“`yaml
\n# config.yml
\ndatabase:
\n type: mysql # Required for multi-server
\n mysql:
\n host: localhost
\n port: 3306
\n database: wefriends
\n username: root
\n password: “your_password”<\/p>\n

server:
\n name: lobby # Unique name for each server<\/p>\n

cross-server:
\n enabled: true # Enable cross-server features
\n sync-interval: 30
\n notification-timeout: 5<\/p>\n

redis:
\n enabled: true # Required for cross-server
\n host: localhost
\n port: 6379
\n password: “”
\n channel: wefriends:events<\/p>\n

limits:
\n max-friends: 200
\n max-party-size: 8
\n“`<\/p>\n

### Database Setup (MySQL)<\/p>\n

“`sql
\nCREATE DATABASE wefriends;
\nCREATE USER ‘wefriends’@’%’ IDENTIFIED BY ‘your_password’;
\nGRANT ALL PRIVILEGES ON wefriends.* TO ‘wefriends’@’%’;
\nFLUSH PRIVILEGES;
\n“`<\/p>\n

## \ud83c\udfae Commands<\/p>\n

### Friend Commands
\n– `\/friend add ` – Send a friend request
\n– `\/friend accept ` – Accept a friend request
\n– `\/friend deny ` – Deny a friend request
\n– `\/friend remove ` – Remove a friend
\n– `\/friend list` – View your friends list
\n– `\/friend requests` – View pending requests
\n– `\/friend toggle` – Toggle friend requests on\/off
\n– `\/fchat ` – Send a message to all friends
\n– `\/fmsg ` – Send a private message to a friend<\/p>\n

### Party Commands
\n– `\/party create` – Create a new party
\n– `\/party invite ` – Invite a friend to your party
\n– `\/party accept ` – Accept a party invite
\n– `\/party deny ` – Deny a party invite
\n– `\/party leave` – Leave your current party
\n– `\/party kick ` – Kick a member from the party (leader only)
\n– `\/party promote ` – Promote a member to leader (leader only)
\n– `\/party transfer ` – Transfer leadership (leader only)
\n– `\/party disband` – Disband the party (leader only)
\n– `\/pc ` – Send a message to party members<\/p>\n

### Chat Mode Commands
\n– `\/fchatmode` – Toggle friend chat mode
\n– `\/pchatmode` – Toggle party chat mode
\n– `\/chatmode` – View current chat mode<\/p>\n

### Admin Commands
\n– `\/fchatspy` – Toggle friend chat spy (permission required)
\n– `\/partyspy` – Toggle party chat spy (permission required)
\n– `\/wefriends reload` – Reload the plugin configuration<\/p>\n

## \ud83d\udd11 Permissions<\/p>\n

### Player Permissions
\n– `wefriends.friend.use` – Use friend commands
\n– `wefriends.party.use` – Use party commands
\n– `wefriends.chat.friend` – Use friend chat
\n– `wefriends.chat.party` – Use party chat<\/p>\n

### Admin Permissions
\n– `wefriends.admin` – Access admin commands
\n– `wefriends.spy.friend` – Spy on friend chats
\n– `wefriends.spy.party` – Spy on party chats
\n– `wefriends.reload` – Reload plugin configuration<\/p>\n

## \ud83d\udcca PlaceholderAPI<\/p>\n

The plugin provides placeholders for use with PlaceholderAPI:<\/p>\n

– `%wefriends_friends_online%` – Number of online friends
\n– `%wefriends_friends_total%` – Total number of friends
\n– `%wefriends_party_size%` – Current party size
\n– `%wefriends_party_leader%` – Party leader name
\n– `%wefriends_in_party%` – Whether player is in a party (true\/false)<\/p>\n

## \ud83d\udd27 API Usage<\/p>\n

### Maven Dependency
\n“`xml
\n
\n me.wethink<\/groupId>
\n wefriends<\/artifactId>
\n 1.0.0<\/version>
\n provided<\/scope>
\n<\/dependency>
\n“`<\/p>\n

### Basic API Examples<\/p>\n

“`java
\n\/\/ Get the plugin instance
\nWeFriends plugin = WeFriends.getInstance();<\/p>\n

\/\/ Check if two players are friends
\nboolean areFriends = plugin.getFriendManager().areFriends(player1UUID, player2UUID);<\/p>\n

\/\/ Get a player’s friends
\nSet friends = plugin.getFriendManager().getFriendUuidsPublic(playerUUID);<\/p>\n

\/\/ Get party information
\nString partyId = plugin.getPartyManager().getPartyIdPublic(playerUUID);
\nList partyMembers = plugin.getPartyManager().getPartyMembers(partyId);
\n“`<\/p>\n

## \ud83c\udf10 Cross-Server Setup Guide<\/p>\n

### Step 1: Database Configuration
\nSet up a shared MySQL database accessible by all servers:<\/p>\n

“`yaml
\ndatabase:
\n type: mysql
\n mysql:
\n host: your-database-host
\n port: 3306
\n database: wefriends_network
\n username: wefriends_user
\n password: secure_password
\n“`<\/p>\n

### Step 2: Redis Configuration
\nConfigure Redis for real-time communication:<\/p>\n

“`yaml
\nredis:
\n enabled: true
\n host: your-redis-host
\n port: 6379
\n password: redis_password
\n channel: wefriends:network
\n“`<\/p>\n

### Step 3: Server Identification
\nGive each server a unique name:<\/p>\n

“`yaml
\nserver:
\n name: lobby # For lobby server
\n name: survival # For survival server
\n name: creative # For creative server
\n“`<\/p>\n

### Step 4: Enable Cross-Server Features
\n“`yaml
\ncross-server:
\n enabled: true
\n sync-interval: 30
\n notification-timeout: 5
\n“`<\/p>\n

## \ud83d\udc1b Troubleshooting<\/p>\n

### Common Issues<\/p>\n

**Database Connection Failed**
\n– Verify MySQL credentials and host accessibility
\n– Check firewall settings
\n– Ensure database exists and user has proper permissions<\/p>\n

**Redis Connection Failed**
\n– Verify Redis server is running
\n– Check Redis host and port configuration
\n– Verify Redis password if authentication is enabled<\/p>\n

**Cross-Server Not Working**
\n– Ensure all servers use the same MySQL database
\n– Verify Redis configuration is identical across servers
\n– Check that server names are unique
\n– Confirm `cross-server.enabled` is true<\/p>\n

**Plugin Not Loading**
\n– Verify Java 17+ is installed
\n– Check server software compatibility (Paper 1.21.1+)
\n– Review server logs for error messages<\/p>\n

## \ud83e\udd1d Contributing<\/p>\n

We welcome contributions! Please follow these steps:<\/p>\n

1. **Fork** the repository
\n2. **Create** a feature branch (`git checkout -b feature\/amazing-feature`)
\n3. **Commit** your changes (`git commit -m ‘Add amazing feature’`)
\n4. **Push** to the branch (`git push origin feature\/amazing-feature`)
\n5. **Open** a Pull Request<\/p>\n

### Development Setup<\/p>\n

1. Clone the repository
\n2. Import into your IDE (IntelliJ IDEA recommended)
\n3. Run `mvn clean install` to build
\n4. Test on a Paper 1.21.1+ server<\/p>\n

## \ud83d\udcdd License<\/p>\n

This project is licensed under the MIT License – see the [LICENSE](LICENSE) file for details.<\/p>\n

## \ud83d\ude4f Acknowledgments<\/p>\n

– **Paper Team** – For the excellent server software
\n– **Folia Team** – For multi-threaded server support
\n– **PlaceholderAPI** – For placeholder integration
\n– **HikariCP** – For database connection pooling
\n– **Jedis** – For Redis connectivity<\/p>\n

## \ud83d\udcde Support<\/p>\n

– **Issues**: GitHub Issues
\n– **Discussions**: GitHub Discussions<\/p>\n

—<\/p>\n

Made with \u2764\ufe0f by WeThink<\/p>\n","protected":false},"excerpt":{"rendered":"

A comprehensive friend and party management system for Minecraft servers with cross-server support, built for Paper\/Spigot and Folia.<\/p>\n","protected":false},"featured_media":169471,"template":"","meta":{"_minecraft_slug":"wefriends","_minecraft_project_id":"LAkZOYf0","_minecraft_author":"WeThink25","_minecraft_license":"MIT","_minecraft_downloads":276,"_minecraft_follows":4,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"wefriends.zip","_minecraft_size_bytes":20373136,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:00:44.324119Z","_minecraft_date_created":"2025-08-24T22:32:17.958813Z","_minecraft_date_modified":"2025-08-24T14:59:36.865436Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/wefriends","_minecraft_icon_attachment_id":169471,"_minecraft_imported_at":"2026-06-09T20:14:31+00:00","_minecraft_import_hash":"f9f38acadf6d746dbefad6894806ab4d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[88,125,89,126,127],"mod_loader":[131,132],"minecraft_version":[59,36,60,93,94,101,102,62,37,73,74,38,78,79,80,81],"class_list":["post-169470","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-equipment","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_loader-folia","mod_loader-paper","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\nWeFriends - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/wefriends\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"WeFriends - Minecraft\" \/>\n<meta property=\"og:description\" content=\"A comprehensive friend and party management system for Minecraft servers with cross-server support, built for Paper\/Spigot and Folia.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/wefriends\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"6 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/wefriends\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/wefriends\\\/\",\"name\":\"WeFriends - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/wefriends\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/wefriends\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/wefriends-icon-044157558663bddfe54c51fa82d7bca3344cfc4b_96.webp\",\"datePublished\":\"2026-06-09T20:14:31+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/wefriends\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/wefriends\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/wefriends\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/wefriends-icon-044157558663bddfe54c51fa82d7bca3344cfc4b_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/wefriends-icon-044157558663bddfe54c51fa82d7bca3344cfc4b_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/wefriends\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"WeFriends\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"WeFriends - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/wefriends\/","og_locale":"en_US","og_type":"article","og_title":"WeFriends - Minecraft","og_description":"A comprehensive friend and party management system for Minecraft servers with cross-server support, built for Paper\/Spigot and Folia.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/wefriends\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"6 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/wefriends\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/wefriends\/","name":"WeFriends - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/wefriends\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/wefriends\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/wefriends-icon-044157558663bddfe54c51fa82d7bca3344cfc4b_96.webp","datePublished":"2026-06-09T20:14:31+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/wefriends\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/wefriends\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/wefriends\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/wefriends-icon-044157558663bddfe54c51fa82d7bca3344cfc4b_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/wefriends-icon-044157558663bddfe54c51fa82d7bca3344cfc4b_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/wefriends\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"WeFriends"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/169470","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/169471"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=169470"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=169470"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=169470"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=169470"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}