Summon Items

Drop a Summon Item on the ground and it is used up and spawns monsters next to the drop spot. Any monster class works, from vanilla or CustomMonster. Each summon can scale the monster (level, life, damage, defense, rates, exp) and give it its own loot bag, so you can reuse one class for many summons without editing Monster.xml.

File Location#

Data/Plugins/Items/SummonItem.xml

Dependencies#

Depends OnPurpose
Item.xmlThe summon item must exist (server and client item list)
Monster.xmlBase stats of the summoned class
CustomMonsterApplied first. Summon scaling is applied on top of it
EventItemBagBag indexes used by ItemBag

How It Works#

  1. A player drops the item. The server checks level, map, safe zone, cooldown and alive count.
  2. Every <Group> rolls once (Chance %). If it passes, one <Monster> is picked by Rate and Count copies spawn near the drop spot.
  3. One item is used up (one from a stack). If nothing could spawn, the player keeps the item.
  4. The monsters never respawn. A monster is removed when it dies, or after Lifetime if nobody kills it.
  5. On death the monster drops its ItemBag to the top-damage player. With KeepLoot="0" the class's normal drops are skipped.

The following are always blocked: event maps (Devil Square, Blood Castle, Chaos Castle, Illusion Temple, Duel Arena, Doppelganger, Imperial Guardian), safe zones and dungeon runs.

Configuration#

<SummonItems>
  <Messages Cooldown="You can summon again in {0} seconds."
            Level="You need level {0} to use this item."
            Map="You cannot summon here."
            MaxAlive="Your summoned monsters are still alive."
            NoRoom="There is no room to summon here." />

  <Item Index="14,200" Level="0" MinLevel="150" Cooldown="60" MaxAlive="3" Lifetime="300"
        Maps="0,2,3" Message="You used {0}.">
    <Group>
      <Monster Class="43" Rate="70" Count="2" Level="90"  Life="400" Damage="200" Exp="150" ItemBag="300"/>
      <Monster Class="78" Rate="30" Count="1" Level="110" Life="600" Damage="250" Exp="200" ItemBag="301"/>
    </Group>
    <Group Chance="5">
      <Monster Class="275" Life="200" ItemBag="302" KeepLoot="1"/>
    </Group>
  </Item>
</SummonItems>

<Messages>#

Messages go only to the summoner. Leave a message empty to send nothing.

AttributeWhen{0}
CooldownStill on cooldownSeconds left
LevelCharacter level too lowMinLevel
MapMap not allowed, safe zone or dungeon-
MaxAliveToo many of your summons alive-
NoRoomNothing spawned (no free spot, or every group missed)-

<Item>#

AttributeDefaultDescription
Index-"section,index" of the item
Level-1Item level that triggers it (-1 = any)
MinLevel0Character level needed
Cooldown0Seconds between uses, per character
MaxAlive0You cannot use the item while this many of your summons are alive (0 = no limit)
Lifetime0Seconds before an unkilled summon is removed (0 = 1800)
MapsemptyAllowed maps, e.g. "0,2,3" (empty = every map)
MessageemptySent on success, {0} = item name

<Group>#

AttributeDefaultDescription
Chance100% chance this group rolls. Inside the group one <Monster> is picked by Rate

<Monster>#

AttributeDefaultDescription
Class-Monster class
Rate1Weight inside the group
Count1How many spawn
Level0Sets the monster level (0 = keep). Changes the HP bar [level], exp and the item level of normal drops
Life100% of normal life
Damage100% of normal damage
Defense100% of normal defense and magic defense
AttackRate100% of normal attack success rate
DefenseRate100% of normal defense success rate
Exp100% of normal exp
ItemBag-1Bag index dropped on death (-1 = normal class loot)
KeepLoot01 = drop the bag and normal class loot

Notes#

  • Summoned monsters do not roll MonsterAffix affixes unless MonsterAffix.xml allows spawns outside MonsterSetBase.
  • Cooldown is per character name, so relogging does not reset it. A server restart does.
  • Reloading the config does not touch summons that are already alive. They keep their bag, loot and exp settings.

Last updated October 5, 2026