Vibrant Visuals & Graphics

Vibrant Visuals & Graphics API

PocketmineMV gives server admins and plugin developers control over client-side shader rendering (Vibrant Visuals / Deferred Graphics pipeline introduced in recent Bedrock updates).

Architecture: Vanilla PMMP vs PocketmineMV Visual Controls

Aspect	Vanilla PMMP 5	PocketmineMV
Client Shader Toggles	Uncontrolled / Forced default client state	Configurable server-wide & per-player
Server Configuration	No config options for graphics pipeline	settings.default-disable-vibrant-visuals in pocketmine.yml
Developer API	No resource pack offer visual controls	PlayerResourcePackOfferEvent::setForceDisableVibrantVisuals()

Server-Wide Configuration

You can default-disable or enable vibrant visuals server-wide in pocketmine.yml:

settings:
  # Disables Bedrock shader / vibrant visuals rendering by default for connecting players
  default-disable-vibrant-visuals: true

Developer API (PlayerResourcePackOfferEvent)

Plugins can toggle shader support on a per-player basis during the resource pack handshake phase using PlayerResourcePackOfferEvent.

use pocketmine\event\Listener;
use pocketmine\event\player\PlayerResourcePackOfferEvent;

class VisualsListener implements Listener{

    public function onResourcePackOffer(PlayerResourcePackOfferEvent $event) : void{
        $player = $event->getPlayer();

        if($player->hasPermission("vip.shaders")){
            // Allow vibrant visuals for VIPs
            $event->setForceDisableVibrantVisuals(false);
        } else {
            // Force disable vibrant visuals for low-end device users to prevent lag
            $event->setForceDisableVibrantVisuals(true);
        }
    }
}

Event API Methods

• $event->isVibrantVisualsDisabled() : bool Returns whether vibrant visuals are forced disabled for this player session.
• $event->setForceDisableVibrantVisuals(bool $forceDisable) : void Overrides whether vibrant visuals are disabled for the player.