Skip to content
BlackTek

Constants

Lua Constants Reference

This document provides a complete reference of all constants available in BlackTek Server’s Lua interface.

Magic Effects (CONST_ME_*)

Visual effects displayed at a position.

position:sendMagicEffect(CONST_ME_TELEPORT)
ConstantIDDescription
CONST_ME_NONE0No effect
CONST_ME_DRAWBLOOD1Blood splash
CONST_ME_LOSEENERGY2Energy loss
CONST_ME_POFF3Puff/smoke
CONST_ME_BLOCKHIT4Block hit
CONST_ME_EXPLOSIONAREA5Explosion area
CONST_ME_EXPLOSIONHIT6Explosion hit
CONST_ME_FIREAREA7Fire area
CONST_ME_YELLOW_RINGS8Yellow rings
CONST_ME_GREEN_RINGS9Green rings
CONST_ME_HITAREA10Hit area
CONST_ME_TELEPORT11Teleport
CONST_ME_ENERGYHIT12Energy hit
CONST_ME_MAGIC_BLUE13Blue magic
CONST_ME_MAGIC_RED14Red magic
CONST_ME_MAGIC_GREEN15Green magic
CONST_ME_HITBYFIRE16Hit by fire
CONST_ME_HITBYPOISON17Hit by poison
CONST_ME_MORTAREA18Death area
CONST_ME_POISONAREA21Poison area
CONST_ME_BUBBLES26Bubbles
CONST_ME_STUN32Stun effect
CONST_ME_SLEEP33Sleep effect
CONST_ME_GROUNDSHAKER35Ground shaker
CONST_ME_HEARTS36Hearts
CONST_ME_FIREATTACK37Fire attack
CONST_ME_ENERGYAREA38Energy area
CONST_ME_HOLYDAMAGE40Holy damage
CONST_ME_ICEAREA42Ice area
CONST_ME_ICETORNADO43Ice tornado
CONST_ME_ICEATTACK44Ice attack
CONST_ME_STONES45Stones
CONST_ME_PURPLEENERGY48Purple energy
CONST_ME_HOLYAREA50Holy area
CONST_ME_GIANTICE53Giant ice
CONST_ME_WATERSPLASH54Water splash
CONST_ME_CRITICAL_DAMAGE173Critical hit

Distance Effects (CONST_ANI_*)

Projectile animations between positions.

fromPos:sendDistanceEffect(toPos, CONST_ANI_FIRE)
ConstantIDDescription
CONST_ANI_NONE0No animation
CONST_ANI_SPEAR1Spear
CONST_ANI_BOLT2Bolt
CONST_ANI_ARROW3Arrow
CONST_ANI_FIRE4Fire
CONST_ANI_ENERGY5Energy
CONST_ANI_POISONARROW6Poison arrow
CONST_ANI_BURSTARROW7Burst arrow
CONST_ANI_THROWINGSTAR8Throwing star
CONST_ANI_THROWINGKNIFE9Throwing knife
CONST_ANI_SMALLSTONE10Small stone
CONST_ANI_DEATH11Death
CONST_ANI_LARGEROCK12Large rock
CONST_ANI_SNOWBALL13Snowball
CONST_ANI_POWERBOLT14Power bolt
CONST_ANI_POISON15Poison
CONST_ANI_ICE29Ice
CONST_ANI_EARTH30Earth
CONST_ANI_HOLY31Holy
CONST_ANI_SUDDENDEATH32Sudden death
CONST_ANI_EXPLOSION41Explosion

Combat Types

Damage/healing types for combat.

ConstantDescription
COMBAT_NONENo combat type
COMBAT_PHYSICALDAMAGEPhysical damage
COMBAT_ENERGYDAMAGEEnergy damage
COMBAT_EARTHDAMAGEEarth/poison damage
COMBAT_FIREDAMAGEFire damage
COMBAT_UNDEFINEDDAMAGEUndefined damage
COMBAT_LIFEDRAINLife drain
COMBAT_MANADRAINMana drain
COMBAT_HEALINGHealing
COMBAT_DROWNDAMAGEDrowning damage
COMBAT_ICEDAMAGEIce damage
COMBAT_HOLYDAMAGEHoly damage
COMBAT_DEATHDAMAGEDeath damage

