🏢 EmpireFlow

💡 Overview

EmpireFlow is a modern Minecraft tycoon plugin where players build their own economic empire by investing in businesses that generate passive income over time — even while offline.

Designed for long-term engagement, EmpireFlow combines idle mechanics with active decision-making, creating a deep and rewarding progression system.

The plugin focuses on:

• long-term progression
• idle + active gameplay balance
• strategic economy management
• GUI-driven experience
• competitive leaderboards

---

⚙️ Main Command

/empire

Aliases:

/emp /ef /flow

---

📌 Subcommands

• /empire open → Opens the main business GUI
• /empire collect → Collect accumulated income
• /empire stats → View personal statistics
• /empire top → View economy leaderboards
• /empire settings → Toggle sounds, notifications, UI options
• /empire level → Manage player progression level
• /empire reload → Reload configuration (admin)

---

🖥️ GUI SYSTEM (CORE FEATURE)

🎨 Modern Interface Design

EmpireFlow features a fully interactive, polished inventory GUI:

• 54-slot inventory layout
• paginated business system
• smooth navigation
• real-time updates
• sound + visual feedback
• fully customizable items, colors, and lore

---

🧭 Main Business GUI

When a player runs /empire, they open the main empire interface.

🏢 Business Display System

• 🟢 Unlocked Businesses:

  • custom item icon
  • income/hour display (auto-updating)
  • level and upgrade information
  • full stats in lore

• 🔒 Locked Businesses:

  • barrier item display
  • required level
  • unlock cost
  • message: "You have not unlocked this business yet"

---

🛒 First Business UX Improvement

• the first business is NOT locked behind a barrier
• it appears as available for purchase immediately
• improves early-game experience

---

🏢 Business System

EmpireFlow includes 10+ fully configurable businesses:

• Farm
• Mine
• Fishery
• Lumber Mill
• Quarry
• Bank
• Casino
• Laboratory
• Trading Port
• Dragon Farm

Each business is stored in its own YAML file.

---

📈 Income System

• generates passive income at configurable intervals
• works both online and offline
• income is stored until manually collected
• real-time notifications when income is ready
• income display updates based on config (no hardcoded values)

💸 Upkeep System

• hourly maintenance cost per business

• if unpaid:

  • business stops generating income

---

🔼 Upgrade System (3 Separate Paths)

• 💰 Increase Income:

  • boosts payout per cycle

• ⏱️ Reduce Interval:

  • decreases time between income cycles

• ⚙️ Efficiency Upgrade:

  • reduces upkeep or adds bonus effects

Each upgrade has a max level of 10.

---

📊 Empire Info System

• live GUI stats panel
• player level progression
• total businesses owned
• total income
• progress bar (XX/XXX format)

---

🏆 Leaderboard System

• highest income per hour
• most valuable empire
• total money earned across all businesses

Rewards:

• top players receive global income boosts

---

🎁 Events System

• ⚡ Golden Hour:

  • x2 global income

• 📅 Daily Bonus:

  • x2 income for 1 hour

• 🎲 Random Events:

  • business-specific boosts
  • global modifiers

---

📢 Notifications System

• income cycles completed
• taxes paid
• boost events activated
• offline earnings summary on login
• income ready alerts

---

🧠 Progression System

📊 Player Level

• increases through economic activity
• unlocks new businesses
• configurable money goals per level

🌐 Global Tech Tree

• +% global income
• -% upkeep costs
• +% offline earnings

---

⚙️ Admin Commands

/empire level add <player> <level>
/empire level set <player> <level>
/empire reload

Permission:

empire.admin

---

🧾 Smart Help System

/empire help

• shows only commands available to the player
• admins see additional commands

---

⚙️ Settings Menu

/empire settings

• toggle sounds
• toggle notifications

---

💰 Economy Integration

• fully integrated with Vault

• supports:

  • EssentialsX
  • any Vault-compatible plugin

---

🔐 Permissions

• empireflow.use → basic access
• empireflow.admin → admin features
• empire.admin → level management
• empireflow.reload → reload config

---

🚀 Performance

• async task handling
• optimized scheduling system
• no lag spikes
• modular architecture
• fully configurable systems

---

🎯 Final Goal

EmpireFlow delivers a modern Minecraft tycoon experience that combines:

• idle income generation
• strategic upgrades
• deep progression systems
• competitive economy gameplay
• highly customizable GUI-based management

Perfect for:

• survival servers
• RPG servers
• economy servers

❤️ Support

If you need help or want to suggest features, feel free to reach out.