大多数玩家会在加入 Minecraft 服务器的最初十分钟内决定是否留下。当玩家过早离开时,服务器管理员通常只能猜测是哪条规则、命令或遗漏的新手教程导致了他们的流失。
StartFlow 通过引导新玩家完成可自定义的新手里程碑,同时为管理员提供清晰的上手分析数据(精确显示玩家在何处流失),从而解决了这一问题。
为什么选择 StartFlow?
- 清晰查看玩家流失情况: 内置漏斗报告(
/sf report)展示了每个步骤完成多少玩家,并高亮显示玩家放弃上手流程的具体步骤。
- 自动步骤检测: 玩家通过自然游戏行为即可完成步骤。StartFlow 会追踪床铺家、交易、商店销售、领地认领、箱子放置、区域进入以及命令使用情况。
- 安全的奖励发放: 可通过控制台命令按步骤和完成状态发放物品、货币或权限。基于 SQLite 事务支持,防止在服务器重启或重新连接时重复发放奖励。
- 零必需依赖: 开箱即用,适用于 Paper 1.21.x。当存在软依赖项(Vault、GriefPrevention、PlaceholderAPI)时会自动集成。
- 默认多语言支持: 内置六种语言,根据每位玩家的客户端语言自动显示。完整列表见下文。
功能特性
- 交互式指南菜单 (
/guide): 简洁的箱式库存界面,显示步骤状态、说明和实用提示。
- 流失分析: 直接在游戏聊天、管理员 GUI 中查看完成率与瓶颈警告,或将其导出为 CSV 电子表格。
- 现成模板: 一条命令即可应用经过测试的生存、空岛或无政府状态服务器的新手设置(
/sf template survival confirm)。
- 离线玩家管理: 检查进度、完成步骤或重置在线及缓存离线玩家的记录。
- 每日登录奖励: 可选的每日奖励系统,包含连续天数追踪和里程碑奖励(默认禁用)。
- 在线时长奖励: 可选的在线时长里程碑,带有自动 AFK(挂机)检测功能(默认禁用)。
- 上手必备要素: 可选的规则接受门槛、新手包发放以及可自定义的加入/退出公告(默认禁用)。
- Folia 支持: 区域线程调度,已在 Folia 1.21.11 上测试。
- 更新检查器 & bStats: 集成版本通知和轻量级匿名指标统计。
快速开始
- 将
StartFlow-1.0.0.jar 放入你的 plugins/ 目录并重启服务器。
- 为你的游戏模式应用新手模板:
/sf template survival confirm
/sf template skyblock confirm
/sf template anarsi confirm
- 以玩家身份输入
/guide 打开指南菜单以检查流程。
- 在
plugins/StartFlow/config.yml 中自定义坐标和命令,然后使用 /sf reload 重载配置。
- 随时使用
/sf report 查看上手数据,或通过 /sf report csv 导出数据。
命令
玩家
/guide (或 /rehber, /basla):打开新手指南菜单。
/guide daily:检查每日登录连击数及今日奖励状态。
/guide playtime:检查活跃在线时长及即将到来的里程碑。
/guide rules / /guide rules accept:查看或接受服务器规则。
/guide skip:跳过剩余指南步骤。
/guide reset:重置个人指南进度。
管理员 (startflow.admin)
/sf menu:打开管理员管理菜单。
/sf report:在聊天中查看上手流失摘要。
/sf report csv:将漏斗分析导出为 CSV 文件。
/sf template <survival|skyblock|anarsi> [confirm]:应用新手模板。
/sf player <name> info:查看某玩家已完成的步骤。
/sf player <name> step <id>:标记某玩家特定步骤已完成。
/sf player <name> reset [id]:重置某玩家的所有进度或单个步骤。
/sf player <name> reset-daily:重置某玩家的每日登录连击数。
/sf player <name> reset-playtime:重置某玩家的在线时长里程碑。
/sf reload:重载配置文件和语言文件。
PlaceholderAPI 支持
%startflow_progress% - 已完成步骤比例(例如 2/5)
%startflow_progress_percent% - 完成百分比(例如 40)
%startflow_step% - 当前步骤名称或 Complete
%startflow_completed% - 完成状态(Yes / No)
%startflow_bar% - 视觉 MiniMessage 进度条
%startflow_streak% - 当前每日连击数
%startflow_best_streak% - 最高每日连击记录
%startflow_playtime% - 追踪的活跃在线时长(例如 2h 30m)
%startflow_next_milestone% - 下一个在线时长里程碑标识符
语言
StartFlow 会检测玩家的客户端语言并以该语言显示消息。不支持的语言将回退到 config.yml 中的 default-language 设置。
English
Turkish
German
Spanish
Russian
Portuguese
所有语言文件均可在 plugins/StartFlow/messages/ 中进行编辑。
兼容性与要求
- 平台:Paper 1.21.x(或兼容分支),支持 Folia
- 运行环境:Java 21 或更高版本
- 软依赖项:PlaceholderAPI、Vault、GriefPrevention
- 许可证:StartFlow License(免费使用,源码可用)
支持与链接
StartFlow 由 Clodo 开发并维护。
请访问 获取文档和更新信息。
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
- Drop
StartFlow-1.0.0.jar into your plugins/ directory and restart your server.
- Apply a starter template for your game mode:
/sf template survival confirm
/sf template skyblock confirm
/sf template anarsi confirm
- Open the guide menu as a player with
/guide to inspect the flow.
- Customize coordinates and commands in
plugins/StartFlow/config.yml, then reload using /sf reload.
- 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 for documentation and updates.
评论 0
登录后参与评分
还没有评论,来抢沙发吧