Bridge Not Detected
You restarted the server but don't see the QuestFable Bridge startup message. Here's how to fix it.
Expected startup output
After a successful install and restart, the server console should show:
[QuestFableBridge] Detected quest plugin: Quests (PikaMug) v5.3.1
[QuestFableBridge] Ready · run /qf link in-game to connect your account.Possible causes and fixes
1. The jar is in the wrong folder
Make sure QuestFableBridge.jar is in the root plugins/ folder, not a subfolder.
# Correct
plugins/QuestFableBridge.jar
# Wrong
plugins/questfable/QuestFableBridge.jar2. Java version is too old
The Bridge plugin requires Java 21 or later. Check your Java version:
› java -versionIf it shows Java 17 or earlier, upgrade your Java runtime and restart the server.
3. Server software is not Paper or Purpur
The Bridge plugin supports Paper ≥ 1.20.6 and Purpur ≥ 1.20.6. It does not support Spigot, Bukkit, Fabric, Forge, or Vanilla.
4. Quest plugin is not installed or wrong version
The Bridge plugin requires Quests (PikaMug) ≥ 5.0 to be installed and enabled. Check the console for PikaMug startup messages.
If PikaMug is not installed, run /qf setup-quests: the Bridge will install and configure it automatically (MIT licence).
5. Plugin was disabled or blocked by a plugin manager
Some server management plugins can disable or sandbox other plugins. Check if QuestFableBridge appears in the /plugins list and whether it is enabled (green).
6. The jar file is corrupted
Download a fresh copy from Modrinth and verify the file size matches the download page.
Still stuck?
Paste your server startup log (the section around Bridge initialisation) in the QuestFable Discord and the team will help.