📖About ProximityPlus

ProximityPlus

ProximityPlus is a lightweight, high-performance proximity chat and event filtering plugin that limits message visibility based on distance between players. Instead of global spam, players only receive chat and server events occurring within a configurable radius, creating a more immersive and localized multiplayer experience.

Ideal for Survival, SMP, Roleplay, and immersion-focused servers.

FEATURES

Configurable global proximity radius
Independent proximity control for:
Chat
Join messages
Leave messages
Death messages
Advancements
Broadcasts
Live configuration reload
Runtime radius adjustment
Toggle events without restart
Optional bypass permission (see everything globally)
Built-in debug mode
Optimized for low overhead and high performance
Works with or without PlaceholderAPI

HOW IT WORKS

When proximity is enabled, messages and events are only sent to players within the configured radius of the source player.

This reduces global chat spam, encourages localized interaction, and improves immersion.

All changes can be applied live without restarting the server.

COMMANDS

/proximity reload
Reload the plugin configuration

/proximity radius
Change the global proximity radius

Aliases:
/prox
/pp

PERMISSIONS

proximity.admin
Full access to all commands (reload, radius, debug)

proximity.reload
Reload the configuration

proximity.radius
Change the global radius

proximity.bypass
Ignore radius restrictions and receive ALL messages globally
(Not granted by default to admins)

proximity.debug
Access debug and timing information

CONFIG EXAMPLE

radius: 50

chat: true
join: true
leave: true
death: true
advancement: true
broadcast: false

COMPATIBILITY

Minecraft 1.21+
Works standalone
Optional PlaceholderAPI support

PERFORMANCE

ProximityPlus is designed to be lightweight and efficient. Distance checks are optimized and unnecessary processing is avoided when features are disabled. Suitable for both small and large servers.