Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

source: code/trunk/src/orxonox/objects/quest/LocalQuest.h @ 3172

Last change on this file since 3172 was 3068, checked in by landauf, 16 years ago

removing svn:mergeinfo again after sound2 merge

  • Property svn:eol-style set to native
File size: 4.2 KB
RevLine 
[1992]1/*
2 *   ORXONOX - the hottest 3D action shooter ever to exist
3 *                    > www.orxonox.net <
4 *
5 *
6 *   License notice:
7 *
8 *   This program is free software; you can redistribute it and/or
9 *   modify it under the terms of the GNU General Public License
10 *   as published by the Free Software Foundation; either version 2
11 *   of the License, or (at your option) any later version.
12 *
13 *   This program is distributed in the hope that it will be useful,
14 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
15 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16 *   GNU General Public License for more details.
17 *
18 *   You should have received a copy of the GNU General Public License
19 *   along with this program; if not, write to the Free Software
20 *   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
21 *
22 *   Author:
23 *      Damian 'Mozork' Frick
24 *   Co-authors:
25 *      ...
26 *
27 */
[2261]28 
29/**
[2911]30    @file LocalQuest.h
[2662]31    @brief Definition of the LocalQuest class.
[2261]32*/
[1992]33
34#ifndef _LocalQuest_H__
35#define _LocalQuest_H__
36
[2095]37#include "OrxonoxPrereqs.h"
38
[1996]39#include <map>
[1992]40#include <string>
41
[2076]42#include "core/XMLPort.h"
[1992]43#include "Quest.h"
44
[2662]45namespace orxonox
46{
[1992]47    /**
48    @brief
[2261]49        Handles Quests which have different states for different players.
50        LocalQuests have (as opposed to GlobalQuests) a different state for each player, that means if for one player the status of the Quest changes it does not for all the other players which also possess this quest.
51       
52        Creating a LocalQuest through XML goes as follows:
53       
54        <LocalQuest id="questId"> //Where questId is a GUID, see http://en.wikipedia.org/wiki/Globally_Unique_Identifier#Basic_structure for more information
55            <QuestDescription title="Title" description="Description." /> //The description of the quest.
56            <subquests>
[2662]57                <Quest id ="questId1" /> //A list of n subquest, be aware, each of the <Quest /> tags must have a description and so on and so forth as well.
58                ...
59                <Quest id="questIdn" />
60                </subquests>
61                <hints>
62                <QuestHint id="hintId1" /> //A list of n QuestHints, see QuestHint for the full XML representation of those.
63                ...
64                <QuestHint id="hintIdn" />
65                </hints>
[2261]66            <fail-effects>
67                <QuestEffect /> //A list of QuestEffects, invoked when the Quest is failed, see QuestEffect for the full XML representation.
68                ...
69                <QuestEffect />
70            </fail-effects>
71            <complete-effects>
72                <QuestEffect /> //A list of QuestEffects, invoked when the Quest is completed, see QuestEffect for the full XML representation.
73                ...
74                <QuestEffect />
75            </complete-effects>
76        </LocalQuest>
[1992]77    @author
78        Damian 'Mozork' Frick
79    */
[2095]80    class _OrxonoxExport LocalQuest : public Quest
[1992]81    {
[2093]82        public:
[2092]83            LocalQuest(BaseObject* creator);
[2093]84            virtual ~LocalQuest();
[2092]85
[2261]86            virtual void XMLPort(Element& xmlelement, XMLPort::Mode mode); //!< Method for creating a LocalQuest object through XML.
87           
88            virtual bool fail(PlayerInfo* player); //!< Fails the Quest.
89            virtual bool complete(PlayerInfo* player); //!< Completes the Quest.
[2092]90
[2093]91        protected:
[2261]92            virtual bool isStartable(const PlayerInfo* player) const; //!< Checks whether the Quest can be started.
93            virtual bool isFailable(const PlayerInfo* player) const; //!< Checks whether the Quest can be failed.
94            virtual bool isCompletable(const PlayerInfo* player) const; //!< Checks whether the Quest can be completed.
[2092]95
[2261]96            virtual questStatus::Enum getStatus(const PlayerInfo* player) const; //!< Returns the status of the Quest for a specific player.
97            virtual bool setStatus(PlayerInfo* player, const questStatus::Enum & status); //!< Sets the status for a specific player.
[2092]98
[2093]99        private:
[2261]100            std::map<const PlayerInfo*, questStatus::Enum> playerStatus_; //!< List of the status for each player, with the Player-pointer as key.
[2092]101
[1992]102    };
103
104}
105
106#endif /* _LocalQuest_H__ */
Note: See TracBrowser for help on using the repository browser.