# Adaptive Traders

Adaptive Traders adds configurable traveling trader NPCs, designed to fit many types of modpacks — survival, RPG, zombie apocalypse, tech, magic, hardcore economy, and custom progression packs.

Instead of being static villagers or simple trade mobs, traders can arrive near players, stay for a while, leave, bring bodyguards, use dynamic trades, and react to the player's reputation.

## Features

- Configurable trader profiles through TOML files
- Static trades, dynamic trades, and inventory-based trades
- Automatic trader arrivals near players
- Traders can stay for a few Minecraft days and then leave
- Optional bodyguards and defensive AI
- Reputation system with price changes
- Traders can refuse to trade with hostile players
- Daily trade reputation cap to prevent easy reputation farming
- Custom skins from the config folder
- Config reload command

## Designed For

Adaptive Traders is designed for:

- Survival modpacks
- Zombie apocalypse modpacks
- RPG and adventure modpacks
- Hardcore economy packs
- Tech/industrial modpacks
- Magic/fantasy modpacks
- Server-based progression packs
- Custom private modpacks

The mod is especially useful when you want traders to feel like part of the world instead of static shop blocks.

## Commands

```text
/adaptivetraders reload
/adaptivetraders list
/adaptivetraders spawn <profile>
/adaptivetraders arrival force
/adaptivetraders arrival force <profile>
/adaptivetraders arrival status
/adaptivetraders arrival leave
/adaptivetraders arrival guards spawn
/adaptivetraders arrival guards status
/adaptivetraders arrival guards clear

Configs

Configs are generated in:

config/adaptive_traders/

Main config files:

arrival.toml
reputation.toml
guard_arrivals.toml
traders/*.toml
skins/*.png

Example trader profiles are generated automatically.

Current Status

This is an early alpha version.

The mod is playable, but configs and systems may change in future updates. Feedback and bug reports are welcome before v0.2.

```md
## Keywords

Configurable traders, custom trader NPC, wandering trader, dynamic trades, reputation, bodyguards, survival, zombie modpacks