VoidExpanse/installing mods - Revision history

Ai enabled: /* Using mods */

2016-04-05T03:35:22Z

Using mods

← Older revision		Revision as of 03:35, 5 April 2016
Line 12:		Line 12:

	To install the mod, just drop it at the folder:		To install the mod, just drop it at the folder:
	Windows: <User Documents>/AtomicTorchStudio/VoidExpanse/Mods
	Linux: ~/.config/AtomicTorchStudio/VoidExpanse/Mods		''Windows:'' <User Documents>/AtomicTorchStudio/VoidExpanse/Mods
	Ma╤ü: ~/Library/Application Support/AtomicTorchStudio/VoidExpanse/Mods
			''Linux:'' ~/.config/AtomicTorchStudio/VoidExpanse/Mods

			''Ma╤ü:'' ~/Library/Application Support/AtomicTorchStudio/VoidExpanse/Mods

Ai enabled: /* Using mods */

2016-04-05T03:34:56Z

Using mods

← Older revision		Revision as of 03:34, 5 April 2016
Line 11:		Line 11:
	'''STEAM and NON-STEAM versions'''		'''STEAM and NON-STEAM versions'''

	To install the mod, just drop it at the folder /~~Documents~~/AtomicTorchStudio/VoidExpanse/Mods		To install the mod, just drop it at the folder:
			Windows: <User Documents>/AtomicTorchStudio/VoidExpanse/Mods
			Linux: ~/.config/AtomicTorchStudio/VoidExpanse/Mods
			Ma╤ü: ~/Library/Application Support/AtomicTorchStudio/VoidExpanse/Mods


	Then open "Mods" menu from the main menu in the game and mark the mod as active, click on a little checkbox near the mod icon.		Then open "Mods" menu from the main menu in the game and mark the mod as active, click on a little checkbox near the mod icon.
	Then click "Save" - mods configuration will be saved and the mods will be validated.		Then click "Save" - mods configuration will be saved and the mods will be validated.

Askew1: Fix link to modding article.

2015-04-15T11:25:55Z

Fix link to modding article.

← Older revision		Revision as of 11:25, 15 April 2015
Line 1:		Line 1:
	== Mod files ==		== Mod files ==
	This article mainly explains how to use already existing mods. If you are interested in creating mods please see: [[VoidExpanse/~~Modding~~\|VoidExpanse Modding]].		This article mainly explains how to use already existing mods. If you are interested in creating mods please see: [[VoidExpanse/modding\|VoidExpanse Modding]].

	There are two kinds of mod files: .CPK and .MPK.		There are two kinds of mod files: .CPK and .MPK.
Line 7:		Line 7:

	'''MPK''' - stands for Mod Package. It contains all additional files that a mod adds.		'''MPK''' - stands for Mod Package. It contains all additional files that a mod adds.


	== Using mods ==		== Using mods ==

Ai enabled: /* Using mods */

2015-04-08T08:29:48Z

Using mods

← Older revision		Revision as of 08:29, 8 April 2015
Line 11:		Line 11:
	== Using mods ==		== Using mods ==
	'''STEAM and NON-STEAM versions'''		'''STEAM and NON-STEAM versions'''

	To install the mod, just drop it at the folder /Documents/AtomicTorchStudio/VoidExpanse/Mods		To install the mod, just drop it at the folder /Documents/AtomicTorchStudio/VoidExpanse/Mods
	Then open "Mods" menu from the main menu in the game and mark the mod as active, click on a little checkbox near the mod icon.		Then open "Mods" menu from the main menu in the game and mark the mod as active, click on a little checkbox near the mod icon.
	Then click "Save" - mods configuration will be saved and the mods will be validated.		Then click "Save" - mods configuration will be saved and the mods will be validated.


	'''STEAM version only'''		'''STEAM version only'''
	In the Steam version you can ~~also~~ install mods by subscribing on them in Steam Workshop - http://steamcommunity.com/app/324260/workshop/
			In the Steam version you can install mods by subscribing on them in Steam Workshop - http://steamcommunity.com/app/324260/workshop

	== ModsConfig.xml ==		== ModsConfig.xml ==

Ai enabled: /* Using mods */

2015-04-08T08:28:38Z

Using mods

