EmpireFlow

[!(https://wsrv.nl/?url=https%3A%2F%2Fcdn.jsdelivr.net%2Fnpm%2F%40intergrav%2Fdevins-badges%403%2Fassets%2Fcozy%2Fdonate%2Fkofi-singular_vector.svg&n=-1)](https://ko-fi.com/alekkss_/tip)

# 🏢 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.

!(https://cdn.modrinth.com/data/cached_images/2d85bfa1474b264f3986d02f60a4db0a724c0201.png)

The plugin focuses on:

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

# ⚙️ Main Command

``` /empire ```

``` /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

!(https://cdn.modrinth.com/data/cached_images/70b56702a78f07f6e585ee0ffae6df9c22506e26.png)

## 🧭 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"

!(https://cdn.modrinth.com/data/cached_images/ca6501a0594f21035872dbb488bd7d747da0e57e.png)

## 🛒 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)

!(https://cdn.modrinth.com/data/cached_images/122c6dc723d75055345661174c7c0b2bc98ca7cb.png)

!(https://cdn.modrinth.com/data/cached_images/4d7ac8ae7d189bbbd655221cc8b45c12ab78ef90.png) ---

# 💸 Upkeep System

hourly maintenance cost per business if unpaid:

business stops generating income

!(https://cdn.modrinth.com/data/cached_images/bbb2e9fe1ea53dd47575fcc7d2fb824885cd31c2.png)

# 🔼 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.

!(https://cdn.modrinth.com/data/cached_images/12c2330151da97dbcc7f749e5090ebed0c551d78.png)

# 📊 Empire Info System

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

!(https://cdn.modrinth.com/data/cached_images/e8e66ebe1b773e481f4639259736ffc734c7d1bf.png)

# 🏆 Leaderboard System

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

!(https://cdn.modrinth.com/data/cached_images/6e8f9ca7a4ec606602af73cc4cf6248596691581.png)

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 /empire level set /empire reload ```

Permission:

``` empire.admin ```

# 🧾 Smart H