EmpireFlow

ko-fi

🏢 EmpireFlow

💡 Overview

tycoon plugin 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.