← Older revision		Revision as of 08:28, 8 April 2015
Line 10:		Line 10:

	== Using mods ==		== Using mods ==
			'''STEAM and NON-STEAM versions'''
	To install the mod, just drop it at the folder /Documents/AtomicTorchStudio/VoidExpanse/Mods		To install the mod, just drop it at the folder /Documents/AtomicTorchStudio/VoidExpanse/Mods
	Then open "Mods" menu from the main menu in the game and mark the mod as active, click on a little checkbox near the mod icon.		Then open "Mods" menu from the main menu in the game and mark the mod as active, click on a little checkbox near the mod icon.
	Then click "Save" - mods configuration will be saved and the mods will be validated.		Then click "Save" - mods configuration will be saved and the mods will be validated.

			'''STEAM version only'''
			In the Steam version you can also install mods by subscribing on them in Steam Workshop - http://steamcommunity.com/app/324260/workshop/

	== ModsConfig.xml ==		== ModsConfig.xml ==

Ai enabled: /* Using mods */

2015-04-08T08:27:22Z

Using mods

← Older revision		Revision as of 08:27, 8 April 2015
Line 10:		Line 10:

	== Using mods ==		== Using mods ==
	To install mod, just drop it at /Documents/AtomicTorchStudio/VoidExpanse/Mods ~~and~~ open "Mods" menu from the main menu in the game~~. Then you need to~~ mark it as active ~~by clicking~~ on a little checkbox near the mod icon.		To install the mod, just drop it at the folder /Documents/AtomicTorchStudio/VoidExpanse/Mods
			Then open "Mods" menu from the main menu in the game and mark the mod as active, click on a little checkbox near the mod icon.
			Then click "Save" - mods configuration will be saved and the mods will be validated.

	== ModsConfig.xml ==		== ModsConfig.xml ==

Ai enabled: /* Using mods */

2015-04-08T08:25:42Z

Using mods

← Older revision		Revision as of 08:25, 8 April 2015
Line 10:		Line 10:

	== Using mods ==		== Using mods ==
	~~The recommended way to~~ install and ~~use mods is by using~~ "~~AtomicTorch Game Launcher~~". If you ~~have downloaded this launcher~~ it ~~will take care of the mods for you.~~		To install mod, just drop it at /Documents/AtomicTorchStudio/VoidExpanse/Mods and open "Mods" menu from the main menu in the game. Then you need to mark it as active by clicking on a little checkbox near the mod icon.

	~~'''To install~~ a ~~mod:''' just double click on~~ the mod ~~file and it will be automatically installed in the mod folder.~~

	~~'''To activate a mod:''' just press on the cog~~ icon ~~next to "Play" button and press "Select Active Mods" where you can just put tick next to mods you want to load and reorder their loading list if needed~~.


	== ModsConfig.xml ==		== ModsConfig.xml ==

Atomic-admin: /* ModsConfig.xml */

2015-01-16T08:40:01Z

ModsConfig.xml

← Older revision		Revision as of 08:40, 16 January 2015
Line 18:		Line 18:

	== ModsConfig.xml ==		== ModsConfig.xml ==
	To determine what mods should be loaded there is "ModsConfig.xml" file. It is usually located in the documents folder (documents/AtomicTorchStudio/VoidExpanse) and contains a list of mods that will be loaded the next time you start the game. Usually you don't have to edit this file by hands, but for the sake of completeness here is its structure:		To determine what mods should be loaded there is "ModsConfig.xml" file. It is usually located in the documents folder (''documents/AtomicTorchStudio/VoidExpanse'') and contains a list of mods that will be loaded the next time you start the game. Usually you don't have to edit this file by hands, but for the sake of completeness here is its structure:

	<pre>		<pre>

Atomic-admin at 08:08, 6 January 2015

2015-01-06T08:08:19Z

← Older revision		Revision as of 08:08, 6 January 2015
Line 26:		Line 26:

	As you can see each mod specified as it's internal ID and it's version.		As you can see each mod specified as it's internal ID and it's version.

			{{Modding}}

Atomic-admin at 08:06, 6 January 2015

2015-01-06T08:06:53Z

