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]](/proxy/image?url=https%3A%2F%2Fi.ibb.co%2Fx5cccwT%2Fimage-2025-01-21-13-07-24.png)
- 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]](/proxy/image?url=https%3A%2F%2Fi.ibb.co%2FGtSJgt8%2Fphoto-2025-01-21-13-30-02.jpg)
Commands
- /near [radius]
- Lists all players within the specified radius.
- Displays player distance, direction, and other details.
- /near hide
- Toggles the player's visibility for the /near command
![[IMG]](/proxy/image?url=https%3A%2F%2Fi.ibb.co%2FKq4cWqz%2Fphoto-2025-01-21-13-29-59.jpg)
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.