API Caravan Overview

Caravan Commands

Category: Caravan Commands: 8 commands API Version: v1.3.13.3 Status: STABLE

---

Overview

Caravan management commands provide comprehensive control over the caravan system in Mount & Blade II: Bannerlord. These commands allow you to create, count, and disband caravans for different owner types including the player, notables, and NPC lords.

Caravans are essential to Bannerlord's economy, generating trade income for their owners while traveling between settlements. The caravan management command set enables you to customize the economic landscape, rebalance trade networks, and manage caravan populations for different factions and owner types.

All caravan management commands require campaign mode to be active. Many operations permanently modify game state, so it's recommended to understand the economic impact before disbanding large numbers of caravans, as this can significantly affect kingdom wealth and notable prosperity.

---

Command Reference

Quick Reference Table

Command	Description	Category	Status
gm.caravan.count	Count caravans by owner type	Information	STABLE
gm.caravan.create_player_caravan	Create caravan owned by player	Creation	STABLE
gm.caravan.create_notable_caravan	Create caravan owned by notable	Creation	STABLE
gm.caravan.disband_caravans	Disband all caravans	Disbandment	STABLE
gm.caravan.disband_player_caravans	Disband player-owned caravans	Disbandment	STABLE
gm.caravan.disband_notable_caravans	Disband notable-owned caravans	Disbandment	STABLE
gm.caravan.disband_npc_lord_caravans	Disband NPC lord-owned caravans	Disbandment	STABLE
gm.caravan.force_destroy_disbanding_caravans	Destroys all caravans currently disbanding	Cleanup	STABLE

---

Command Categories

Caravan Information

Commands for gathering information about existing caravans.

gm.caravan.count - Display count of caravans by owner type (player, notables, NPC lords). Provides overview of the caravan economy and ownership distribution.

Caravan Creation Commands

Commands for creating new caravans for different owner types.

gm.caravan.create_player_caravan - Create a new caravan owned by the player's clan. The caravan will generate trade income for the player and can be managed through the clan interface.

gm.caravan.create_notable_caravan - Create a new caravan owned by a specified notable. Notables use caravans to generate income and improve settlement prosperity. Requires a valid notable hero identifier.

Caravan Disbandment Commands

Commands for removing caravans from the game world.

gm.caravan.disband_caravans - Disband all caravans in the game world regardless of owner. Useful for resetting the trade economy or testing scenarios. Can specify exact count or use "all".

gm.caravan.disband_player_caravans - Disband caravans owned by the player's clan. Allows selective removal of player-owned trade assets. Can specify exact count or use "all".

gm.caravan.disband_notable_caravans - Disband caravans owned by notables. Affects settlement prosperity and notable wealth. Can specify exact count or use "all".

gm.caravan.disband_npc_lord_caravans - Disband caravans owned by NPC lords. Impacts lord income and kingdom economy. Can specify exact count or use "all".

---

Common Parameters

Count Parameter

Disbandment commands accept a flexible count parameter:

• Integer Value - Exact number of caravans to disband (e.g., 5, 10, 20)
• "all" Keyword - Disband all caravans of the specified type

The count parameter allows precise control over caravan populations. When specifying an integer, the system will disband up to that many caravans. If fewer caravans exist than requested, all available caravans will be disbanded.

Owner Types

Commands distinguish between three owner types:

• Player - Caravans owned by the player's clan
• Notables - Caravans owned by settlement notables (merchants, artisans)
• NPC Lords - Caravans owned by lords from all kingdoms

This distinction allows targeted management of different economic segments within the game.

---

Usage Examples

Example 1: Checking Caravan Distribution

Get overview of current caravan economy:

gm.caravan.count

Result: Displays count of caravans by owner type, showing economic distribution.

Example 2: Creating Player Trade Network

Establish multiple player-owned caravans:

gm.caravan.create_player_caravan
gm.caravan.create_player_caravan
gm.caravan.create_player_caravan

Result: Three new player-owned caravans begin operating, generating trade income.

Example 3: Boosting Settlement Economy

Create notable caravans to improve settlement prosperity:

gm.caravan.create_notable_caravan notable_merchant_1
gm.caravan.create_notable_caravan notable_merchant_2

Result: Specified notables now own caravans, increasing their income and settlement economic activity.

Example 4: Partial Caravan Reduction

Reduce player caravan count without complete removal:

gm.caravan.disband_player_caravans 2

Result: Two player-owned caravans are disbanded, reducing overhead while maintaining some trade income.