← Older revision		Revision as of 08:06, 6 January 2015
Line 1:		Line 1:
	== Mod files ==		== Mod files ==
			This article mainly explains how to use already existing mods. If you are interested in creating mods please see: [[VoidExpanse/Modding\|VoidExpanse Modding]].

	There are two kinds of mod files: .CPK and .MPK.		There are two kinds of mod files: .CPK and .MPK.

	'''CPK''' - stands for Core Package. It contains essential game functionality, and without it		'''CPK''' - stands for Core Package. It contains essential game functionality, and without it game won't work. There shouldn't be multiple CPK files loaded at the same time as it can cause galaxy-scale disasters (not really).
	game won't work. There shouldn't be multiple CPK files loaded ~~into one game,~~ it can cause galaxy-scale
	disasters.

	'''MPK''' - stands for Mod Package. It contains additional files, that~~'ll be added to game's virtual file system and overwrite~~		'''MPK''' - stands for Mod Package. It contains all additional files that a mod adds.
	~~files with the same name and path, contained in CPK and previous MPK files~~.

	~~For example, if we have CPK with file /content/readme.txt and MPK with file /content/readme.txt, then~~
	~~the second one will be loaded, and first one ignored. This mechanism is created to make overriding core~~
	~~functionality easy, without recompiling whole CPK.~~

	== ~~MPK structure~~ ==		== Using mods ==
			The recommended way to install and use mods is by using "AtomicTorch Game Launcher". If you have downloaded this launcher it will take care of the mods for you.

	~~Each~~ mod ~~must have header.xml, or~~ it ~~won't~~ be ~~loaded~~.		'''To install a mod:''' just double click on the mod file and it will be automatically installed in the mod folder.
	~~Structure of header.xml is in standart XML format~~:
	~~<pre>~~		'''To activate a mod:''' just press on the cog icon next to "Play" button and press "Select Active Mods" where you can just put tick next to mods you want to load and reorder their loading list if needed.
	~~<?xml version=~~"~~1.0~~" ~~encoding=~~"~~utf-8~~"?>
	~~<root>~~
	~~<id>devmod</id>~~		== ModsConfig.xml ==
	~~<title>Dev Mod</title>~~		To determine what mods should be loaded there is "ModsConfig.xml" file. It is usually located in the documents folder (documents/AtomicTorchStudio/VoidExpanse) and contains a list of mods that will be loaded the next time you start the game. Usually you don't have to edit this file by hands, but for the sake of completeness here is its structure:
	~~<author>AtomicTorch Studio</author>~~
	~~<description>Dev~~. ~~mod for easier debugging for VoidExpanse.</description>~~
	~~<version>0~~.1.0</~~version>~~
	~~<updated>17.01.2014<~~/~~updated>~~
	~~<modtype>2</modtype> <!-- 1 - server, 2 - client-server, 3 - client -->~~
	~~</root>~~
	~~</pre>~~
	~~For every mod, there's~~ a ~~unique ID formed: [id]_[version]~~. ~~For instance~~, ~~unique ID~~ of ~~this mod~~ is ~~'''devmod_0.1.0'''.~~

	~~To add/remove mods from game, there's a file '''ModsConfig.xml'''. All mods, that should be loaded, should be listed in this file.~~
	~~To add "devmod" mod, just add this line into "mods" tag:~~
	<pre>		<pre>
	<mod>~~devmod_0~~.1.1</mod>		<mod>core_1.0.0</mod>
			<mod>some_awesome_mod_0.5.9</mod>
	</pre>		</pre>

	~~Modtype is a special parameter, defines whether mod should be loaded on server, on client, or both.~~		As you can see each mod specified as it's internal ID and it's version.
	~~For example, if we want to create a mod, which just replaces some icons, this is a typical '''client''' mod.~~
	~~Client-side mods will be ignored by server, if listed in ModsConfig.xml.~~
	~~Mods, that contains only server-side alterations, like new topics or scriptis, are typical '''server'''~~ mod.
	~~If they are listed in ModsConfig.xml, server will load them, but~~ it ~~won~~'~~t demand one of players. It means, that~~
	~~if server has server-side mod,~~ and ~~client is not -~~ it's ~~okay.~~
	~~Third type is client-server mod, complex type of mod, which is needed on both client and server. If server was created~~
	~~with specific server-side mod, and client doesn't have the same one, server won't let client connect and will give a~~
	~~warning.~~

	~~== Virtual file system concepts ==~~

	* All mods are loaded into one virtual file system, with overwrite rule (see in "mod files" section above).
	* Mods can use each other files, so don't hesitate to use original game resources in your mods.
	* If two MPK files have the same file (path+name), the last one (by order in ModsConfig.xml) will be taken.
	* All file names are not case-sensitive. QwEr.xml and qwer.xml are considered the same.