Condition Types

Status effect types.

ConstantDescription
CONDITION_NONENo condition
CONDITION_POISONPoison damage
CONDITION_FIREFire damage
CONDITION_ENERGYEnergy damage
CONDITION_BLEEDINGBleeding
CONDITION_HASTESpeed increase
CONDITION_PARALYZESpeed decrease
CONDITION_OUTFITOutfit change
CONDITION_INVISIBLEInvisibility
CONDITION_LIGHTLight source
CONDITION_MANASHIELDMagic shield
CONDITION_INFIGHTIn combat
CONDITION_DRUNKDrunk
CONDITION_EXHAUSTExhausted
CONDITION_REGENERATIONRegeneration
CONDITION_SOULSoul regen
CONDITION_DROWNDrowning
CONDITION_MUTEDCannot speak
CONDITION_ATTRIBUTESStat modifiers
CONDITION_FREEZINGIce damage
CONDITION_DAZZLEDDazzled
CONDITION_CURSEDCursed
CONDITION_ROOTEDCannot move
CONDITION_FEAREDFear

Skills

Player skill types.

ConstantIDDescription
SKILL_FIST0Fist fighting
SKILL_CLUB1Club fighting
SKILL_SWORD2Sword fighting
SKILL_AXE3Axe fighting
SKILL_DISTANCE4Distance fighting
SKILL_SHIELDING5Shielding
SKILL_FISHING6Fishing
SKILL_MAGLEVEL-Magic level
SKILL_LEVEL-Experience level

Slots

Equipment slot constants.

ConstantIDDescription
CONST_SLOT_HEAD1Head
CONST_SLOT_NECKLACE2Necklace
CONST_SLOT_BACKPACK3Backpack
CONST_SLOT_ARMOR4Armor
CONST_SLOT_RIGHT5Right hand
CONST_SLOT_LEFT6Left hand
CONST_SLOT_LEGS7Legs
CONST_SLOT_FEET8Feet
CONST_SLOT_RING9Ring
CONST_SLOT_AMMO10Ammunition

Message Types

Text message types for players.

ConstantDescription
MESSAGE_STATUS_CONSOLE_BLUEBlue console message
MESSAGE_STATUS_CONSOLE_REDRed console message
MESSAGE_STATUS_DEFAULTWhite bottom/console
MESSAGE_STATUS_WARNINGRed warning
MESSAGE_STATUS_SMALLSmall status
MESSAGE_INFO_DESCRGreen info
MESSAGE_DAMAGE_DEALTDamage dealt
MESSAGE_DAMAGE_RECEIVEDDamage received
MESSAGE_HEALEDHealing received
MESSAGE_EXPERIENCEExperience gained
MESSAGE_EVENT_ADVANCELevel/skill advance

Talk Types

Speech types for creatures.

ConstantDescription
TALKTYPE_SAYNormal say
TALKTYPE_WHISPERWhisper
TALKTYPE_YELLYell
TALKTYPE_PRIVATE_FROMPrivate from
TALKTYPE_PRIVATE_TOPrivate to
TALKTYPE_CHANNEL_YYellow channel
TALKTYPE_CHANNEL_OOrange channel
TALKTYPE_BROADCASTBroadcast
TALKTYPE_MONSTER_SAYMonster say
TALKTYPE_MONSTER_YELLMonster yell

Skulls

PvP skull types.

ConstantIDDescription
SKULL_NONE0No skull
SKULL_YELLOW1Yellow skull
SKULL_GREEN2Green skull
SKULL_WHITE3White skull
SKULL_RED4Red skull
SKULL_BLACK5Black skull
SKULL_ORANGE6Orange skull

Directions

Movement directions.

ConstantIDDescription
DIRECTION_NORTH0North (up)
DIRECTION_EAST1East (right)
DIRECTION_SOUTH2South (down)
DIRECTION_WEST3West (left)
DIRECTION_NORTHEAST4Northeast
DIRECTION_SOUTHEAST5Southeast
DIRECTION_SOUTHWEST6Southwest
DIRECTION_NORTHWEST7Northwest

