VCMC Bedrock Addon 2.0

Proximity voice chat for Minecraft Bedrock worlds and dedicated servers

Download VCMC · Documentation · Changelog · Discord

What This Repository Contains

This is the official Bedrock Addon used by VCMC. The editable source is divided into:

Pack	Use
VCMC - WORLD	A world hosted directly from Minecraft Bedrock
VCMC - SERVER	A dedicated Bedrock server, including Aternos or BDS
VCMC - RP	Shared icons, forms, translations, and interface resources

Generated .mcpack and .mcaddon files are distributed through GitHub Releases and are intentionally excluded from source commits.

Requirements

• Minecraft Bedrock with cheats enabled
• The VCMC app on every device that will send or receive voice
• The World or Server behavior pack
• The shared VCMC resource pack
• Internet access to the VCMC voice service

VCMC 2.0 is recommended for all new features. Older apps and Addons retain the legacy connection flow with a reduced feature set.

Choose a Mode

Local World

Use this mode when a player creates the world from Minecraft Bedrock.

1. Add VCMC - WORLD and VCMC - RP to the world.
2. The host enables WebSockets and disables Encrypted WebSockets only in Minecraft settings.
3. Everyone enters the host's room in the VCMC app.
4. The host copies the generated /wsserver command from VCMC and pastes it in Minecraft.
5. After the world is linked, every guest copies and pastes their own /vcmc:verify "<code>" command.

The host is the only player who installs the Addon and uses /wsserver. Each guest still verifies their own identity before joining the world's protected voice subroom.

Dedicated Bedrock Server

Use this mode for BDS, Aternos, or another dedicated Bedrock server.

1. Upload VCMC - SERVER and VCMC - RP.
2. On non-Aternos servers, allow @minecraft/server-net in config/default/permissions.json.
3. Restart the server and join it from Minecraft.
4. Add the server in the VCMC app.
5. Copy /vcmc:verify "<code>" from the app and paste it in Minecraft.

The Addon creates and restores its protected room automatically. Players do not need an IP, room ID, or room token.

VCMC 2.0 Features

• Distance and spatial voice data
• Secure World subrooms
• Individual player verification
• Bidirectional app and Minecraft settings
• Master and per-player volume
• Self mute and administrative mute
• Public, private, and administrative groups
• Group passwords with an administrator warning before bypass
• Megaphone routing
• Built-in and custom voice effects
• Environmental effects for water, lava, caves, and dimensions
• Custom-dimension support
• Connection, mute, speaking, and megaphone indicators
• Legacy compatibility for older VCMC clients

Player Commands

The visible commands are shared by Addon World, Addon Server, and the Java plugin.

Command	Description
/vcmc:verify "<code>"	Link the Minecraft player with the personal code shown by VCMC
/vcmc:menu	Open voice settings, groups, and per-player volume
/vcmc:m [true|false]	Toggle or set your own mute state
/vcmc:groups	Open the groups menu
/vcmc:groups create <name> [password]	Create a voice group
/vcmc:groups join <group_or_name> [password]	Join a voice group
/vcmc:groups leave	Leave the current group
/vcmc:groups list	List available groups
/vcmc:groups delete [group_or_name]	Delete a group you own

Administrator Commands

These commands require operator permissions.

Command	Description
/vcmc:admin	Open the VCMC administration menu
/vcmc:mute <player|selector> <true|false>	Force or restore a player's microphone
/vcmc:groups-settings <group> <global|external|environmental> <true|false>	Change group audio routing
/vcmc:groups-admin create <group 1-255>	Create an administrative group
/vcmc:groups-admin move <group|0> <player|selector>	Move players between groups
/vcmc:groups-admin leave <player|selector>	Remove players from a group
/vcmc:groups-admin list	List administrative groups
/vcmc:groups-admin delete <group>	Delete an administrative group
/vcmc:megaphone <player|selector> <true|false>	Enable or disable megaphone
/vcmc:sfx add <name> <json-string>	Create a custom effect
/vcmc:sfx delete <name>	Delete a custom effect
/vcmc:sfx list	List custom effects
/vcmc:sfx-player set <player|selector> <effect>	Assign a built-in effect
/vcmc:sfx-player set <player|selector> custom <name>	Assign a custom effect
/vcmc:sfx-player clear <player|selector>	Clear a player's effect

Custom SFX on Bedrock

Bedrock receives JSON as a string. Wrap the full object in quotes and escape every internal quote:

/vcmc:sfx add grave "{\"base\":\"normal\",\"pitch\":-4,\"gain\":2,\"lowpass\":4200,\"highpass\":80,\"q\":0.8,\"distortion\":1.5,\"dry\":1}"

The Java plugin accepts the JSON object directly; only Bedrock requires this escaped format.

Removed Commands

/vcmc:join, /vcmc:room, and /vcmc:reconnect are no longer public commands. VCMC now identifies, restores, and reconnects rooms automatically.

World bridge and synchronization commands are internal. Players and administrators should not execute them manually.

Source Layout

source/
├── VCMC - RP/
├── VCMC - SERVER/
└── VCMC - WORLD/

Downloads

VCMC App

• Android — Google Play
• iOS — App Store
• Windows — Microsoft Store
• Windows — GitHub Releases
• Web app for macOS and Linux

Other Minecraft Components

• Java/Geyser plugin
• Plugin on CurseForge

Help

• Official VCMC documentation
• VCMC 2.0 changelog
• Discord support
• Repository issues

VCMC is a free, independent project created by Naru. It is not affiliated with Mojang Studios. Minecraft is a trademark of Mojang AB.