lineage2/l2j_mobius
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

More tutorial improvements.

Browse Source
This commit is contained in:
MobiusDev 2017-07-26 13:00:46 +00:00
parent 8d375d4a93
commit e7a41d117b
3 changed files with 28 additions and 289 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

253
L2J_Mobius_Classic/dist/game/data/scripts/quests/LetterQuest.java vendored
View File

@ -1,253 +0,0 @@
/*
* This file is part of the L2J Mobius project.
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
package quests;
import com.l2jmobius.Config;
import com.l2jmobius.gameserver.enums.HtmlActionScope;
import com.l2jmobius.gameserver.enums.QuestSound;
import com.l2jmobius.gameserver.enums.Race;
import com.l2jmobius.gameserver.instancemanager.CastleManager;
import com.l2jmobius.gameserver.model.Location;
import com.l2jmobius.gameserver.model.actor.instance.L2PcInstance;
import com.l2jmobius.gameserver.model.events.EventType;
import com.l2jmobius.gameserver.model.events.ListenerRegisterType;
import com.l2jmobius.gameserver.model.events.annotations.RegisterEvent;
import com.l2jmobius.gameserver.model.events.annotations.RegisterType;
import com.l2jmobius.gameserver.model.events.impl.character.player.OnPlayerBypass;
import com.l2jmobius.gameserver.model.events.impl.character.player.OnPlayerLevelChanged;
import com.l2jmobius.gameserver.model.events.impl.character.player.OnPlayerLogin;
import com.l2jmobius.gameserver.model.events.impl.character.player.OnPlayerPressTutorialMark;
import com.l2jmobius.gameserver.model.quest.Quest;
import com.l2jmobius.gameserver.model.quest.QuestState;
import com.l2jmobius.gameserver.network.NpcStringId;
import com.l2jmobius.gameserver.network.SystemMessageId;
import com.l2jmobius.gameserver.network.serverpackets.ExShowScreenMessage;
import com.l2jmobius.gameserver.network.serverpackets.PlaySound;
import com.l2jmobius.gameserver.network.serverpackets.TutorialCloseHtml;
import com.l2jmobius.gameserver.network.serverpackets.TutorialShowHtml;
import com.l2jmobius.gameserver.network.serverpackets.TutorialShowQuestionMark;
import com.l2jmobius.gameserver.taskmanager.AttackStanceTaskManager;
/**
* Abstract class for quests "Letters from the Queen" and "Kekropus' Letter"
* @author malyelfik
*/
public abstract class LetterQuest extends Quest
{
private int _startSOE;
private Location _startTeleport;
private NpcStringId _startMessage;
private String _startQuestSound;
public LetterQuest(int questId)
{
super(questId);
}
/**
* Sets additional conditions that must be met to show question mark or start quest.
* @param player player trying start quest
* @return {@code true} when additional conditions are met, otherwise {@code false}
*/
public boolean canShowTutorialMark(L2PcInstance player)
{
return true;
}
/**
* Sets start quest sound.<br>
* This sound will be played when player clicks on the tutorial question mark.
* @param sound name of sound
*/
public final void setStartQuestSound(String sound)
{
_startQuestSound = sound;
}
/**
* Sets quest level restrictions.
* @param min minimum player's level to start quest
* @param max maximum player's level to start quest
*/
public final void setLevel(int min, int max)
{
addCondLevel(min, max, "");
}
/**
* Sets start location of quest.<br>
* When player starts quest, he will receive teleport scroll with id {@code itemId}.<br>
* When tutorial window is displayed, he can also teleport to location {@code loc} using HTML bypass.
* @param itemId id of item which player gets on quest start
* @param loc place where player will be teleported
*/
public final void setStartLocation(int itemId, Location loc)
{
_startSOE = itemId;
_startTeleport = loc;
}
/**
* Sets if quest is only for Ertheia characters or not.
* @param val {@code true} means {@code Race.ERTHEIA}, {@code false} means other
*/
public final void setIsErtheiaQuest(boolean val)
{
if (val)
{
addCondRace(Race.ERTHEIA, "");
_startMessage = NpcStringId.QUEEN_NAVARI_HAS_SENT_A_LETTER_NCLICK_THE_QUESTION_MARK_ICON_TO_READ;
}
else
{
addCondNotRace(Race.ERTHEIA, "");
_startMessage = NpcStringId.KEKROPUS_LETTER_HAS_ARRIVED_NCLICK_THE_QUESTION_MARK_ICON_TO_READ;
}
}
public final void setStartMessage(NpcStringId msg)
{
_startMessage = msg;
}
/**
* Gets teleport command associated with current quest.
* @return command in form Q<i>questId</i>_teleport (<i>questId</i> is replaced with original quest id)
*/
private String getTeleportCommand()
{
return "Q" + getId() + "_teleport";
}
@Override
public boolean canStartQuest(L2PcInstance player)
{
return canShowTutorialMark(player) && super.canStartQuest(player);
}
@RegisterEvent(EventType.ON_PLAYER_PRESS_TUTORIAL_MARK)
@RegisterType(ListenerRegisterType.GLOBAL_PLAYERS)
public void onPlayerPressTutorialMark(OnPlayerPressTutorialMark event)
{
final L2PcInstance player = event.getActiveChar();
if ((event.getMarkId() == getId()) && canStartQuest(player))
{
final String html = getHtm(player.getHtmlPrefix(), "popup.html").replace("%teleport%", getTeleportCommand());
final QuestState st = getQuestState(player, true);
st.startQuest();
player.sendPacket(new PlaySound(3, _startQuestSound, 0, 0, 0, 0, 0));
player.sendPacket(new TutorialShowHtml(html));
giveItems(player, _startSOE, 1);
}
}
@RegisterEvent(EventType.ON_PLAYER_BYPASS)
@RegisterType(ListenerRegisterType.GLOBAL_PLAYERS)
public void OnPlayerBypass(OnPlayerBypass event)
{
final L2PcInstance player = event.getActiveChar();
final QuestState st = getQuestState(player, false);
if (event.getCommand().equals(getTeleportCommand()))
{
if ((st != null) && st.isCond(1) && hasQuestItems(player, _startSOE))
{
if (CastleManager.getInstance().getCastles().stream().anyMatch(c -> c.getSiege().isInProgress()))
{
showOnScreenMsg(player, NpcStringId.YOU_MAY_NOT_TELEPORT_IN_MIDDLE_OF_A_SIEGE, ExShowScreenMessage.TOP_CENTER, 5000);
}
else if (player.isInParty())
{
showOnScreenMsg(player, NpcStringId.YOU_CANNOT_TELEPORT_IN_PARTY_STATUS, ExShowScreenMessage.TOP_CENTER, 5000);
}
else if (player.isInInstance())
{
showOnScreenMsg(player, NpcStringId.YOU_MAY_NOT_TELEPORT_WHILE_USING_INSTANCE_ZONE, ExShowScreenMessage.TOP_CENTER, 5000);
}
else if (AttackStanceTaskManager.getInstance().hasAttackStanceTask(player))
{
showOnScreenMsg(player, NpcStringId.YOU_CANNOT_TELEPORT_IN_COMBAT, ExShowScreenMessage.TOP_CENTER, 5000);
}
else if (player.isTransformed())
{
showOnScreenMsg(player, NpcStringId.YOU_CANNOT_TELEPORT_WHILE_IN_A_TRANSFORMED_STATE, ExShowScreenMessage.TOP_CENTER, 5000);
}
else if (player.isDead())
{
showOnScreenMsg(player, NpcStringId.YOU_CANNOT_TELEPORT_WHILE_YOU_ARE_DEAD, ExShowScreenMessage.TOP_CENTER, 5000);
}
else
{
player.teleToLocation(_startTeleport);
takeItems(player, _startSOE, -1);
}
}
player.sendPacket(TutorialCloseHtml.STATIC_PACKET);
player.clearHtmlActions(HtmlActionScope.TUTORIAL_HTML);
}
}
@RegisterEvent(EventType.ON_PLAYER_LEVEL_CHANGED)
@RegisterType(ListenerRegisterType.GLOBAL_PLAYERS)
public void OnPlayerLevelChanged(OnPlayerLevelChanged event)
{
if (Config.DISABLE_TUTORIAL)
{
return;
}
final L2PcInstance player = event.getActiveChar();
final QuestState st = getQuestState(player, false);
if ((st == null) && (event.getOldLevel() < event.getNewLevel()) && canStartQuest(player))
{
player.sendPacket(new TutorialShowQuestionMark(getId()));
playSound(player, QuestSound.ITEMSOUND_QUEST_TUTORIAL);
showOnScreenMsg(player, _startMessage, ExShowScreenMessage.TOP_CENTER, 10000);
}
}
@RegisterEvent(EventType.ON_PLAYER_LOGIN)
@RegisterType(ListenerRegisterType.GLOBAL_PLAYERS)
public void OnPlayerLogin(OnPlayerLogin event)
{
if (Config.DISABLE_TUTORIAL)
{
return;
}
final L2PcInstance player = event.getActiveChar();
final QuestState st = getQuestState(player, false);
if ((st == null) && canStartQuest(player))
{
player.sendPacket(new TutorialShowQuestionMark(getId()));
playSound(player, QuestSound.ITEMSOUND_QUEST_TUTORIAL);
showOnScreenMsg(player, _startMessage, ExShowScreenMessage.TOP_CENTER, 10000);
}
}
@Override
public void onQuestAborted(L2PcInstance player)
{
final QuestState st = getQuestState(player, true);
st.startQuest();
player.sendPacket(SystemMessageId.THIS_QUEST_CANNOT_BE_DELETED);
}
}

