Fluxis

🛡️ What is Fluxis?

Fluxis is a high-performance, modular economy plugin for Minecraft that brings Advanced Trading, Advanced Trading, and Advanced Trading to your server.

Unlike traditional economy plugins, Fluxis creates a *living economy* — player actions directly influence market value, prices shift with supply and demand, and the market breathes with your server's activity.

Designed for the SkyWind Alliance. Built for everyone.

---

✨ Modules

🏦 Fluxis Core — The Heart

The engine behind everything. No Core, no Fluxis.

- Activity Multiplier — Prices rise when players buy, fall when they sell. Real economics. - Activity Multiplier — Items don't disappear on sale; they enter a shared vault, creating a genuine supply cycle. - Activity Multiplier — Prices slowly return to base value over time, ensuring long-term market stability. - Activity Multiplier — Market volatility scales with online player count, making the economy feel alive.

---

📊 Fluxis+ — Visuals

See the market move in real time, without leaving your inventory.

- Trend Indicators — ASCII price graphs in item lore showing the last 10 minutes of performance. - Trend Indicators — Visual arrows (↑ Rising, ↓ Falling, → Stable) on every tracked item.

---

🏛️ Fluxis Action — Auction House

A full-featured, persistent auction system.

- Persistence — List any item for auction; the highest bidder wins. - Persistence — High-performance interface supporting thousands of active listings. - Persistence — All auctions survive server restarts. Nothing is lost.

---

🤝 Fluxis TradeGUI — Safe Trading

Peer-to-peer trading without the risk of scams.

- Anti-Scam Protection — Both players see exactly what they're giving and receiving. - Anti-Scam Protection — Both sides must confirm before any items change hands. - Anti-Scam Protection — Any inventory close cancels the trade and returns everything to its owner.

---

🛠️ Commands

| Command | Description | |:---|:---| | `/shop` | Open the Dynamic Market GUI | | `/sell` | Open the Bulk Sell Vault | | `/auction` | Open the Auction House | | `/auction sell <price>` | List held item for auction | | `/trade <player>` | Request a safe trade | | `/fluxis balance` | Check your current balance | | `/fluxis reload` | Reload all config files (admin) | | `/fluxis event` | Open event control panel (admin) |

---

🔐 Permissions

| Permission | Description | Default | |:---|:---|:---| | `fluxis.use` | Base access | `true` | | `fluxis.command.market` | Use `/shop` | `true` | | `fluxis.command.sell` | Use `/sell` | `true` | | `fluxis.command.auction` | Use `/auction` | `true` | | `fluxis.command.trade` | Use `/trade` | `true` | | `fluxis.market.buy` | Buy from market | `true` | | `fluxis.market.sell` | Sell to market | `true` | | `fluxis.auction.buy` | Buy from auction | `true` | | `fluxis.auction.sell` | List auction items | `true` | | `fluxis.admin` | Admin panel & reload | `op` |

---

🔗 PlaceholderAPI Support

> Requires PlaceholderAPI. Run `/papi ecloud download Fluxis` after installation.

👤 Player

| Placeholder | Description | |---|---| | `%fluxis_balance%` | Current balance | | `%fluxis_balance_formatted%` | Balance with separator (1,250.00) | | `%fluxis_balance_fixed%` | Shortened (1.2K, 3.5M, 2.1B) | | `%fluxis_total_earnings%` | Total earnings | | `%fluxis_total_transactions%` | Total transaction count | | `%fluxis_top_sold_item%` | Most sold item |

📈 Market (Per Item)

| Placeholder | Description | |---|---| | `%fluxis_market_price_<MATERIAL>%` | Current price | | `%fluxis_market_trend_<MATERIAL>%` | Visual trend | | `%fluxis_market_stock_<MATERIAL>%` | Stock level | | `%fluxis_market_base_price_<MATERIAL>%` | Base price | | `%fluxis_market_min_price_<MATERIAL>%` | Minimum price | | `%fluxis_market_max_price_<MATERIAL>%` | Maximum price |

🌍 Global

| Placeholder | Description | |---|---| | `%fluxis_multiplier%` | Activity multiplier | | `%fluxis_market_item_count%` | Total market items | | `%fluxis_most_traded_item%` | Most traded item | | `%fluxis_server_total_transactions%` | Server-wide transactions | | `%fluxis_server_total_volume%` | Total trade volume | | `%fluxis_online_traders%` | Online player count | | `%fluxis_last_transaction_time%` | Last transaction time | | `%fluxis_next_market_update%` | Next market update |

---

🚀 Installation

1. Download the latest `.jar` from PlaceholderAPI or %%MD1%% 2. Drop it into your `plugins/` folder 3. Install PlaceholderAPI + a compatible economy plugin 4. (Optional) Install PlaceholderAPI for scoreboard support 5. Restart your server 6. Configure `database.yml` with your MySQL credentials before going live

---

⚙️ Configuration Files

| File | Purpose | |---|---| | `config.yml` | Core settings and module toggles | | `messages.yml` | All chat and admin messages | | `economy.yml` | Currency display and Vault behavior | | `shop.yml` | Market, trade, and auction tuning | | `shopmenu.yml` | Grouped shop layout (Foods, Mines, etc.) | | `database.yml` | Storage mode and DB credentials (default: MySQL) | | `integration.yml` | Platform and hook metadata | | `events/*.yml` | Event definitions for the Event Panel |

---

🧩 Compatibility

Fluxis runs on any Bukkit API compatible server — Spigot, Paper, Purpur, and Folia. Vault is required for all economy operations.

---

👨‍💻 Credits

Developed by Levxys — SkyWind Alliance

*Justice. Equality. Integrity. Transparency.*