SFriends

SFriends - Simple Friends with Proximity Visibility

SFriends is a modern, lightweight, and intuitive friends system designed to enhance community and teamwork on your server. It provides the essential friend management features your players expect, wrapped in a simple command structure and a clean GUI.

The standout feature is the Proximity Nameplate Visibility system: friends' nameplates are displayed in a friendly color when they are nearby, while the names of strangers remain hidden. This adds a layer of immersion and makes it easy to identify your allies in a crowd without the clutter of a complex party or clan plugin.

✨ Key Features

* Localization Ready: Simple commands (`/friend add`, `accept`, `remove`) that are easy for anyone to learn. * Localization Ready: A clean and simple graphical menu (`/friend list`) that displays all friends as player heads. Simply click a head to remove a friend. * Localization Ready: * Friends' nameplates are revealed in Localization Ready: when they enter a configurable radius. * The names of non-friend players are hidden, reducing screen clutter and adding a layer of mystery. * Powered by scoreboards for wide server compatibility, no external dependencies required. * Localization Ready: All data is stored in a single file within the plugin folder. No external database setup is needed! * Localization Ready: Easily change the nameplate visibility radius, update speed, and all player-facing messages. * Localization Ready: Supports multiple languages. Comes with `English` and `Ukrainian` translations out of the box.

---

🎮 How It Works

SFriends is designed to be plug-and-play.

1. A player sends a request with `/friend add <name>`. 2. The target player accepts with `/friend accept <name>`. You are now friends! 3. When you get close to your friend (within the configured `radius`), their nameplate will appear above their head in green. If you move too far away, it will disappear again. 4. Manage your friends anytime with the `/friend` command to open the GUI.

This system is perfect for Survival, SMP, and even light-PvP servers where simple team identification is a valuable tool.

*(Here you could add a GIF demonstrating a friend's nameplate appearing as a player gets closer)*

---

⚙️ Commands & Permissions

Commands: * `/friend` or `/friends`: Opens the Friend List GUI. * `/friend add <player>`: Sends a friend request to a player. * `/friend accept <player>`: Accepts a pending friend request. * `/friend remove <player>`: Removes a player from your friend list. * `/friend list`: An alias to open the Friend List GUI.

Permissions: * There are no permission nodes to manage. All commands are available to all players by default.

---

🔧 Configuration

The `config.yml` is simple and lets you tailor the core mechanics to your server's needs.

```yaml

Maximum distance in blocks at which friends can see each other's name plates.

radius: 75

Tick interval for refreshing friend visibility. (20 ticks = 1 second)

updatePeriodTicks: 5

Enable optional ProtocolLib integrations when available.

Note: Currently uses scoreboard teams. ProtocolLib support may be added later.

useProtocolLib: true

Default language for plugin messages (supported: en, uk).

language: en

Storage settings (currently only sqlite is supported)

storage: type: sqlite file: data.db ```

Dependencies

* None! The plugin works out-of-the-box. * *(Optional)*: The configuration includes a setting for `ProtocolLib`, but it is not required for the plugin to function. The core visibility feature uses Minecraft's built-in scoreboard system.