ValMarchand
ValMarchand is an advanced dynamic merchant plugin designed for RPG and economy-based Minecraft servers. It introduces rotating merchant selections, dynamic pricing, support for custom items, rank-based bonuses, and configurable selling limits to create a more engaging and balanced economy.
Commands
Player Commands
/marchand
Opens the merchant menu.
/marchand help
Displays the plugin help menu.
/marchand info
Displays information about the current merchant selection and remaining rotation time.
Staff Commands
/marchand reload
Reloads all plugin configuration files.
/marchand force
Forces a new merchant rotation immediately.
/marchand stats [player]
Displays selling statistics for yourself or another player.
/marchand overview
Displays the top merchant sellers and global statistics.
Permissions
merchant.reload
Allows usage of /marchand reload
merchant.force
Allows usage of /marchand force
merchant.statsAllows usage of /marchand stats
merchant.admin
Allows usage of /marchand overview
merchant.rank.<rank>
Assigns a merchant rank to a player.
Examples:
merchant.rank.default
merchant.rank.vip
merchant.rank.elite
merchant.rank.daimyo
merchant.rank.shogun
Features
Dynamic Merchant Rotations
Automatic merchant rotations every configured interval.
Multiple merchant selections with weighted chances.
Persistent selection storage across server restarts.
Dynamic Pricing System
Item prices can automatically fluctuate between rotations.
Configurable minimum and maximum multipliers.
Creates a living market economy.
Rank Bonuses
Players can receive additional selling profits based on their rank.
Fully configurable through the plugin configuration.
Selling Limits
Individual selling limits per item.
Different limits depending on player rank.
Prevents economy abuse and resource inflation.
Advanced Item Support
ValMarchand supports multiple item identification methods:
Vanilla Items
type: VANILLA
CustomModelData Items
type: CUSTOM_MODEL_DATA
ItemsAdder Items
type: ITEMSADDER
MMOItems Items
type: MMOITEMS
Customizable GUI
Fully configurable GUI.
Custom textures support.
Placeholder support.
Translation support through lang.yml.
Data Storage
YAML storage support.
MySQL storage support.
Persistent player statistics.
Configuration Files
config.yml
General plugin settings:
Merchant rotations
Rank bonuses
Dynamic prices
Storage settings
gui.yml
Merchant menu configuration:
Layout
Buttons
Decoration items
Custom icons
selections.yml
Merchant selections:
Available items
PricesLimits
Rotation pools
lang.yml
All plugin messages and translations.
Placeholders
Merchant Information
%valmarchand_current_selection%
Current active merchant selection.
%valmarchand_time_remaining%
Time remaining before the next rotation.
Player Statistics
%valmarchand_player_sales_<itemId>%
Displays the amount sold by a player for a specific item.
Example:
%valmarchand_player_sales_ruby%
GUI Placeholders
%price%
Current item selling price.
%current_sales%
Amount already sold by the player.
%max_sales%
Maximum amount the player can sell.
%dynamic_multiplier%
Current dynamic price multiplier.
%rank_bonus%
Current rank bonus percentage.
Supported Integrations
Vault
PlaceholderAPI
MMOItems
ItemsAdder
MySQL
LuckPerms
Why ValMarchand?
ValMarchand transforms a simple selling system into a complete economic feature by introducing:
Dynamic market prices
Merchant rotations
Rank progression rewards
Custom item support
RPG-friendly economy balancing
Long-term player engagement
Perfect for Survival, RPG, MMORPG and Economy servers.
Support
Join our Discord community:
https://discord.gg/NV9hbuEYVF