/*
* This program is free software: you can redistribute it and/or modify it under
* the terms of the GNU General Public License as published by the Free Software
* Foundation, either version 3 of the License, or (at your option) any later
* version.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
* details.
*
* You should have received a copy of the GNU General Public License along with
* this program. If not, see .
*/
package com.l2jserver.gameserver.model.quest;
import java.sql.Connection;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.util.Map;
import java.util.logging.Level;
import java.util.logging.Logger;
import com.l2jserver.Config;
import com.l2jserver.L2DatabaseFactory;
import com.l2jserver.gameserver.GameTimeController;
import com.l2jserver.gameserver.cache.HtmCache;
import com.l2jserver.gameserver.datatables.ItemTable;
import com.l2jserver.gameserver.instancemanager.QuestManager;
import com.l2jserver.gameserver.model.L2DropData;
import com.l2jserver.gameserver.model.L2ItemInstance;
import com.l2jserver.gameserver.model.actor.L2Character;
import com.l2jserver.gameserver.model.actor.L2Npc;
import com.l2jserver.gameserver.model.actor.instance.L2MonsterInstance;
import com.l2jserver.gameserver.model.actor.instance.L2PcInstance;
import com.l2jserver.gameserver.network.SystemMessageId;
import com.l2jserver.gameserver.network.serverpackets.ExShowQuestMark;
import com.l2jserver.gameserver.network.serverpackets.InventoryUpdate;
import com.l2jserver.gameserver.network.serverpackets.PlaySound;
import com.l2jserver.gameserver.network.serverpackets.QuestList;
import com.l2jserver.gameserver.network.serverpackets.StatusUpdate;
import com.l2jserver.gameserver.network.serverpackets.SystemMessage;
import com.l2jserver.gameserver.network.serverpackets.TutorialCloseHtml;
import com.l2jserver.gameserver.network.serverpackets.TutorialEnableClientEvent;
import com.l2jserver.gameserver.network.serverpackets.TutorialShowHtml;
import com.l2jserver.gameserver.network.serverpackets.TutorialShowQuestionMark;
import com.l2jserver.gameserver.skills.Stats;
import com.l2jserver.gameserver.templates.item.L2EtcItemType;
import com.l2jserver.util.Rnd;
import javolution.util.FastMap;
/**
* @author Luis Arias
*/
public final class QuestState
{
protected static final Logger _log = Logger.getLogger(Quest.class.getName());
/** Quest associated to the QuestState */
private final String _questName;
/** Player who engaged the quest */
private final L2PcInstance _player;
/** State of the quest */
private byte _state;
/** List of couples (variable for quest,value of the variable for quest) */
private Map _vars;
/** Boolean flag letting QuestStateManager know to exit quest when cleaning up */
private boolean _isExitQuestOnCleanUp = false;
/**
* Constructor of the QuestState : save the quest in the list of quests of the player.
*
* Actions :
* Save informations in the object QuestState created (Quest, Player, Completion, State)
* Add the QuestState in the player's list of quests by using setQuestState()
* Add drops gotten by the quest
*
* @param quest : quest associated with the QuestState
* @param player : L2PcInstance pointing out the player
* @param state : state of the quest
* @param completed : boolean for completion of the quest
*/
QuestState(Quest quest, L2PcInstance player, byte state)
{
_questName = quest.getName();
_player = player;
// Save the state of the quest for the player in the player's list of quest onwed
getPlayer().setQuestState(this);
// set the state of the quest
_state = state;
}
public String getQuestName()
{
return _questName;
}
/**
* Return the quest
* @return Quest
*/
public Quest getQuest()
{
return QuestManager.getInstance().getQuest(_questName);
}
/**
* Return the L2PcInstance
* @return L2PcInstance
*/
public L2PcInstance getPlayer()
{
return _player;
}
/**
* Return the state of the quest
* @return State
*/
public byte getState()
{
return _state;
}
/**
* Return true if quest just created, false otherwise
* @return
*/
public boolean isCreated()
{
return (getState() == State.CREATED);
}
/**
* Return true if quest completed, false otherwise
* @return boolean
*/
public boolean isCompleted()
{
return (getState() == State.COMPLETED);
}
/**
* Return true if quest started, false otherwise
* @return boolean
*/
public boolean isStarted()
{
return (getState() == State.STARTED);
}
/**
* Return state of the quest after its initialization.
* Actions :
* Remove drops from previous state
* Set new state of the quest
* Add drop for new state
* Update information in database
* Send packet QuestList to client
* @param state
* @return object
*/
public Object setState(byte state)
{
// set new state if it is not already in that state
if (_state != state)
{
final boolean newQuest = isCreated();
_state = state;
if (newQuest)
Quest.createQuestInDb(this);
else
Quest.updateQuestInDb(this);
getPlayer().sendPacket(new QuestList());
}
return state;
}
public Object setStateAndNotSave(byte state)
{
// set new state if it is not already in that state
if (_state != state)
{
_state = state;
getPlayer().sendPacket(new QuestList());
}
return state;
}
/**
* Add parameter used in quests.
* @param var : String pointing out the name of the variable for quest
* @param val : String pointing out the value of the variable for quest
* @return String (equal to parameter "val")
*/
public String setInternal(String var, String val)
{
if (_vars == null)
_vars = new FastMap();
if (val == null)
val = "";
_vars.put(var, val);
return val;
}
/**
* Return value of parameter "val" after adding the couple (var,val) in class variable "vars".
* Actions :
* Initialize class variable "vars" if is null
* Initialize parameter "val" if is null
* Add/Update couple (var,val) in class variable FastMap "vars"
* If the key represented by "var" exists in FastMap "vars", the couple (var,val) is updated in the database. The key is known as
* existing if the preceding value of the key (given as result of function put()) is not null.
* If the key doesn't exist, the couple is added/created in the database
* @param var : String indicating the name of the variable for quest
* @param val : String indicating the value of the variable for quest
* @return String (equal to parameter "val")
*/
public String set(String var, String val)
{
if (_vars == null)
_vars = new FastMap();
if (val == null)
val = "";
// FastMap.put() returns previous value associated with specified key, or null if there was no mapping for key.
String old = _vars.put(var, val);
if (old != null)
Quest.updateQuestVarInDb(this, var, val);
else
Quest.createQuestVarInDb(this, var, val);
if ("cond".equals(var))
{
try
{
int previousVal = 0;
try
{
previousVal = Integer.parseInt(old);
}
catch (Exception ex)
{
previousVal = 0;
}
setCond(Integer.parseInt(val), previousVal);
}
catch (Exception e)
{
_log.log(Level.WARNING, getPlayer().getName() + ", " + getQuestName() + " cond [" + val + "] is not an integer. Value stored, but no packet was sent: " + e.getMessage(), e);
}
}
return val;
}
/**
* Internally handles the progression of the quest so that it is ready for sending
* appropriate packets to the client
* Actions :
* Check if the new progress number resets the quest to a previous (smaller) step
* If not, check if quest progress steps have been skipped
* If skipped, prepare the variable completedStateFlags appropriately to be ready for sending to clients
* If no steps were skipped, flags do not need to be prepared...
* If the passed step resets the quest to a previous step, reset such that steps after the parameter are not
* considered, while skipped steps before the parameter, if any, maintain their info
* @param cond : int indicating the step number for the current quest progress (as will be shown to the client)
* @param old : int indicating the previously noted step
*
* For more info on the variable communicating the progress steps to the client, please see
* @link com.l2jserver.loginserver.serverpacket.QuestList
*/
private void setCond(int cond, int old)
{
int completedStateFlags = 0; // initializing...
// if there is no change since last setting, there is nothing to do here
if (cond == old)
return;
// cond 0 and 1 do not need completedStateFlags. Also, if cond > 1, the 1st step must
// always exist (i.e. it can never be skipped). So if cond is 2, we can still safely
// assume no steps have been skipped.
// Finally, more than 31 steps CANNOT be supported in any way with skipping.
if (cond < 3 || cond > 31)
{
unset("__compltdStateFlags");
}
else
completedStateFlags = getInt("__compltdStateFlags");
// case 1: No steps have been skipped so far...
if (completedStateFlags == 0)
{
// check if this step also doesn't skip anything. If so, no further work is needed
// also, in this case, no work is needed if the state is being reset to a smaller value
// in those cases, skip forward to informing the client about the change...
// ELSE, if we just now skipped for the first time...prepare the flags!!!
if (cond > (old + 1))
{
// set the most significant bit to 1 (indicates that there exist skipped states)
// also, ensure that the least significant bit is an 1 (the first step is never skipped, no matter
// what the cond says)
completedStateFlags = 0x80000001;
// since no flag had been skipped until now, the least significant bits must all
// be set to 1, up until "old" number of bits.
completedStateFlags |= ((1 << old) - 1);
// now, just set the bit corresponding to the passed cond to 1 (current step)
completedStateFlags |= (1 << (cond - 1));
set("__compltdStateFlags", String.valueOf(completedStateFlags));
}
}
// case 2: There were exist previously skipped steps
else
{
// if this is a push back to a previous step, clear all completion flags ahead
if (cond < old)
{
completedStateFlags &= ((1 << cond) - 1); // note, this also unsets the flag indicating that there exist skips
//now, check if this resulted in no steps being skipped any more
if (completedStateFlags == ((1 << cond) - 1))
unset("__compltdStateFlags");
else
{
// set the most significant bit back to 1 again, to correctly indicate that this skips states.
// also, ensure that the least significant bit is an 1 (the first step is never skipped, no matter
// what the cond says)
completedStateFlags |= 0x80000001;
set("__compltdStateFlags", String.valueOf(completedStateFlags));
}
}
// if this moves forward, it changes nothing on previously skipped steps...so just mark this
// state and we are done
else
{
completedStateFlags |= (1 << (cond - 1));
set("__compltdStateFlags", String.valueOf(completedStateFlags));
}
}
// send a packet to the client to inform it of the quest progress (step change)
QuestList ql = new QuestList();
getPlayer().sendPacket(ql);
int questId = getQuest().getQuestIntId();
if (questId > 0 && questId < 19999 && cond > 0)
getPlayer().sendPacket(new ExShowQuestMark(questId));
}
/**
* Remove the variable of quest from the list of variables for the quest.
* Concept :
* Remove the variable of quest represented by "var" from the class variable FastMap "vars" and from the database.
* @param var : String designating the variable for the quest to be deleted
* @return String pointing out the previous value associated with the variable "var"
*/
public String unset(String var)
{
if (_vars == null)
return null;
String old = _vars.remove(var);
if (old != null)
Quest.deleteQuestVarInDb(this, var);
return old;
}
/**
* Insert (or Update) in the database variables that need to stay persistant for this player after a reboot.
* This function is for storage of values that do not related to a specific quest but are
* global for all quests. For example, player's can get only once the adena and XP reward for
* the first class quests, but they can make more than one first class quest.
* @param var : String designating the name of the variable for the quest
* @param value : String designating the value of the variable for the quest
*/
public final void saveGlobalQuestVar(String var, String value)
{
Connection con = null;
try
{
con = L2DatabaseFactory.getInstance().getConnection();
PreparedStatement statement;
statement = con.prepareStatement("REPLACE INTO character_quest_global_data (charId,var,value) VALUES (?,?,?)");
statement.setInt(1, _player.getObjectId());
statement.setString(2, var);
statement.setString(3, value);
statement.executeUpdate();
statement.close();
}
catch (Exception e)
{
_log.log(Level.WARNING, "Could not insert player's global quest variable: " + e.getMessage(), e);
}
finally
{
L2DatabaseFactory.close(con);
}
}
/**
* Read from the database a previously saved variable for this quest.
* Due to performance considerations, this function should best be used only when the quest is first loaded.
* Subclasses of this class can define structures into which these loaded values can be saved.
* However, on-demand usage of this function throughout the script is not prohibited, only not recommended.
* Values read from this function were entered by calls to "saveGlobalQuestVar"
* @param var : String designating the name of the variable for the quest
* @return String : String representing the loaded value for the passed var, or an empty string if the var was invalid
*/
public final String getGlobalQuestVar(String var)
{
String result = "";
Connection con = null;
try
{
con = L2DatabaseFactory.getInstance().getConnection();
PreparedStatement statement;
statement = con.prepareStatement("SELECT value FROM character_quest_global_data WHERE charId = ? AND var = ?");
statement.setInt(1, _player.getObjectId());
statement.setString(2, var);
ResultSet rs = statement.executeQuery();
if (rs.first())
result = rs.getString(1);
rs.close();
statement.close();
}
catch (Exception e)
{
_log.log(Level.WARNING, "Could not load player's global quest variable: " + e.getMessage(), e);
}
finally
{
L2DatabaseFactory.close(con);
}
return result;
}
/**
* Permanently delete from the database one of the player's global quest variable that was previously saved.
* @param var : String designating the name of the variable
*/
public final void deleteGlobalQuestVar(String var)
{
Connection con = null;
try
{
con = L2DatabaseFactory.getInstance().getConnection();
PreparedStatement statement;
statement = con.prepareStatement("DELETE FROM character_quest_global_data WHERE charId = ? AND var = ?");
statement.setInt(1, _player.getObjectId());
statement.setString(2, var);
statement.executeUpdate();
statement.close();
}
catch (Exception e)
{
_log.log(Level.WARNING, "could not delete player's global quest variable: " + e.getMessage(), e);
}
finally
{
L2DatabaseFactory.close(con);
}
}
/**
* Return the value of the variable of quest represented by "var"
* @param var : name of the variable of quest
* @return String
*/
public String get(String var)
{
if (_vars == null)
return null;
return _vars.get(var);
}
/**
* Return the value of the variable of quest represented by "var"
* @param var : String designating the variable for the quest
* @return int
*/
public int getInt(String var)
{
if (_vars == null)
return 0;
final String variable = _vars.get(var);
if (variable == null || variable.length() == 0)
return 0;
int varint = 0;
try
{
varint = Integer.parseInt(variable);
}
catch (Exception e)
{
_log.log(Level.FINER, getPlayer().getName() + ": variable " + var + " isn't an integer: " + varint + " ! " + e.getMessage(), e);
// if (Config.AUTODELETE_INVALID_QUEST_DATA)
// exitQuest(true);
}
return varint;
}
/**
* Add player to get notification of characters death
* @param character : L2Character of the character to get notification of death
*/
public void addNotifyOfDeath(L2Character character)
{
if (character == null || !(character instanceof L2PcInstance))
return;
((L2PcInstance)character).addNotifyQuestOfDeath(this);
}
/**
* Return the quantity of one sort of item hold by the player
* @param itemId : ID of the item wanted to be count
* @return long
*/
public long getQuestItemsCount(int itemId)
{
long count = 0;
for (L2ItemInstance item : getPlayer().getInventory().getItems())
if (item != null && item.getItemId() == itemId)
count += item.getCount();
return count;
}
/**
* @param int : ID of the item you're looking for
* @return true if item exists in player's inventory, false - if not
*/
public boolean hasQuestItems(int itemId)
{
return getPlayer().getInventory().getItemByItemId(itemId) != null;
}
/**
* Return the level of enchantment on the weapon of the player(Done specifically for weapon SA's)
* @param itemId : ID of the item to check enchantment
* @return int
*/
public int getEnchantLevel(int itemId)
{
L2ItemInstance enchanteditem = getPlayer().getInventory().getItemByItemId(itemId);
if (enchanteditem == null)
return 0;
return enchanteditem.getEnchantLevel();
}
/**
* Give adena to the player
* @param count
* @param applyRates
*/
public void giveAdena(long count, boolean applyRates)
{
giveItems(57, count, applyRates ? 0 : 1);
}
/**
* Give reward to player using multiplier's
* @param itemId
* @param count
*/
public void rewardItems(int itemId, long count)
{
if (count <= 0)
return;
L2ItemInstance _tmpItem = ItemTable.getInstance().createDummyItem(itemId);
if (_tmpItem == null)
return;
if (itemId == 57)
{
count = (long) (count * Config.RATE_QUEST_REWARD_ADENA);
}
else if (Config.RATE_QUEST_REWARD_USE_MULTIPLIERS)
{
if(_tmpItem.isEtcItem())
{
L2EtcItemType _type = _tmpItem.getEtcItem().getItemType();
if (_type == L2EtcItemType.POTION)
count = (long) (count * Config.RATE_QUEST_REWARD_POTION);
else if (_type == L2EtcItemType.SCROLL)
count = (long) (count * Config.RATE_QUEST_REWARD_SCROLL);
else if (_type == L2EtcItemType.RECEIPE)
count = (long) (count * Config.RATE_QUEST_REWARD_RECIPE);
else if (_type == L2EtcItemType.MATERIAL)
count = (long) (count * Config.RATE_QUEST_REWARD_MATERIAL);
else
count = (long) (count * Config.RATE_QUEST_REWARD);
}
}
else
{
count = (long) (count * Config.RATE_QUEST_REWARD);
}
// Add items to player's inventory
L2ItemInstance item = getPlayer().getInventory().addItem("Quest", itemId, count, getPlayer(), getPlayer().getTarget());
if (item == null)
return;
// If item for reward is gold, send message of gold reward to client
if (itemId == 57)
{
SystemMessage smsg = new SystemMessage(SystemMessageId.EARNED_ADENA);
smsg.addItemNumber(count);
getPlayer().sendPacket(smsg);
}
// Otherwise, send message of object reward to client
else
{
if (count > 1)
{
SystemMessage smsg = new SystemMessage(SystemMessageId.EARNED_S2_S1_S);
smsg.addItemName(item);
smsg.addItemNumber(count);
getPlayer().sendPacket(smsg);
}
else
{
SystemMessage smsg = new SystemMessage(SystemMessageId.EARNED_ITEM);
smsg.addItemName(item);
getPlayer().sendPacket(smsg);
}
}
// send packets
StatusUpdate su = new StatusUpdate(getPlayer());
su.addAttribute(StatusUpdate.CUR_LOAD, getPlayer().getCurrentLoad());
getPlayer().sendPacket(su);
}
/**
* Give item/reward to the player
* @param itemId
* @param count
*/
public void giveItems(int itemId, long count)
{
giveItems(itemId, count, 0);
}
public void giveItems(int itemId, long count, int enchantlevel)
{
if (count <= 0)
return;
// If item for reward is adena (ID=57), modify count with rate for quest reward if rates available
if (itemId == 57 && !(enchantlevel > 0))
count = (long) (count * Config.RATE_QUEST_REWARD_ADENA);
// Add items to player's inventory
L2ItemInstance item = getPlayer().getInventory().addItem("Quest", itemId, count, getPlayer(), getPlayer().getTarget());
if (item == null)
return;
// set enchant level for item if that item is not adena
if (enchantlevel > 0 && itemId != 57)
item.setEnchantLevel(enchantlevel);
// If item for reward is gold, send message of gold reward to client
if (itemId == 57)
{
SystemMessage smsg = new SystemMessage(SystemMessageId.EARNED_ADENA);
smsg.addItemNumber(count);
getPlayer().sendPacket(smsg);
}
// Otherwise, send message of object reward to client
else
{
if (count > 1)
{
SystemMessage smsg = new SystemMessage(SystemMessageId.EARNED_S2_S1_S);
smsg.addItemName(item);
smsg.addItemNumber(count);
getPlayer().sendPacket(smsg);
}
else
{
SystemMessage smsg = new SystemMessage(SystemMessageId.EARNED_ITEM);
smsg.addItemName(item);
getPlayer().sendPacket(smsg);
}
}
// send packets
StatusUpdate su = new StatusUpdate(getPlayer());
su.addAttribute(StatusUpdate.CUR_LOAD, getPlayer().getCurrentLoad());
getPlayer().sendPacket(su);
}
public void giveItems(int itemId, long count, byte attributeId, int attributeLevel)
{
if (count <= 0)
return;
// Add items to player's inventory
L2ItemInstance item = getPlayer().getInventory().addItem("Quest", itemId, count, getPlayer(), getPlayer().getTarget());
if (item == null)
return;
// set enchant level for item if that item is not adena
if (attributeId >= 0 && attributeLevel > 0)
{
item.setElementAttr(attributeId, attributeLevel);
if (item.isEquipped())
item.updateElementAttrBonus(getPlayer());
InventoryUpdate iu = new InventoryUpdate();
iu.addModifiedItem(item);
getPlayer().sendPacket(iu);
}
// If item for reward is gold, send message of gold reward to client
if (itemId == 57)
{
SystemMessage smsg = new SystemMessage(SystemMessageId.EARNED_ADENA);
smsg.addItemNumber(count);
getPlayer().sendPacket(smsg);
}
// Otherwise, send message of object reward to client
else
{
if (count > 1)
{
SystemMessage smsg = new SystemMessage(SystemMessageId.EARNED_S2_S1_S);
smsg.addItemName(item);
smsg.addItemNumber(count);
getPlayer().sendPacket(smsg);
}
else
{
SystemMessage smsg = new SystemMessage(SystemMessageId.EARNED_ITEM);
smsg.addItemName(item);
getPlayer().sendPacket(smsg);
}
}
// send packets
StatusUpdate su = new StatusUpdate(getPlayer());
su.addAttribute(StatusUpdate.CUR_LOAD, getPlayer().getCurrentLoad());
getPlayer().sendPacket(su);
}
/**
* Drop Quest item using Config.RATE_QUEST_DROP
* @param itemId : int Item Identifier of the item to be dropped
* @param count(minCount, maxCount) : long Quantity of items to be dropped
* @param neededCount : Quantity of items needed for quest
* @param dropChance : int Base chance of drop, same as in droplist
* @param sound : boolean indicating whether to play sound
* @return boolean indicating whether player has requested number of items
*/
public boolean dropQuestItems(int itemId, int count, long neededCount, int dropChance, boolean sound)
{
return dropQuestItems(itemId, count, count, neededCount, dropChance, sound);
}
public boolean dropQuestItems(int itemId, int minCount, int maxCount, long neededCount, int dropChance, boolean sound)
{
dropChance *= Config.RATE_QUEST_DROP / ((getPlayer().getParty() != null) ? getPlayer().getParty().getMemberCount() : 1);
long currentCount = getQuestItemsCount(itemId);
if (neededCount > 0 && currentCount >= neededCount)
return true;
if (currentCount >= neededCount)
return true;
long itemCount = 0;
int random = Rnd.get(L2DropData.MAX_CHANCE);
while (random < dropChance)
{
// Get the item quantity dropped
if (minCount < maxCount)
itemCount += Rnd.get(minCount, maxCount);
else if (minCount == maxCount)
itemCount += minCount;
else
itemCount++;
// Prepare for next iteration if dropChance > L2DropData.MAX_CHANCE
dropChance -= L2DropData.MAX_CHANCE;
}
if (itemCount > 0)
{
// if over neededCount, just fill the gap
if (neededCount > 0 && currentCount + itemCount > neededCount)
itemCount = neededCount - currentCount;
// Inventory slot check
if (!getPlayer().getInventory().validateCapacityByItemId(itemId))
return false;
// Give the item to Player
getPlayer().addItem("Quest", itemId, itemCount, getPlayer().getTarget(), true);
if (sound)
playSound((currentCount + itemCount < neededCount) ? "Itemsound.quest_itemget" : "Itemsound.quest_middle");
}
return (neededCount > 0 && currentCount + itemCount >= neededCount);
}
//TODO: More radar functions need to be added when the radar class is complete.
// BEGIN STUFF THAT WILL PROBABLY BE CHANGED
public void addRadar(int x, int y, int z)
{
getPlayer().getRadar().addMarker(x, y, z);
}
public void removeRadar(int x, int y, int z)
{
getPlayer().getRadar().removeMarker(x, y, z);
}
public void clearRadar()
{
getPlayer().getRadar().removeAllMarkers();
}
// END STUFF THAT WILL PROBABLY BE CHANGED
/**
* Remove items from player's inventory when talking to NPC in order to have rewards.
* Actions :
* Destroy quantity of items wanted
* Send new inventory list to player
* @param itemId : Identifier of the item
* @param count : Quantity of items to destroy
*/
public void takeItems(int itemId, long count)
{
// Get object item from player's inventory list
L2ItemInstance item = getPlayer().getInventory().getItemByItemId(itemId);
if (item == null)
return;
// Tests on count value in order not to have negative value
if (count < 0 || count > item.getCount())
count = item.getCount();
// Destroy the quantity of items wanted
if (item.isEquipped())
{
L2ItemInstance[] unequiped = getPlayer().getInventory().unEquipItemInBodySlotAndRecord(item.getItem().getBodyPart());
InventoryUpdate iu = new InventoryUpdate();
for (L2ItemInstance itm: unequiped)
iu.addModifiedItem(itm);
getPlayer().sendPacket(iu);
getPlayer().broadcastUserInfo();
}
getPlayer().destroyItemByItemId("Quest", itemId, count, getPlayer(), true);
}
/**
* Send a packet in order to play sound at client terminal
* @param sound
*/
public void playSound(String sound)
{
getPlayer().sendPacket(new PlaySound(sound));
}
/**
* Add XP and SP as quest reward
* @param exp
* @param sp
*/
public void addExpAndSp(int exp, int sp)
{
getPlayer().addExpAndSp((int) getPlayer().calcStat(Stats.EXPSP_RATE, exp * Config.RATE_QUEST_REWARD_XP, null, null), (int) getPlayer().calcStat(Stats.EXPSP_RATE, sp * Config.RATE_QUEST_REWARD_SP, null, null));
}
/**
* Return random value
* @param max : max value for randomisation
* @return int
*/
public int getRandom(int max)
{
return Rnd.get(max);
}
/**
* Return number of ticks from GameTimeController
* @return int
*/
public int getItemEquipped(int loc)
{
return getPlayer().getInventory().getPaperdollItemId(loc);
}
/**
* Return the number of ticks from the GameTimeController
* @return int
*/
public int getGameTicks()
{
return GameTimeController.getGameTicks();
}
/**
* Return true if quest is to exited on clean up by QuestStateManager
* @return boolean
*/
public final boolean isExitQuestOnCleanUp()
{
return _isExitQuestOnCleanUp;
}
/**
* Return the QuestTimer object with the specified name
* @return QuestTimer
Return null if name does not exist
*/
public void setIsExitQuestOnCleanUp(boolean isExitQuestOnCleanUp)
{
_isExitQuestOnCleanUp = isExitQuestOnCleanUp;
}
/**
* Start a timer for quest.
* @param name
The name of the timer. Will also be the value for event of onEvent
* @param time
The milisecond value the timer will elapse
*/
public void startQuestTimer(String name, long time)
{
getQuest().startQuestTimer(name, time, null, getPlayer(), false);
}
public void startQuestTimer(String name, long time, L2Npc npc)
{
getQuest().startQuestTimer(name, time, npc, getPlayer(), false);
}
public void startRepeatingQuestTimer(String name, long time)
{
getQuest().startQuestTimer(name, time, null, getPlayer(), true);
}
public void startRepeatingQuestTimer(String name, long time, L2Npc npc)
{
getQuest().startQuestTimer(name, time, npc, getPlayer(), true);
}
/**
* Return the QuestTimer object with the specified name
* @return QuestTimer
Return null if name does not exist
*/
public final QuestTimer getQuestTimer(String name)
{
return getQuest().getQuestTimer(name, null, getPlayer());
}
/**
* Add spawn for player instance
* Return object id of newly spawned npc
*/
public L2Npc addSpawn(int npcId)
{
return addSpawn(npcId, getPlayer().getX(), getPlayer().getY(), getPlayer().getZ(), 0, false, 0);
}
public L2Npc addSpawn(int npcId, int despawnDelay)
{
return addSpawn(npcId, getPlayer().getX(), getPlayer().getY(), getPlayer().getZ(), 0, false, despawnDelay);
}
public L2Npc addSpawn(int npcId, int x, int y, int z)
{
return addSpawn(npcId, x, y, z, 0, false, 0);
}
/**
* Add spawn for player instance
* Will despawn after the spawn length expires
* Uses player's coords and heading.
* Adds a little randomization in the x y coords
* Return object id of newly spawned npc
*/
public L2Npc addSpawn(int npcId, L2Character cha)
{
return addSpawn(npcId, cha, true, 0);
}
public L2Npc addSpawn(int npcId, L2Character cha, int despawnDelay)
{
return addSpawn(npcId, cha.getX(), cha.getY(), cha.getZ(), cha.getHeading(), true, despawnDelay);
}
/**
* Add spawn for player instance
* Will despawn after the spawn length expires
* Return object id of newly spawned npc
*/
public L2Npc addSpawn(int npcId, int x, int y, int z, int despawnDelay)
{
return addSpawn(npcId, x, y, z, 0, false, despawnDelay);
}
/**
* Add spawn for player instance
* Inherits coords and heading from specified L2Character instance.
* It could be either the player, or any killed/attacked mob
* Return object id of newly spawned npc
*/
public L2Npc addSpawn(int npcId, L2Character cha, boolean randomOffset, int despawnDelay)
{
return addSpawn(npcId, cha.getX(), cha.getY(), cha.getZ(), cha.getHeading(), randomOffset, despawnDelay);
}
/**
* Add spawn for player instance
* Return object id of newly spawned npc
*/
public L2Npc addSpawn(int npcId, int x, int y, int z, int heading, boolean randomOffset, int despawnDelay)
{
return getQuest().addSpawn(npcId, x, y, z, heading, randomOffset, despawnDelay, false);
}
/**
* Add spawn for player instance
* Return object id of newly spawned npc
*/
public L2Npc addSpawn(int npcId, int x, int y, int z, int heading, boolean randomOffset, int despawnDelay, boolean isSummonSpawn)
{
return getQuest().addSpawn(npcId, x, y, z, heading, randomOffset, despawnDelay, isSummonSpawn);
}
public String showHtmlFile(String fileName)
{
return getQuest().showHtmlFile(getPlayer(), fileName);
}
/**
* Destroy element used by quest when quest is exited
* @param repeatable
* @return QuestState
*/
public QuestState exitQuest(boolean repeatable)
{
// remove this quest from the notifyDeath list of this character if its on this list
_player.removeNotifyQuestOfDeath(this);
if (isCompleted() || isCreated())
return this;
// Say quest is completed
setState(State.COMPLETED);
// Clean registered quest items
int[] itemIdList = getQuest().getRegisteredItemIds();
if (itemIdList != null)
{
for (int i = 0; i < itemIdList.length; i++)
takeItems(itemIdList[i], -1);
}
// If quest is repeatable, delete quest from list of quest of the player and from database (quest CAN be created again => repeatable)
if (repeatable)
{
getPlayer().delQuestState(getQuestName());
Quest.deleteQuestInDb(this);
_vars = null;
}
else
{
// Otherwise, delete variables for quest and update database (quest CANNOT be created again => not repeatable)
if (_vars != null)
{
for (String var : _vars.keySet())
unset(var);
}
Quest.updateQuestInDb(this);
}
return this;
}
public void showQuestionMark(int number)
{
getPlayer().sendPacket(new TutorialShowQuestionMark(number));
}
public void playTutorialVoice(String voice)
{
getPlayer().sendPacket(new PlaySound(2, voice, 0, 0, getPlayer().getX(), getPlayer().getY(), getPlayer().getZ()));
}
public void showTutorialHTML(String html)
{
String text = HtmCache.getInstance().getHtm(getPlayer().getHtmlPrefix(), "data/scripts/quests/255_Tutorial/" + html);
if (text == null)
{
_log.warning("missing html page data/scripts/quests/255_Tutorial/" + html);
text = "File data/scripts/quests/255_Tutorial/" + html + " not found or file is empty.";
}
getPlayer().sendPacket(new TutorialShowHtml(text));
}
public void closeTutorialHtml()
{
getPlayer().sendPacket(new TutorialCloseHtml());
}
public void onTutorialClientEvent(int number)
{
getPlayer().sendPacket(new TutorialEnableClientEvent(number));
}
public void dropItem(L2MonsterInstance npc, L2PcInstance player, int itemId, int count)
{
npc.dropItem(player, itemId, count);
}
}