Stendhal Quest Coding - Part 3: Difference between revisions

These are used for the travel logs and other parts of the game which refer to quests - e.g. the achievement for completing all quests in Semos needs the region to be set for quests in Semos city, to be able to find them. These standard methods give meta information about the quest which is accessible to other parts of the Stendhal code.

=== getHistory ===

This fills in the quest history in the travel log. It is basically a list of steps in the quest in readable form. It starts with an empty list and then checks the state of the player. The list is added to if the player has completed that step. Finally the list is returned at the end.

<source lang = "java">

@Override

public List<String> getHistory(final Player player) {

final List<String> res = new ArrayList<String>();

if (!player.hasQuest(QUEST_SLOT)) {

return res;

}

res.add("I have talked to Hayunn.");

final String questState = player.getQuest(QUEST_SLOT);

if ("rejected".equals(questState)) {

res.add("I do not want to make Hayunn drunk.");

}

if (player.isQuestInState(QUEST_SLOT, "start", "done")) {

res.add("I promised to buy him a bear from Margaret in Semos Tavern.");

}

if (("start".equals(questState) && player.isEquipped("beer")) || "done".equals(questState)) {

res.add("I have a bottle of beer.");

}

if ("done".equals(questState)) {

res.add("I gave the beer to Hayunn. He paid me 20 gold coins and I got some experience.");

}

return res;

}

</source>

There are a few ways to check the states. Some developers use ChatConditions like we did when setting the NPC conversation. Others use more direct checks on the quest state. If using ChatConditions, these have been written to work with the add method for the NPC. If you just want to use them to get a true/false value directly, , you need to get at the 'fire', for example <code>(new() QuestCompletedCondition(QUEST_SLOT).fire(player, null, null)</code>.

=== getQuestInfo / fillQuestInfo ===

{{TODO|populate with an example from BeerForHayunn and explanation}}

=== getMinLevel ===

This piece of meta information suggests the minimum level of player who may be expected to completed the quest. It's not a hard requirement - ChatConditions on the level should be used if you really want to add a level restriction, when the NPC offers the quest.

This value is used in the travel log and for other NPCs who might hint that you start unstarted quests - they won't hint at unstarted quests beyond your level. If the value is 0, i.e. any player can do it, you don't need to add this method, as this is the default (though, BeerForHayunn does explicitly set the value to 0 and there is no harm in this.)

<source lang="java">

@Override

public int getMinLevel() {

return 10;

}

</source>

If there is a specific region matching one of the Stendhal regions, as defined in [https://github.com/arianne/stendhal/blob/master/src/games/stendhal/server/maps/Region.java Region.java], then you can set this here and any achievements or NPCs referring to quests from that region will notice the quest. You can leave this method out if you have no region to set (e.g. global quests) because the default is null.

Fill in the name of the NPC that the player starts the quest with. You can leave this method out if there is no specific NPC who starts the quest (e.g. the Seven Cherubim quest where you just start meeting any of the angels.) This is unlikely to happen often.

<source lang="java">

@Override

public String getNPCName() {

return "Hayunn Naratha";

}

</source>

Reference functions that gather 'meta' information about the quest use this - for example if an NPC wants to list which NPCs to speak to to start quests in a certain region.

{{TODO|Others? isCompleted? isRepeatable? More of the name ones?}}

You can have a look at the [https://github.com/arianne/stendhal/blob/master/src/games/stendhal/server/maps/quests/BeerForHayunn.java complete source code for this quest].

* [[How to test NPC Parser]] - ''this can help with trouble shooting if an NPC isn't understanding a response''