Example 5: Complete Economic Reset

Remove all caravans for testing or scenario setup:

gm.caravan.disband_caravans all

Result: All caravans removed from game world, allowing clean slate for economic configuration.

Example 6: Targeted Notable Caravan Management

Remove notable caravans to rebalance settlement economies:

gm.caravan.disband_notable_caravans 5

Result: Five notable-owned caravans disbanded, reducing notable wealth and settlement trade activity.

Example 7: Weakening Enemy Kingdoms

Disband NPC lord caravans to impact enemy economy:

gm.caravan.disband_npc_lord_caravans 10

Result: Ten NPC lord caravans removed, reducing enemy kingdom economic power.

---

Best Practices

TIP: Check Before Disbanding

Always use gm.caravan.count before executing disbandment commands to understand current caravan distribution:

gm.caravan.count
gm.caravan.disband_player_caravans 3

This prevents accidentally disbanding more caravans than intended.

TIP: Incremental Disbandment

When rebalancing the economy, disband caravans incrementally rather than all at once. This allows you to observe economic impacts:

gm.caravan.disband_caravans 5
// Wait and observe
gm.caravan.disband_caravans 5

TIP: Settlement Economic Impact

When creating notable caravans, consider settlement prosperity levels. Adding caravans to struggling settlements can help boost their economy:

gm.query.settlement poor_town
gm.caravan.create_notable_caravan notable_from_poor_town

TIP: Player Economy Management

Balance player caravan count with party wages and other expenses. Too many caravans can make the game too easy economically:

gm.caravan.create_player_caravan  // Add income
// or
gm.caravan.disband_player_caravans 1  // Reduce for challenge

TIP: Notable Identification

Use query commands to find notable identifiers before creating notable caravans:

gm.query.hero merchant
gm.caravan.create_notable_caravan found_notable_id

TIP: Kingdom Economic Warfare

Target enemy kingdom caravans to weaken their economic strength in wars:

gm.caravan.disband_npc_lord_caravans 15  // Economic pressure on enemies

---

Notes & Warnings

WARNING: Economic Impact

Disbanding large numbers of caravans significantly impacts game economy:

• Reduced Trade - Fewer goods moving between settlements
• Lower Prosperity - Settlement prosperity decreases without trade caravans
• Notable Wealth - Notables lose income sources
• Lord Income - NPC lords have reduced passive income

Consider the broader economic consequences before mass caravan removal.

WARNING: Permanent Removal

Caravan disbandment is permanent. Disbanded caravans do not automatically respawn. You must manually create new caravans using creation commands if you want to restore caravan populations.

NOTE: Player Caravan Limit

Bannerlord has a default limit on player-owned caravans (typically based on clan tier). Creating caravans through commands may bypass some restrictions, but game balance considerations still apply.

NOTE: Notable Requirements

Creating notable caravans requires:

• Valid notable hero (merchants, artisans, gang leaders)
• Notable must be alive and active
• Notable must have sufficient resources (game may auto-assign)

Not all heroes can own caravans. Ensure the specified notable is appropriate for caravan ownership.

NOTE: Caravan Party State

Disbanded caravans immediately remove the caravan party from the world. Any troops, equipment, or goods in the caravan are lost. This cannot be undone.

NOTE: Trade Route Impact

Removing caravans affects:

• Settlement trade power
• Goods availability in markets
• Price fluctuations (fewer caravans = less trade = higher prices)
• Prosperity growth rates

Monitor these effects after caravan management operations.

NOTE: Creation Location

Newly created caravans spawn at logical locations based on owner:

• Player caravans typically spawn near player location or clan settlements
• Notable caravans spawn at notable's home settlement
• System automatically assigns appropriate starting equipment and goods

---

Related Documentation

Command Groups

• Settlement Management Commands - Manage settlements that benefit from caravans
• Hero Management Commands - Manage notable heroes who can own caravans
• Clan Management Commands - Manage player clan and caravan economics
• Query Commands - Search for notables and settlements

Reference Materials

• Economy Reference - Understanding Bannerlord's economic systems
• Trade Reference - How caravans affect trade networks
• Settlements Reference - Settlement prosperity and economy

User Guides

• Quick Start Guide - Getting started with GameMaster commands
• Best Practices - Recommended usage patterns
• Troubleshooting - Common issues and solutions

---

Last Updated: 2025-01-07 API Version: v1.3.13.3

Return to API Reference | Home