axvFriends

Key Features

Friend Requests System

Send, accept and reject friend requests with confirmation system and expiration timer.

PvP Protection

Friends cannot attack each other - automatic PvP blocking between mutual friends.

Multi-Language Support

Full translation support with 10+ languages available out of the box.

Multi-Database Support

Support for SQLite, MySQL and MariaDB with automatic table creation.

Admin Tools

Full admin control with commands to manage friendships and blocks.

bStats Integration

Anonymous usage statistics to help improve the plugin.

Installation Guide

1

Download the Plugin

Download the latest version of axvFriends from SpigotMC or our official website.

2

Install the Plugin

Place the axvFriends.jar file in your server's plugins folder.

3

Configure and Start

Start your server to generate configuration files. Edit config.yml to your needs and restart.

Commands Reference

/friend add <name>

Send a friend request to a player

/friend remove <name>

Remove a player from your friends list

/friend accept <name>

Accept a friend request

/friend reject <name>

Reject a friend request

/friend block <name>

Block friend requests from a player

/friend unblock <name>

Unblock friend requests from a player

/friend list

Show your friends list

Permissions

Permission	Description	Default
axvFriends.use	Basic access to friend commands	true
axvFriends.admin.list	View other players' friends lists	op
axvFriends.admin.add	Add friendships between players	op
axvFriends.admin.remove	Remove friendships between players	op
axvFriends.admin.block	Block friendships between players	op
axvFriends.admin.unblock	Unblock friendships between players	op
axvFriends.reload	Reload plugin configuration	op

Configuration

config.yml

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

# -----------------------------
#  LANGUAGE
# -----------------------------
# Default language used for messages.
# Available: 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 included 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

License

MIT License

Copyright (c) 2025 Axverse.space, creators of the axvFriends plugin

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Get axvFriends today!

Download the latest version and enhance your server's social experience.

View on bStats