Troubleshooting

Troubleshooting

Build fails because Java version is wrong

ServerFabric uses internal managed JDKs for builds.
Check:

• template version
• build log file
• tools-cache/jdks/

BuildTools / Spigot build fails

Check:

build-cache/<template>/<version>/buildlog.txt

Instance stays in STOPPING

Make sure the proxy/client status watch logic is working and that the host actually reports the clean exit.

Proxy decode errors

Check protocol changes across:

• client write order
• proxy read order
• response packet structure

Stats feel slow

Disk usage may be cached on the host side.
This is normal and reduces heavy filesystem walking.

API is not available

Check:

• ServerFabricProxy is installed and enabled
• the plugin depends on the proxy
• the API is not being shaded into the consumer plugin