Configuration

VoiceHub's configuration is stored in config.json inside the mod's data folder.

Default Configuration

{
  "_info": "KyuubiSoft VoiceHub Configuration",
  "proximity": {
    "enabled": true,
    "maxHearingDistance": 64.0,
    "fullVolumeDistance": 16.0,
    "deadPlayersCanHear": false
  },
  "defaultChannels": [
    {
      "name": "Proximity",
      "description": "Players nearby can hear you",
      "type": "PROXIMITY"
    },
    {
      "name": "Global",
      "description": "Server-wide voice channel",
      "type": "GLOBAL"
    }
  ],
  "channels": {
    "maxChannelsPerPlayer": 3,
    "maxChannelsTotal": 50,
    "maxMembersDefault": 20,
    "allowPlayerCreatedChannels": true,
    "allowGlobalChannels": false,
    "whisperEnabled": true,
    "persistentChannelsEnabled": true,
    "autoDeleteEmptyAfterMinutes": 30
  },
  "permissions": {
    "adminPermission": "kyuubisoft.voicehub.admin",
    "createPermission": "kyuubisoft.voicehub.create"
  }
}

Settings Reference

Proximity

Setting	Type	Default	Description
enabled	boolean	true	Enable proximity voice
maxHearingDistance	float	64.0	Maximum hearing range in blocks
fullVolumeDistance	float	16.0	Distance at which volume starts to fade
deadPlayersCanHear	boolean	false	Whether dead players can hear voice

Default Channels

An array of channels that are automatically created on server start. These channels cannot be deleted by players.

Field	Type	Description
name	string	Display name of the channel
description	string	Channel description
type	string	Channel type: PROXIMITY, GROUP, GLOBAL, MODERATED, WHISPER

Channels

Setting	Type	Default	Description
maxChannelsPerPlayer	int	3	Maximum channels a player can own
maxChannelsTotal	int	50	Maximum total channels on the server
maxMembersDefault	int	20	Default member limit for new channels
allowPlayerCreatedChannels	boolean	true	Whether players can create channels
allowGlobalChannels	boolean	false	Whether GLOBAL type channels are allowed
whisperEnabled	boolean	true	Whether whisper channels are allowed
persistentChannelsEnabled	boolean	true	Whether channels can persist across restarts
autoDeleteEmptyAfterMinutes	int	30	Auto-delete empty non-persistent channels after X minutes

Permissions

Setting	Type	Default	Description
adminPermission	string	kyuubisoft.voicehub.admin	Permission for admin commands and panel
createPermission	string	kyuubisoft.voicehub.create	Permission required when allowPlayerCreatedChannels is false

Player Channel Creation

When allowPlayerCreatedChannels is true (default), all players can create channels without any permission. The createPermission is only checked when allowPlayerCreatedChannels is false.

Database

VoiceHub uses SQLite for persistence. The database file voicehub.db is stored in the mod's data folder and contains:

• channels — persistent channel configurations
• channel_members — member lists for persistent channels
• channel_permissions — moderator assignments
• player_settings — per-player preferences (last channel, voice enabled)