Return Values

Action return values.

ConstantDescription
RETURNVALUE_NOERRORSuccess
RETURNVALUE_NOTPOSSIBLENot possible
RETURNVALUE_NOTENOUGHROOMNot enough room
RETURNVALUE_PLAYERISPZLOCKEDPZ locked
RETURNVALUE_PLAYERISNOTINVITEDNot invited
RETURNVALUE_CANNOTTHROWCannot throw
RETURNVALUE_THEREISNOWAYNo way
RETURNVALUE_DESTINATIONOUTOFREACHOut of reach
RETURNVALUE_CREATUREBLOCKCreature blocking
RETURNVALUE_NOTMOVEABLENot moveable
RETURNVALUE_DROPTWOHANDEDITEMDrop two-handed
RETURNVALUE_BOTHHANDSNEEDTOBEFREEBoth hands needed
RETURNVALUE_CANONLYUSEONEWEAPONOne weapon only
RETURNVALUE_NEEDEXCHANGENeed exchange
RETURNVALUE_CANNOTBEDRESSEDCannot be dressed
RETURNVALUE_PUTTHISOBJECTINYOURHANDPut in hand
RETURNVALUE_PUTTHISOBJECTINBOTHHANDSPut in both hands
RETURNVALUE_TOOFARAWAYToo far away
RETURNVALUE_FIRSTGODOWNSTAIRSGo downstairs first
RETURNVALUE_FIRSTGOUPSTAIRSGo upstairs first
RETURNVALUE_CONTAINERNOTENOUGHROOMContainer full
RETURNVALUE_NOTENOUGHCAPACITYNot enough capacity
RETURNVALUE_CANNOTPICKUPCannot pick up
RETURNVALUE_THISISIMPOSSIBLEImpossible
RETURNVALUE_DEPOTISFULLDepot full
RETURNVALUE_CREATUREDOESNOTEXISTCreature doesn’t exist
RETURNVALUE_CANNOTUSETHISOBJECTCannot use object
RETURNVALUE_PLAYERWITHTHISNAMEISNOTONLINEPlayer not online
RETURNVALUE_NOTREQUIREDLEVELTOUSERUNELevel too low for rune
RETURNVALUE_YOUAREALREADYTRADINGAlready trading
RETURNVALUE_THISPLAYERISALREADYTRADINGPlayer already trading
RETURNVALUE_YOUMAYNOTLOGOUTDURINGAFIGHTCannot logout in fight
RETURNVALUE_DIRECTPLAYERSHOOTDirect player shoot
RETURNVALUE_NOTENOUGHLEVELNot enough level
RETURNVALUE_NOTENOUGHMAGICLEVELNot enough magic level
RETURNVALUE_NOTENOUGHMANANot enough mana
RETURNVALUE_NOTENOUGHSOULNot enough soul
RETURNVALUE_YOUAREEXHAUSTEDExhausted
RETURNVALUE_PLAYERISNOTREACHABLEPlayer not reachable
RETURNVALUE_CANONLYUSETHISRUNEONCREATURESRune only on creatures
RETURNVALUE_ACTIONNOTPERMITTEDINPROTECTIONZONEPZ not allowed
RETURNVALUE_YOUMAYNOTATTACKTHISPLAYERCannot attack player
RETURNVALUE_YOUMAYNOTATTACKTHISCREATURECannot attack creature
RETURNVALUE_YOUMAYNOTATTACKAPERSONINPROTECTIONZONECannot attack in PZ
RETURNVALUE_YOUMAYNOTATTACKAPERSONWHILEINPROTECTIONZONEIn PZ cannot attack
RETURNVALUE_YOUCANONLYUSEITONCREATURESOnly on creatures
RETURNVALUE_TURNSECUREMODETOATTACKUNMARKEDPLAYERSSecure mode
RETURNVALUE_YOUNEEDPREMIUMACCOUNTNeed premium
RETURNVALUE_YOUNEEDTOLEARNTHISSPELLNeed to learn spell
RETURNVALUE_YOURVOCATIONCANNOTUSETHISSPELLWrong vocation
RETURNVALUE_YOUNEEDAWEAPONTOUSETHISSPELLNeed weapon
RETURNVALUE_PLAYERISPZLOCKEDLEAVEPVPZONELeave PvP zone
RETURNVALUE_PLAYERISPZLOCKEDENTERPVPZONEEnter PvP zone
RETURNVALUE_ACTIONNOTPERMITTEDINANOPVPZONENo-PvP zone
RETURNVALUE_YOUCANNOTLOGOUTHERECannot logout here
RETURNVALUE_YOUNEEDAMAGICITEMTOCASTSPELLNeed magic item
RETURNVALUE_CANNOTCONJUREITEMHERECannot conjure here
RETURNVALUE_NAMEISTOOAMBIGUOUSName too ambiguous
RETURNVALUE_CANONLYUSEONESHIELDOne shield only
RETURNVALUE_NOPARTYMEMBERSINRANGENo party in range
RETURNVALUE_YOUARENOTTHEOWNERNot the owner

