Biblioteca de funções lua/SVN
Definições da biblioteca [Necessário ler!]
OBS.: itemtables, creaturetables e spelltables estão marcados com um (!), GUID está marcado com um ($) e atributos opcionais estão marcados com (*)
FUNÇÕES EXPLICADAS
getPlayerFood(cid)
ação ~> retorna o status de food do player
getPlayerMana(cid)
ação ~> retorna o status de mana do player
getPlayerMaxMana(cid)
ação ~> retorna o máximo de mana que o player pode ter
getPlayerLevel(cid)
ação ~> retorna o level do player
getPlayerMagLevel(cid)
ação ~> retorna o magiclevel (ML) do player
getPlayerAccess(cid)
ação ~> retorna o acesso do player (geralmente 0 pra players, 3 pra GOD, etc)
getPlayerSkill(cid, skillid)
ação ~> retorna o skill skillid do playerexemplo: getPlayerSkill(cid, 4) irá retornar o valor do skill 4 (distance fight)
.: skillid ~> um número de 0 a 6 que representa o skill que vc quer obter
.:. 0 ~> FIST
.:. 1 ~> CLUB
.:. 2 ~> SWORD
.:. 3 ~> AXE
.:. 4 ~> DIST
.:. 5 ~> SHIELD
.:. 6 ~> FISH
getPlayerMasterPos(cid)
ação ~> retorna a posição que o player renasce
getPlayerTown(cid)
ação ~> retorna o id da cidade a que ele pertence
getPlayerVocation(cid)
ação ~> retorna um número identificando a vocação do player.retorno:
~> 0 -> NENHUM
~> 1 -> SORCERER
~> 2 -> DRUID
~> 3 -> PALADIN
~> 4 -> KNIGHT
~> 5 -> MASTER SORCERER
~> 6 -> ELDER DRUID
~> 7 -> ROYAL PALADIN
~> 8 -> ELITE KNIGHT
getPlayerItemCount(cid, itemid, subtype)
ação ~> retorna a quantidade de items de id itemid do subtipo subtype (*).: itemid ~> id do item a ser contado
.: subtype (*) ~> atributo opcional, o subtipo do item a ser contado (exemplo: subtipo de vials)
getPlayerSoul(cid)
ação ~> retorna a quantidade de soul points que o player possui no momento
getPlayerFreeCap(cid)
ação ~> retorna a cap livre que o player possui no momento
getCreatureLight(cid)
ação ~> retorna o status da iluminação da criatura
getCreatureLookDir(cid)
ação ~> retorna um número indicando a direção que o player está viradoretorno:
~> 0 -> NORTH (Norte)
~> 1 -> EAST (Leste)
~> 2 -> SOUTH (Sul)
~> 3 -> WEST (Oeste)
getPlayerSlotItem(cid, slotid)
ação ~> retorna o itemtable(!) do item que está no slot slotid.: slotid ~> um número de 1 a 10 que representa o slot que vc quer checar
.:. 01 ~> HEAD (Cabeça)
.:. 02 ~> NECKLACE (Colar)
.:. 03 ~> BACKPACK (Slot da Bolsa)
.:. 04 ~> ARMOR (Armadura)
.:. 05 ~> RIGHT (Mão Direita)
.:. 06 ~> LEFT (Mão Dsquerda)
.:. 07 ~> LEGS (Calça)
.:. 08 ~> FEET (Sapatos)
.:. 09 ~> RING (Anel)
.:. 10 ~> AMMO (Munição)
getPlayerItemById(cid, deepSearch, itemId, subType)
ação ~> retorna o itemtable(!) do item de id itemid e de subtipo subtype(*) que o player está carregando..: deepSearch ~> informa se você vai pesquisar dentro da bag/bp (deepSearch=1). Caso contrário, deepSearch poderá assumir qualquer outro valor
.: itemid ~> id do item a ser retornado
.: subtype (*) ~> atributo opcional, o subtipo do item a ser retornado
getPlayerDepotItems(cid, depotid)
ação ~> retorna a quantidade de itens no dp de id depotid.: depotid ~> Id do depot
getPlayerGuildId(cid)
ação ~> retorna o id da guild do player
getPlayerGuildName(cid)
ação ~> retorna o nome da guild do player
getPlayerGuildRank(cid)
ação ~> retorna o rank que o player ocupa na guild
getPlayerGuildNick(cid)
ação ~> retorna o nick do player na guild
getPlayerSex(cid)
ação ~> retorna um número que representa o sexo do playerretorno:
~> 0 -> FEMALE (Mulher)
~> 1 -> MALE (Homem)
~> 2 -> FEMALE_GAMEMASTER (Mulher GM)
~> 3 -> MALE_GAMEMASTER (Homem GM)
~> 4 -> FEMALE_MANAGER (Mulher ComManager)
~> 5 -> MALE_MANAGER (Homem ComManager)
~> 6 -> FEMALE_GOD (Mulher GOD)
~> 7 -> MALE_GOD (Homem GOD)
getPlayerGUID(cid)
ação ~> retorna o número de identificação do player (campo 'id' da tabela 'players' da database).OBS.: A diferença do GUID com o cid é que o GUID é permanente (ler cid nas definições da biblioteca). Embora os dois sirvam para identificar o player, você não pode passar o GUID de um player pra uma função lua como se fosse o cid! São coisas diferentes!
getPlayerNameByGUID(guid)
ação ~> retorna o nome do player a partir do seu GUID ($)
getPlayerFlagValue(cid, flag)
ação ~> retorna TRUE ou FALSE se o player tem uma determinada flag.: flag ~> são as "PLAYERFLAG_...." encontradas no global.lua.
getPlayerLossPercent(cid, lossType)
ação ~> retorna as rates de loss do player.: lossType ~> "PLAYERLOSS_...." encontradas no global.lua
getPlayerPremiumDays(cid)
ação ~> retorna o numero de dias que o player ainda tem de premium
getPlayerSkullType(cid)
ação ~> retorna a skull que o player está no momentoretorno:
~> 0 -> NONE (Nenhuma)
~> 1 -> YELLOW (Amarela)
~> 2 -> GREEN (Verde)
~> 3 -> WHITE (Branca)
~> 4 -> RED (Vermelha)
getPlayerRedSkullTicks(cid)
ação ~> retorna o tempo que a skull do player vai demorar pra sair
getPlayerAccountBalance(cid)
ação ~> retorna o valor que o player possui no banco
playerLearnInstantSpell(cid, name)
ação ~> faz o player aprender o spell de nome name
canPlayerLearnInstantSpell(cid, name)
ação ~> verifica se o player pode (retorna TRUE) ou não pode (retorna FALSE) aprender o spell de nome name
getPlayerLearnedInstantSpell(cid, name)
ação ~> verifica se o player já aprendeu (retorna TRUE) ou não (retorna FALSE) a spell de nome name
getPlayerInstantSpellInfo(cid, index)
ação ~> retorna a spelltable (!) de uma magia contida na lista de magias que o player tem.: index ~> a posição da magia na lista do player. Começa no 0.
OBS.: a função é geralmente usada em conjunto com a getPlayerInstantSpellCount(cid) para se criar spellbook
getPlayerInstantSpellCount(cid)
ação ~> retorna a quantidade de magias que o player pode usar. Geralmente é usada em conjunto com a getPlayerInstantSpellInfo(cid, index)
getInstantSpellInfoByName(cid, name)
ação ~> retorna a spelltable (!) de uma magia de nome nameOBS.: se cid for igual a 0, a spelltable (!) irá retornar normal, com exceção da variável mana, que vai ser 0
getInstantSpellWords(name)
ação ~> retorna as "palavras mágicas" da magia de nome name
getPlayerStorageValue(cid, valueid)
ação ~> retorna o valor da storagevalue de id valueid do player
setPlayerStorageValue(cid, valueid, newvalue)
ação ~> define o valor newvalue para a storagevalue de id valueid do player
isPremium(cid)
ação ~> retorna TRUE se o player for premmium
getPlayerLastLogin(cid)
ação ~> retorna um número que representa a data de último login do playerOBS.: O número equivale ao número de segundos passados desde 00:00 horas, 1o de Janeiro, 1970 UTC.
getGlobalStorageValue(valueid)
ação ~> retorna o valor do globalStorageValue de value valueid.OBS.: Os globalStorageValue são como se fosse um storagevalue "do server" e não do player. São salvos na tabela `global_storage` da database.
setGlobalStorageValue(valueid, newvalue)
ação ~> define o valor newvalue para a globalStorageValue de id valueidOBS.: Os globalStorageValue são como se fosse um storagevalue "do server" e não do player. São salvos na tabela `global_storage` da database.
getTilePzInfo(pos)
ação ~> retorna 1 se o tile for protection zone (pz) ou 0 se não for
FUNÇÕES A SEREM ADICIONADAS