Troubleshooting

Start with the doctor

/cdisc admin doctor

Lists every source with one of four marks. It runs from the console too.

Mark	Means
✔	Works
✖	Switched off in sources.yml
!	Switched on, but missing its key
?	Works until it doesn't, such as YouTube without a fallback

Most "track not found" reports are a source that was never configured, and this is the command that says which.

Nobody hears anything

• Every player needs the client mod of the voice chat the server runs. Without it the plugin works and they hear nothing.
• Check that voice chat itself works: ordinary speech between players should get through.
• Look at the console at startup. CDisc names the voice backend it picked; if it found none, it disabled itself.
• Check the voice chat volume on the client, and the "CDisc Music" category in Simple Voice Chat's settings.

Only I can hear it

You are probably carrying the jukebox: its audio goes straight to you, and others hear it only from near you. Put it back down.

Several jukeboxes sound like mush

Two jukeboxes with the same disc are two independent playbacks and drift apart. Put them in a speaker group, where one decode feeds all of them.

A track isn't found or won't play

1. /cdisc admin doctor.
2. Check the source is switched on in sources.yml.
3. For YouTube, see YouTube. youtube.fallback-api: true is the first thing to try.
4. A Discord link more than about a day old has expired: copy it again.
5. A direct link needs enabled.http: true, or save it with /cdisc admin download.
6. Read the console: the reason for a refusal is there.

A command refuses

The reason is in the message: no permission, still on cooldown, a blocked host, a track that's too long, a region you're not a member of. All of it is set in Permissions and, for regions, WorldGuard.

Lyrics don't show

• Players who never chose see nothing unless lyrics.default-on: true. /cdisc lyrics lyrics turns them on for you.
• Most tracks without words simply aren't in the lyrics databases. lyrics.debug: true names each lookup in the console.
• For a file in the music folder, add the words yourself with /cdisc admin local-files-config.

Music didn't resume after a restart

• resume-playback: true in config.yml.
• A jukebox resumes when its chunk loads: walk over to it.
• A paused jukebox stays paused on purpose.

The server works harder than I'd like

• Every playing jukebox is decoded and encoded separately; each speaker in a group is a separate source for every listener near it.
• A larger hearing range means more listeners per source and more outgoing traffic. Lower svc-config.distance and the beacon levels.
• With voice-backend: multi, each voice plugin costs one extra encode.

Reporting a bug

/cdisc admin logs

uploads the server log to mclo.gs, with the doctor report on top and keys and tokens hidden, and replies with a link. Paste it into a new issue with:

• the Minecraft and server versions, and the CDisc version;
• which voice plugin is installed;
• what you did, and what you expected.

Search the open issues first. Never attach tokens.yml: issues are public.

Questions are also welcome on Discord.