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

• Intuitive Friend Management: Simple commands (/friend add, accept, remove) that are easy for anyone to learn.
• GUI Friend List: A clean and simple graphical menu (/friend list) that displays all friends as player heads. Simply click a head to remove a friend.
• Proximity Nameplate Visibility:
  • Friends' nameplates are revealed in green 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.
• Lightweight SQLite Storage: All data is stored in a single file within the plugin folder. No external database setup is needed!
• Highly Configurable: 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.

# 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.