summaryrefslogtreecommitdiffstats
path: root/backend/LegacyInstance.h
blob: ef449b79408e330440c99844a1b5664d61157416 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
#pragma once

#include "BaseInstance.h"

class LIBMULTIMC_EXPORT LegacyInstance : public BaseInstance
{
	Q_OBJECT
public:
	
	explicit LegacyInstance(const QString &rootDir, SettingsObject * settings, QObject *parent = 0);
	
	/// Path to the instance's minecraft.jar
	QString mcJar() const;
	
	//! Path to the instance's mcbackup.jar
	QString mcBackup() const;
	
	//! Path to the instance's modlist file.
	QString modListFile() const;
	
	////// Directories //////
	QString minecraftDir() const;
	QString instModsDir() const;
	QString binDir() const;
	QString savesDir() const;
	QString mlModsDir() const;
	QString coreModsDir() const;
	QString resourceDir() const;
	
	/*!
	 * \brief Checks whether or not the currentVersion of the instance needs to be updated. 
	 *        If this returns true, updateCurrentVersion is called. In the 
	 *        standard instance, this is determined by checking a timestamp 
	 *        stored in the instance config file against the last modified time of Minecraft.jar.
	 * \return True if updateCurrentVersion() should be called.
	 */
	bool shouldUpdateCurrentVersion() const;
	
	/*!
	 * \brief Updates the current version. 
	 *        This function should first set the current version timestamp 
	 *        (setCurrentVersionTimestamp()) to the current time. Next, if 
	 *        keepCurrent is false, this function should check what the 
	 *        instance's current version is and call setCurrentVersion() to 
	 *        update it. This function will automatically be called when the 
	 *        instance is loaded if shouldUpdateCurrentVersion returns true.
	 * \param keepCurrent If true, only the version timestamp will be updated.
	 */
	void updateCurrentVersion(bool keepCurrent = false); 
	
	/*!
	 * Gets the last time that the current version was checked.
	 * This is checked against the last modified time on the jar file to see if
	 * the current version needs to be checked again.
	 */
	qint64 lastCurrentVersionUpdate() const;
	void setLastCurrentVersionUpdate(qint64 val);
	
	
	/*!
	 * Whether or not the instance's minecraft.jar needs to be rebuilt.
	 * If this is true, when the instance launches, its jar mods will be 
	 * re-added to a fresh minecraft.jar file.
	 */
	bool shouldRebuild() const;
	void setShouldRebuild(bool val);
	
	
	/*!
	 * The instance's current version.
	 * This value represents the instance's current version. If this value is 
	 * different from the intendedVersion, the instance should be updated.
	 * \warning Don't change this value unless you know what you're doing.
	 */
	QString currentVersion() const;
	void setCurrentVersion(QString val);

	//! The version of LWJGL that this instance uses.
	QString lwjglVersion() const;
	void setLWJGLVersion(QString val);
	
	/*!
	 * The version that the user has set for this instance to use.
	 * If this is not the same as currentVersion, the instance's game updater
	 * will be run on launch.
	 */
	QString intendedVersion() const;
	void setIntendedVersion(QString val);
	
	/*!
	 * Whether or not Minecraft should be downloaded when the instance is launched.
	 * This returns true if shouldForceUpdate game is true or if the intended and 
	 * current versions don't match.
	 */
	bool shouldUpdate() const;
	void setShouldUpdate(bool val);
	
	/// return a valid GameUpdateTask if an update is needed, return NULL otherwise
	virtual GameUpdateTask* doUpdate();
	
	/// prepare the instance for launch and return a constructed MinecraftProcess instance
	virtual MinecraftProcess* prepareForLaunch( QString user, QString session );
};