FTB Quests: Prelude

Open the FTB Quests quest book outside a world: browse and edit local quests from the main menu, and view single-player save progress.

A client-side mod for Minecraft 1.20.1 (Forge) that opens the FTB Quests quest book outside a world: from the main menu (TitleScreen), the world selection (SelectWorldScreen) and world creation (CreateWorldScreen) screens, and the world loading screen (LevelLoadingScreen). It also displays a single-player save's quest progress in the same book.

Requires FTB Quests and its dependencies (FTB Library, FTB Teams, Architectury API). Client-side only — a server does not need it.

What it adds

FTB Quests' book can only be opened from inside a world. This mod adds entry points for it in screens where it is normally unreachable:

Screen What the button opens
TitleScreen (main menu) The local book — the quests in <config>/ftbquests/quests
SelectWorldScreen The highlighted save's quest progress
CreateWorldScreen The local book
LevelLoadingScreen The loading save's quest progress

On LevelLoadingScreen the button is drawn by this mod, because that screen does not draw widgets itself; packs that replace or wrap it (FancyMenu and similar) may not show it.

Local editing

Editor mode makes every quest visible and editable: quests, chapters, tasks, rewards and reward tables. Changes are written straight to <config>/ftbquests/quests. Turn editor mode on with the book's editor button, or with editorModeDefault = true in the config.

The quest files can also be edited outside the game: the reload button in the book's button panel re-reads them from disk, keeping the current save/team and the screen you came from.

Writing is guarded, so a mistake is recoverable:

  • debounced auto-save while you edit;
  • an extra save when the screen closes;
  • a timestamped backup before every save, with a configurable retention count;
  • orphaned chapter and reward-table files are cleaned up on save.

Single-player save progress

The save icon button in the book's bottom-right button panel opens the progress picker:

  • while you are viewing a save, it opens that save's team list;
  • otherwise it opens a save picker first, and the team list has a Switch save… entry.

Each team row shows its member count. Hover it for the member names, or right-click it for the full member list. Selecting a team loads that team's progress into the open book.

Configuration

The config file is <config>/ftbq_prelude/ftbquests_prelude-common.toml.

Option Default Range Description
backupCount 10 0–1000 Timestamped backups to keep. 0 disables backups.
backupIntervalMinutes 10 1–1440 Minimum minutes between automatic backups.
autoSaveOnClose true — Save pending edits when the screen closes.
autoSaveDebounceSeconds 5 1–300 Seconds of inactivity before pending edits are saved.
editorModeDefault false — Open the local book in editor mode.
showEntryButtons true — Show the menu-screen buttons (the only entry point).
showSaveProgressButton true — Show the progress button inside the book.
hiddenButtonPackages ["com.huanghuang.rsintegration."] — Java package prefixes of third-party quest book buttons to hide while the local book is open.
compatWorkarounds true — Allow working around third-party mods that crash the book outside a world (their config is never written).

Compatibility

  • Minecraft 1.20.1
  • Loader Forge 47.x
  • Side Client only (displayTest = IGNORE_ALL_VERSION, so clients may join servers without it)
  • Dependencies FTB Quests 2001.4.x or newer (built against 2001.4.22), plus FTB Library, FTB Teams and Architectury API

Known limitations

  • This mod does not replace FTB Quests' server sync. In multiplayer, quest data and progress remain server-authoritative.
  • Quest files that were never cached locally may be unavailable, so multiplayer progress is not guaranteed.
  • Editing multiplayer quests from these screens is not supported — use the in-world book.
  • Not every flow reuses the full native UI, so some interactions differ from the in-world book.
  • Team names and members are read from local save data; players never seen on this machine can show as a short UUID.
  • Outside a world a few things cannot match the in-world book: modded biomes only appear once a world has been joined in the session; the fluid picker shows no fluid icons; and T / S / D (edit quest title / subtitle / description), the dimension task icon and the reward-table close "x" do not work. All of these behave the same way in unmodified FTB Quests on this machine, so they are left alone.

Credits and license

  • License: MIT.
  • Built on FTB Quests, FTB Library, FTB Teams and the Architectury API; thanks to their authors.
  • This project is not affiliated with or endorsed by FTB (Feed The Beast).

FTB Quests: Prelude Team

profile avatar
  • 3
    Projects
  • 410
    Downloads

More from wdlpiaoyi