Перейти к содержимому
Mineforgian

Worthify

Fast, modern item worth & pricing system for Minecraft servers

Загрузки
245
Подписчики
4
Обновлён
11 мая 2026 г.
Лицензия
MIT

Опубликован 7 февраля 2026 г.

Worthify

Worthify is a lightweight Paper plugin that assigns a configurable worth to items and lets players sell items for in-game currency.

Features

  • Sell items from your hand or sell all sellable items
  • Configurable item worth values (prices.yml)
  • Sell history GUI (/sellhistory)
  • Player-to-player payments (/pay)
  • Optional client-side item tooltip worth line (requires ProtocolLib)
  • Optional Vault integration (uses your server economy if available)
  • Standalone internal economy fallback if Vault isn’t installed (balances.yml)
  • Worth multiplier system (global + category + per-material overrides)
  • Multiplier GUI (/multiplier) to view/edit category multipliers (only works when enabled)
  • SellTools:
    • SellWand: sell container contents by right/left click (configurable)
    • SellAxe: sell container contents and optionally destroy the container (configurable)
    • Offline expiry (absolute timestamps) + anti-duplication registry
    • Optional usage-limited wands (no expiry shown in lore)

Commands

  • /sell [hand|all]

    • Permission: worthify.sell
  • /pay <player> <amount>

    • Permission: worthify.sell
  • /worth [page]

    • Permission: worthify.sell
  • /sellhistory [page]

    • Permission: worthify.sell
  • /multiplier (alias: /mult)

    • Permission: worthify.sell
    • Notes: Only opens when worth_multiplier.enabled: true. Everyone can view, but editing requires worthify.admin.
  • /setworth <number>

    • Permission: worthify.admin
  • /worthify reload

    • Permission: worthify.admin
  • /sellwand usage <uses> [player]

    • Permission: worthify.selltools.give
  • /sellwand selfdestruction <time> <unit> [player]

    • Permission: worthify.selltools.give
  • /sellaxe <time> <unit> [player]

    • Permission: worthify.selltools.give

Permissions

  • worthify.sell
    • Default: true
  • worthify.admin
    • Default: op

Dependencies

  • Required: none
  • Optional:
    • Vault (to use an external economy provider such as EssentialsX Economy)
    • ProtocolLib (to display a client-side Worth: $X tooltip line on items without breaking stacking )

Configuration

Worthify writes config files into plugins/Worthify/.

  • config.yml

    • economy.internal.enabled: enable internal economy fallback when Vault is missing
    • economy.internal.starting_balance: default balance for players not in balances.yml
    • worth_lore.enabled: enable worth tooltip injection (requires ProtocolLib)
    • worth_lore.line: format line (supports {worth} or ${worth})
    • worth_multiplier.enabled: enables worth multiplier logic and the multiplier GUI
    • worth_multiplier.value: global multiplier applied to all items
    • worth_multiplier.categories.*: category multipliers (ores/food/seeds)
    • worth_multiplier.materials.*: per-material multiplier overrides
  • prices.yml

    • Stores per-material prices under prices.<MATERIAL_NAME>
  • sellhistory.yml

    • Stores per-player sell history entries
  • balances.yml

    • Stores per-player balances when using internal economy
  • selltools.yml

    • SellTools templates and behavior (activation mode, allowed containers, self-destruction on expiry, uses)
  • gui/multiplier.yml

    • Customize the multiplier GUI

Placeholders (PlaceholderAPI)

  • %worthify_balance%
  • %worthify_balance_plain%
  • %worthify_balance_short%

Notes

  • If Vault is installed and an economy provider is available, Worthify will use it.
  • If Vault is not installed, Worthify will fall back to its internal economy automatically (if enabled in config).

Ченджлог

1.0.5Релиз1.21.9, 1.21.10, 1.21.11 · 11 мая 2026 г.

Changelog

1.0.5

