API Troop add_mixed

add_mixed

Endpoint: gm.troops.add_mixed

Syntax

gm.troops.add_mixed <partyLeader> <countOfEach>

Parameters

Parameter	Type	Required	Description
partyLeader	string	Yes	Query to find the party leader hero (e.g., "player", "derthert"). Also accepts alias: "leader"
countOfEach	integer	Yes	Number of EACH type to add (range: 1-3000). Also accepts alias: "count"

Description

Adds mixed tier troops to the party. The count specifies how many of EACH type (basic, elite, mercenary) to add. For example, countOfEach=10 will add 30 total troops: 10 basic + 10 elite + 10 mercenary.

This command is useful for quickly creating balanced armies with a variety of troop types from the leader's culture.

Requirements

• Hero must have a party
• Hero must be the party leader (not just a member)
• Troops added are based on the hero's culture

Examples

gm.troops.add_mixed derthert 15

Output:

Added 45 mixed tier troops to Derthert's party (15 of each: basic, elite, mercenary).
Party: Derthert's Army (Total size: 195)

gm.troops.add_mixed player 20

Output:

Added 60 mixed tier troops to Player's party (20 of each: basic, elite, mercenary).
Party: Player's Army (Total size: 260)

Using Named Arguments

gm.troops.add_mixed partyLeader:derthert countOfEach:15
gm.troops.add_mixed leader:player count:20

Notes

NOTE: Only works for party leaders. If the hero is not a party leader, the command will fail with an error message.

NOTE: The actual number of troops added will be 3x the countOfEach value (basic + elite + mercenary).

TIP: This command is perfect for quickly creating well-rounded armies with multiple troop types.

TIP: Use smaller countOfEach values to maintain a balanced force without overwhelming your party capacity.

WARNING: Party size limits still apply. Consider the 3x multiplier when specifying countOfEach to avoid exceeding capacity.

Related Commands

• gm.troops.add_basic - Add only basic tier troops
• gm.troops.add_elite - Add only elite tier troops
• gm.troops.add_mercenary - Add only mercenary troops
• gm.troops.give_hero_troops - Add specific troop types

Last Updated: 2025-12-22