💎 axvFriends

The Ultimate Friends System for Minecraft 1.20+

axvFriends 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

# ==========================================================
# axvFriends - Main Configuration
# ==========================================================

# -----------------------------
#  LANGUAGE
# -----------------------------
# Default language used for messages.
# Make sure you have a matching file in plugins/axvFriends/lang/
# Example: en, pl, de, es, fr, it, ja, ko, ru, zh
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 (future use)
  # ---------------------------
  notifications:
    join-leave:
      enabled: true