62
L2J_Mobius_Classic/dist/game/data/scripts/quests/Q00255_Tutorial/Q00255_Tutorial.java vendored
View File

@ -129,16 +129,7 @@ public class Q00255_Tutorial extends Quest
case "tutorial_02.html": case "tutorial_02.html":
{ {
playTutorialVoice(player, "tutorial_voice_003"); playTutorialVoice(player, "tutorial_voice_003");
htmltext = event; showTutorialHtml(player, event);
break;
}
case "user_connected":
{
// start the newbie tutorial
if ((qs.getMemoState() < 4) && STARTING_VOICE_HTML.containsKey(player.getClassId().getId()))
{
startQuestTimer("start_newbie_tutorial", 5000, null, player);
}
break; break;
} }
case "start_newbie_tutorial": case "start_newbie_tutorial":
@ -146,18 +137,7 @@ public class Q00255_Tutorial extends Quest
qs.startQuest(); qs.startQuest();
qs.setMemoState(1); qs.setMemoState(1);
playTutorialVoice(player, STARTING_VOICE_HTML.get(player.getClassId().getId()).getSound()); playTutorialVoice(player, STARTING_VOICE_HTML.get(player.getClassId().getId()).getSound());
htmltext = STARTING_VOICE_HTML.get(player.getClassId().getId()).getHtml(); showTutorialHtml(player, STARTING_VOICE_HTML.get(player.getClassId().getId()).getHtml());
break;
}
case "newbie_pick_up_items":
{
if (qs.getMemoState() <= 1)
{
playTutorialVoice(player, "tutorial_voice_011");
playSound(player, "ItemSound.quest_tutorial");
player.sendPacket(new TutorialShowHtml(getHtm(player.getHtmlPrefix(), "tutorial_09t.html")));
return null;
}
break; break;
} }
case "goto_newbie_guide": case "goto_newbie_guide":
@ -176,7 +156,7 @@ public class Q00255_Tutorial extends Quest
{ {
player.sendPacket(TutorialCloseHtml.STATIC_PACKET); player.sendPacket(TutorialCloseHtml.STATIC_PACKET);
player.clearHtmlActions(HtmlActionScope.TUTORIAL_HTML); player.clearHtmlActions(HtmlActionScope.TUTORIAL_HTML);
return null; break;
} }
} }
return htmltext; return htmltext;
@ -186,13 +166,9 @@ public class Q00255_Tutorial extends Quest
public String onTalk(L2Npc npc, L2PcInstance player) public String onTalk(L2Npc npc, L2PcInstance player)
{ {
final QuestState qs = getQuestState(player, false); final QuestState qs = getQuestState(player, false);
if ((qs != null) && (qs.getMemoState() < 4) && (qs.getMemoState() > 1) && hasQuestItems(player, BLUE_GEM)) if ((qs != null) && !qs.isCompleted() && (qs.getMemoState() > 1) && hasQuestItems(player, BLUE_GEM))
{ {
qs.setMemoState(4); // finish here! qs.exitQuest(false, false); // finish here!
takeItems(player, BLUE_GEM, -1);
final int classId = player.getClassId().getId();
addRadar(player, COMPLETE_LOCATION.get(classId).getX(), COMPLETE_LOCATION.get(classId).getY(), COMPLETE_LOCATION.get(classId).getZ());
playSound(player, "ItemSound.quest_tutorial");
if (player.isMageClass() && (player.getRace() != Race.ORC)) if (player.isMageClass() && (player.getRace() != Race.ORC))
{ {
giveItems(player, SPIRITSHOT_REWARD); giveItems(player, SPIRITSHOT_REWARD);
@ -201,8 +177,11 @@ public class Q00255_Tutorial extends Quest
{ {
giveItems(player, SOULSHOT_REWARD); giveItems(player, SOULSHOT_REWARD);
} }
final int classId = player.getClassId().getId();
addRadar(player, COMPLETE_LOCATION.get(classId).getX(), COMPLETE_LOCATION.get(classId).getY(), COMPLETE_LOCATION.get(classId).getZ());
playSound(player, "ItemSound.quest_tutorial");
} }
if ((qs != null) && (qs.getMemoState() > 1)) if ((qs != null) && (qs.isCompleted() || (qs.getMemoState() > 1)))
{ {
return "tutorial_15.html"; return "tutorial_15.html";
} }
@ -226,7 +205,12 @@ public class Q00255_Tutorial extends Quest
} }
if (counter < 10) // do not drop if more than 10 if (counter < 10) // do not drop if more than 10
{ {
startQuestTimer("newbie_pick_up_items", 100, null, killer); if (qs.getMemoState() <= 1)
{
playSound(killer, "ItemSound.quest_tutorial");
playTutorialVoice(killer, "tutorial_voice_011");
showTutorialHtml(killer, "tutorial_09t.html");
}
npc.dropItem(killer, BLUE_GEM, 1); npc.dropItem(killer, BLUE_GEM, 1);
} }
} }
@ -245,8 +229,8 @@ public class Q00255_Tutorial extends Quest
player.sendPacket(TutorialCloseHtml.STATIC_PACKET); player.sendPacket(TutorialCloseHtml.STATIC_PACKET);
player.clearHtmlActions(HtmlActionScope.TUTORIAL_HTML); player.clearHtmlActions(HtmlActionScope.TUTORIAL_HTML);
qs.setMemoState(2); qs.setMemoState(2);
playTutorialVoice(player, "tutorial_voice_013");
playSound(player, "ItemSound.quest_tutorial"); playSound(player, "ItemSound.quest_tutorial");
playTutorialVoice(player, "tutorial_voice_013");
player.sendPacket(new TutorialShowQuestionMark(0, 1)); player.sendPacket(new TutorialShowQuestionMark(0, 1));
} }
} }
@ -256,9 +240,9 @@ public class Q00255_Tutorial extends Quest
public void onPlayerPressTutorialMark(OnPlayerPressTutorialMark event) public void onPlayerPressTutorialMark(OnPlayerPressTutorialMark event)
{ {
final QuestState qs = getQuestState(event.getActiveChar(), false); final QuestState qs = getQuestState(event.getActiveChar(), false);
if ((qs != null) && (qs.getMemoState() < 4) && (event.getMarkId() == 1)) // tutorial mark if ((qs != null) && (event.getMarkId() == 1)) // tutorial mark
{ {
startQuestTimer("goto_newbie_guide", 100, null, event.getActiveChar()); notifyEvent("goto_newbie_guide", null, event.getActiveChar());
} }
} }
@ -291,10 +275,18 @@ public class Q00255_Tutorial extends Quest
QuestState qs = getQuestState(player, true); QuestState qs = getQuestState(player, true);
if (qs != null) if (qs != null)
{ {
notifyEvent("user_connected", null, player); if (!qs.isCompleted() && STARTING_VOICE_HTML.containsKey(player.getClassId().getId()))
{
startQuestTimer("start_newbie_tutorial", 5000, null, player);
}
} }
} }
private void showTutorialHtml(L2PcInstance player, String html)
{
player.sendPacket(new TutorialShowHtml(getHtm(player.getHtmlPrefix(), html)));
}
public void playTutorialVoice(L2PcInstance player, String voice) public void playTutorialVoice(L2PcInstance player, String voice)
{ {
player.sendPacket(new PlaySound(2, voice, 0, 0, player.getX(), player.getY(), player.getZ())); player.sendPacket(new PlaySound(2, voice, 0, 0, player.getX(), player.getY(), player.getZ()));

2
L2J_Mobius_Classic/dist/game/data/scripts/quests/Q00255_Tutorial/tutorial_02.html vendored
View File

@ -1,5 +1,5 @@
<html><body> <html><body>
<center><font color="LEVEL">[Movement]</font></center><br> <center><font color="LEVEL">[Movement]</font></center><br>
Move your mouse cursor to the spot to which you want to move and <font color="FF0000">left-click</font>. Then, you will be moved to that location.<img src="L2UI_CH3.tutorial_img01" width=64 height=64><img src="L2UI_CH3.tutorial_img021" width=64 height=64><br> Move your mouse cursor to the spot to which you want to move and <font color="FF0000">left-click</font>. Then, you will be moved to that location.<img src="L2UI_CH3.tutorial_img01" width=64 height=64><img src="L2UI_CH3.tutorial_img021" width=64 height=64><br>
<Button ALIGN=LEFT ICON="NORMAL" action="bypass -h Quest Q00255_Tutorial close_window">Exit the Tutorial</Button> <Button ALIGN=LEFT ICON="NORMAL" action="bypass -h Quest Q00255_Tutorial close_tutorial">Exit the Tutorial</Button>
</body></html> </body></html>