Scripta

Scripta (Fabric, Architectury + OwoLib)

Global, data-driven questing mod for Minecraft 1.21.1, currently shipping on Fabric. Only three starter categories ship by default — quests are authored by you (hand-written JSON or the web).

Authoring quests

• Category: id, display_name, icon {id, count}, sort_order, number
• Quest: id, category, title, description, icon, objectives[], rewards[], prerequisites[], auto_claim (default true)
• Objective type: break_block | kill_entity | collect_item | grant_advancement | reach_stat (custom stats only, e.g. minecraft:jump)

Rewards (FTB Quests style)

Each reward is { "type": ..., ... }. Types:

• Reward tables are weighted pools: {id, name, entries:[{reward, weight}], crate:{enabled, name}}. Edit them in the web editor's Reward tables panel; quests reference them by id. A choice reward inside a table is refused — choices live on quests directly.
• Auto-claim (auto_claim, default true): non-interactive rewards are granted the moment the quest completes. Turn it off (or use choice rewards) to require Claim / Choose buttons in the quest book. Claim state is stored per player and synced.
• Unknown reward types and legacy JSON round-trip instead of failing the quest; one bad entry in a rewards array is skipped, not fatal.
• Reload with /reload; definitions sync to clients on join and via tick broadcast.

Playing

• /quests (client command) or G keybind opens the quest book: categories tab, quest list (name + icon), detail overview
• /questedit opens the full in-game editor (op level 2 enforced server-side): quests, categories, reward tables, presets, and theme controls share the same save/cancel flow as the web editor. Icon upload remains web-only.
• Web editor: when any world/server runs, operators receive a clickable link on join; /scripta web sends the link again on demand. Edit quests, categories, reward tables, presets, theme, and upload PNG icons from the browser — changes apply instantly and sync to every player. Port override: -Dscripta.webport=<port>. The token is a fresh random value on every server start and is only delivered in chat to operator level 2 players (on join and via /scripta web) — it is never written to the server log, so keep the link secret.
  • Editor layout: sidebar sections for Quests, Categories, Reward tables, Presets, Icons, and GUI theme. A dirty-state bar keeps Save/Discard actions visible while editing.
  • Structured objectives: each objective has a type dropdown, target autocomplete, and count field; targets autocomplete from the live item, block, entity, and advancement registries.
  • Prerequisite chips: add or remove prerequisite quest IDs without editing a comma-separated string.
  • Structured rewards and table entries: reward types come from the server registry, reward tables expose weighted structured entries, and inline/unknown rewards remain editable as raw JSON.
  • Quest categories are a dropdown — pick one, don't type IDs.
  • Numbered categories (set a number on the category) give hierarchical quest IDs: category 1's quests become 1.1, 1.2, … (use the Auto button or leave the ID free-form; unnumbered categories keep classic IDs).
  • Structured reward builder with server-provided type metadata; inline choice options and unknown future types remain editable as raw JSON.
  • Reward tables panel: create/edit/delete weighted tables and toggle their loot-crate mode.
  • Reward presets (Starter Kit, Monster Hunter, Treasure + your own): insert one into any quest with a click, manage them in their own panel.
• Quest icons are either a block/item ("icon": {"id": "...", "count": 1}) or a texture path ("icon": "scripta:web_icons/dragon.png") from a resource pack or a web-uploaded PNG (auto-synced to clients).
• /scripta list shows all quests with your completion state
• /scripta web (operator level 2) sends the clickable web-editor link in chat; operators also receive it automatically on join
• /scripta sync re-syncs your progress + definitions
• /scripta reset [<player>] clears progress (op level 2)
• Completing a quest sends a chat message + level-up sound; item rewards that don't fit are dropped at your feet instead of voided. Auto-claimed rewards are granted immediately; manual-claim / choice rewards show Claim, Choose (picker screen) and Claim All buttons in the quest detail.
• Progress persists per player via SavedData (scripta_progress); only progress is per-world, quests are global.
• Removing a quest JSON prunes it from everyone's completed list on the next tick.
• GUI theme (web console → GUI theme): per-pane surfaces (PANEL, DARK_PANEL, PANEL_INSET, VANILLA_TRANSLUCENT, BLANK, or image:<texture> backgrounds), title/text/accent colors, text shadow, tab + icon sizes, pane widths, and widget colors for buttons, fields, selection, muted text, focus, and danger states. Stored per-world (serverconfig/scripta_theme.json), applied to every player's screens the moment you save. Fonts are intentionally excluded — owo renders labels with Minecraft's global fonts, which only resource packs can change.

Credits

• Developed by @pqlle
• GUI Design + logo by @Doggegn
• Built using and OwoLib.

Help

• Discord
• Docs