|
@@ -0,0 +1,2458 @@
|
|
|
|
+/*
|
|
|
|
+ * Copyright (C) 2004-2014 L2J Server
|
|
|
|
+ *
|
|
|
|
+ * This file is part of L2J Server.
|
|
|
|
+ *
|
|
|
|
+ * L2J Server 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.
|
|
|
|
+ *
|
|
|
|
+ * L2J Server 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 <http://www.gnu.org/licenses/>.
|
|
|
|
+ */
|
|
|
|
+package com.l2jserver.gameserver.model.events;
|
|
|
|
+
|
|
|
|
+import java.lang.annotation.Annotation;
|
|
|
|
+import java.lang.reflect.Method;
|
|
|
|
+import java.util.ArrayList;
|
|
|
|
+import java.util.Arrays;
|
|
|
|
+import java.util.Collection;
|
|
|
|
+import java.util.Collections;
|
|
|
|
+import java.util.List;
|
|
|
|
+import java.util.Map;
|
|
|
|
+import java.util.concurrent.ConcurrentHashMap;
|
|
|
|
+import java.util.function.Consumer;
|
|
|
|
+import java.util.function.Function;
|
|
|
|
+import java.util.logging.Level;
|
|
|
|
+import java.util.logging.Logger;
|
|
|
|
+
|
|
|
|
+import javolution.util.FastList;
|
|
|
|
+
|
|
|
|
+import com.l2jserver.Config;
|
|
|
|
+import com.l2jserver.gameserver.GameTimeController;
|
|
|
|
+import com.l2jserver.gameserver.datatables.DoorTable;
|
|
|
|
+import com.l2jserver.gameserver.datatables.ItemTable;
|
|
|
|
+import com.l2jserver.gameserver.datatables.NpcData;
|
|
|
|
+import com.l2jserver.gameserver.enums.QuestSound;
|
|
|
|
+import com.l2jserver.gameserver.idfactory.IdFactory;
|
|
|
|
+import com.l2jserver.gameserver.instancemanager.CastleManager;
|
|
|
|
+import com.l2jserver.gameserver.instancemanager.FortManager;
|
|
|
|
+import com.l2jserver.gameserver.instancemanager.InstanceManager;
|
|
|
|
+import com.l2jserver.gameserver.instancemanager.ZoneManager;
|
|
|
|
+import com.l2jserver.gameserver.model.L2Spawn;
|
|
|
|
+import com.l2jserver.gameserver.model.Location;
|
|
|
|
+import com.l2jserver.gameserver.model.actor.L2Attackable;
|
|
|
|
+import com.l2jserver.gameserver.model.actor.L2Character;
|
|
|
|
+import com.l2jserver.gameserver.model.actor.L2Npc;
|
|
|
|
+import com.l2jserver.gameserver.model.actor.instance.L2DoorInstance;
|
|
|
|
+import com.l2jserver.gameserver.model.actor.instance.L2MonsterInstance;
|
|
|
|
+import com.l2jserver.gameserver.model.actor.instance.L2PcInstance;
|
|
|
|
+import com.l2jserver.gameserver.model.actor.instance.L2TrapInstance;
|
|
|
|
+import com.l2jserver.gameserver.model.actor.templates.L2NpcTemplate;
|
|
|
|
+import com.l2jserver.gameserver.model.entity.Castle;
|
|
|
|
+import com.l2jserver.gameserver.model.entity.Fort;
|
|
|
|
+import com.l2jserver.gameserver.model.entity.Instance;
|
|
|
|
+import com.l2jserver.gameserver.model.events.annotations.Npc;
|
|
|
|
+import com.l2jserver.gameserver.model.events.annotations.Npcs;
|
|
|
|
+import com.l2jserver.gameserver.model.events.annotations.RegisterEvent;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.IBaseEvent;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.OnCreatureKill;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.OnCreatureZoneEnter;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.OnCreatureZoneExit;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.npc.OnNpcCanBeSeen;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.npc.OnNpcCreatureSee;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.npc.OnNpcEventReceived;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.npc.OnNpcFirstTalk;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.npc.OnNpcMoveFinished;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.npc.OnNpcMoveNodeArrived;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.npc.OnNpcMoveRouteFinished;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.npc.OnNpcSkillFinished;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.npc.OnNpcSkillSee;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.npc.OnNpcSpawn;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.npc.attackable.OnAttackableAggroRangeEnter;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.npc.attackable.OnAttackableAttack;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.npc.attackable.OnAttackableFactionCall;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.npc.attackable.OnAttackableHate;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.npc.attackable.OnAttackableKill;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.player.OnPlayerLogin;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.player.OnPlayerLogout;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.player.OnPlayerProfessionChange;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.player.OnPlayerSkillLearn;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.player.OnPlayerSummonSpawn;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.character.trap.OnTrapAction;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.item.OnItemBypassEvent;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.item.OnItemTalk;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.olympiad.OnOlympiadMatchResult;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.sieges.castle.OnCastleSiegeFinish;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.sieges.castle.OnCastleSiegeOwnerChange;
|
|
|
|
+import com.l2jserver.gameserver.model.events.impl.sieges.castle.OnCastleSiegeStart;
|
|
|
|
+import com.l2jserver.gameserver.model.events.listeners.AbstractEventListener;
|
|
|
|
+import com.l2jserver.gameserver.model.events.listeners.AnnotationEventListener;
|
|
|
|
+import com.l2jserver.gameserver.model.events.listeners.ConsumerEventListener;
|
|
|
|
+import com.l2jserver.gameserver.model.events.listeners.DummyEventListener;
|
|
|
|
+import com.l2jserver.gameserver.model.events.listeners.FunctionEventListener;
|
|
|
|
+import com.l2jserver.gameserver.model.events.listeners.RunnableEventListener;
|
|
|
|
+import com.l2jserver.gameserver.model.events.returns.AbstractEventReturn;
|
|
|
|
+import com.l2jserver.gameserver.model.events.returns.TerminateReturn;
|
|
|
|
+import com.l2jserver.gameserver.model.holders.ItemHolder;
|
|
|
|
+import com.l2jserver.gameserver.model.interfaces.IPositionable;
|
|
|
|
+import com.l2jserver.gameserver.model.itemcontainer.Inventory;
|
|
|
|
+import com.l2jserver.gameserver.model.itemcontainer.PcInventory;
|
|
|
|
+import com.l2jserver.gameserver.model.items.L2Item;
|
|
|
|
+import com.l2jserver.gameserver.model.items.instance.L2ItemInstance;
|
|
|
|
+import com.l2jserver.gameserver.model.olympiad.Olympiad;
|
|
|
|
+import com.l2jserver.gameserver.model.skills.Skill;
|
|
|
|
+import com.l2jserver.gameserver.model.stats.Stats;
|
|
|
|
+import com.l2jserver.gameserver.model.zone.L2ZoneType;
|
|
|
|
+import com.l2jserver.gameserver.network.NpcStringId;
|
|
|
|
+import com.l2jserver.gameserver.network.SystemMessageId;
|
|
|
|
+import com.l2jserver.gameserver.network.serverpackets.ExShowScreenMessage;
|
|
|
|
+import com.l2jserver.gameserver.network.serverpackets.InventoryUpdate;
|
|
|
|
+import com.l2jserver.gameserver.network.serverpackets.SpecialCamera;
|
|
|
|
+import com.l2jserver.gameserver.network.serverpackets.StatusUpdate;
|
|
|
|
+import com.l2jserver.gameserver.network.serverpackets.SystemMessage;
|
|
|
|
+import com.l2jserver.gameserver.scripting.ManagedScript;
|
|
|
|
+import com.l2jserver.gameserver.util.MinionList;
|
|
|
|
+import com.l2jserver.util.Rnd;
|
|
|
|
+
|
|
|
|
+/**
|
|
|
|
+ * @author UnAfraid
|
|
|
|
+ */
|
|
|
|
+public abstract class AbstractScript extends ManagedScript
|
|
|
|
+{
|
|
|
|
+ protected static final Logger _log = Logger.getLogger(AbstractScript.class.getName());
|
|
|
|
+ private final Map<ListenerRegisterType, List<Integer>> _registeredIds = new ConcurrentHashMap<>();
|
|
|
|
+ private final List<AbstractEventListener> _listeners = new FastList<AbstractEventListener>().shared();
|
|
|
|
+
|
|
|
|
+ public AbstractScript()
|
|
|
|
+ {
|
|
|
|
+ initializeAnnotationListeners();
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ private void initializeAnnotationListeners()
|
|
|
|
+ {
|
|
|
|
+ final List<Integer> npcIds = new ArrayList<>();
|
|
|
|
+ for (Method method : getClass().getMethods())
|
|
|
|
+ {
|
|
|
|
+ if (method.isAnnotationPresent(RegisterEvent.class))
|
|
|
|
+ {
|
|
|
|
+ final RegisterEvent listener = method.getAnnotation(RegisterEvent.class);
|
|
|
|
+ final EventType eventType = listener.value();
|
|
|
|
+ if (method.getParameterCount() != 1)
|
|
|
|
+ {
|
|
|
|
+ _log.log(Level.WARNING, getClass().getSimpleName() + ": Non properly defined annotation listener on method: " + method.getName() + " expected parameter count is 1 but found: " + method.getParameterCount());
|
|
|
|
+ continue;
|
|
|
|
+ }
|
|
|
|
+ else if (!eventType.isEventClass(method.getParameterTypes()[0]))
|
|
|
|
+ {
|
|
|
|
+ _log.log(Level.WARNING, getClass().getSimpleName() + ": Non properly defined annotation listener on method: " + method.getName() + " expected parameter to be type of: " + eventType.getEventClass().getSimpleName() + " but found: " + method.getParameterTypes()[0].getSimpleName());
|
|
|
|
+ continue;
|
|
|
|
+ }
|
|
|
|
+ else if (!eventType.isReturnClass(method.getReturnType()))
|
|
|
|
+ {
|
|
|
|
+ _log.log(Level.WARNING, getClass().getSimpleName() + ": Non properly defined annotation listener on method: " + method.getName() + " expected return type to be one of: " + Arrays.toString(eventType.getReturnClasses()) + " but found: " + method.getReturnType().getSimpleName());
|
|
|
|
+ continue;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // Clear the list
|
|
|
|
+ npcIds.clear();
|
|
|
|
+
|
|
|
|
+ // Scan for possible Npc ID filters
|
|
|
|
+ for (Annotation annotation : method.getAnnotations())
|
|
|
|
+ {
|
|
|
|
+ if (annotation instanceof Npc)
|
|
|
|
+ {
|
|
|
|
+ final Npc npc = (Npc) annotation;
|
|
|
|
+ for (int id : npc.value())
|
|
|
|
+ {
|
|
|
|
+ npcIds.add(id);
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ else if (annotation instanceof Npcs)
|
|
|
|
+ {
|
|
|
|
+ final Npcs npcs = (Npcs) annotation;
|
|
|
|
+ for (Npc npc : npcs.value())
|
|
|
|
+ {
|
|
|
|
+ for (int id : npc.value())
|
|
|
|
+ {
|
|
|
|
+ npcIds.add(id);
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ if (!npcIds.isEmpty())
|
|
|
|
+ {
|
|
|
|
+ if (!_registeredIds.containsKey(ListenerRegisterType.NPC))
|
|
|
|
+ {
|
|
|
|
+ _registeredIds.put(ListenerRegisterType.NPC, new FastList<Integer>().shared());
|
|
|
|
+ }
|
|
|
|
+ _registeredIds.get(ListenerRegisterType.NPC).addAll(npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ registerAnnotation(method, eventType, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Unloads all listeners registered by this class.
|
|
|
|
+ */
|
|
|
|
+ @Override
|
|
|
|
+ public boolean unload()
|
|
|
|
+ {
|
|
|
|
+ _listeners.forEach(AbstractEventListener::unregisterMe);
|
|
|
|
+ _listeners.clear();
|
|
|
|
+ return true;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides delayed (Depending on {@link com.l2jserver.gameserver.model.actor.L2Attackable#getOnKillDelay()}) callback operation when L2Attackable dies from a player.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setAttackableKillId(Consumer<OnAttackableKill> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_ATTACKABLE_KILL, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides delayed (Depending on {@link com.l2jserver.gameserver.model.actor.L2Attackable#getOnKillDelay()}) callback operation when L2Attackable dies from a player.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setAttackableKillId(Consumer<OnAttackableKill> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_ATTACKABLE_KILL, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when L2Attackable dies from a player with return type.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> addCreatureKillId(Function<OnCreatureKill, ? extends AbstractEventReturn> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerFunction(callback, EventType.ON_CREATURE_KILL, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when L2Attackable dies from a player.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setCreatureKillId(Consumer<OnCreatureKill> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_CREATURE_KILL, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2Attackable} dies from a {@link L2PcInstance}.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setCreatureKillId(Consumer<OnCreatureKill> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_CREATURE_KILL, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2PcInstance} talk to {@link L2Npc} for first time.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcFirstTalkId(Consumer<OnNpcFirstTalk> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_NPC_FIRST_TALK, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2PcInstance} talk to {@link L2Npc} for first time.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcFirstTalkId(Consumer<OnNpcFirstTalk> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_NPC_FIRST_TALK, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2PcInstance} talk to {@link L2Npc}.
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcTalkId(Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerDummy(EventType.ON_NPC_TALK, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2PcInstance} talk to {@link L2Npc}.
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcTalkId(int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerDummy(EventType.ON_NPC_TALK, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2PcInstance} talk to {@link L2Npc} and must receive quest state.
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcQuestStartId(int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerDummy(EventType.ON_NPC_QUEST_START, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2PcInstance} talk to {@link L2Npc} and must receive quest state.
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcQuestStartId(Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerDummy(EventType.ON_NPC_QUEST_START, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when L2Npc sees skill from a player.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcSkillSeeId(Consumer<OnNpcSkillSee> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_NPC_SKILL_SEE, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when L2Npc sees skill from a player.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcSkillSeeId(Consumer<OnNpcSkillSee> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_NPC_SKILL_SEE, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when L2Npc casts skill on a player.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcSkillFinishedId(Consumer<OnNpcSkillFinished> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_NPC_SKILL_FINISHED, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when L2Npc casts skill on a player.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcSkillFinishedId(Consumer<OnNpcSkillFinished> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_NPC_SKILL_FINISHED, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when L2Npc is spawned.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcSpawnId(Consumer<OnNpcSpawn> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_NPC_SPAWN, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when L2Npc is spawned.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcSpawnId(Consumer<OnNpcSpawn> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_NPC_SPAWN, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2Npc} receives event from another {@link L2Npc}
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcEventReceivedId(Consumer<OnNpcEventReceived> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_NPC_EVENT_RECEIVED, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2Npc} receives event from another {@link L2Npc}
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcEventReceivedId(Consumer<OnNpcEventReceived> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_NPC_EVENT_RECEIVED, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2Npc} finishes to move.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcMoveFinishedId(Consumer<OnNpcMoveFinished> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_NPC_MOVE_FINISHED, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2Npc} finishes to move.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcMoveFinishedId(Consumer<OnNpcMoveFinished> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_NPC_MOVE_FINISHED, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2Npc} arrive to node of its route
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcMoveNodeArrivedId(Consumer<OnNpcMoveNodeArrived> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_NPC_MOVE_NODE_ARRIVED, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2Npc} arrive to node of its route
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcMoveNodeArrivedId(Consumer<OnNpcMoveNodeArrived> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_NPC_MOVE_NODE_ARRIVED, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2Npc} finishes to move on its route.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcMoveRouteFinishedId(Consumer<OnNpcMoveRouteFinished> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_NPC_MOVE_ROUTE_FINISHED, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2Npc} finishes to move on its route.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcMoveRouteFinishedId(Consumer<OnNpcMoveRouteFinished> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_NPC_MOVE_ROUTE_FINISHED, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2Npc} is about to hate and start attacking a creature.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcHateId(Consumer<OnAttackableHate> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_NPC_HATE, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2Npc} is about to hate and start attacking a creature.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcHateId(Consumer<OnAttackableHate> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_NPC_HATE, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2Npc} is about to hate and start attacking a creature.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> addNpcHateId(Function<OnAttackableHate, TerminateReturn> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerFunction(callback, EventType.ON_NPC_HATE, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2Npc} is about to hate and start attacking a creature.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> addNpcHateId(Function<OnAttackableHate, TerminateReturn> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerFunction(callback, EventType.ON_NPC_HATE, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2Npc} is about to hate and start attacking a creature.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcCanBeSeenId(Consumer<OnNpcCanBeSeen> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_NPC_CAN_BE_SEEN, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2Npc} is about to hate and start attacking a creature.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcCanBeSeenId(Consumer<OnNpcCanBeSeen> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_NPC_CAN_BE_SEEN, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2Npc} is about to hate and start attacking a creature.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcCanBeSeenId(Function<OnNpcCanBeSeen, TerminateReturn> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerFunction(callback, EventType.ON_NPC_CAN_BE_SEEN, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2Npc} is about to hate and start attacking a creature.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcCanBeSeenId(Function<OnNpcCanBeSeen, TerminateReturn> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerFunction(callback, EventType.ON_NPC_CAN_BE_SEEN, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2Npc} sees another creature.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcCreatureSeeId(Consumer<OnNpcCreatureSee> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_NPC_CREATURE_SEE, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2Npc} sees another creature.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setNpcCreatureSeeId(Consumer<OnNpcCreatureSee> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_NPC_CREATURE_SEE, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when L2Attackable is under attack to other clan mates.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setAttackableFactionIdId(Consumer<OnAttackableFactionCall> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_ATTACKABLE_FACTION_CALL, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when L2Attackable is under attack to other clan mates.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setAttackableFactionIdId(Consumer<OnAttackableFactionCall> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_ATTACKABLE_FACTION_CALL, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when L2Attackable is attacked from a player.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setAttackableAttackId(Consumer<OnAttackableAttack> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_ATTACKABLE_ATTACK, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when L2Attackable is attacked from a player.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setAttackableAttackId(Consumer<OnAttackableAttack> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_ATTACKABLE_ATTACK, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2PcInstance} enters in {@link L2Attackable}'s aggressive range.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setAttackableAggroRangeEnterId(Consumer<OnAttackableAggroRangeEnter> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_ATTACKABLE_AGGRO_RANGE_ENTER, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2PcInstance} enters in {@link L2Attackable}'s aggressive range.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setAttackableAggroRangeEnterId(Consumer<OnAttackableAggroRangeEnter> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_ATTACKABLE_AGGRO_RANGE_ENTER, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2PcInstance} learn's a {@link Skill}.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setPlayerSkillLearnId(Consumer<OnPlayerSkillLearn> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_PLAYER_SKILL_LEARN, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2PcInstance} learn's a {@link Skill}.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setPlayerSkillLearnId(Consumer<OnPlayerSkillLearn> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_PLAYER_SKILL_LEARN, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2PcInstance} summons a servitor or a pet
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setPlayerSummonSpawnId(Consumer<OnPlayerSummonSpawn> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_PLAYER_SUMMON_SPAWN, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2PcInstance} summons a servitor or a pet
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setPlayerSummonSpawnId(Consumer<OnPlayerSummonSpawn> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_PLAYER_SUMMON_SPAWN, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2PcInstance} summons a servitor or a pet
|
|
|
|
+ * @param callback
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setPlayerLoginId(Consumer<OnPlayerLogin> callback)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_PLAYER_LOGIN, ListenerRegisterType.GLOBAL);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2PcInstance} summons a servitor or a pet
|
|
|
|
+ * @param callback
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setPlayerLogoutId(Consumer<OnPlayerLogout> callback)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_PLAYER_LOGOUT, ListenerRegisterType.GLOBAL);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link com.l2jserver.gameserver.model.actor.L2Character} Enters on a {@link L2ZoneType}.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setCreatureZoneEnterId(Consumer<OnCreatureZoneEnter> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_CREATURE_ZONE_ENTER, ListenerRegisterType.ZONE, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link com.l2jserver.gameserver.model.actor.L2Character} Enters on a {@link L2ZoneType}.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setCreatureZoneEnterId(Consumer<OnCreatureZoneEnter> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_CREATURE_ZONE_ENTER, ListenerRegisterType.ZONE, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link com.l2jserver.gameserver.model.actor.L2Character} Exits on a {@link L2ZoneType}.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setCreatureZoneExitId(Consumer<OnCreatureZoneExit> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_CREATURE_ZONE_EXIT, ListenerRegisterType.ZONE, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link com.l2jserver.gameserver.model.actor.L2Character} Exits on a {@link L2ZoneType}.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setCreatureZoneExitId(Consumer<OnCreatureZoneExit> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_CREATURE_ZONE_EXIT, ListenerRegisterType.ZONE, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link com.l2jserver.gameserver.model.actor.instance.L2TrapInstance} acts.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setTrapActionId(Consumer<OnTrapAction> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_TRAP_ACTION, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link com.l2jserver.gameserver.model.actor.instance.L2TrapInstance} acts.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setTrapActionId(Consumer<OnTrapAction> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_TRAP_ACTION, ListenerRegisterType.NPC, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2Item} receives an event from {@link L2PcInstance}.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setItemBypassEvenId(Consumer<OnItemBypassEvent> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_ITEM_BYPASS_EVENT, ListenerRegisterType.ITEM, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2Item} receives an event from {@link L2PcInstance}.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setItemBypassEvenId(Consumer<OnItemBypassEvent> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_ITEM_BYPASS_EVENT, ListenerRegisterType.ITEM, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2PcInstance} talk to {@link L2Item}.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setItemTalkId(Consumer<OnItemTalk> callback, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_ITEM_TALK, ListenerRegisterType.ITEM, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when {@link L2PcInstance} talk to {@link L2Item}.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setItemTalkId(Consumer<OnItemTalk> callback, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_ITEM_TALK, ListenerRegisterType.ITEM, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when Olympiad match finishes.
|
|
|
|
+ * @param callback
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setOlympiadMatchResult(Consumer<OnOlympiadMatchResult> callback)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_OLYMPIAD_MATCH_RESULT, ListenerRegisterType.OLYMPIAD);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when castle siege begins
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param castleIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setCastleSiegeStartId(Consumer<OnCastleSiegeStart> callback, int... castleIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_CASTLE_SIEGE_START, ListenerRegisterType.CASTLE, castleIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when castle siege begins
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param castleIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setCastleSiegeStartId(Consumer<OnCastleSiegeStart> callback, Collection<Integer> castleIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_CASTLE_SIEGE_START, ListenerRegisterType.CASTLE, castleIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when Castle owner has changed during a siege
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param castleIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setCastleSiegeOwnerChangeId(Consumer<OnCastleSiegeOwnerChange> callback, int... castleIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_CASTLE_SIEGE_OWNER_CHANGE, ListenerRegisterType.CASTLE, castleIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when Castle owner has changed during a siege
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param castleIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setCastleSiegeOwnerChangeId(Consumer<OnCastleSiegeOwnerChange> callback, Collection<Integer> castleIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_CASTLE_SIEGE_OWNER_CHANGE, ListenerRegisterType.CASTLE, castleIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when castle siege ends
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param castleIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setCastleSiegeFinishId(Consumer<OnCastleSiegeFinish> callback, int... castleIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_CASTLE_SIEGE_FINISH, ListenerRegisterType.CASTLE, castleIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when castle siege ends
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param castleIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setCastleSiegeFinishId(Consumer<OnCastleSiegeFinish> callback, Collection<Integer> castleIds)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_CASTLE_SIEGE_FINISH, ListenerRegisterType.CASTLE, castleIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // ---------------------------------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Provides instant callback operation when player's profession has change
|
|
|
|
+ * @param callback
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> setPlayerProfessionChangeId(Consumer<OnPlayerProfessionChange> callback)
|
|
|
|
+ {
|
|
|
|
+ return registerConsumer(callback, EventType.ON_PLAYER_PROFESSION_CHANGE, ListenerRegisterType.GLOBAL);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // --------------------------------------------------------------------------------------------------
|
|
|
|
+ // --------------------------------Default listener register methods---------------------------------
|
|
|
|
+ // --------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Method that registers Function type of listeners (Listeners that need parameters but doesn't return objects)
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param type
|
|
|
|
+ * @param registerType
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> registerConsumer(Consumer<? extends IBaseEvent> callback, EventType type, ListenerRegisterType registerType, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerListener((container) -> new ConsumerEventListener(container, type, callback, this), registerType, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Method that registers Function type of listeners (Listeners that need parameters but doesn't return objects)
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param type
|
|
|
|
+ * @param registerType
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> registerConsumer(Consumer<? extends IBaseEvent> callback, EventType type, ListenerRegisterType registerType, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerListener((container) -> new ConsumerEventListener(container, type, callback, this), registerType, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Method that registers Function type of listeners (Listeners that need parameters and return objects)
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param type
|
|
|
|
+ * @param registerType
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> registerFunction(Function<? extends IBaseEvent, ? extends AbstractEventReturn> callback, EventType type, ListenerRegisterType registerType, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerListener((container) -> new FunctionEventListener(container, type, callback, this), registerType, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Method that registers Function type of listeners (Listeners that need parameters and return objects)
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param type
|
|
|
|
+ * @param registerType
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> registerFunction(Function<? extends IBaseEvent, ? extends AbstractEventReturn> callback, EventType type, ListenerRegisterType registerType, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerListener((container) -> new FunctionEventListener(container, type, callback, this), registerType, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Method that registers runnable type of listeners (Listeners that doesn't needs parameters or return objects)
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param type
|
|
|
|
+ * @param registerType
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> registerRunnable(Runnable callback, EventType type, ListenerRegisterType registerType, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerListener((container) -> new RunnableEventListener(container, type, callback, this), registerType, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Method that registers runnable type of listeners (Listeners that doesn't needs parameters or return objects)
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param type
|
|
|
|
+ * @param registerType
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> registerRunnable(Runnable callback, EventType type, ListenerRegisterType registerType, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerListener((container) -> new RunnableEventListener(container, type, callback, this), registerType, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Method that registers runnable type of listeners (Listeners that doesn't needs parameters or return objects)
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param type
|
|
|
|
+ * @param registerType
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> registerAnnotation(Method callback, EventType type, ListenerRegisterType registerType, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerListener((container) -> new AnnotationEventListener(container, type, callback, this), registerType, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Method that registers runnable type of listeners (Listeners that doesn't needs parameters or return objects)
|
|
|
|
+ * @param callback
|
|
|
|
+ * @param type
|
|
|
|
+ * @param registerType
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> registerAnnotation(Method callback, EventType type, ListenerRegisterType registerType, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerListener((container) -> new AnnotationEventListener(container, type, callback, this), registerType, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Method that registers dummy type of listeners (Listeners doesn't gets notification but just used to check if their type present or not)
|
|
|
|
+ * @param type
|
|
|
|
+ * @param registerType
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> registerDummy(EventType type, ListenerRegisterType registerType, int... npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerListener((container) -> new DummyEventListener(container, type, this), registerType, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Method that registers dummy type of listeners (Listeners doesn't gets notification but just used to check if their type present or not)
|
|
|
|
+ * @param type
|
|
|
|
+ * @param registerType
|
|
|
|
+ * @param npcIds
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> registerDummy(EventType type, ListenerRegisterType registerType, Collection<Integer> npcIds)
|
|
|
|
+ {
|
|
|
|
+ return registerListener((container) -> new DummyEventListener(container, type, this), registerType, npcIds);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // --------------------------------------------------------------------------------------------------
|
|
|
|
+ // --------------------------------------Register methods--------------------------------------------
|
|
|
|
+ // --------------------------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Generic listener register method
|
|
|
|
+ * @param action
|
|
|
|
+ * @param registerType
|
|
|
|
+ * @param ids
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> registerListener(Function<ListenersContainer, AbstractEventListener> action, ListenerRegisterType registerType, int... ids)
|
|
|
|
+ {
|
|
|
|
+ final List<AbstractEventListener> listeners = new ArrayList<>(ids.length > 0 ? ids.length : 1);
|
|
|
|
+ if (ids.length > 0)
|
|
|
|
+ {
|
|
|
|
+ for (int id : ids)
|
|
|
|
+ {
|
|
|
|
+ switch (registerType)
|
|
|
|
+ {
|
|
|
|
+ case NPC:
|
|
|
|
+ {
|
|
|
|
+ final L2NpcTemplate template = NpcData.getInstance().getTemplate(id);
|
|
|
|
+ if (template != null)
|
|
|
|
+ {
|
|
|
|
+ listeners.add(template.addListener(action.apply(template)));
|
|
|
|
+ }
|
|
|
|
+ break;
|
|
|
|
+ }
|
|
|
|
+ case ZONE:
|
|
|
|
+ {
|
|
|
|
+ final L2ZoneType template = ZoneManager.getInstance().getZoneById(id);
|
|
|
|
+ if (template != null)
|
|
|
|
+ {
|
|
|
|
+ listeners.add(template.addListener(action.apply(template)));
|
|
|
|
+ }
|
|
|
|
+ break;
|
|
|
|
+ }
|
|
|
|
+ case ITEM:
|
|
|
|
+ {
|
|
|
|
+ final L2Item template = ItemTable.getInstance().getTemplate(id);
|
|
|
|
+ if (template != null)
|
|
|
|
+ {
|
|
|
|
+ listeners.add(template.addListener(action.apply(template)));
|
|
|
|
+ }
|
|
|
|
+ break;
|
|
|
|
+ }
|
|
|
|
+ case CASTLE:
|
|
|
|
+ {
|
|
|
|
+ final Castle template = CastleManager.getInstance().getCastleById(id);
|
|
|
|
+ if (template != null)
|
|
|
|
+ {
|
|
|
|
+ listeners.add(template.addListener(action.apply(template)));
|
|
|
|
+ }
|
|
|
|
+ break;
|
|
|
|
+ }
|
|
|
|
+ case FORTRESS:
|
|
|
|
+ {
|
|
|
|
+ final Fort template = FortManager.getInstance().getFortById(id);
|
|
|
|
+ if (template != null)
|
|
|
|
+ {
|
|
|
|
+ listeners.add(template.addListener(action.apply(template)));
|
|
|
|
+ }
|
|
|
|
+ break;
|
|
|
|
+ }
|
|
|
|
+ default:
|
|
|
|
+ {
|
|
|
|
+ _log.log(Level.WARNING, getClass().getSimpleName() + ": Unhandled register type: " + registerType);
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ if (!_registeredIds.containsKey(registerType))
|
|
|
|
+ {
|
|
|
|
+ _registeredIds.put(registerType, new FastList<Integer>().shared());
|
|
|
|
+ }
|
|
|
|
+ _registeredIds.get(registerType).add(id);
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ else
|
|
|
|
+ {
|
|
|
|
+ switch (registerType)
|
|
|
|
+ {
|
|
|
|
+ case OLYMPIAD:
|
|
|
|
+ {
|
|
|
|
+ final Olympiad template = Olympiad.getInstance();
|
|
|
|
+ listeners.add(template.addListener(action.apply(template)));
|
|
|
|
+ break;
|
|
|
|
+ }
|
|
|
|
+ default: // Global Listener
|
|
|
|
+ {
|
|
|
|
+ final EventDispatcher template = EventDispatcher.getInstance();
|
|
|
|
+ listeners.add(template.addListener(action.apply(template)));
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ _listeners.addAll(listeners);
|
|
|
|
+ return listeners;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Generic listener register method
|
|
|
|
+ * @param action
|
|
|
|
+ * @param registerType
|
|
|
|
+ * @param ids
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ protected final List<AbstractEventListener> registerListener(Function<ListenersContainer, AbstractEventListener> action, ListenerRegisterType registerType, Collection<Integer> ids)
|
|
|
|
+ {
|
|
|
|
+ final List<AbstractEventListener> listeners = new ArrayList<>(!ids.isEmpty() ? ids.size() : 1);
|
|
|
|
+ if (!ids.isEmpty())
|
|
|
|
+ {
|
|
|
|
+ for (int id : ids)
|
|
|
|
+ {
|
|
|
|
+ switch (registerType)
|
|
|
|
+ {
|
|
|
|
+ case NPC:
|
|
|
|
+ {
|
|
|
|
+ final L2NpcTemplate template = NpcData.getInstance().getTemplate(id);
|
|
|
|
+ if (template != null)
|
|
|
|
+ {
|
|
|
|
+ listeners.add(template.addListener(action.apply(template)));
|
|
|
|
+ }
|
|
|
|
+ break;
|
|
|
|
+ }
|
|
|
|
+ case ZONE:
|
|
|
|
+ {
|
|
|
|
+ final L2ZoneType template = ZoneManager.getInstance().getZoneById(id);
|
|
|
|
+ if (template != null)
|
|
|
|
+ {
|
|
|
|
+ listeners.add(template.addListener(action.apply(template)));
|
|
|
|
+ }
|
|
|
|
+ break;
|
|
|
|
+ }
|
|
|
|
+ case ITEM:
|
|
|
|
+ {
|
|
|
|
+ final L2Item template = ItemTable.getInstance().getTemplate(id);
|
|
|
|
+ if (template != null)
|
|
|
|
+ {
|
|
|
|
+ listeners.add(template.addListener(action.apply(template)));
|
|
|
|
+ }
|
|
|
|
+ break;
|
|
|
|
+ }
|
|
|
|
+ case CASTLE:
|
|
|
|
+ {
|
|
|
|
+ final Castle template = CastleManager.getInstance().getCastleById(id);
|
|
|
|
+ if (template != null)
|
|
|
|
+ {
|
|
|
|
+ listeners.add(template.addListener(action.apply(template)));
|
|
|
|
+ }
|
|
|
|
+ break;
|
|
|
|
+ }
|
|
|
|
+ case FORTRESS:
|
|
|
|
+ {
|
|
|
|
+ final Fort template = FortManager.getInstance().getFortById(id);
|
|
|
|
+ if (template != null)
|
|
|
|
+ {
|
|
|
|
+ listeners.add(template.addListener(action.apply(template)));
|
|
|
|
+ }
|
|
|
|
+ break;
|
|
|
|
+ }
|
|
|
|
+ default:
|
|
|
|
+ {
|
|
|
|
+ _log.log(Level.WARNING, getClass().getSimpleName() + ": Unhandled register type: " + registerType);
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ if (!_registeredIds.containsKey(registerType))
|
|
|
|
+ {
|
|
|
|
+ _registeredIds.put(registerType, new FastList<Integer>().shared());
|
|
|
|
+ }
|
|
|
|
+ _registeredIds.get(registerType).addAll(ids);
|
|
|
|
+ }
|
|
|
|
+ else
|
|
|
|
+ {
|
|
|
|
+ switch (registerType)
|
|
|
|
+ {
|
|
|
|
+ case OLYMPIAD:
|
|
|
|
+ {
|
|
|
|
+ final Olympiad template = Olympiad.getInstance();
|
|
|
|
+ listeners.add(template.addListener(action.apply(template)));
|
|
|
|
+ break;
|
|
|
|
+ }
|
|
|
|
+ default: // Global Listener
|
|
|
|
+ {
|
|
|
|
+ final EventDispatcher template = EventDispatcher.getInstance();
|
|
|
|
+ listeners.add(template.addListener(action.apply(template)));
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ _listeners.addAll(listeners);
|
|
|
|
+ return listeners;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ public List<Integer> getRegisteredIds(ListenerRegisterType type)
|
|
|
|
+ {
|
|
|
|
+ return _registeredIds.containsKey(type) ? _registeredIds.get(type) : Collections.emptyList();
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ public List<AbstractEventListener> getListeners()
|
|
|
|
+ {
|
|
|
|
+ return _listeners;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * -------------------------------------------------------------------------------------------------------
|
|
|
|
+ */
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Show an on screen message to the player.
|
|
|
|
+ * @param player the player to display the message to
|
|
|
|
+ * @param text the message to display
|
|
|
|
+ * @param time the duration of the message in milliseconds
|
|
|
|
+ */
|
|
|
|
+ public static void showOnScreenMsg(L2PcInstance player, String text, int time)
|
|
|
|
+ {
|
|
|
|
+ player.sendPacket(new ExShowScreenMessage(text, time));
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Show an on screen message to the player.
|
|
|
|
+ * @param player the player to display the message to
|
|
|
|
+ * @param npcString the NPC string to display
|
|
|
|
+ * @param position the position of the message on the screen
|
|
|
|
+ * @param time the duration of the message in milliseconds
|
|
|
|
+ * @param params values of parameters to replace in the NPC String (like S1, C1 etc.)
|
|
|
|
+ */
|
|
|
|
+ public static void showOnScreenMsg(L2PcInstance player, NpcStringId npcString, int position, int time, String... params)
|
|
|
|
+ {
|
|
|
|
+ player.sendPacket(new ExShowScreenMessage(npcString, position, time, params));
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Show an on screen message to the player.
|
|
|
|
+ * @param player the player to display the message to
|
|
|
|
+ * @param systemMsg the system message to display
|
|
|
|
+ * @param position the position of the message on the screen
|
|
|
|
+ * @param time the duration of the message in milliseconds
|
|
|
|
+ * @param params values of parameters to replace in the system message (like S1, C1 etc.)
|
|
|
|
+ */
|
|
|
|
+ public static void showOnScreenMsg(L2PcInstance player, SystemMessageId systemMsg, int position, int time, String... params)
|
|
|
|
+ {
|
|
|
|
+ player.sendPacket(new ExShowScreenMessage(systemMsg, position, time, params));
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Add a temporary spawn of the specified NPC.
|
|
|
|
+ * @param npcId the ID of the NPC to spawn
|
|
|
|
+ * @param pos the object containing the spawn location coordinates
|
|
|
|
+ * @return the {@link L2Npc} object of the newly spawned NPC or {@code null} if the NPC doesn't exist
|
|
|
|
+ * @see #addSpawn(int, IPositionable, boolean, long, boolean, int)
|
|
|
|
+ * @see #addSpawn(int, int, int, int, int, boolean, long, boolean, int)
|
|
|
|
+ */
|
|
|
|
+ public static L2Npc addSpawn(int npcId, IPositionable pos)
|
|
|
|
+ {
|
|
|
|
+ return addSpawn(npcId, pos.getX(), pos.getY(), pos.getZ(), pos.getHeading(), false, 0, false, 0);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Add a temporary spawn of the specified NPC.
|
|
|
|
+ * @param npcId the ID of the NPC to spawn
|
|
|
|
+ * @param pos the object containing the spawn location coordinates
|
|
|
|
+ * @param isSummonSpawn if {@code true}, displays a summon animation on NPC spawn
|
|
|
|
+ * @return the {@link L2Npc} object of the newly spawned NPC or {@code null} if the NPC doesn't exist
|
|
|
|
+ * @see #addSpawn(int, IPositionable, boolean, long, boolean, int)
|
|
|
|
+ * @see #addSpawn(int, int, int, int, int, boolean, long, boolean, int)
|
|
|
|
+ */
|
|
|
|
+ public static L2Npc addSpawn(int npcId, IPositionable pos, boolean isSummonSpawn)
|
|
|
|
+ {
|
|
|
|
+ return addSpawn(npcId, pos.getX(), pos.getY(), pos.getZ(), pos.getHeading(), false, 0, isSummonSpawn, 0);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Add a temporary spawn of the specified NPC.
|
|
|
|
+ * @param npcId the ID of the NPC to spawn
|
|
|
|
+ * @param pos the object containing the spawn location coordinates
|
|
|
|
+ * @param randomOffset if {@code true}, adds +/- 50~100 to X/Y coordinates of the spawn location
|
|
|
|
+ * @param despawnDelay time in milliseconds till the NPC is despawned (0 - only despawned on server shutdown)
|
|
|
|
+ * @return the {@link L2Npc} object of the newly spawned NPC or {@code null} if the NPC doesn't exist
|
|
|
|
+ * @see #addSpawn(int, IPositionable, boolean, long, boolean, int)
|
|
|
|
+ * @see #addSpawn(int, int, int, int, int, boolean, long, boolean, int)
|
|
|
|
+ */
|
|
|
|
+ public static L2Npc addSpawn(int npcId, IPositionable pos, boolean randomOffset, long despawnDelay)
|
|
|
|
+ {
|
|
|
|
+ return addSpawn(npcId, pos.getX(), pos.getY(), pos.getZ(), pos.getHeading(), randomOffset, despawnDelay, false, 0);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Add a temporary spawn of the specified NPC.
|
|
|
|
+ * @param npcId the ID of the NPC to spawn
|
|
|
|
+ * @param pos the object containing the spawn location coordinates
|
|
|
|
+ * @param randomOffset if {@code true}, adds +/- 50~100 to X/Y coordinates of the spawn location
|
|
|
|
+ * @param despawnDelay time in milliseconds till the NPC is despawned (0 - only despawned on server shutdown)
|
|
|
|
+ * @param isSummonSpawn if {@code true}, displays a summon animation on NPC spawn
|
|
|
|
+ * @return the {@link L2Npc} object of the newly spawned NPC or {@code null} if the NPC doesn't exist
|
|
|
|
+ * @see #addSpawn(int, IPositionable, boolean, long, boolean, int)
|
|
|
|
+ * @see #addSpawn(int, int, int, int, int, boolean, long, boolean, int)
|
|
|
|
+ */
|
|
|
|
+ public static L2Npc addSpawn(int npcId, IPositionable pos, boolean randomOffset, long despawnDelay, boolean isSummonSpawn)
|
|
|
|
+ {
|
|
|
|
+ return addSpawn(npcId, pos.getX(), pos.getY(), pos.getZ(), pos.getHeading(), randomOffset, despawnDelay, isSummonSpawn, 0);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Add a temporary spawn of the specified NPC.
|
|
|
|
+ * @param npcId the ID of the NPC to spawn
|
|
|
|
+ * @param pos the object containing the spawn location coordinates
|
|
|
|
+ * @param randomOffset if {@code true}, adds +/- 50~100 to X/Y coordinates of the spawn location
|
|
|
|
+ * @param despawnDelay time in milliseconds till the NPC is despawned (0 - only despawned on server shutdown)
|
|
|
|
+ * @param isSummonSpawn if {@code true}, displays a summon animation on NPC spawn
|
|
|
|
+ * @param instanceId the ID of the instance to spawn the NPC in (0 - the open world)
|
|
|
|
+ * @return the {@link L2Npc} object of the newly spawned NPC or {@code null} if the NPC doesn't exist
|
|
|
|
+ * @see #addSpawn(int, IPositionable)
|
|
|
|
+ * @see #addSpawn(int, IPositionable, boolean)
|
|
|
|
+ * @see #addSpawn(int, IPositionable, boolean, long)
|
|
|
|
+ * @see #addSpawn(int, IPositionable, boolean, long, boolean)
|
|
|
|
+ * @see #addSpawn(int, int, int, int, int, boolean, long, boolean, int)
|
|
|
|
+ */
|
|
|
|
+ public static L2Npc addSpawn(int npcId, IPositionable pos, boolean randomOffset, long despawnDelay, boolean isSummonSpawn, int instanceId)
|
|
|
|
+ {
|
|
|
|
+ return addSpawn(npcId, pos.getX(), pos.getY(), pos.getZ(), pos.getHeading(), randomOffset, despawnDelay, isSummonSpawn, instanceId);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Add a temporary spawn of the specified NPC.
|
|
|
|
+ * @param npcId the ID of the NPC to spawn
|
|
|
|
+ * @param x the X coordinate of the spawn location
|
|
|
|
+ * @param y the Y coordinate of the spawn location
|
|
|
|
+ * @param z the Z coordinate (height) of the spawn location
|
|
|
|
+ * @param heading the heading of the NPC
|
|
|
|
+ * @param randomOffset if {@code true}, adds +/- 50~100 to X/Y coordinates of the spawn location
|
|
|
|
+ * @param despawnDelay time in milliseconds till the NPC is despawned (0 - only despawned on server shutdown)
|
|
|
|
+ * @return the {@link L2Npc} object of the newly spawned NPC or {@code null} if the NPC doesn't exist
|
|
|
|
+ * @see #addSpawn(int, IPositionable, boolean, long, boolean, int)
|
|
|
|
+ * @see #addSpawn(int, int, int, int, int, boolean, long, boolean, int)
|
|
|
|
+ */
|
|
|
|
+ public static L2Npc addSpawn(int npcId, int x, int y, int z, int heading, boolean randomOffset, long despawnDelay)
|
|
|
|
+ {
|
|
|
|
+ return addSpawn(npcId, x, y, z, heading, randomOffset, despawnDelay, false, 0);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Add a temporary spawn of the specified NPC.
|
|
|
|
+ * @param npcId the ID of the NPC to spawn
|
|
|
|
+ * @param x the X coordinate of the spawn location
|
|
|
|
+ * @param y the Y coordinate of the spawn location
|
|
|
|
+ * @param z the Z coordinate (height) of the spawn location
|
|
|
|
+ * @param heading the heading of the NPC
|
|
|
|
+ * @param randomOffset if {@code true}, adds +/- 50~100 to X/Y coordinates of the spawn location
|
|
|
|
+ * @param despawnDelay time in milliseconds till the NPC is despawned (0 - only despawned on server shutdown)
|
|
|
|
+ * @param isSummonSpawn if {@code true}, displays a summon animation on NPC spawn
|
|
|
|
+ * @return the {@link L2Npc} object of the newly spawned NPC or {@code null} if the NPC doesn't exist
|
|
|
|
+ * @see #addSpawn(int, IPositionable, boolean, long, boolean, int)
|
|
|
|
+ * @see #addSpawn(int, int, int, int, int, boolean, long, boolean, int)
|
|
|
|
+ */
|
|
|
|
+ public static L2Npc addSpawn(int npcId, int x, int y, int z, int heading, boolean randomOffset, long despawnDelay, boolean isSummonSpawn)
|
|
|
|
+ {
|
|
|
|
+ return addSpawn(npcId, x, y, z, heading, randomOffset, despawnDelay, isSummonSpawn, 0);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Add a temporary spawn of the specified NPC.
|
|
|
|
+ * @param npcId the ID of the NPC to spawn
|
|
|
|
+ * @param x the X coordinate of the spawn location
|
|
|
|
+ * @param y the Y coordinate of the spawn location
|
|
|
|
+ * @param z the Z coordinate (height) of the spawn location
|
|
|
|
+ * @param heading the heading of the NPC
|
|
|
|
+ * @param randomOffset if {@code true}, adds +/- 50~100 to X/Y coordinates of the spawn location
|
|
|
|
+ * @param despawnDelay time in milliseconds till the NPC is despawned (0 - only despawned on server shutdown)
|
|
|
|
+ * @param isSummonSpawn if {@code true}, displays a summon animation on NPC spawn
|
|
|
|
+ * @param instanceId the ID of the instance to spawn the NPC in (0 - the open world)
|
|
|
|
+ * @return the {@link L2Npc} object of the newly spawned NPC or {@code null} if the NPC doesn't exist
|
|
|
|
+ * @see #addSpawn(int, IPositionable, boolean, long, boolean, int)
|
|
|
|
+ * @see #addSpawn(int, int, int, int, int, boolean, long)
|
|
|
|
+ * @see #addSpawn(int, int, int, int, int, boolean, long, boolean)
|
|
|
|
+ */
|
|
|
|
+ public static L2Npc addSpawn(int npcId, int x, int y, int z, int heading, boolean randomOffset, long despawnDelay, boolean isSummonSpawn, int instanceId)
|
|
|
|
+ {
|
|
|
|
+ try
|
|
|
|
+ {
|
|
|
|
+ L2NpcTemplate template = NpcData.getInstance().getTemplate(npcId);
|
|
|
|
+ if (template == null)
|
|
|
|
+ {
|
|
|
|
+ _log.log(Level.SEVERE, "addSpawn(): no NPC template found for NPC #" + npcId + "!");
|
|
|
|
+ }
|
|
|
|
+ else
|
|
|
|
+ {
|
|
|
|
+ if ((x == 0) && (y == 0))
|
|
|
|
+ {
|
|
|
|
+ _log.log(Level.SEVERE, "addSpawn(): invalid spawn coordinates for NPC #" + npcId + "!");
|
|
|
|
+ return null;
|
|
|
|
+ }
|
|
|
|
+ if (randomOffset)
|
|
|
|
+ {
|
|
|
|
+ int offset = Rnd.get(50, 100);
|
|
|
|
+ if (Rnd.nextBoolean())
|
|
|
|
+ {
|
|
|
|
+ offset *= -1;
|
|
|
|
+ }
|
|
|
|
+ x += offset;
|
|
|
|
+
|
|
|
|
+ offset = Rnd.get(50, 100);
|
|
|
|
+ if (Rnd.nextBoolean())
|
|
|
|
+ {
|
|
|
|
+ offset *= -1;
|
|
|
|
+ }
|
|
|
|
+ y += offset;
|
|
|
|
+ }
|
|
|
|
+ L2Spawn spawn = new L2Spawn(template);
|
|
|
|
+ spawn.setInstanceId(instanceId);
|
|
|
|
+ spawn.setHeading(heading);
|
|
|
|
+ spawn.setX(x);
|
|
|
|
+ spawn.setY(y);
|
|
|
|
+ spawn.setZ(z);
|
|
|
|
+ spawn.stopRespawn();
|
|
|
|
+ L2Npc result = spawn.spawnOne(isSummonSpawn);
|
|
|
|
+
|
|
|
|
+ if (despawnDelay > 0)
|
|
|
|
+ {
|
|
|
|
+ result.scheduleDespawn(despawnDelay);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ return result;
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ catch (Exception e1)
|
|
|
|
+ {
|
|
|
|
+ _log.warning("Could not spawn NPC #" + npcId + "; error: " + e1.getMessage());
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ return null;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * @param trapId
|
|
|
|
+ * @param x
|
|
|
|
+ * @param y
|
|
|
|
+ * @param z
|
|
|
|
+ * @param heading
|
|
|
|
+ * @param skill
|
|
|
|
+ * @param instanceId
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ public L2TrapInstance addTrap(int trapId, int x, int y, int z, int heading, Skill skill, int instanceId)
|
|
|
|
+ {
|
|
|
|
+ final L2NpcTemplate npcTemplate = NpcData.getInstance().getTemplate(trapId);
|
|
|
|
+ L2TrapInstance trap = new L2TrapInstance(IdFactory.getInstance().getNextId(), npcTemplate, instanceId, -1);
|
|
|
|
+ trap.setCurrentHp(trap.getMaxHp());
|
|
|
|
+ trap.setCurrentMp(trap.getMaxMp());
|
|
|
|
+ trap.setIsInvul(true);
|
|
|
|
+ trap.setHeading(heading);
|
|
|
|
+ trap.spawnMe(x, y, z);
|
|
|
|
+ return trap;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * @param master
|
|
|
|
+ * @param minionId
|
|
|
|
+ * @return
|
|
|
|
+ */
|
|
|
|
+ public L2Npc addMinion(L2MonsterInstance master, int minionId)
|
|
|
|
+ {
|
|
|
|
+ return MinionList.spawnMinion(master, minionId);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Get the amount of an item in player's inventory.
|
|
|
|
+ * @param player the player whose inventory to check
|
|
|
|
+ * @param itemId the ID of the item whose amount to get
|
|
|
|
+ * @return the amount of the specified item in player's inventory
|
|
|
|
+ */
|
|
|
|
+ public static long getQuestItemsCount(L2PcInstance player, int itemId)
|
|
|
|
+ {
|
|
|
|
+ return player.getInventory().getInventoryItemCount(itemId, -1);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Get the total amount of all specified items in player's inventory.
|
|
|
|
+ * @param player the player whose inventory to check
|
|
|
|
+ * @param itemIds a list of IDs of items whose amount to get
|
|
|
|
+ * @return the summary amount of all listed items in player's inventory
|
|
|
|
+ */
|
|
|
|
+ public long getQuestItemsCount(L2PcInstance player, int... itemIds)
|
|
|
|
+ {
|
|
|
|
+ long count = 0;
|
|
|
|
+ for (L2ItemInstance item : player.getInventory().getItems())
|
|
|
|
+ {
|
|
|
|
+ if (item == null)
|
|
|
|
+ {
|
|
|
|
+ continue;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ for (int itemId : itemIds)
|
|
|
|
+ {
|
|
|
|
+ if (item.getId() == itemId)
|
|
|
|
+ {
|
|
|
|
+ if ((count + item.getCount()) > Long.MAX_VALUE)
|
|
|
|
+ {
|
|
|
|
+ return Long.MAX_VALUE;
|
|
|
|
+ }
|
|
|
|
+ count += item.getCount();
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ return count;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Check if the player has the specified item in his inventory.
|
|
|
|
+ * @param player the player whose inventory to check for the specified item
|
|
|
|
+ * @param item the {@link ItemHolder} object containing the ID and count of the item to check
|
|
|
|
+ * @return {@code true} if the player has the required count of the item
|
|
|
|
+ */
|
|
|
|
+ protected static boolean hasItem(L2PcInstance player, ItemHolder item)
|
|
|
|
+ {
|
|
|
|
+ return hasItem(player, item, true);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Check if the player has the required count of the specified item in his inventory.
|
|
|
|
+ * @param player the player whose inventory to check for the specified item
|
|
|
|
+ * @param item the {@link ItemHolder} object containing the ID and count of the item to check
|
|
|
|
+ * @param checkCount if {@code true}, check if each item is at least of the count specified in the ItemHolder,<br>
|
|
|
|
+ * otherwise check only if the player has the item at all
|
|
|
|
+ * @return {@code true} if the player has the item
|
|
|
|
+ */
|
|
|
|
+ protected static boolean hasItem(L2PcInstance player, ItemHolder item, boolean checkCount)
|
|
|
|
+ {
|
|
|
|
+ if (item == null)
|
|
|
|
+ {
|
|
|
|
+ return false;
|
|
|
|
+ }
|
|
|
|
+ if (checkCount)
|
|
|
|
+ {
|
|
|
|
+ return (getQuestItemsCount(player, item.getId()) >= item.getCount());
|
|
|
|
+ }
|
|
|
|
+ return hasQuestItems(player, item.getId());
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Check if the player has all the specified items in his inventory and, if necessary, if their count is also as required.
|
|
|
|
+ * @param player the player whose inventory to check for the specified item
|
|
|
|
+ * @param checkCount if {@code true}, check if each item is at least of the count specified in the ItemHolder,<br>
|
|
|
|
+ * otherwise check only if the player has the item at all
|
|
|
|
+ * @param itemList a list of {@link ItemHolder} objects containing the IDs of the items to check
|
|
|
|
+ * @return {@code true} if the player has all the items from the list
|
|
|
|
+ */
|
|
|
|
+ protected static boolean hasAllItems(L2PcInstance player, boolean checkCount, ItemHolder... itemList)
|
|
|
|
+ {
|
|
|
|
+ if ((itemList == null) || (itemList.length == 0))
|
|
|
|
+ {
|
|
|
|
+ return false;
|
|
|
|
+ }
|
|
|
|
+ for (ItemHolder item : itemList)
|
|
|
|
+ {
|
|
|
|
+ if (!hasItem(player, item, checkCount))
|
|
|
|
+ {
|
|
|
|
+ return false;
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ return true;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Check for an item in player's inventory.
|
|
|
|
+ * @param player the player whose inventory to check for quest items
|
|
|
|
+ * @param itemId the ID of the item to check for
|
|
|
|
+ * @return {@code true} if the item exists in player's inventory, {@code false} otherwise
|
|
|
|
+ */
|
|
|
|
+ public static boolean hasQuestItems(L2PcInstance player, int itemId)
|
|
|
|
+ {
|
|
|
|
+ return (player.getInventory().getItemByItemId(itemId) != null);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Check for multiple items in player's inventory.
|
|
|
|
+ * @param player the player whose inventory to check for quest items
|
|
|
|
+ * @param itemIds a list of item IDs to check for
|
|
|
|
+ * @return {@code true} if all items exist in player's inventory, {@code false} otherwise
|
|
|
|
+ */
|
|
|
|
+ public static boolean hasQuestItems(L2PcInstance player, int... itemIds)
|
|
|
|
+ {
|
|
|
|
+ if ((itemIds == null) || (itemIds.length == 0))
|
|
|
|
+ {
|
|
|
|
+ return false;
|
|
|
|
+ }
|
|
|
|
+ final PcInventory inv = player.getInventory();
|
|
|
|
+ for (int itemId : itemIds)
|
|
|
|
+ {
|
|
|
|
+ if (inv.getItemByItemId(itemId) == null)
|
|
|
|
+ {
|
|
|
|
+ return false;
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ return true;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Check for multiple items in player's inventory.
|
|
|
|
+ * @param player the player whose inventory to check for quest items
|
|
|
|
+ * @param itemIds a list of item IDs to check for
|
|
|
|
+ * @return {@code true} if at least one items exist in player's inventory, {@code false} otherwise
|
|
|
|
+ */
|
|
|
|
+ public boolean hasAtLeastOneQuestItem(L2PcInstance player, int... itemIds)
|
|
|
|
+ {
|
|
|
|
+ final PcInventory inv = player.getInventory();
|
|
|
|
+ for (int itemId : itemIds)
|
|
|
|
+ {
|
|
|
|
+ if (inv.getItemByItemId(itemId) != null)
|
|
|
|
+ {
|
|
|
|
+ return true;
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ return false;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Get the enchantment level of an item in player's inventory.
|
|
|
|
+ * @param player the player whose item to check
|
|
|
|
+ * @param itemId the ID of the item whose enchantment level to get
|
|
|
|
+ * @return the enchantment level of the item or 0 if the item was not found
|
|
|
|
+ */
|
|
|
|
+ public static int getEnchantLevel(L2PcInstance player, int itemId)
|
|
|
|
+ {
|
|
|
|
+ final L2ItemInstance enchantedItem = player.getInventory().getItemByItemId(itemId);
|
|
|
|
+ if (enchantedItem == null)
|
|
|
|
+ {
|
|
|
|
+ return 0;
|
|
|
|
+ }
|
|
|
|
+ return enchantedItem.getEnchantLevel();
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Give Adena to the player.
|
|
|
|
+ * @param player the player to whom to give the Adena
|
|
|
|
+ * @param count the amount of Adena to give
|
|
|
|
+ * @param applyRates if {@code true} quest rates will be applied to the amount
|
|
|
|
+ */
|
|
|
|
+ public void giveAdena(L2PcInstance player, long count, boolean applyRates)
|
|
|
|
+ {
|
|
|
|
+ if (applyRates)
|
|
|
|
+ {
|
|
|
|
+ rewardItems(player, Inventory.ADENA_ID, count);
|
|
|
|
+ }
|
|
|
|
+ else
|
|
|
|
+ {
|
|
|
|
+ giveItems(player, Inventory.ADENA_ID, count);
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Give a reward to player using multipliers.
|
|
|
|
+ * @param player the player to whom to give the item
|
|
|
|
+ * @param holder
|
|
|
|
+ */
|
|
|
|
+ public static void rewardItems(L2PcInstance player, ItemHolder holder)
|
|
|
|
+ {
|
|
|
|
+ rewardItems(player, holder.getId(), holder.getCount());
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Give a reward to player using multipliers.
|
|
|
|
+ * @param player the player to whom to give the item
|
|
|
|
+ * @param itemId the ID of the item to give
|
|
|
|
+ * @param count the amount of items to give
|
|
|
|
+ */
|
|
|
|
+ public static void rewardItems(L2PcInstance player, int itemId, long count)
|
|
|
|
+ {
|
|
|
|
+ if (count <= 0)
|
|
|
|
+ {
|
|
|
|
+ return;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ final L2ItemInstance _tmpItem = ItemTable.getInstance().createDummyItem(itemId);
|
|
|
|
+ if (_tmpItem == null)
|
|
|
|
+ {
|
|
|
|
+ return;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ try
|
|
|
|
+ {
|
|
|
|
+ if (itemId == Inventory.ADENA_ID)
|
|
|
|
+ {
|
|
|
|
+ count *= Config.RATE_QUEST_REWARD_ADENA;
|
|
|
|
+ }
|
|
|
|
+ else if (Config.RATE_QUEST_REWARD_USE_MULTIPLIERS)
|
|
|
|
+ {
|
|
|
|
+ if (_tmpItem.isEtcItem())
|
|
|
|
+ {
|
|
|
|
+ switch (_tmpItem.getEtcItem().getItemType())
|
|
|
|
+ {
|
|
|
|
+ case POTION:
|
|
|
|
+ count *= Config.RATE_QUEST_REWARD_POTION;
|
|
|
|
+ break;
|
|
|
|
+ case SCRL_ENCHANT_WP:
|
|
|
|
+ case SCRL_ENCHANT_AM:
|
|
|
|
+ case SCROLL:
|
|
|
|
+ count *= Config.RATE_QUEST_REWARD_SCROLL;
|
|
|
|
+ break;
|
|
|
|
+ case RECIPE:
|
|
|
|
+ count *= Config.RATE_QUEST_REWARD_RECIPE;
|
|
|
|
+ break;
|
|
|
|
+ case MATERIAL:
|
|
|
|
+ count *= Config.RATE_QUEST_REWARD_MATERIAL;
|
|
|
|
+ break;
|
|
|
|
+ default:
|
|
|
|
+ count *= Config.RATE_QUEST_REWARD;
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ else
|
|
|
|
+ {
|
|
|
|
+ count *= Config.RATE_QUEST_REWARD;
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ catch (Exception e)
|
|
|
|
+ {
|
|
|
|
+ count = Long.MAX_VALUE;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // Add items to player's inventory
|
|
|
|
+ L2ItemInstance item = player.getInventory().addItem("Quest", itemId, count, player, player.getTarget());
|
|
|
|
+ if (item == null)
|
|
|
|
+ {
|
|
|
|
+ return;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ sendItemGetMessage(player, item, count);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Send the system message and the status update packets to the player.
|
|
|
|
+ * @param player the player that has got the item
|
|
|
|
+ * @param item the item obtain by the player
|
|
|
|
+ * @param count the item count
|
|
|
|
+ */
|
|
|
|
+ private static void sendItemGetMessage(L2PcInstance player, L2ItemInstance item, long count)
|
|
|
|
+ {
|
|
|
|
+ // If item for reward is gold, send message of gold reward to client
|
|
|
|
+ if (item.getId() == Inventory.ADENA_ID)
|
|
|
|
+ {
|
|
|
|
+ SystemMessage smsg = SystemMessage.getSystemMessage(SystemMessageId.EARNED_S1_ADENA);
|
|
|
|
+ smsg.addLong(count);
|
|
|
|
+ player.sendPacket(smsg);
|
|
|
|
+ }
|
|
|
|
+ // Otherwise, send message of object reward to client
|
|
|
|
+ else
|
|
|
|
+ {
|
|
|
|
+ if (count > 1)
|
|
|
|
+ {
|
|
|
|
+ SystemMessage smsg = SystemMessage.getSystemMessage(SystemMessageId.EARNED_S2_S1_S);
|
|
|
|
+ smsg.addItemName(item);
|
|
|
|
+ smsg.addLong(count);
|
|
|
|
+ player.sendPacket(smsg);
|
|
|
|
+ }
|
|
|
|
+ else
|
|
|
|
+ {
|
|
|
|
+ SystemMessage smsg = SystemMessage.getSystemMessage(SystemMessageId.EARNED_ITEM_S1);
|
|
|
|
+ smsg.addItemName(item);
|
|
|
|
+ player.sendPacket(smsg);
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ // send packets
|
|
|
|
+ StatusUpdate su = new StatusUpdate(player);
|
|
|
|
+ su.addAttribute(StatusUpdate.CUR_LOAD, player.getCurrentLoad());
|
|
|
|
+ player.sendPacket(su);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Give item/reward to the player
|
|
|
|
+ * @param player
|
|
|
|
+ * @param itemId
|
|
|
|
+ * @param count
|
|
|
|
+ */
|
|
|
|
+ public static void giveItems(L2PcInstance player, int itemId, long count)
|
|
|
|
+ {
|
|
|
|
+ giveItems(player, itemId, count, 0);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Give item/reward to the player
|
|
|
|
+ * @param player
|
|
|
|
+ * @param holder
|
|
|
|
+ */
|
|
|
|
+ protected static void giveItems(L2PcInstance player, ItemHolder holder)
|
|
|
|
+ {
|
|
|
|
+ giveItems(player, holder.getId(), holder.getCount());
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * @param player
|
|
|
|
+ * @param itemId
|
|
|
|
+ * @param count
|
|
|
|
+ * @param enchantlevel
|
|
|
|
+ */
|
|
|
|
+ public static void giveItems(L2PcInstance player, int itemId, long count, int enchantlevel)
|
|
|
|
+ {
|
|
|
|
+ if (count <= 0)
|
|
|
|
+ {
|
|
|
|
+ return;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // Add items to player's inventory
|
|
|
|
+ final L2ItemInstance item = player.getInventory().addItem("Quest", itemId, count, player, player.getTarget());
|
|
|
|
+ if (item == null)
|
|
|
|
+ {
|
|
|
|
+ return;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // set enchant level for item if that item is not adena
|
|
|
|
+ if ((enchantlevel > 0) && (itemId != Inventory.ADENA_ID))
|
|
|
|
+ {
|
|
|
|
+ item.setEnchantLevel(enchantlevel);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ sendItemGetMessage(player, item, count);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * @param player
|
|
|
|
+ * @param itemId
|
|
|
|
+ * @param count
|
|
|
|
+ * @param attributeId
|
|
|
|
+ * @param attributeLevel
|
|
|
|
+ */
|
|
|
|
+ public static void giveItems(L2PcInstance player, int itemId, long count, byte attributeId, int attributeLevel)
|
|
|
|
+ {
|
|
|
|
+ if (count <= 0)
|
|
|
|
+ {
|
|
|
|
+ return;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // Add items to player's inventory
|
|
|
|
+ final L2ItemInstance item = player.getInventory().addItem("Quest", itemId, count, player, player.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(player);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ InventoryUpdate iu = new InventoryUpdate();
|
|
|
|
+ iu.addModifiedItem(item);
|
|
|
|
+ player.sendPacket(iu);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ sendItemGetMessage(player, item, count);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Give the specified player a set amount of items if he is lucky enough.<br>
|
|
|
|
+ * Not recommended to use this for non-stacking items.
|
|
|
|
+ * @param player the player to give the item(s) to
|
|
|
|
+ * @param itemId the ID of the item to give
|
|
|
|
+ * @param amountToGive the amount of items to give
|
|
|
|
+ * @param limit the maximum amount of items the player can have. Won't give more if this limit is reached. 0 - no limit.
|
|
|
|
+ * @param dropChance the drop chance as a decimal digit from 0 to 1
|
|
|
|
+ * @param playSound if true, plays ItemSound.quest_itemget when items are given and ItemSound.quest_middle when the limit is reached
|
|
|
|
+ * @return {@code true} if limit > 0 and the limit was reached or if limit <= 0 and items were given; {@code false} in all other cases
|
|
|
|
+ */
|
|
|
|
+ public static boolean giveItemRandomly(L2PcInstance player, int itemId, long amountToGive, long limit, double dropChance, boolean playSound)
|
|
|
|
+ {
|
|
|
|
+ return giveItemRandomly(player, null, itemId, amountToGive, amountToGive, limit, dropChance, playSound);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Give the specified player a set amount of items if he is lucky enough.<br>
|
|
|
|
+ * Not recommended to use this for non-stacking items.
|
|
|
|
+ * @param player the player to give the item(s) to
|
|
|
|
+ * @param npc the NPC that "dropped" the item (can be null)
|
|
|
|
+ * @param itemId the ID of the item to give
|
|
|
|
+ * @param amountToGive the amount of items to give
|
|
|
|
+ * @param limit the maximum amount of items the player can have. Won't give more if this limit is reached. 0 - no limit.
|
|
|
|
+ * @param dropChance the drop chance as a decimal digit from 0 to 1
|
|
|
|
+ * @param playSound if true, plays ItemSound.quest_itemget when items are given and ItemSound.quest_middle when the limit is reached
|
|
|
|
+ * @return {@code true} if limit > 0 and the limit was reached or if limit <= 0 and items were given; {@code false} in all other cases
|
|
|
|
+ */
|
|
|
|
+ public static boolean giveItemRandomly(L2PcInstance player, L2Npc npc, int itemId, long amountToGive, long limit, double dropChance, boolean playSound)
|
|
|
|
+ {
|
|
|
|
+ return giveItemRandomly(player, npc, itemId, amountToGive, amountToGive, limit, dropChance, playSound);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Give the specified player a random amount of items if he is lucky enough.<br>
|
|
|
|
+ * Not recommended to use this for non-stacking items.
|
|
|
|
+ * @param player the player to give the item(s) to
|
|
|
|
+ * @param npc the NPC that "dropped" the item (can be null)
|
|
|
|
+ * @param itemId the ID of the item to give
|
|
|
|
+ * @param minAmount the minimum amount of items to give
|
|
|
|
+ * @param maxAmount the maximum amount of items to give (will give a random amount between min/maxAmount multiplied by quest rates)
|
|
|
|
+ * @param limit the maximum amount of items the player can have. Won't give more if this limit is reached. 0 - no limit.
|
|
|
|
+ * @param dropChance the drop chance as a decimal digit from 0 to 1
|
|
|
|
+ * @param playSound if true, plays ItemSound.quest_itemget when items are given and ItemSound.quest_middle when the limit is reached
|
|
|
|
+ * @return {@code true} if limit > 0 and the limit was reached or if limit <= 0 and items were given; {@code false} in all other cases
|
|
|
|
+ */
|
|
|
|
+ public static boolean giveItemRandomly(L2PcInstance player, L2Npc npc, int itemId, long minAmount, long maxAmount, long limit, double dropChance, boolean playSound)
|
|
|
|
+ {
|
|
|
|
+ final long currentCount = getQuestItemsCount(player, itemId);
|
|
|
|
+
|
|
|
|
+ if ((limit > 0) && (currentCount >= limit))
|
|
|
|
+ {
|
|
|
|
+ return true;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ minAmount *= Config.RATE_QUEST_DROP;
|
|
|
|
+ maxAmount *= Config.RATE_QUEST_DROP;
|
|
|
|
+ dropChance *= Config.RATE_QUEST_DROP; // TODO separate configs for rate and amount
|
|
|
|
+ if ((npc != null) && Config.L2JMOD_CHAMPION_ENABLE && npc.isChampion())
|
|
|
|
+ {
|
|
|
|
+ dropChance *= Config.L2JMOD_CHAMPION_REWARDS;
|
|
|
|
+ if ((itemId == Inventory.ADENA_ID) || (itemId == Inventory.ANCIENT_ADENA_ID))
|
|
|
|
+ {
|
|
|
|
+ minAmount *= Config.L2JMOD_CHAMPION_ADENAS_REWARDS;
|
|
|
|
+ maxAmount *= Config.L2JMOD_CHAMPION_ADENAS_REWARDS;
|
|
|
|
+ }
|
|
|
|
+ else
|
|
|
|
+ {
|
|
|
|
+ minAmount *= Config.L2JMOD_CHAMPION_REWARDS;
|
|
|
|
+ maxAmount *= Config.L2JMOD_CHAMPION_REWARDS;
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ long amountToGive = ((minAmount == maxAmount) ? minAmount : Rnd.get(minAmount, maxAmount));
|
|
|
|
+ final double random = Rnd.nextDouble();
|
|
|
|
+ // Inventory slot check (almost useless for non-stacking items)
|
|
|
|
+ if ((dropChance >= random) && (amountToGive > 0) && player.getInventory().validateCapacityByItemId(itemId))
|
|
|
|
+ {
|
|
|
|
+ if ((limit > 0) && ((currentCount + amountToGive) > limit))
|
|
|
|
+ {
|
|
|
|
+ amountToGive = limit - currentCount;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // Give the item to player
|
|
|
|
+ L2ItemInstance item = player.addItem("Quest", itemId, amountToGive, npc, true);
|
|
|
|
+ if (item != null)
|
|
|
|
+ {
|
|
|
|
+ // limit reached (if there is no limit, this block doesn't execute)
|
|
|
|
+ if ((currentCount + amountToGive) == limit)
|
|
|
|
+ {
|
|
|
|
+ if (playSound)
|
|
|
|
+ {
|
|
|
|
+ playSound(player, QuestSound.ITEMSOUND_QUEST_MIDDLE);
|
|
|
|
+ }
|
|
|
|
+ return true;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ if (playSound)
|
|
|
|
+ {
|
|
|
|
+ playSound(player, QuestSound.ITEMSOUND_QUEST_ITEMGET);
|
|
|
|
+ }
|
|
|
|
+ // if there is no limit, return true every time an item is given
|
|
|
|
+ if (limit <= 0)
|
|
|
|
+ {
|
|
|
|
+ return true;
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ return false;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Take an amount of a specified item from player's inventory.
|
|
|
|
+ * @param player the player whose item to take
|
|
|
|
+ * @param itemId the ID of the item to take
|
|
|
|
+ * @param amount the amount to take
|
|
|
|
+ * @return {@code true} if any items were taken, {@code false} otherwise
|
|
|
|
+ */
|
|
|
|
+ public static boolean takeItems(L2PcInstance player, int itemId, long amount)
|
|
|
|
+ {
|
|
|
|
+ // Get object item from player's inventory list
|
|
|
|
+ final L2ItemInstance item = player.getInventory().getItemByItemId(itemId);
|
|
|
|
+ if (item == null)
|
|
|
|
+ {
|
|
|
|
+ return false;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // Tests on count value in order not to have negative value
|
|
|
|
+ if ((amount < 0) || (amount > item.getCount()))
|
|
|
|
+ {
|
|
|
|
+ amount = item.getCount();
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ // Destroy the quantity of items wanted
|
|
|
|
+ if (item.isEquipped())
|
|
|
|
+ {
|
|
|
|
+ final L2ItemInstance[] unequiped = player.getInventory().unEquipItemInBodySlotAndRecord(item.getItem().getBodyPart());
|
|
|
|
+ InventoryUpdate iu = new InventoryUpdate();
|
|
|
|
+ for (L2ItemInstance itm : unequiped)
|
|
|
|
+ {
|
|
|
|
+ iu.addModifiedItem(itm);
|
|
|
|
+ }
|
|
|
|
+ player.sendPacket(iu);
|
|
|
|
+ player.broadcastUserInfo();
|
|
|
|
+ }
|
|
|
|
+ return player.destroyItemByItemId("Quest", itemId, amount, player, true);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Take a set amount of a specified item from player's inventory.
|
|
|
|
+ * @param player the player whose item to take
|
|
|
|
+ * @param holder the {@link ItemHolder} object containing the ID and count of the item to take
|
|
|
|
+ * @return {@code true} if the item was taken, {@code false} otherwise
|
|
|
|
+ */
|
|
|
|
+ protected static boolean takeItem(L2PcInstance player, ItemHolder holder)
|
|
|
|
+ {
|
|
|
|
+ if (holder == null)
|
|
|
|
+ {
|
|
|
|
+ return false;
|
|
|
|
+ }
|
|
|
|
+ return takeItems(player, holder.getId(), holder.getCount());
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Take a set amount of all specified items from player's inventory.
|
|
|
|
+ * @param player the player whose items to take
|
|
|
|
+ * @param itemList the list of {@link ItemHolder} objects containing the IDs and counts of the items to take
|
|
|
|
+ * @return {@code true} if all items were taken, {@code false} otherwise
|
|
|
|
+ */
|
|
|
|
+ protected static boolean takeAllItems(L2PcInstance player, ItemHolder... itemList)
|
|
|
|
+ {
|
|
|
|
+ if ((itemList == null) || (itemList.length == 0))
|
|
|
|
+ {
|
|
|
|
+ return false;
|
|
|
|
+ }
|
|
|
|
+ // first check if the player has all items to avoid taking half the items from the list
|
|
|
|
+ if (!hasAllItems(player, true, itemList))
|
|
|
|
+ {
|
|
|
|
+ return false;
|
|
|
|
+ }
|
|
|
|
+ for (ItemHolder item : itemList)
|
|
|
|
+ {
|
|
|
|
+ // this should never be false, but just in case
|
|
|
|
+ if (!takeItem(player, item))
|
|
|
|
+ {
|
|
|
|
+ return false;
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ return true;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Take an amount of all specified items from player's inventory.
|
|
|
|
+ * @param player the player whose items to take
|
|
|
|
+ * @param amount the amount to take of each item
|
|
|
|
+ * @param itemIds a list or an array of IDs of the items to take
|
|
|
|
+ * @return {@code true} if all items were taken, {@code false} otherwise
|
|
|
|
+ */
|
|
|
|
+ public static boolean takeItems(L2PcInstance player, int amount, int... itemIds)
|
|
|
|
+ {
|
|
|
|
+ boolean check = true;
|
|
|
|
+ if (itemIds != null)
|
|
|
|
+ {
|
|
|
|
+ for (int item : itemIds)
|
|
|
|
+ {
|
|
|
|
+ check &= takeItems(player, item, amount);
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ return check;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Send a packet in order to play a sound to the player.
|
|
|
|
+ * @param player the player whom to send the packet
|
|
|
|
+ * @param sound the name of the sound to play
|
|
|
|
+ */
|
|
|
|
+ public static void playSound(L2PcInstance player, String sound)
|
|
|
|
+ {
|
|
|
|
+ player.sendPacket(QuestSound.getSound(sound));
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Send a packet in order to play a sound to the player.
|
|
|
|
+ * @param player the player whom to send the packet
|
|
|
|
+ * @param sound the {@link QuestSound} object of the sound to play
|
|
|
|
+ */
|
|
|
|
+ public static void playSound(L2PcInstance player, QuestSound sound)
|
|
|
|
+ {
|
|
|
|
+ player.sendPacket(sound.getPacket());
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Add EXP and SP as quest reward.
|
|
|
|
+ * @param player the player whom to reward with the EXP/SP
|
|
|
|
+ * @param exp the amount of EXP to give to the player
|
|
|
|
+ * @param sp the amount of SP to give to the player
|
|
|
|
+ */
|
|
|
|
+ public static void addExpAndSp(L2PcInstance player, long exp, int sp)
|
|
|
|
+ {
|
|
|
|
+ player.addExpAndSp((long) player.calcStat(Stats.EXPSP_RATE, exp * Config.RATE_QUEST_REWARD_XP, null, null), (int) player.calcStat(Stats.EXPSP_RATE, sp * Config.RATE_QUEST_REWARD_SP, null, null));
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Get a random integer from 0 (inclusive) to {@code max} (exclusive).<br>
|
|
|
|
+ * Use this method instead of importing {@link com.l2jserver.util.Rnd} utility.
|
|
|
|
+ * @param max the maximum value for randomization
|
|
|
|
+ * @return a random integer number from 0 to {@code max - 1}
|
|
|
|
+ */
|
|
|
|
+ public static int getRandom(int max)
|
|
|
|
+ {
|
|
|
|
+ return Rnd.get(max);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Get a random integer from {@code min} (inclusive) to {@code max} (inclusive).<br>
|
|
|
|
+ * Use this method instead of importing {@link com.l2jserver.util.Rnd} utility.
|
|
|
|
+ * @param min the minimum value for randomization
|
|
|
|
+ * @param max the maximum value for randomization
|
|
|
|
+ * @return a random integer number from {@code min} to {@code max}
|
|
|
|
+ */
|
|
|
|
+ public static int getRandom(int min, int max)
|
|
|
|
+ {
|
|
|
|
+ return Rnd.get(min, max);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Get a random boolean.<br>
|
|
|
|
+ * Use this method instead of importing {@link com.l2jserver.util.Rnd} utility.
|
|
|
|
+ * @return {@code true} or {@code false} randomly
|
|
|
|
+ */
|
|
|
|
+ public static boolean getRandomBoolean()
|
|
|
|
+ {
|
|
|
|
+ return Rnd.nextBoolean();
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Get the ID of the item equipped in the specified inventory slot of the player.
|
|
|
|
+ * @param player the player whose inventory to check
|
|
|
|
+ * @param slot the location in the player's inventory to check
|
|
|
|
+ * @return the ID of the item equipped in the specified inventory slot or 0 if the slot is empty or item is {@code null}.
|
|
|
|
+ */
|
|
|
|
+ public static int getItemEquipped(L2PcInstance player, int slot)
|
|
|
|
+ {
|
|
|
|
+ return player.getInventory().getPaperdollItemId(slot);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * @return the number of ticks from the {@link com.l2jserver.gameserver.GameTimeController}.
|
|
|
|
+ */
|
|
|
|
+ public static int getGameTicks()
|
|
|
|
+ {
|
|
|
|
+ return GameTimeController.getInstance().getGameTicks();
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Execute a procedure for each player depending on the parameters.
|
|
|
|
+ * @param player the player on which the procedure will be executed
|
|
|
|
+ * @param npc the related NPC
|
|
|
|
+ * @param isSummon {@code true} if the event that called this method was originated by the player's summon, {@code false} otherwise
|
|
|
|
+ * @param includeParty if {@code true}, #actionForEachPlayer(L2PcInstance, L2Npc, boolean) will be called with the player's party members
|
|
|
|
+ * @param includeCommandChannel if {@code true}, {@link #actionForEachPlayer(L2PcInstance, L2Npc, boolean)} will be called with the player's command channel members
|
|
|
|
+ * @see #actionForEachPlayer(L2PcInstance, L2Npc, boolean)
|
|
|
|
+ */
|
|
|
|
+ public final void executeForEachPlayer(L2PcInstance player, final L2Npc npc, final boolean isSummon, boolean includeParty, boolean includeCommandChannel)
|
|
|
|
+ {
|
|
|
|
+ if ((includeParty || includeCommandChannel) && player.isInParty())
|
|
|
|
+ {
|
|
|
|
+ if (includeCommandChannel && player.getParty().isInCommandChannel())
|
|
|
|
+ {
|
|
|
|
+ player.getParty().getCommandChannel().forEachMember(member ->
|
|
|
|
+ {
|
|
|
|
+ actionForEachPlayer(member, npc, isSummon);
|
|
|
|
+ return true;
|
|
|
|
+ });
|
|
|
|
+ }
|
|
|
|
+ else if (includeParty)
|
|
|
|
+ {
|
|
|
|
+ player.getParty().forEachMember(member ->
|
|
|
|
+ {
|
|
|
|
+ actionForEachPlayer(member, npc, isSummon);
|
|
|
|
+ return true;
|
|
|
|
+ });
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ else
|
|
|
|
+ {
|
|
|
|
+ actionForEachPlayer(player, npc, isSummon);
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Overridable method called from {@link #executeForEachPlayer(L2PcInstance, L2Npc, boolean, boolean, boolean)}
|
|
|
|
+ * @param player the player on which the action will be run
|
|
|
|
+ * @param npc the NPC related to this action
|
|
|
|
+ * @param isSummon {@code true} if the event that called this method was originated by the player's summon
|
|
|
|
+ */
|
|
|
|
+ public void actionForEachPlayer(L2PcInstance player, L2Npc npc, boolean isSummon)
|
|
|
|
+ {
|
|
|
|
+ // To be overridden in quest scripts.
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Open a door if it is present on the instance and its not open.
|
|
|
|
+ * @param doorId the ID of the door to open
|
|
|
|
+ * @param instanceId the ID of the instance the door is in (0 if the door is not not inside an instance)
|
|
|
|
+ */
|
|
|
|
+ public void openDoor(int doorId, int instanceId)
|
|
|
|
+ {
|
|
|
|
+ final L2DoorInstance door = getDoor(doorId, instanceId);
|
|
|
|
+ if (door == null)
|
|
|
|
+ {
|
|
|
|
+ _log.log(Level.WARNING, getClass().getSimpleName() + ": called openDoor(" + doorId + ", " + instanceId + "); but door wasnt found!", new NullPointerException());
|
|
|
|
+ }
|
|
|
|
+ else if (!door.getOpen())
|
|
|
|
+ {
|
|
|
|
+ door.openMe();
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Close a door if it is present in a specified the instance and its open.
|
|
|
|
+ * @param doorId the ID of the door to close
|
|
|
|
+ * @param instanceId the ID of the instance the door is in (0 if the door is not not inside an instance)
|
|
|
|
+ */
|
|
|
|
+ public void closeDoor(int doorId, int instanceId)
|
|
|
|
+ {
|
|
|
|
+ final L2DoorInstance door = getDoor(doorId, instanceId);
|
|
|
|
+ if (door == null)
|
|
|
|
+ {
|
|
|
|
+ _log.log(Level.WARNING, getClass().getSimpleName() + ": called closeDoor(" + doorId + ", " + instanceId + "); but door wasnt found!", new NullPointerException());
|
|
|
|
+ }
|
|
|
|
+ else if (door.getOpen())
|
|
|
|
+ {
|
|
|
|
+ door.closeMe();
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Retrieve a door from an instance or the real world.
|
|
|
|
+ * @param doorId the ID of the door to get
|
|
|
|
+ * @param instanceId the ID of the instance the door is in (0 if the door is not not inside an instance)
|
|
|
|
+ * @return the found door or {@code null} if no door with that ID and instance ID was found
|
|
|
|
+ */
|
|
|
|
+ public L2DoorInstance getDoor(int doorId, int instanceId)
|
|
|
|
+ {
|
|
|
|
+ L2DoorInstance door = null;
|
|
|
|
+ if (instanceId <= 0)
|
|
|
|
+ {
|
|
|
|
+ door = DoorTable.getInstance().getDoor(doorId);
|
|
|
|
+ }
|
|
|
|
+ else
|
|
|
|
+ {
|
|
|
|
+ final Instance inst = InstanceManager.getInstance().getInstance(instanceId);
|
|
|
|
+ if (inst != null)
|
|
|
|
+ {
|
|
|
|
+ door = inst.getDoor(doorId);
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ return door;
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Teleport a player into/out of an instance.
|
|
|
|
+ * @param player the player to teleport
|
|
|
|
+ * @param loc the {@link Location} object containing the destination coordinates
|
|
|
|
+ * @param instanceId the ID of the instance to teleport the player to (0 to teleport out of an instance)
|
|
|
|
+ */
|
|
|
|
+ public void teleportPlayer(L2PcInstance player, Location loc, int instanceId)
|
|
|
|
+ {
|
|
|
|
+ teleportPlayer(player, loc, instanceId, true);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Teleport a player into/out of an instance.
|
|
|
|
+ * @param player the player to teleport
|
|
|
|
+ * @param loc the {@link Location} object containing the destination coordinates
|
|
|
|
+ * @param instanceId the ID of the instance to teleport the player to (0 to teleport out of an instance)
|
|
|
|
+ * @param allowRandomOffset if {@code true}, will randomize the teleport coordinates by +/-Config.MAX_OFFSET_ON_TELEPORT
|
|
|
|
+ */
|
|
|
|
+ public void teleportPlayer(L2PcInstance player, Location loc, int instanceId, boolean allowRandomOffset)
|
|
|
|
+ {
|
|
|
|
+ loc.setInstanceId(instanceId);
|
|
|
|
+ player.teleToLocation(loc, allowRandomOffset);
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Sends the special camera packet to the player.
|
|
|
|
+ * @param player the player
|
|
|
|
+ * @param creature the watched creature
|
|
|
|
+ * @param force
|
|
|
|
+ * @param angle1
|
|
|
|
+ * @param angle2
|
|
|
|
+ * @param time
|
|
|
|
+ * @param range
|
|
|
|
+ * @param duration
|
|
|
|
+ * @param relYaw
|
|
|
|
+ * @param relPitch
|
|
|
|
+ * @param isWide
|
|
|
|
+ * @param relAngle
|
|
|
|
+ */
|
|
|
|
+ public static final void specialCamera(L2PcInstance player, L2Character creature, int force, int angle1, int angle2, int time, int range, int duration, int relYaw, int relPitch, int isWide, int relAngle)
|
|
|
|
+ {
|
|
|
|
+ player.sendPacket(new SpecialCamera(creature, force, angle1, angle2, time, range, duration, relYaw, relPitch, isWide, relAngle));
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Sends the special camera packet to the player.
|
|
|
|
+ * @param player
|
|
|
|
+ * @param creature
|
|
|
|
+ * @param force
|
|
|
|
+ * @param angle1
|
|
|
|
+ * @param angle2
|
|
|
|
+ * @param time
|
|
|
|
+ * @param duration
|
|
|
|
+ * @param relYaw
|
|
|
|
+ * @param relPitch
|
|
|
|
+ * @param isWide
|
|
|
|
+ * @param relAngle
|
|
|
|
+ */
|
|
|
|
+ public static final void specialCameraEx(L2PcInstance player, L2Character creature, int force, int angle1, int angle2, int time, int duration, int relYaw, int relPitch, int isWide, int relAngle)
|
|
|
|
+ {
|
|
|
|
+ player.sendPacket(new SpecialCamera(creature, player, force, angle1, angle2, time, duration, relYaw, relPitch, isWide, relAngle));
|
|
|
|
+ }
|
|
|
|
+
|
|
|
|
+ /**
|
|
|
|
+ * Sends the special camera packet to the player.
|
|
|
|
+ * @param player
|
|
|
|
+ * @param creature
|
|
|
|
+ * @param force
|
|
|
|
+ * @param angle1
|
|
|
|
+ * @param angle2
|
|
|
|
+ * @param time
|
|
|
|
+ * @param range
|
|
|
|
+ * @param duration
|
|
|
|
+ * @param relYaw
|
|
|
|
+ * @param relPitch
|
|
|
|
+ * @param isWide
|
|
|
|
+ * @param relAngle
|
|
|
|
+ * @param unk
|
|
|
|
+ */
|
|
|
|
+ public static final void specialCamera3(L2PcInstance player, L2Character creature, int force, int angle1, int angle2, int time, int range, int duration, int relYaw, int relPitch, int isWide, int relAngle, int unk)
|
|
|
|
+ {
|
|
|
|
+ player.sendPacket(new SpecialCamera(creature, force, angle1, angle2, time, range, duration, relYaw, relPitch, isWide, relAngle, unk));
|
|
|
|
+ }
|
|
|
|
+}
|