🚀 JobSystem 1.1.2

Performance, Compatibility & Marketplace Update

JobSystem 1.1.2 focuses on improving server performance, modern server compatibility, economy systems, GUI quality, and marketplace functionality.

This update introduces Folia support, bStats, a heavily upgraded Auction House, a redesigned Stock Market, improved economy integration, GUI PlaceholderAPI support, and several important stability fixes.

---

✨ Highlights

• 🧵 Folia Support
• 📊 bStats Integration
• 🏦 Company Vault Duplication Fix
• ⚡ Major Performance Improvements
• 🛒 Marketplace V2
• 📈 Premium Stock Market
• 💰 Economy Market Redesign
• 🏢 Job Center Redesign
• 🧩 PlaceholderAPI Support in GUIs
• 🔌 Improved Vault Economy Detection
• 🛡️ Additional Transaction & Concurrency Protection

---

🧵 Folia Support

JobSystem now includes improved support for Folia-based servers.

Improvements

• Added folia-supported: true
• Added a dedicated scheduler abstraction
• Uses Folia's:
  • Entity Scheduler
  • Global Region Scheduler
  • Async Scheduler
• Automatically falls back to the Bukkit scheduler on:
  • Paper
  • Purpur
  • Spigot
  • Bukkit
• Improved thread safety for region-based execution
• Migrated several internal scheduled tasks away from direct Bukkit scheduler calls

[!NOTE] No separate Folia build is required.
JobSystem automatically uses the correct scheduler for the server environment.

---

📊 bStats Integration

Official bStats metrics support has been added.

Plugin ID: 33567

The bStats library is shaded and relocated inside JobSystem to prevent dependency conflicts.

Metrics can provide anonymous information such as:

• Database type
• Selected language
• Plugin usage statistics

---

🏦 Company Vault Security

A critical Company Vault duplication issue has been fixed.

Previously, multiple players could open separate copies of the same Company Vault and potentially withdraw the same item multiple times.

New Protection

• Only one valid Company Vault state is maintained
• Improved synchronization between viewers
• Stale inventory states can no longer overwrite newer vault data
• Vault contents are safely stored when closing
• Improved protection for simultaneous access
• Improved Folia compatibility

[!IMPORTANT] This fix prevents a potential item duplication exploit involving Company Vaults.

---

⚡ Performance Improvements

Several frequently used systems have been optimized to reduce server load.

XP & Level Calculations

• XP curves are now cached
• Reduced repeated Math.pow() calculations
• Level calculations use faster lookup logic
• Reduced processing during high-frequency job actions

Job Reward Cache

Frequently accessed reward configuration values are cached instead of repeatedly reading YAML files.

This improves performance for jobs such as:

• Miner
• Lumberjack
• Farmer
• Hunter
• Fisherman
• Builder
• Crafter
• Explorer

Thread-Safe Runtime Caches

Several internal structures were upgraded for better concurrent access.

Improved areas include:

• Reward buffers
• Company caches
• Statistics caches
• Placed-block tracking
• Company member lookups

Company Payout Queue

The payout processor no longer checks the queue every single server tick by default.

performance:
  payout-interval-ticks: 5

This reduces unnecessary scheduler activity while keeping payouts responsive.

Explorer Optimizations

• Cached structure reflection
• Cached structure constants
• Reduced repeated configuration lookups
• Reduced expensive operations during exploration events

Chat Prefix Cache

Company and prestige prefixes are refreshed less frequently instead of rebuilding every second for every player.

performance:
  chat-prefix-refresh-ticks: 40

---

🔌 Improved Vault Economy Integration

Vault economy initialization has been improved.

Previously, JobSystem could disable itself when Vault was installed but the actual economy provider had not yet registered during startup.

JobSystem now distinguishes between:

• Vault not installed
• Vault installed but no Economy provider available yet
• Economy provider successfully registered

The plugin can briefly wait for the provider during startup instead of disabling immediately.

Compatible Vault economy providers can include:

• EssentialsX Economy
• CMI
• XConomy
• TheNewEconomy
• Other Vault-compatible economy plugins

---

🛒 Marketplace V2

The Auction House has received a major upgrade and is now much closer to a complete server marketplace.

---

🎨 Premium Auction House Interface

The Auction House now includes:

• Premium 54-slot layout
• 28 auction slots per page
• Improved navigation
• Page indicators
• Refresh controls
• Account information
• Listing information
• Listing fee information
• Better pricing display
• Remaining auction duration
• Improved auction item descriptions

---

🔎 Auction Search

Players can search active listings directly.

/job ah search diamond

Search supports:

• Material names
• Custom item names
• Item lore
• Seller names

Clear the current search using:

/job ah search clear

---

🗂️ Marketplace Categories

Listings can now be filtered by category.

Available categories include:

• All
• Blocks
• Tools
• Weapons
• Armor
• Farming
• Redstone
• Food
• Other

Search, categories, sorting, and pagination work together.

---

↕️ Auction Sorting

Listings can be sorted by:

• Newest
• Lowest Price
• Highest Price
• Ending Soon

---

👤 My Auctions

Players can switch between:

• All marketplace listings
• Their own active listings

This makes managing active auctions much easier.

---

✅ Purchase Confirmation

Clicking an auction no longer immediately purchases the item.

A dedicated confirmation interface now displays:

• Auction item
• Seller
• Price
• Confirm purchase
• Cancel purchase

Own listings also receive a separate removal confirmation.

---

🔐 Transaction Protection

Auction purchases now include additional backend safety.

