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"