Added

  • Added support for overriding ShopGUI+ sell prices with Worthify worth. Can be enabled/disabled from config.yml under shopguiplus.override_sell_prices.
  • Fixed worth_multiplier not working.
  • Fixed The Worth It Self.
  • Fixed worthtoggle.
  • Fixed Conflict with other plugins.
  • Add more support to folia .
  • Full Rework On Multiplier Gui With Donut Style
1.0.4Релиз1.21.9, 1.21.10, 1.21.11 · 3 марта 2026 г.

Changelog

1.0.4

Added

  • Fix Sell Tools

  • /pay admin <enable|disable|status>

    • Permanently enable/disable /pay for everyone (including admins)
    • Persists after restart (paysettings.yml)
  • Vault economy provider selection options:

    • economy.vault.prefer_cmi
    • economy.vault.disable_cmi
  • PlaceholderAPI placeholders for leaderboards / numeric-only displays:

    • %worthify_balance_ajlb% (numeric-only)
    • %worthify_balance_kmbq% (compact: k/m/b/t/q)
    • %worthify_top_balance_kmbq_<n>% (compact top balance)

Changed

  • Startup console line now supports colors

Fixed

  • Fixed selltools.yml YAML formatting/indentation issues that could prevent the plugin from enabling
1.0.3Релиз1.21.9, 1.21.10, 1.21.11 · 19 февраля 2026 г.

Worthify Changelog

1.0.3

Added

  • SellTools system (SellWand / SellAxe) with offline expiry (absolute timestamp) and anti-duplication registry.
  • selltools.yml configuration:
    • Per-tool enable/disable
    • Activation mode (right/left click for wand, break/right/left for axe)
    • Allowed container whitelist
    • Optional container destruction (axe)
    • Optional self-destruction on expiry
    • Uses support ({uses} placeholder)
  • New SellWand subcommands:
    • /sellwand usage <uses> [player] (usage-only wand; expiry hidden in lore)
    • /sellwand selfdestruction <time> <unit> [player] (time-expiring wand)
    • /sellwand setuses <uses> [player] (edit uses of wand in main hand)
  • Tab completion improvements for /sellwand and /sellaxe.
  • Multiplier GUI customization file: gui/multiplier.yml.

Changed

  • Localization coverage for new SellTools messages/keys.

Fixed

  • Expired/invalid SellTools cleanup logic on join/inventory open.
1.0.2Релиз1.21.9, 1.21.10, 1.21.11 · 17 февраля 2026 г.

[1.0.2] - 2025-02-17

Added

  • bStats integration: Anonymous usage metrics collection (plugin ID 29561)
    • Custom charts for economy mode (internal vs Vault) and worth lore enabled status
  • Top balance GUI support for Vault economy
    • /baltop, /topbal, /topbalance, /balancetop now open the GUI even when Vault is active
    • Async cached Vault leaderboard (scans up to 5000 offline players)
    • Shows "Calculating..." briefly on first open, then displays cached results
    • Cache refreshes every 60 seconds
  • Command aliases: /topbal, /topbalance, /balancetop now map to /baltop

Fixed

  • ShadowJar build failure with Java 21: Upgraded Shadow plugin to GradleUp namespace (com.gradleup.shadow 8.3.9) to resolve "Unsupported class file major version 65"
  • Unknown material warnings: Enhanced MaterialResolver
    • Added normalization and legacy matchMaterial fallback
    • Added aliases for renamed materials (e.g., SCUTE -> TURTLE_SCUTE)
    • Suppressed warnings for known-but-unsupported materials on newer server versions
  • Worth lore stacking issue: Fixed items with worth lore not stacking
    • ProtocolLib hook now skips packet modifications for player's own inventory window (windowId 0)
    • Preserves vanilla stacking behavior while keeping worth lore in other contexts

Technical

  • Gradle build now produces only the shaded jar (plain jar task disabled)
  • bStats dependency relocated to dev.simpleye.worthify.lib.bstats to avoid conflicts
  • Improved error handling in bStats initialization (graceful fallback)

