UPDATE 1.3 IS HERE!

!mzFriends

💎 mzFriends

The Ultimate Friends System for Minecraft 1.20+

mzFriends it's Easy-to-use friends system for Minecraft 1.20+. Effortlessly manage requests and build community.

---

✨ Key Features

• Comprehensive Friend System: Send, accept, and manage friend requests with a full confirmation system.
• Friends PvP Protection: Prevent friendly fire! Friends cannot attack each other, perfect for Survival and Role-Play servers.
• Block Player System: Completely block players to prevent unwanted requests and private messages.
• Database Versatility: Seamless support for MySQL, MariaDB, and SQLite. Choose your preferred storage in the config.yml.
• Admin Tools & Tab Completion: Powerful administrative commands (e.g., forced removal) and smart Tab Completion for quick management.
• Multi-Language Support: Full localization support for: Polish, Spanish, German, Russian, Japanese, French, Italian, Portuguese, Portuguese (Brazil), and Chinese (Simplified).
• Enhanced Statistics: Integrated bStats support to provide transparent usage statistics.

---

⚡ Commands

Command	Description
/friends	Opens the graphical user interface (GUI) for friend management.
/friend add <player>	Sends a friend request to a player.
/friend accept <player>	Accepts an incoming friend request.
/friend remove <player>	Removes a player from your friends list.
/friend block <player>	Blocks a player (prevents requests/messages).
/friend unblock <player>	Unblocks a player.
/friend admin remove <player> <friend>	Forcibly removes a player from another player's list (Admin permission needed).

---

⚙️ Configuration Example

# ==========================================================
# mzFriends - Main Configuration
# ==========================================================
# Plugin by MZCode | https://mzcode.pl/
# ==========================================================

# -----------------------------
#  PLUGIN PREFIX
# -----------------------------
# The prefix shown before all plugin messages.
# Supports Minecraft color codes (&a, &b, &c, etc.)
# Default: &8[&d&lmz&f&lFriends&8]
#
# Examples:
#   &8[&d&lmz&f&lFriends&8]   <- default (dark gray brackets, purple mz, white Friends)
#   &8[&bMyServer&8]            <- custom server name
#   &6[Friends]                 <- gold color
plugin-prefix: "&8[&d&lmz&f&lFriends&8] "


# -----------------------------
#  LANGUAGE
# -----------------------------
# Default language used for messages.
# Make sure you have a matching file in plugins/mzFriends/lang/
# Available: en, pl, de, es, fr, it, ja, ko, ru, zh, pt
language: "en"

==========================================================

DATABASE

==========================================================

type:

SQLite - local file in the plugin folder (friends.db)

MySQL - external MySQL database (use JDBC URL)

MariaDB - external MariaDB database (use JDBC URL)

Examples:

MySQL: jdbc:mysql://user:pass@host:3306/database

MariaDB: jdbc:mariadb://user:pass@host:3306/database

database: type: "SQLite" # SQLite, MySQL, MariaDB url: "" # If SQLite -> leave empty

If MySQL/MariaDB -> full JDBC URL

username: "" # Optional (if not in URL) password: "" # Optional

==========================================================

SETTINGS

==========================================================

settings:

---------------------------

PvP between friends

---------------------------

pvp: # If true - friends cannot damage each other. disable-friend-pvp: true

# If true - attacker receives a message when trying to hit a friend.
send-message: true

---------------------------

Friend requests

---------------------------

requests: # Time before a friend request expires (in seconds). expire-time: 300

---------------------------

Friends

---------------------------

friends: # Maximum number of friends per player. max-friends: 50

---------------------------

Notifications

---------------------------

notifications: join-leave: # Notify friends when a player joins/leaves. enabled: true

==========================================================

TIMEZONE

==========================================================

The timezone used for displaying dates and times (e.g. last seen).

Format: Use a valid Java TimeZone ID from the IANA database.

Full list: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

Common timezones by region:

EUROPE:

Poland / PL -> Europe/Warsaw (+01:00 / +02:00 DST)

Germany / DE -> Europe/Berlin (+01:00 / +02:00 DST)

France / FR -> Europe/Paris (+01:00 / +02:00 DST)

United Kingdom -> Europe/London (+00:00 / +01:00 DST)

Russia / RU -> Europe/Moscow (+03:00)

AMERICAS:

USA East -> America/New_York (-05:00 / -04:00 DST)

USA Central -> America/Chicago (-06:00 / -05:00 DST)

USA West -> America/Los_Angeles (-08:00 / -07:00 DST)

Brazil / PT -> America/Sao_Paulo (-03:00)

ASIA:

China / ZH -> Asia/Shanghai (+08:00)

Japan / JA -> Asia/Tokyo (+09:00)

Korea / KO -> Asia/Seoul (+09:00)

UTC (universal, no offset):

UTC -> UTC (+00:00)

timezone: "Europe/Warsaw"