SculWave Documentation

Learn how to install and configure SculWave Minecraft voice chat for Java and Bedrock players. Set up proximity voice, Geyser and Floodgate compatibility, multi-server networks, groups, moderation, and supported Minecraft servers.

✨ Powered by LiveKit

Low-latency audio streaming with automatic room switching and spatial awareness.

Features

Real-time Proximity Voice

Automatic spatial audio based on player positions, helping nearby players communicate naturally in the game world.

Spatial Audio

Distance-aware voice communication that reflects how close players are to one another.

Automatic Room Switching

Seamless voice room switching between servers in a connected Minecraft network.

Companion Clients

Support for the SculWave Android app and web client.

Group Voice Chat

Communicate with group members independently of proximity communication.

Moderation Tools

Administrator commands and voice bans for managing access to voice chat.

Java and Bedrock Voice Chat

Geyser and Floodgate compatibility lets Java and Bedrock players communicate through the same SculWave voice experience.

Multi-World Awareness

Voice communication is isolated between different worlds.

Installation

Supported Servers

SculWave supports the following server software:

Paper
Purpur
Pufferfish
Spigot
Folia

Network Installation

⚠️ Important

SculWave is not a Velocity plugin. Install SculWave on every backend Minecraft server in your network, including servers where voice is disabled.

For example, a Velocity network may contain these backend servers:

Velocity
├── Lobby
├── Survival
├── Skyblock
└── Minigames

Install the SculWave plugin on each backend server listed above.

Setup Steps

Download the latest SculWave plugin.
Copy it into each server's plugins folder.
Start every server once so the plugin can generate its configuration.
Edit the generated configuration.
Restart the servers.

Configuration

Config File

The main configuration includes these settings:

activation-key: ""
voice-enabled: true
voice-bans: []

`activation-key`

Every server in the same network must use the same activation key. This links all backend servers into a single SculWave network.

activation-key: YOUR_NETWORK_KEY

`voice-enabled`

Enable or disable voice chat for a specific server. Players automatically disconnect from voice while visiting disabled servers and reconnect when entering voice-enabled servers.

# Lobby
voice-enabled: false

# Survival
voice-enabled: true

Room Codes

Each backend server receives its own unique room code. Players only need to connect once—SculWave automatically transfers them into the correct voice room when moving between servers.

Backend server	Example room code
Lobby	`ABCD`
Survival	`EFGH`
Skyblock	`IJKL`

Commands

Player Commands

Command	Description
`/vc`	Display voice chat help
`/vm`	Toggle your microphone mute state
`/vc invite <player>`	Invite a player to your group
`/vc join <code>`	Join a group using its code
`/vc leave`	Leave your current group
`/vc members`	View group members
`/vc kick <player>`	Remove a member from your group
`/vc transfer <player>`	Transfer group ownership

Administrator Commands

Command	Description
`/vc voiceban <player>`	Permanently disable voice for a player
`/vc voiceunban <player>`	Remove a voice ban
`/vc voicecheck <player>`	View a player's voice status
`/vc reload`	Reload configuration

Permissions

Permission	Description
`SculWave.admin`	Access to administrator commands (default: OP)

Confirm the exact subcommands and aliases against the installed plugin version before publishing.

Group Chat

Groups allow players to communicate regardless of distance. Players can invite others, transfer ownership, and automatically sync across the network.

Group Features

Player invitations
Automatic group creation
Ownership transfer
Member kicking
Automatic ownership migration
Real-time synchronization

Joining a Network

SculWave helps players discover and join publicly listed networks without having to manually track down a room code.

Discover Networks

The network discovery list can show details such as:

Network name, logo, and banner
Supported platforms and game version
Region and availability

Select a network to retrieve its current active room code and continue through the existing room-joining flow.

Joining a Network

Open network discovery in the SculWave client.
Choose the network you want to join.
Use the displayed room code to join through the existing room-joining flow.

The room code is also shown on the network discovery card and can be copied. Manual room-code joining remains available.

If a Network Is Unavailable

A network can be listed even when it does not currently have an active voice session. If that happens, the client should explain that the session is unavailable and let you try again later.

Benefits

Find publicly listed networks in one place
Review network information before joining
Copy room codes instead of retyping them
Continue using manual room-code joining when preferred
See availability before attempting to connect

How to Publish Your Minecraft Server on SculWave

SculWave Server Listing helps players discover your Minecraft server or community.

Who Can Publish a Listing?

Server owners can publish a listing from the dashboard. There is no separate verification or approval process described for publishing a listing.

Publish Your Server

Open the SculWave dashboard.
Select the server or network you want to list.
Open Server Listing.
Fill in the available listing fields.
Choose Publish (or the equivalent action shown in the dashboard).

Available fields depend on the form and may include:

Server name
Description
Server address, if requested
Game modes
Server icon or banner, if supported
Additional server details

Writing a Useful Listing

Help players understand what makes your server worth joining:

Describe the gameplay and main features.
Explain the community or play style.
Include accurate server information.
Use a clear icon or banner if image uploads are supported.
Keep the listing up to date when details change.

Manage Your Listing

Return to Server Listing in the dashboard to review or update the supported fields.

Frequently Asked Questions

Does my server need verification?

There is no separate verification process described for publishing a listing.

Does a listing require approval?

The documented flow does not include a manual approval step.

Can a small or new server be listed?

The publishing flow is not limited to large or established servers.

Can I update my listing later?

You can manage and update the fields supported by the dashboard.

What should I include in the description?

Explain your server's gameplay, features, community, and what players can expect.

Voice Moderation

Administrators can permanently restrict players from using voice chat through voice bans.

Voice bans persist across server restarts.
Voice bans apply across the entire SculWave network.
Voice bans can be removed at any time.

Multi-World Support

Voice chat only works between players in the same world. This keeps conversations isolated across multi-world servers.

World pair	Voice communication
Lobby ↔ Survival	Not available
Survival ↔ Skyblock	Not available
Overworld ↔ Nether	Not available

Java and Bedrock Voice with Geyser and Floodgate

SculWave supports Bedrock players on Minecraft servers using Geyser and Floodgate. Java and Bedrock players can join the same SculWave voice experience and communicate using proximity voice through the same companion application.

Requirements and Support

Requirements

Java 21 or newer
Internet connection
SculWave companion app (Android or Web)
SculWave activation key

Need Help?

If you encounter any issues, please open an issue on GitHub or join the SculWave community for support.

Add your official support links here when ready:

GitHub