BetterNEAR icon

BetterNEAR -----

/near command with advanced filtering. CMI, Essentials, SuperVanish hook.



Overview
The BetterNEAR Plugin is a powerful and configurable tool for tracking nearby players in Minecraft, designed with flexibility and performance in mind. It offers extensive filtering options, customizable messages, and cooldown management to ensure a seamless and fair experience for all players.

Features
  • Player Filters:
    • Automatically hide players based on specific conditions:
      • Dead players (hide-dead)
      • Players with the invisibility effect (hide-invisible)
      • Players in spectator mode (hide-spectators)
      • Players vanished using Essentials (hide-essentials-vanished)
      • Players vanished using CMI (hide-cmi-vanished)
      • Players vanished using SuperVanish or PremiumVanish (hide-supervanish-vanished)
  • Custom Direction Formats:
    • Easily identify player directions with configurable labels and icons:
      • Straight: ↑
      • Left: ←
      • Right: →
      • Back: ↓
      • Diagonal directions: ↖, ↗, ↙, ↘
  • Radius Management:
    • Define a list of predefined search radii:
      • Supports values such as 100, 200, 300, 400, 500, and 600 blocks.
    • Prevents unauthorized usage of large radii with permission checks.
  • Cooldown System:
    • Fully customizable cooldowns for different groups (requires Vault):
      • Admin: No cooldown (0 seconds).
      • MVP: 30 seconds.
      • VIP: 45 seconds.
      • Default: 60 seconds.
      [​IMG]
  • Customizable Messages:
    • Permission and cooldown notifications.
    • Messages for found players, empty results, and errors.
    • Visibility toggling messages for /near command.
Permissions
The plugin uses permissions to manage access to specific features:

  • betternear.use: Access to use the /near command.
  • betternear.hide.use: Access to use the /near hide command.
  • betternear.bypass.cooldown: Allows bypassing of the cooldown system.
  • betternear.radius.<value>: Restricts the maximum radius a player can use.
    [​IMG]
Commands
  • /near [radius]
    • Lists all players within the specified radius.
    • Displays player distance, direction, and other details.
    [​IMG]
  • /near hide
    • Toggles the player's visibility for the /near command
    [​IMG]
Configuration
The plugin is fully configurable, allowing you to fine-tune every aspect of its behavior. Here's a preview of the configuration file:
Code (Text):
settings:
  filter:
    # Hides players from /near if they are dead.
    hide-dead: true
    # Hides players from /near if they have the invisibility effect applied.
    hide-invisible: true
    # Hides players from /near if they are in spectator mode.
    hide-spectators: true
    # Requires the Essentials plugin! Hides players who are vanished using Essentials.
    hide-essentials-vanished: true
    # Requires the CMI plugin! Hides players who are vanished using CMI.
    hide-cmi-vanished: true
    # Requires the SuperVanish or PremiumVanish plugin! Hides players who are vanished using these plugins.
    hide-supervanish-vanished: true

  direction-formats:
    straight: '&a↑ Straight'
    left: '&a← Left'
    right: '&a→ Right'
    back: '&a↓ Back'
    straightLeft: '&a↖ Straight-Left'
    straightRight: '&a↗ Straight-Right'
    backLeft: '&a↙ Back-Left'
    backRight: '&a↘ Back-Right'
    unknown: '&cUnknown'

  # A predefined list of radii (in blocks) that can be used for the command. These values determine how far the player search will extend.
  radius-list:
    - 100
    - 200
    - 300
    - 400
    - 500
    - 600

  # Vault required!
  cooldown:
    # Enables or disables the cooldown system, which sets a waiting time before the command can be reused.
    enabled: true
    groups:
      admin: 0
      # Sets the cooldown for the "admin" group to 0 seconds (no waiting).
      mvp: 30
      vip: 45
      default: 60

messages:
  no-permission: "&cYou don't have permission to perform this command!"
  cooldown: '&cYou cannot use this command for another %time% seconds!'
  message: '&7Players within a radius of &a%radius%&7 blocks: '
  no-players: '&fNo players found nearby.'
  format: '&7| &a%player% &7(&a%distance% bs.&7) %direction% '
  hide-on: '&7You have enabled your visibility for &a/near&7.'
  hide-off: '&7You have disabled your visibility for &a/near&7.'
  incorrect-radius: '&cYou have specified an incorrect radius!'
  max-radius: '&cYou do not have permission to view such a far distance! Maximum radius: &a%maxRadius%&c.'
Requirements
  • Minecraft Version: Compatible with 1.12–1.21.X.
  • Dependencies:
    • Vault: Required for group-based cooldowns.
    • Essentials, CMI, or SuperVanish/PremiumVanish: Optional, for advanced vanish support.
Resource Information
Author:
----------
Total Downloads: 49
First Release: Jan 21, 2025
Last Update: Jan 21, 2025
Category: ---------------
All-Time Rating:
1 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings