?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
StartFlow

StartFlow

Free onboarding guide and funnel drop-off analytics for Paper servers. Guide new players through starter steps and see exactly where they abandon your server.

8downloads
0followers
8downloads
0followers

Compatibility

Minecraft: Java Edition

1.21.x

Platforms

Links

Report issues View source Join Discord server

Tags

Creators

Details

Licensed ARR
Published 2 days ago
Updated last week

Most players decide whether to stay on a Minecraft server within their first ten minutes. When players leave early, server administrators are usually left guessing which rule, command, or missing tutorial caused them to quit.

StartFlow solves this by guiding newcomers through customizable starter milestones while giving administrators clear onboarding analytics that show exactly where players drop off.

Why StartFlow?

  • See Player Drop-Off Clearly: The built-in funnel report (/sf report) shows how many players completed each step and highlights the exact step where players abandon the onboarding flow.
  • Automated Step Detection: Players complete steps naturally by playing. StartFlow tracks bed homes, trades, shop sales, land claims, chest placement, region entries, and commands.
  • Safe Rewards: Grant items, currency, or permissions via console commands per step and on completion. Backed by SQLite transactions to prevent duplicate rewards across server restarts or reconnects.
  • Zero Required Dependencies: Runs out of the box on Paper 1.21.x. Soft dependencies (Vault, GriefPrevention, PlaceholderAPI) integrate automatically when present.
  • Multilingual by Default: Six built-in languages, delivered based on each player's client language. See the full list below.

Features

  • Interactive Guide Menu (/guide): A clean chest inventory interface displaying step status, instructions, and practical hints.
  • Drop-Off Analytics: View completion rates and bottleneck warnings directly in game chat, in an admin GUI, or export them to a CSV spreadsheet.
  • Ready-Made Templates: Apply tested starter setups for Survival, Skyblock, or Anarchy servers with one command (/sf template survival confirm).
  • Offline Player Management: Inspect progress, complete steps, or reset records for online and cached offline players.
  • Daily Login Rewards: Optional daily reward system with consecutive day streak tracking and milestone bonuses (disabled by default).
  • Playtime Rewards: Optional playtime milestones with automatic AFK detection (disabled by default).
  • Onboarding Essentials: Optional rules acceptance gate, starter kit delivery, and customizable join/quit announcements (disabled by default).
  • Folia Support: Region-threaded scheduling, tested on Folia 1.21.11.
  • Update Checker & bStats: Integrated version notifications and lightweight anonymous metrics.

Quick Start

  1. Drop StartFlow-1.0.0.jar into your plugins/ directory and restart your server.
  2. Apply a starter template for your game mode:
    • /sf template survival confirm
    • /sf template skyblock confirm
    • /sf template anarsi confirm
  3. Open the guide menu as a player with /guide to inspect the flow.
  4. Customize coordinates and commands in plugins/StartFlow/config.yml, then reload using /sf reload.
  5. View your onboarding data anytime using /sf report or export data via /sf report csv.

Commands

Players

  • /guide (or /rehber, /basla): Open the starter guide menu.
  • /guide daily: Check daily login streak and today's reward status.
  • /guide playtime: Check active playtime and upcoming milestones.
  • /guide rules / /guide rules accept: View or accept server rules.
  • /guide skip: Skip remaining guide steps.
  • /guide reset: Reset personal guide progress.

Admins (startflow.admin)

  • /sf menu: Open the admin management menu.
  • /sf report: View the onboarding drop-off summary in chat.
  • /sf report csv: Export the funnel analysis to a CSV file.
  • /sf template <survival|skyblock|anarsi> [confirm]: Apply a starter template.
  • /sf player <name> info: View completed steps for a player.
  • /sf player <name> step <id>: Mark a specific step complete for a player.
  • /sf player <name> reset [id]: Reset all progress or a single step for a player.
  • /sf player <name> reset-daily: Reset daily login streak for a player.
  • /sf player <name> reset-playtime: Reset playtime milestones for a player.
  • /sf reload: Reload configuration and language files.

PlaceholderAPI Support

  • %startflow_progress% - Completed steps ratio (e.g. 2/5)
  • %startflow_progress_percent% - Completion percentage (e.g. 40)
  • %startflow_step% - Current step name or Complete
  • %startflow_completed% - Completion status (Yes / No)
  • %startflow_bar% - Visual MiniMessage progress bar
  • %startflow_streak% - Current daily streak count
  • %startflow_best_streak% - Highest daily streak record
  • %startflow_playtime% - Tracked active playtime (e.g. 2h 30m)
  • %startflow_next_milestone% - Next playtime milestone identifier

Languages

StartFlow detects the player's client language and shows messages in it. Unsupported languages fall back to default-language in config.yml.

  • English
  • Turkish
  • German
  • Spanish
  • Russian
  • Portuguese

All language files can be edited in plugins/StartFlow/messages/.

Compatibility & Requirements

  • Platform: Paper 1.21.x (or compatible forks), Folia supported
  • Runtime: Java 21 or newer
  • Soft Dependencies: PlaceholderAPI, Vault, GriefPrevention
  • License: StartFlow License (free to use, source-available)

Support & Links

StartFlow is developed and maintained by Clodo. Visit https://clodo.net for documentation and updates.