Notes

  • If using Vault economy, the top balance GUI may briefly show "Calculating..." on first open
  • Command aliases require a full server restart to take effect
  • bStats data is anonymous; no sensitive information is collected
1.0.1Релиз1.21.9, 1.21.10, 1.21.11 · 11 февраля 2026 г.

Worthify v1.0.1 — Changelog

✨ New

  • Modrinth update checker
    • Periodic version checks with optional join notifications (worthify.update).
  • True auto-updater (opt-in)
    • Downloads latest jar to plugins/update/Worthify.jar; applies on restart.
    • Shows a clear startup warning when enabled.
  • New languages
    • Added: ar, tr, fr, de, es.
  • Per-player pay receive toggle
    • /paytoggle lets players enable/disable receiving payments.
    • Settings stored in paysettings.yml.
    • OP bypass configurable.
  • Pay improvements
    • Optional cooldown (default off).
    • Human-friendly amounts: 1k, 2.5m, 1b, 1t.
    • Money formatting with commas.
  • Anti-vanish detection
    • /pay ignores vanished players (SuperVanish/PremiumVanish via reflection).

🛠️ Changed / Fixed

  • Guardrails for worth values
    • Invalid prices (negative, NaN, Infinity) are skipped with warnings.
    • Selling never pays out invalid/negative amounts.
  • Better money formatting
    • Balances and payments display as 1,234.00.

⚠️ Notes

  • Auto-updater is disabled by default. Enable only if you accept auto-downloaded jars.
  • Language files are community contributions. Please report mistakes via GitHub issues/PRs.

Modrinth changelog URL

  • v1.0.1: https://modrinth.com/plugin/worthify/changelog#1.0.1
1.0.0Релиз1.21.9, 1.21.10, 1.21.11 · 10 февраля 2026 г.

Worthify v1.0.0 - Initial Release

🎉 Features

Economy System

  • Player Balance Management - Built-in balance system with persistent YAML storage
  • Sell Command - Sell items from inventory with configurable item worth values
  • Balance Command - Check your current balance
  • Top Balance Leaderboard - View top players by balance with /topbal
  • Pay Command - Transfer money between players

Worth Management

  • Customizable Item Pricing - Set worth for any Minecraft material via configuration
  • Dynamic Price Configuration - Prices stored in prices.yml with hot-reload support
  • Material Resolution - Smart material name handling with alias support across different server versions

User Interface

  • Item Worth GUI - Interactive GUI to browse all priced items
    • Pagination support for large item lists
    • Search functionality to filter items
    • Click items to see unit price and total value

History & Tracking

  • Sell History - Track last 250 sell transactions per player
  • Sell History GUI - Visual interface to view your recent sales
  • Transaction Logging - Persistent storage of all transactions

Admin Features

  • Set Worth Command - Dynamically set item prices while holding items
  • Delete Worth Command - Remove pricing for specific items
  • Permission-based Access Control - Admin-only commands with worthify.admin permission

Advanced Features

  • Worth Lore Hook - Optional ProtocolLib integration to display item worth in lore tooltips
  • Multi-version Compatibility - Support for Paper, Purpur, and Spigot servers
  • Server Version Detection - Automatic compatibility for Minecraft 1.20 - 1.21

Technical Highlights

  • Java Records - Modern Java implementation using records for cleaner code
  • Thread-safe Operations - Volatile caching for concurrent price lookups
  • Configuration Management - Robust YAML configuration with fallback defaults
  • Hook System - Extensible plugin dependency integration (Vault, ProtocolLib)
  • Material Mapping - Smart resolution of material names across versions

Supported Versions

  • Minecraft 1.20
  • Minecraft 1.20.1
  • Minecraft 1.20.2
  • Minecraft 1.20.4
  • Minecraft 1.21

**This is a stable, first release **

Комментарии

Загружаем…