Help & Diagnostics

First-run checklist and plain-language troubleshooting.

Connection Readiness

Use this before changing settings. It checks the common causes of a blank page or commands that do nothing.

Checking…

First-Run Checklist

  1. The Binhex container is named binhex-minecraftbedrockserver, or the template variable matches its real name.
  2. /var/run/docker.sock is mounted read/write into CraftCommand Center.
  3. /mnt/user/appdata/craftcommand-center/data is mapped to /app/data.
  4. Screen Session is set to auto, Docker User is nobody, and Command Method is attach.
  5. Change the default password and use HTTPS before allowing access outside your trusted home network.
  6. For public reachability, set the external hostname/IP and UDP port in the Unraid Edit screen.
  7. Map /mnt/user/backups/craftcommand-center to /app/backups for admin server exports.

Account Roles

Viewer

Can browse items, status, players, kits, diagnostics, and only their own activity. Cannot send commands.

Operator

Can give items, XP, send kits, refresh players, and repair the screen attachment.

Admin

Can also manage dashboard accounts, add manual players, create/delete custom kits, review all activity, and create/download server exports.

Common Problems

Commands return OK, but nothing happens

Run diagnostics, then refresh the Docker/screen attachment. Confirm the live session looks like 140.minecraft and the Docker user is nobody.

The public endpoint shows offline

Confirm the public DNS/IP and UDP port in Unraid. The default external mode uses an internet-hosted Bedrock probe. Local mode runs from Unraid and can fail on routers without NAT loopback even when outside players can connect.

A player is missing from the target list

Use Pull Known Players. If Bedrock does not expose the name in logs or server files, an admin can use Add Player manually.

The Unraid Docker page does not show Edit

Create the container from the included DockerMan XML template rather than a raw docker run command.

The browser shows old buttons after an update

Hard-refresh the page or clear site cache. Static files use versioned query strings, but some mobile browsers hold older pages longer than expected.

An item icon shows letters instead of Minecraft art

CraftCommand Center loads current Minecraft Wiki inventory sprites and falls back through Invicon, ItemSprite, and BlockSprite names. Check that the phone or browser can reach minecraft.wiki; uncommon technical items may not have a matching wiki image.

Beta Feedback

When reporting a problem, include the CraftCommand Center version, Unraid version, Binhex container name, diagnostics results, browser/device, and the exact button pressed. Do not include passwords or private server addresses.

🐛 Open a GitHub issue