<\/p>\n
# qShadowTrader<\/p>\n
***<\/p>\n
## Main Features<\/p>\n
* Random trader spawn near a valid player.
\n* Configurable spawn intervals, chance, and distance.
\n* Spawn restrictions by world (`blocked-worlds`) and optional allow-list (`allowed-worlds`).
\n* Configurable offers in `trades.yml`:
\n * regular items (`material`, `amount`),
\n * custom items (`item.*`: name\/lore\/model-data\/enchantments\/flags\/unbreakable).
\n* Global purchase limits per offer (`limit`) displayed in lore.
\n* Command execution on purchase (`[console]` \/ `[player]`).
\n* Double-click purchase protection.
\n* Chat notifications for trader spawn\/despawn.
\n* Player cooldown persistence in `data.yml`.<\/p>\n
***<\/p>\n
## Trader Lifecycle<\/p>\n
1. The plugin waits a random interval between `spawn.interval-min` and `spawn.interval-max`.
\n2. On each cycle, it rolls `spawn.chance`.
\n3. A random valid player is selected:
\n * online and alive,
\n * not in creative\/spectator,
\n * world is not in `spawn.blocked-worlds`,
\n * if `allowed-worlds` is set, world must be in that list,
\n * `player-cooldown` must be satisfied.
\n4. Trader spawns at a safe location near that player (`spawn-distance`).
\n5. Offers are generated from `trades.yml` using weighted `chance` values.
\n6. Trader despawns after `lifetime` or when all active offers are bought out (if `despawn-when-empty: true`).<\/p>\n
***<\/p>\n
## Commands<\/p>\n
* `\/shadowtrader spawn` \u2014 spawn near self (if executed by player) or random valid target (from console). ***<\/p>\n ## Permissions<\/p>\n * `qshadowtrader.use` ***<\/p>\n ## Configuration (`config.yml`)<\/p>\n Key sections:<\/p>\n * `spawn` \u2014 auto-spawn logic (intervals, chance, worlds). ***<\/p>\n ## Offers (`trades.yml`)<\/p>\n Each offer is defined under `items. * `material` \/ `amount` (short format), **or** ### Offer Lore Placeholders<\/p>\n * `%CURR_LIMIT%` \u2014 current purchased amount ### Command Prefixes<\/p>\n * `[console] command` \u2014 execute as console Supported placeholders in commands: ` ***<\/p>\n ## Offer Example<\/p>\n “` ## Notes<\/p>\n * Trader is protected from damage\/combustion. qShadowTrader adds a secret merchant that randomly appears near players and offers limited rare items for a short time. Designed to create a dynamic black market and unique server economy<\/p>\n","protected":false},"featured_media":127424,"template":"","meta":{"_minecraft_slug":"qshadowtrader","_minecraft_project_id":"VPDZUwp7","_minecraft_author":"qustan","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":2,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"qshadowtrader.zip","_minecraft_size_bytes":26005,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:22:00.454664Z","_minecraft_date_created":"2026-05-03T03:06:40.258442Z","_minecraft_date_modified":"2026-04-24T21:07:48.163691Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/qshadowtrader","_minecraft_icon_attachment_id":127424,"_minecraft_imported_at":"2026-06-07T11:54:04+00:00","_minecraft_import_hash":"08a7148395a750764275881eefaa469f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,844,89,127,129],"mod_loader":[132,134],"minecraft_version":[118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,73,74,38],"class_list":["post-127423","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-economy","mod_category-game-mechanics","mod_category-paper","mod_category-spigot","mod_loader-paper","mod_loader-spigot","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4"],"yoast_head":"\n
\n* `\/shadowtrader spawn random` \u2014 force random spawn using valid target rules.
\n* `\/shadowtrader spawn
\n* `\/shadowtrader despawn` \u2014 remove current active trader.
\n* `\/shadowtrader reload` \u2014 reload plugin configs.
\n* `\/shadowtrader info` \u2014 show trader status.
\n* Alias: `\/st`<\/p>\n
\n* `qshadowtrader.admin`
\n* `qshadowtrader.spawn`
\n* `qshadowtrader.reload`<\/p>\n
\n* `player-cooldown` \u2014 cooldown before same player can be selected again.
\n* `spawn-distance` \u2014 min\/max distance from target player.
\n* `messages` \u2014 chat messages.
\n* `lifetime` \u2014 trader lifetime in seconds.
\n* `despawn-when-empty` \u2014 despawn when all offers are exhausted.
\n* `trader` \u2014 entity behavior\/options.
\n* `menu` \u2014 GUI settings.
\n* `protection.double-click-window-ms` \u2014 anti-double-click window.<\/p>\n
\n* `item.*` (advanced custom item format),
\n* `limit` \u2014 max purchases for the current trader session,
\n* `chance` \u2014 generation weight,
\n* `lore` \u2014 offer description shown in GUI,
\n* `commands` \u2014 commands to run on purchase.<\/p>\n
\n* `%MAX_LIMIT%` \u2014 max limit for this offer<\/p>\n
\n* `[player] command` \u2014 execute as player
\n* no prefix \u2014 executes as console<\/p>\n
\ntotem:
\n material: TOTEM_OF_UNDYING
\n amount: 1
\n limit: 1
\n chance: 10
\n lore:
\n – “”
\n – “&7Price: &62500”
\n – “&7Limit: %CURR_LIMIT%\/%MAX_LIMIT%”
\n – “”
\n commands:
\n – “[console] eco remove
\n“`<\/p>\n
\n* Offer limits reset on each new trader spawn.
\n* If auto-spawn does not work, check `spawn.enabled`, world filters (`allowed\/blocked`), and whether there are valid online players.<\/p>\n","protected":false},"excerpt":{"rendered":"