Improvements

• Auction IDs use PersistentDataContainer
• Removed internal auction IDs from item lore
• Atomic listing removal
• Protection against simultaneous purchases
• Improved Folia concurrency handling
• Failed Economy transactions safely restore listings
• Improved auction expiration handling

These improvements significantly reduce the chance of race conditions and duplicate purchases.

---

💵 Price Per Item

Stack listings now show both the full price and individual unit price.

Total Price: $6,400
Price Per Item: $100

This makes stack prices easier to compare.

---

📊 Market Price System

JobSystem now tracks completed marketplace sales and can calculate historical item values.

Listings can display:

• Average market value
• Number of comparable sales
• Price difference from the market average
• Percentage above or below average

Example:

Market Average: $4,250
Current Price: $3,900
▼ 8.2% Below Market

The market calculation window can be configured.

auctionhouse:
  market-price-days: 7

---

🧾 Recently Sold

A new Recently Sold marketplace page has been added.

It can display:

• Sold item
• Sale price
• Price per item
• Seller
• Buyer
• Sale date
• Sale time

This gives players a better overview of actual marketplace activity.

---

🗄️ Auction Transaction History

Completed sales are now stored separately from active listings.

The sale history records information such as:

• Material
• Item
• Amount
• Price
• Seller
• Buyer
• Timestamp

Database indexes were added for frequently accessed marketplace data.

Sale history is written asynchronously to reduce database impact on the server.

Configuration

auctionhouse:
  history:
    retention-days: 90
    max-memory-entries: 1000

---

⚙️ Marketplace Configuration

Additional Auction House settings are now available.

auctionhouse:
  enabled: true

  listing-fee: 50.0
  listing-duration-hours: 168

  max-listings-per-player: 20

  min-price: 1.0
  max-price: 1000000000.0

  search-max-length: 40
  market-price-days: 7

  history:
    retention-days: 90
    max-memory-entries: 1000

Set the listing limit to 0 to disable it.

max-listings-per-player: 0

---

📈 Premium Stock Market

The Stock Market interface has received a major redesign.

Instead of showing basic company listings, the Stock Market now works as a more complete investment dashboard.

---

📊 Market Dashboard

The dashboard can display:

• Available player balance
• Estimated portfolio value
• Owned shares
• Listed companies
• Total available shares
• Average share price
• Market capitalization
• Overall market status

---

🏢 Company Stock Cards

Each listed company can display:

• Company name
• Company value
• Company level
• Member count
• Current share price
• Available shares
• Player-owned shares
• Ownership percentage
• Market activity status

Possible market indicators include:

▲ Active
● Stable
▼ Quiet
⚠ Impaired

Companies are sorted by value for a cleaner market overview.

---

🖱️ Multi-Amount Share Purchasing

Players can purchase different amounts of shares directly through the Stock Market GUI.

Left Click       → Buy 1 Share
Shift + Click    → Buy up to 5 Shares
Right Click      → Buy up to 10 Shares

Before completing the transaction, JobSystem validates:

• Available company shares
• Player balance
• Total purchase price

---

🏢 Job Center Redesign

The Job Center has been upgraded into a cleaner dashboard.

Improvements include:

• Better visual structure
• Improved menu grouping
• Cleaner navigation
• Player overview
• Active jobs
• Total job level
• Daily streak
• Improved descriptions for connected systems

Sections such as these now have clearer presentation:

• Bank
• Companies
• Stock Market
• Town Hall
• Black Market

---

💰 Economy Market Redesign

The Economy Market has also received a visual and informational upgrade.

It now provides a clearer overview of the current job economy.

Information can include:

• Average economy multiplier
• Strong-performing jobs
• Stable jobs
• Weak-performing jobs
• Market trend indicators
• Improved job cards

Possible trend indicators include:

▲ Strong
● Stable
▼ Weak

---

🧩 GUI PlaceholderAPI Support

PlaceholderAPI placeholders can now be used in more GUI elements.

Supported locations include:

• Inventory titles
• Item display names
• Item lore

Example:

title: "&8JobSystem &7- &e%player_name%"

lore:
  - "&7Player: &f%player_name%"
  - "&7Balance: &a%vault_eco_balance_formatted%"

JobSystem also supports:

%player%
{player}

[!NOTE] PlaceholderAPI remains optional.

[!IMPORTANT] Storage and trading interfaces only process placeholders where it is safe to do so.
Real player-owned item metadata is not modified.

---

🛠️ Compatibility & Stability

This update also contains several compatibility improvements.

• Fixed PlaceholderAPI OfflinePlayer / Player compatibility
• Improved Folia-safe placeholder handling
• Improved scheduler compatibility
• Improved concurrent data handling
• Improved Economy provider detection
• Improved GUI ItemFlag compatibility across supported server APIs
• Additional marketplace transaction protection
• Improved Company Vault synchronization

---

🌐 Languages

Both language files have been updated with new messages and GUI content.

• 🇬🇧 English
• 🇩🇪 German

This includes updated text for:

• Marketplace
• Stock Market
• Economy systems
• Job Center
• Validation messages
• Transaction messages
• GUI elements

---

📦 Version Information

JobSystem 1.1.2

[!TIP] After updating, review the newly added Auction House and performance settings in your configuration files.

---

❤️ Thank You

Thank you for using JobSystem.

Version 1.1.2 represents a major step forward for the plugin's economy systems, compatibility, performance, and overall user experience.

If you encounter an issue or have a feature suggestion, please report it through the official Veronix support channels.