Interface VoiceWallService

public interface VoiceWallService
Acoustic engine service managing wall sound occlusion, acoustic pathfinding through apertures, air damping, and real-time particle raycast debugging.

  • Method Summary

    Modifier and Type
    Method
    Description
    @NotNull VoiceWallMode
    getMode()
    Gets the active occlusion mode.
    boolean
    hasDebugPlayer(@NotNull UUID playerUuid)
    Checks whether a player has visual particle debugging enabled.
    void
    init(@NotNull de.maxhenkel.voicechat.api.VoicechatServerApi api)
    Initializes the VoiceWall service with the Simple Voice Chat server API.
    boolean
    isAirDampingEnabled()
    Checks whether high-frequency air damping over distance is active.
    boolean
    isDebug()
    Checks whether debug logging is enabled.
    boolean
    isEnable()
    Checks whether the VoiceWall acoustic engine is globally enabled.
    default boolean
    isStrictBlock()
    Convenience check if strict block mode (100% soundproof) is active.
    void
    processEntitySoundPacket(@NotNull de.maxhenkel.voicechat.api.events.EntitySoundPacketEvent event, @NotNull VPlayer vSender, @NotNull VPlayer vReceiver, @NotNull de.maxhenkel.voicechat.api.VoicechatConnection receiverConn)
    Intercepts and processes a positional entity sound packet, performing acoustic raycasting and attenuation.
    void
    setAirDampingEnabled(boolean value)
    Sets high-frequency air damping over distance.
    void
    setDebug(boolean value)
    Sets debug logging flag.
    void
    setDebugPlayer(@NotNull UUID playerUuid, boolean enabled)
    Sets visual particle debugging state for a player.
    void
    setEnable(boolean value)
    Enables or disables VoiceWall globally.
    void
    setMode(@NotNull VoiceWallMode mode)
    Sets the active occlusion mode.
    boolean
    toggleDebugPlayer(@NotNull org.bukkit.entity.Player player)
    Toggles visual particle raycast debugging and Action Bar diagnostics for a player.

  • Method Details

    • init

      void init(@NotNull @NotNull de.maxhenkel.voicechat.api.VoicechatServerApi api)
      Initializes the VoiceWall service with the Simple Voice Chat server API.
      Parameters:
      api - the VoicechatServerApi instance

    • isEnable

      boolean isEnable()
      Checks whether the VoiceWall acoustic engine is globally enabled.
      Returns:
      true if active

    • setEnable

      void setEnable(boolean value)
      Enables or disables VoiceWall globally.
      Parameters:
      value - the enabled flag

    • getMode

      @NotNull @NotNull VoiceWallMode getMode()
      Gets the active occlusion mode.
      Returns:
      the VoiceWallMode

    • setMode

      void setMode(@NotNull @NotNull VoiceWallMode mode)
      Sets the active occlusion mode.
      Parameters:
      mode - the new VoiceWallMode

    • isStrictBlock

      default boolean isStrictBlock()
      Convenience check if strict block mode (100% soundproof) is active.
      Returns:
      true if strict block mode

    • isAirDampingEnabled

      boolean isAirDampingEnabled()
      Checks whether high-frequency air damping over distance is active.
      Returns:
      true if air damping is enabled

    • setAirDampingEnabled

      void setAirDampingEnabled(boolean value)
      Sets high-frequency air damping over distance.
      Parameters:
      value - the air damping flag

    • isDebug

      boolean isDebug()
      Checks whether debug logging is enabled.
      Returns:
      true if debug is active

    • setDebug

      void setDebug(boolean value)
      Sets debug logging flag.
      Parameters:
      value - debug flag

    • toggleDebugPlayer

      boolean toggleDebugPlayer(@NotNull @NotNull org.bukkit.entity.Player player)
      Toggles visual particle raycast debugging and Action Bar diagnostics for a player.
      Parameters:
      player - the player
      Returns:
      new debugging state (true if enabled)

    • hasDebugPlayer

      boolean hasDebugPlayer(@NotNull @NotNull UUID playerUuid)
      Checks whether a player has visual particle debugging enabled.
      Parameters:
      playerUuid - the player UUID
      Returns:
      true if debug active for this player

    • setDebugPlayer

      void setDebugPlayer(@NotNull @NotNull UUID playerUuid, boolean enabled)
      Sets visual particle debugging state for a player.
      Parameters:
      playerUuid - the player UUID
      enabled - debugging flag

    • processEntitySoundPacket

      void processEntitySoundPacket(@NotNull @NotNull de.maxhenkel.voicechat.api.events.EntitySoundPacketEvent event, @NotNull @NotNull VPlayer vSender, @NotNull @NotNull VPlayer vReceiver, @NotNull @NotNull de.maxhenkel.voicechat.api.VoicechatConnection receiverConn)
      Intercepts and processes a positional entity sound packet, performing acoustic raycasting and attenuation.
      Parameters:
      event - the intercepted SVC entity sound packet event
      vSender - the sender voice player wrapper
      vReceiver - the receiver voice player wrapper
      receiverConn - the receiver voicechat connection