Account Types

ConstantIDDescription
ACCOUNT_TYPE_NORMAL1Normal player
ACCOUNT_TYPE_TUTOR2Tutor
ACCOUNT_TYPE_SENIORTUTOR3Senior tutor
ACCOUNT_TYPE_GAMEMASTER4Gamemaster
ACCOUNT_TYPE_COMMUNITYMANAGER5Community manager
ACCOUNT_TYPE_GOD6God/Admin

Game States

ConstantIDDescription
GAME_STATE_STARTUP0Starting up
GAME_STATE_INIT1Initializing
GAME_STATE_NORMAL2Running normally
GAME_STATE_CLOSED3Closed
GAME_STATE_SHUTDOWN4Shutting down
GAME_STATE_CLOSING5Closing
GAME_STATE_MAINTAIN6Maintenance

World Types

ConstantIDDescription
WORLD_TYPE_NO_PVP1No PvP
WORLD_TYPE_PVP2Open PvP
WORLD_TYPE_PVP_ENFORCED3Hardcore PvP

Item Attributes

ConstantDescription
ITEM_ATTRIBUTE_NONENo attribute
ITEM_ATTRIBUTE_ACTIONIDAction ID
ITEM_ATTRIBUTE_UNIQUEIDUnique ID
ITEM_ATTRIBUTE_DESCRIPTIONDescription
ITEM_ATTRIBUTE_TEXTWritten text
ITEM_ATTRIBUTE_DATEDate
ITEM_ATTRIBUTE_WRITERWriter name
ITEM_ATTRIBUTE_NAMECustom name
ITEM_ATTRIBUTE_ARTICLEArticle
ITEM_ATTRIBUTE_PLURALNAMEPlural name
ITEM_ATTRIBUTE_WEIGHTWeight
ITEM_ATTRIBUTE_ATTACKAttack value
ITEM_ATTRIBUTE_DEFENSEDefense value
ITEM_ATTRIBUTE_EXTRADEFENSEExtra defense
ITEM_ATTRIBUTE_ARMORArmor value
ITEM_ATTRIBUTE_HITCHANCEHit chance
ITEM_ATTRIBUTE_SHOOTRANGEShoot range
ITEM_ATTRIBUTE_OWNEROwner
ITEM_ATTRIBUTE_DURATIONDuration
ITEM_ATTRIBUTE_DECAYSTATEDecay state
ITEM_ATTRIBUTE_CORPSEOWNERCorpse owner
ITEM_ATTRIBUTE_CHARGESCharges
ITEM_ATTRIBUTE_FLUIDTYPEFluid type
ITEM_ATTRIBUTE_DOORIDDoor ID

Zones

ConstantDescription
ZONE_PROTECTIONProtection zone
ZONE_NOPVPNo-PvP zone
ZONE_PVPPvP zone
ZONE_NOLOGOUTNo logout zone
ZONE_NORMALNormal zone

Tile Flags

ConstantDescription
TILESTATE_PROTECTIONZONEProtection zone
TILESTATE_NOPVPZONENo-PvP zone
TILESTATE_PVPZONEPvP zone
TILESTATE_NOLOGOUTNo logout
TILESTATE_REFRESHRefresh
TILESTATE_HOUSEHouse tile