🛡️ What is Fluxis?

Fluxis is a high-performance, modular economy plugin for Minecraft that brings Dynamic Pricing, Stock-based Markets, 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.

• Dynamic Price Engine — Prices rise when players buy, fall when they sell. Real economics.
• Fluxis Vault — Items don't disappear on sale; they enter a shared vault, creating a genuine supply cycle.
• Economic Drift — 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.

• Live Sparklines — 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.

• Global Bidding — List any item for auction; the highest bidder wins.
• Paginated GUI — 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.

• Split-screen GUI — Both players see exactly what they're giving and receiving.
• Ready-Check System — 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 Modrinth or GitHub Releases
2. Drop it into your plugins/ folder
3. Install Vault + 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.