FirstHour Lite

A guided first hour for every new player

A goal in the first five minutes, rewards while they play, and your Day 1 return rate.

---

⚡ Why FirstHour?

New players join, don't know what to do, see nobody around and leave. You never find out why. FirstHour gives every new player a welcome screen, one clear goal on their bossbar, a reward for every step and a reason to come back tomorrow. Then /firsthour stats shows you how many actually came back.

• 🚀 Welcome screen: one Start button two seconds after the first join. A native dialog on 26.1 servers, a chat welcome with a title on 1.21.4.
• 🎯 Bossbar goal: the current step, live progress and a countdown to the next reward.
• ✨ Trail and compass: go-to goals point the way, so nobody gets lost at spawn.
• 🎁 Rewards: one for every step, plus timed rewards at 5, 15, 30 and 60 minutes of playtime.
• 📅 Come back tomorrow: when they finish, they see their Day 2 reward. It opens 20 hours after the first join.
• 📊 Day 1 return rate: new players today, this week and this month, and how many joined again 20 to 48 hours later.

---

🗺️ Build the path

Write up to 6 goals in paths.yml, or load the survival preset with /firsthour preset survival.

Step types

• Go to: walk to a spot like your spawn shops or warp hub.
• Command: run /rtp, /sethome, /claim or any command.
• Break, place, craft, kill, fish: any block, item or mob.
• Earn: reach an amount of money (Vault).
• Playtime and chat: play a few minutes, or say hello once.

Rewards

• Money: through Vault.
• Items: any material and amount.
• Commands: run by the console, with %player%.
• Pays once: no farming a reward with a rejoin.

---

🎨 Make it yours

• Messages: every line in MiniMessage, in messages.yml.
• Look and sound: every sound, title timing, bossbar colour and style, trail particle and colour in config.yml.
• Stats menu: items and slots, filler included.
• Safe config: a bad value falls back to its default with one clear console warning.
• Live servers: players with 30+ minutes of playtime count as veterans when you add it.

---

⚙️ Commands

• /firsthour: your current goal and hint (alias /fh).
• /firsthour skip: skip the new-player goals.
• /firsthour stats: the retention screen (stats chat for a chat summary).
• /firsthour preset survival: load the survival path. Your old one is backed up first.
• /firsthour reset <player>: wipe a player's FirstHour data.
• /firsthour reload: reload config, messages and paths.

Permissions: firsthour.use and firsthour.skip (everyone), firsthour.admin (op).

---

💎 Want the whole dashboard? FirstHour PRO

Lite gets new players started. PRO shows you exactly where the rest quit.

• 📊 Full dashboard: Day 7 return, median first session, and a step funnel with the goal most players quit on in red.
• 📄 CSV export and daily cohorts.
• 👋 Veterans say hi: regulars get a clickable "say hi" line for each new player, and the first greeter gets paid.
• 📅 Day 2 to 7 rewards with a login streak.
• 🗺️ Unlimited paths and steps, plus the Economy SMP and Lifesteal presets.
• 🔌 Stonkz, WorldEvents PRO and Relics SMP steps, and PlaceholderAPI.

In Lite, admins see the PRO items on the stats screen. Players never do, and pro-hints: false hides them.

---

✅ Requirements

• Server: Paper 1.21.4 or 26.1.2.
• Java: 21 or newer (26.1 servers need Java 25).
• Optional: Vault and an economy plugin for money rewards and earn goals.

---

❓ Need support?