Install the Bridge Plugin

Prerequisites

• Server software: Paper or Purpur ≥ 1.20.6
• Java: 21 or later
• Quest plugin: Quests (PikaMug) ≥ 5.0 (supported plugins)

Step 1: Download the Bridge plugin

Download QuestFableBridge.jar from one of these sources:

• Modrinth (recommended)
• Hangar (PaperMC)
• SpigotMC

Step 2: Add the jar to your server

Copy QuestFableBridge.jar into your server's plugins/ folder.

# copy to your server's plugins folder
cp QuestFableBridge.jar /your-server/plugins/

Step 3: Restart your server

Restart the server (or run /reload confirm if your server supports it).

On startup, the Bridge plugin detects your installed quest plugin and prints to the console:

[QuestFableBridge] Detected quest plugin: Quests (PikaMug) v5.3.1
[QuestFableBridge] Ready · run /qf link in-game to connect your account.

What the Bridge plugin does (and does not do)

• Does: connects to QuestFable's backend over HTTPS (outbound only, no inbound ports opened)
• Does: writes quest files into plugins/Quests/import/ only
• Does not: modify quests.yml or any existing plugin file
• Does not: collect player data, player names, or server metrics
• Does not: require a restart after generating quests (hot-reload via PikaMug)