Skip to content

MuDevs Lua API

Game Item

GameItem

GameItem (CItem)¶

Represents an item in the game.

Methods — Type Checks (all return `boolean`)¶

Method	Description
`IsItem()`	Is a valid item
`IsExcItem()`	Is Excellent
`IsLegendaryExcItem()`	Is Legendary Excellent
`IsExtItem()`	Has extended options
`IsSetItem()`	Is Ancient/Set
`IsSocketItem()`	Has sockets
`IsMasterySocketItem()`	Has mastery sockets
`IsPentagramItem()`	Is Pentagram
`IsWingItem()`	Is a wing
`IsSmallWingItem()`	Is a small wing
`IsBow()`	Is a bow
`IsCrossBow()`	Is a crossbow
`IsShieldItem()`	Is a shield
`IsRingItem()`	Is a ring
`IsPendantItem()`	Is a pendant
`IsMuunItem()`	Is a Muun
`IsBookItem()`	Is a book (DL)
`IsStaffItem()`	Is a staff
`IsStickItem()`	Is a stick
`IsScepter()`	Is a scepter
`IsRuneMaceItem()`	Is a Rune Mace
`IsMagicGun()`	Is a Magic Gun
`IsHorse()`	Is a horse mount
`IsDivineHorse()`	Is a divine horse
`IsRaven()`	Is a raven
`IsDivineRaven()`	Is a divine raven
`IsLegendaryItem()`	Is Legendary
`IsEventItem()`	Is an event item
`IsArtifact()`	Is an artifact
`IsCollectItem()`	Is a collectible
...	(60+ more type checks available)

Methods — Getters¶

Method	Returns	Description
`GetName()`	string	Item name
`GetDamageMin()`	number	Min damage
`GetDamageMax()`	number	Max damage
`GetDefense()`	number	Defense value
`GetDefenseSuccessRate()`	number	Defense success rate
`GetBookSuccessRate()`	number	Book success rate
`GetMuunItemRank()`	number	Muun rank
`GetRavenViewType()`	number	Raven appearance type
`GetCollectCount()`	number	Collection count
`Value()`	number	Sell value in Zen
`OldValue()`	number	Old sell value
`PetValue()`	number	Pet value
`IsClass(class, changeUp)`	boolean	Can be used by class
`Convert(...)`	void	Set item properties

Methods — Durability¶

Method	Description
`WeaponDurabilityDown(lpObj, def, type)`	Reduce weapon durability
`ArmorDurabilityDown(lpObj, dmg)`	Reduce armor durability
`WingDurabilityDown(lpObj)`	Reduce wing durability
`PendantDurabilityDown(lpObj)`	Reduce pendant durability
`RingDurabilityDown(lpObj)`	Reduce ring durability
`LuckyDurabilityDown(lpObj)`	Reduce lucky item durability
`CheckDurabilityState()`	Update durability state
`AddPetItemExp(exp)`	Add experience to pet
`DecPetItemExp(exp)`	Remove experience from pet
`SetPetItemInfo(...)`	Set pet item data
`SetCollectCount(n)`	Set collection count

Properties¶

Property	Type	Description
`m_Index`	number	Global item ID
`m_Level`	number	Item level (+0 to +15)
`m_Slot`	number	Inventory slot position
`m_Class`	number	Item class
`m_TwoHand`	number	Is two-handed
`m_Durability`	number	Current durability
`m_BaseDurability`	number	Base durability
`m_DamageMin`	number	Min damage
`m_DamageMax`	number	Max damage
`m_Defense`	number	Defense value
`m_MagicDefense`	number	Magic defense
`m_AttackSpeed`	number	Attack speed
`m_Option1`	number	Skill option
`m_Option2`	number	Luck option
`m_Option3`	number	Additional option
`m_NewOption`	number	Excellent options (bitmask)
`m_SetOption`	number	Ancient/Set option
`m_JewelOfHarmonyOption`	number	JoH option
`m_ItemOptionEx`	number	Extended option
`m_SocketOption[n]`	number	Socket options (0-4)
`m_SocketOptionBonus`	number	Socket bonus
`m_SellMoney`	number	Sell price
`m_BuyMoney`	number	Buy price
`m_RequireStrength`	number	Required STR
`m_RequireDexterity`	number	Required DEX
`m_RequireEnergy`	number	Required ENE
`m_RequireLevel`	number	Required level
`m_RequireVitality`	number	Required VIT
`m_RequireLeadership`	number	Required CMD
`m_MagicDamageRate`	number	Magic damage rate
`m_IsValidItem`	number	Valid item flag
`m_PetItemLevel`	number	Pet level
`m_PetItemExp`	number	Pet experience
`m_ElementalAttack`	number	Elemental attack
`m_ElementalDefense`	number	Elemental defense
`m_LegendaryStage`	number	Legendary stage
`serialKey`	string	Item serial (NEW_ITEM_SERIAL=1)
`m_Serial`	number	Item serial (NEW_ITEM_SERIAL=0)

local weapon = player.Inventory[0]
if weapon:IsItem() then
    LogAdd(LOG_BLUE, player.Name .. " has " .. weapon:GetName() .. " +" .. weapon.m_Level)
    if weapon:IsExcItem() then
        LogAdd(LOG_GREEN, "It's Excellent!")
    end
end

Help