Skip to main content

FAQ & Troubleshooting

Frequently Asked Questions​

How do I open the voice channel browser?​

Use any of these commands:

/ksvoice open
/vc open
/voicehub open

You can also use the aliases menu or ui instead of open.

What are the different channel types?​

TypeBehavior
ProximityDistance-based -- only players within range hear you. Range is configurable per channel or globally.
GroupAll members hear each other regardless of distance (within the same world).
WhisperPrivate 1-on-1 channel, limited to 2 members.
ModeratedMembers need talk power to speak. Owner and moderators always have talk power.
GlobalServer-wide channel. Must be enabled in config (allowGlobalChannels).

Can I be in multiple channels at once?​

No. Each player can only be in one channel at a time. Joining a new channel automatically leaves the previous one. When you leave a non-default channel, you are moved back to the default Proximity channel.

How do passwords work?​

Channel passwords are hashed with SHA-256 before storage -- plain-text passwords are never saved. When joining a password-protected channel, enter the password in the UI detail panel or pass it as an argument:

/ksvoice join <channelId> <password>

Admins with kyuubisoft.voicehub.admin bypass password checks when joining through the UI.

How does the text chat (!vc) work?​

Type !vc <message> in normal chat. The message is intercepted, the original chat message is cancelled, and the text is delivered only to members of your current voice channel. The format is:

[VoiceChat] PlayerName: message

If you are not in a channel, you will see: [VoiceHub] You are not in a voice channel.

What happens when I disconnect?​

When you disconnect:

  1. You are removed from your current channel.
  2. A leave message is broadcast to channel members (except for default channels).
  3. If the channel is now empty, non-persistent, and not a default channel, it is auto-deleted immediately.
  4. When you reconnect, VoiceHub tries to rejoin your last channel. If that fails, you are placed in the default Proximity channel.

What is a "persistent" channel?​

Persistent channels survive server restarts. They are stored in the SQLite database along with their settings and member lists. Admin-created channels (via /ksvoice admin create) are persistent by default. Player-created channels are not persistent.

Troubleshooting​

"Voice module not active. Running in channel-management-only mode."​

This means VoiceHub could not find or activate Hytale's VoiceModule. Possible causes:

  • Your server is running a Hytale version older than Update 4.
  • Voice is disabled in the server configuration.

Channel management (creating, joining, listing) still works, but actual voice routing does not.

Players cannot hear each other across worlds​

This is a known limitation of Hytale's voice system. QUIC voice streams are scoped to individual worlds. Players in different worlds cannot hear each other, even if they are in the same channel. VoiceHub displays a warning when this happens:

Players in other worlds cannot hear you.

"Failed to create channel. Limit reached?"​

This error appears when:

  • The server has reached maxChannelsTotal (default: 50).
  • You have reached maxChannelsPerPlayer (default: 3).
  • The channel name is invalid (must be 2-32 characters, alphanumeric with spaces, hyphens, and underscores).

"You cannot leave this channel."​

You cannot leave default channels (Proximity and any other channels defined in the defaultChannels config). When you leave a non-default channel, you are automatically moved back to the default channel.

"No permission" when creating channels​

If allowPlayerCreatedChannels is set to false in config.json, players need the kyuubisoft.voicehub.create permission to create channels. Check with your server admin.

Admin commands don't work​

Admin commands require both of these permissions:

  • ks.voice.admin -- command-level gate (Hytale's command system)
  • kyuubisoft.voicehub.admin -- runtime check inside the command handler

Make sure both are granted to the player or their permission group.

Player avatars are not showing in the member list​

Avatars require KyuubiSoft Core to be installed. Core provides the DynamicImageService that downloads and renders player heads from HyVatar. Without Core, avatar slots are simply not displayed. This is optional and does not affect functionality.

Voice-banned player can still join channels​

Voice bans (blacklist) prevent players from joining non-default channels and block their voice packets from being routed. The player is moved to the default channel and effectively muted. The ban is timed and expires automatically. To check or manage bans, use the admin panel's Blacklist tab.

Channel was deleted but I didn't delete it​

Empty non-persistent channels are automatically cleaned up after autoDeleteEmptyAfterMinutes (default: 30 minutes). If a channel has no members for that duration, it is removed. Persistent channels (admin-created) are never auto-deleted.

How do I change the language?​

Use the /kslang command:

  • /kslang -- opens the language selection UI
  • /kslang de-DE -- sets language to German
  • /kslang auto -- reverts to auto-detected client language

Supported languages: en-US, de-DE, fr-FR, es-ES, pt-BR, ru-RU, pl-PL, tr-TR, it-IT.