valmarchand

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