Ships and General Mod Creation - Revision history

AdmiralRalwood: /* Getting Started: */ Cleaning up this awkward construction.

2016-08-30T19:14:58Z

Getting Started:: Cleaning up this awkward construction.

← Older revision		Revision as of 19:14, 30 August 2016
Line 32:		Line 32:
	*''Interface'' - Images and animations used in the menu system go here. Not everything that you would expect to be a still is stored as a still, so research carefully before changing anything. Only larger mods and total conversions generally go into this because it is hard to do properly.		*''Interface'' - Images and animations used in the menu system go here. Not everything that you would expect to be a still is stored as a still, so research carefully before changing anything. Only larger mods and total conversions generally go into this because it is hard to do properly.
	*''Maps'' - Texture files for ships and other model-based objects.		*''Maps'' - Texture files for ships and other model-based objects.
	*''Missions'' - This is where FRED should be storing mission files and the only place where FS2 will look for missions both single player ~~and campaign~~.		*''Missions'' - This is where FRED should be storing mission files and the only place where FS2 will look for missions and campaigns, both single- and multi-player.
	*''Models'' - .pof files go here no matter what purpose.		*''Models'' - .pof files go here no matter what purpose.
	*''Music'' - In-game music files go here.		*''Music'' - In-game music files go here.

AdmiralRalwood: /* Getting Started: */ Cache files aren't used anymore.

2016-08-30T19:01:54Z

Getting Started:: Cache files aren't used anymore.

← Older revision		Revision as of 19:01, 30 August 2016
Line 23:		Line 23:

	*''Cache'' - To reduce loading times, the engine will generate a cache file for each model it encounters. Since cache generation can take quite long for more complex models, you should always include cache files for unique mods.		*''Cache'' - To reduce loading times, the engine will generate a cache file for each model it encounters. Since cache generation can take quite long for more complex models, you should always include cache files for unique mods.
			{{Table374\|
			:Cache files are no longer used or generated by the executable; since making a new mod should always be done on the latest stable release, you shouldn't have to worry about cache files anymore.}}
	*''Cbanims'' - This is where command and mission briefing animations are stored.		*''Cbanims'' - This is where command and mission briefing animations are stored.
	*''Effects'' - Weapon and other 2D effects, stars, planets, nebulae, e.t.c.		*''Effects'' - Weapon and other 2D effects, stars, planets, nebulae, e.t.c.

Headdie: expanded Effects entry

2011-09-11T19:37:21Z

expanded Effects entry

← Older revision		Revision as of 19:37, 11 September 2011
Line 24:		Line 24:
	*''Cache'' - To reduce loading times, the engine will generate a cache file for each model it encounters. Since cache generation can take quite long for more complex models, you should always include cache files for unique mods.		*''Cache'' - To reduce loading times, the engine will generate a cache file for each model it encounters. Since cache generation can take quite long for more complex models, you should always include cache files for unique mods.
	*''Cbanims'' - This is where command and mission briefing animations are stored.		*''Cbanims'' - This is where command and mission briefing animations are stored.
	*''Effects'' - Weapon and other 2D effects		*''Effects'' - Weapon and other 2D effects, stars, planets, nebulae, e.t.c.
	*''Fonts'' - Font files are kept here. Unless you are aiming at a total conversion, you will in all likelihood not need this folder.		*''Fonts'' - Font files are kept here. Unless you are aiming at a total conversion, you will in all likelihood not need this folder.
	*''Hud'' - This is where custom HUD graphics go.		*''Hud'' - This is where custom HUD graphics go.

SypheDMar: /* Adding A Ship */ contractions need apostrophes

2011-06-06T12:54:47Z

Adding A Ship: contractions need apostrophes

← Older revision		Revision as of 12:54, 6 June 2011
Line 61:		Line 61:
	<b>Congratulations!</b> You have just created your first mod. If you look in the maps folder there will be three .dds image files which make up the ship's texture. The models folder will contain SCLamia.pof, and in tables there are two .tbm files - one for the ship and one for a custom weapon for that ship.		<b>Congratulations!</b> You have just created your first mod. If you look in the maps folder there will be three .dds image files which make up the ship's texture. The models folder will contain SCLamia.pof, and in tables there are two .tbm files - one for the ship and one for a custom weapon for that ship.

	There is one more thing I want you to do, though. Open sclamia-shp.tbm in a text editor and find the line starting $flags:. The full line reads ''$Flags: ( "cruiser" )''. Add "in tech database" with the quotation marks to the line between the parentheses so it reads ''$Flags: ( "cruiser" "in tech database" )''. Save and close the file. This allows the Lamia to be viewed in the Techroom from the beginning. Open your FreeSpace launcher and select New Ship as the mod and run the game. If you get an error message, go back to the file and double-check the flags line to the example I provided. When you reach the main screen go to the Techroom and at the bottom should be the Shivan cruiser you just added, the ship ~~wont~~ appear in any missions at this time because a mission file needs creating using the ship.		There is one more thing I want you to do, though. Open sclamia-shp.tbm in a text editor and find the line starting $flags:. The full line reads ''$Flags: ( "cruiser" )''. Add "in tech database" with the quotation marks to the line between the parentheses so it reads ''$Flags: ( "cruiser" "in tech database" )''. Save and close the file. This allows the Lamia to be viewed in the Techroom from the beginning. Open your FreeSpace launcher and select New Ship as the mod and run the game. If you get an error message, go back to the file and double-check the flags line to the example I provided. When you reach the main screen go to the Techroom and at the bottom should be the Shivan cruiser you just added, the ship will not appear in any missions at this time because a mission file needs creating using the ship.

	===Mod.ini===		===Mod.ini===

SypheDMar: /* Adding A Ship */ Grammar

2011-06-06T12:53:32Z

Adding A Ship: Grammar

← Older revision		Revision as of 12:53, 6 June 2011
Line 45:		Line 45:
	The following will be an example of how to add a ship in FreeSpace:		The following will be an example of how to add a ship in FreeSpace:

	*~~First go~~ to [[SC Lamia]] in [[User-made Ships]] and download it.		*Go to [[SC Lamia]] in [[User-made Ships]] and download it.
	*Create a folder in FreeSpace2 directory called New Ship.		*Create a folder in FreeSpace2 directory called New Ship.
	*Within the New Ship directory, create a folder called data.		*Within the New Ship directory, create a folder called data.
	*~~Open up~~ sc_lamia.rar. If you are unable to, you can download a file archiver such as 7-zip to extract the files.		*Extract sc_lamia.rar. If you are unable to, you can download a file archiver such as 7-zip to extract the files.
	*Inside the file are three folders called maps, models and tables. Copy them into your New Ship\data folder without altering them.		*Inside the file are three folders called maps, models, and tables. Copy them into your New Ship\data folder without altering them.
	*~~create~~ a mod.ini by opening a text editor. The following are required for the mod.ini to work:		*Create a mod.ini by opening a text editor. The following are required for the mod.ini to work:
	**[launcher]		**[launcher]
	**modname = New Ship;		**modname = New Ship;

Snail: /* Getting Started: */ Wiki syntax

2011-06-04T14:53:20Z

Getting Started:: Wiki syntax

← Older revision		Revision as of 14:53, 4 June 2011
Line 22:		Line 22:
	The first thing to know when modifying FreeSpace 2 is to understand how the mod structure works. Each mod needs its own folder within the FreeSpace 2 folder. For example, Wings of Dawn on my computer is C:\Games\Freespace2\Wings of Dawn. All files that directly relate to the WoD mod are found within this folder on my PC, though a file (mod.ini) within the folder tells FreeSpace to go and look for the mediavps mod. The mod structure allows for mods to be chained together in a simple fashion. Within the mod folders is another folder called data. The data folder is not present in mods relying on .[[VP]] files, which are container files that mimic the mod structure and are used to make distributing and installing mods easier. Within the data folder are the subfolders which the files that make the mod are stored. The subfolders are there to keep everyone sane and make everything easier to find. The majority are self-explanatory but a detailed breakdown can be found in [[FS2_Data_Structure]]. Below is a summary of important information relating to this tutorial.		The first thing to know when modifying FreeSpace 2 is to understand how the mod structure works. Each mod needs its own folder within the FreeSpace 2 folder. For example, Wings of Dawn on my computer is C:\Games\Freespace2\Wings of Dawn. All files that directly relate to the WoD mod are found within this folder on my PC, though a file (mod.ini) within the folder tells FreeSpace to go and look for the mediavps mod. The mod structure allows for mods to be chained together in a simple fashion. Within the mod folders is another folder called data. The data folder is not present in mods relying on .[[VP]] files, which are container files that mimic the mod structure and are used to make distributing and installing mods easier. Within the data folder are the subfolders which the files that make the mod are stored. The subfolders are there to keep everyone sane and make everything easier to find. The majority are self-explanatory but a detailed breakdown can be found in [[FS2_Data_Structure]]. Below is a summary of important information relating to this tutorial.

	''Cache'' - To reduce loading times, the engine will generate a cache file for each model it encounters. Since cache generation can take quite long for more complex models, you should always include cache files for unique mods.		*''Cache'' - To reduce loading times, the engine will generate a cache file for each model it encounters. Since cache generation can take quite long for more complex models, you should always include cache files for unique mods.
			*''Cbanims'' - This is where command and mission briefing animations are stored.
	''Cbanims'' - This is where command and mission briefing animations are stored.		*''Effects'' - Weapon and other 2D effects
			*''Fonts'' - Font files are kept here. Unless you are aiming at a total conversion, you will in all likelihood not need this folder.
	''Effects'' - Weapon and other 2D effects		*''Hud'' - This is where custom HUD graphics go.
			*''Intelanims'' - Animations used in the Techroom for weapons and intel sections are located here.
	''Fonts'' - Font files are kept here. Unless you are aiming at a total conversion, you will in all likelihood not need this folder.		*''Interface'' - Images and animations used in the menu system go here. Not everything that you would expect to be a still is stored as a still, so research carefully before changing anything. Only larger mods and total conversions generally go into this because it is hard to do properly.
			*''Maps'' - Texture files for ships and other model-based objects.
	''Hud'' - This is where custom HUD graphics go.		*''Missions'' - This is where FRED should be storing mission files and the only place where FS2 will look for missions both single player and campaign.
			*''Models'' - .pof files go here no matter what purpose.
	''Intelanims'' - Animations used in the Techroom for weapons and intel sections are located here.		*''Music'' - In-game music files go here.
			*''Sounds'' - Sound effects like weapons fire belong here.
	''Interface'' - Images and animations used in the menu system go here. Not everything that you would expect to be a still is stored as a still, so research carefully before changing anything. Only larger mods and total conversions generally go into this because it is hard to do properly.		*''Tables'' - This is where the .tbl and .tbm files go that tells the game how to use the majority of the information in the folders listed and also controls a number of other game aspects.
			*''Voice'' - Voice overs for mission chatter.
	''Maps'' - Texture files for ships and other model-based objects.

	''Missions'' - This is where FRED should be storing mission files and the only place where FS2 will look for missions both single player and campaign.

	''Models'' - .pof files go here no matter what purpose.

	''Music'' - In-game music files go here.

	''Sounds'' - Sound effects like weapons fire belong here.

	''Tables'' - This is where the .tbl and .tbm files go that tells the game how to use the majority of the information in the folders listed and also controls a number of other game aspects.

	''Voice'' - Voice overs for mission chatter.

	==Simple Modifications==		==Simple Modifications==

SypheDMar: /* Closing Words */ Yay me!

2011-06-04T08:56:47Z

Closing Words: Yay me!

← Older revision		Revision as of 08:56, 4 June 2011
Line 135:		Line 135:
	==Closing Words==		==Closing Words==

	I cannot ~~over state~~ the usefulness of [[Portal:Modding]] and everything within its links~~, a~~ good 90-95%of what I know about modding was learned in there and the rest was trial and error with a new newbie questions on the forum and IRC channel.		I cannot overstate the usefulness of [[Portal:Modding]] and everything within its links. A good 90-95% of what I know about modding was learned in there and the rest was trial and error with a new newbie questions on the forum and IRC channel.

	Another thing is that it is as a matter of courtesy to credit people ~~who’s~~ resources you use~~, you~~ are unlikely to get thrown out of the community for not doing so but it is always nice to have that little nod of thanks.		Another thing is that it is as a matter of courtesy to credit people whose resources you use. You are unlikely to get thrown out of the community for not doing so, but it is always nice to have that little nod of thanks.

	Also on a side note don’t change the name of the folder for and existing/downloaded mod~~, many~~ mods reference each other and changing the name for the folder will ~~brake~~ the links in the mod.ini of any mods that tries to use it~~, which~~ increases the chance that there will be assets missing ~~or you end up using old assets~~. On top of this when you report the issues cause by changing folder name you will be treated in a colder manner because you have broken the hard work that went into making sure the mod worked correctly in the first place ~~through a deliberate act~~. Lets face it~~, how~~ would you react if you got your mod working nicely and someone comes to you because the mod doesn’t work ~~because they changed something~~? And then several people started to complain ~~with~~ the same ~~avoidable~~ problem?		Also on a side note: don’t change the name of the folder for and existing/downloaded mod. Many mods reference each other, and changing the name for the folder will break the links in the mod.ini of any mods that tries to use it. This increases the chance that there will be assets missing. On top of this, when you report the issues cause by changing folder name, you will be treated in a colder manner because you have broken the hard work that went into making sure the mod worked correctly in the first place. Lets face it. How would you react if you got your mod working nicely and someone comes to you because the mod doesn’t work by being renamed? And then several other people started to complain about the same problem?

	Remember the most important thing when modding a ~~game,~~ FreeSpace ~~or any other like any hobby~~ is to have fun. ~~Also it~~ can be surprising how fun trial, error and figuring things out for yourself can be.		Remember the most important thing when modding a FreeSpace is to have fun. It can be surprising how fun trial, error, and figuring things out for yourself can be.


	Good luck and if you really do get stuck ~~dont~~ be afraid to ask questions.		Good luck and if you really do get stuck do not be afraid to ask questions.


	[[Category:Tutorials\|General Mod Creation]]		[[Category:Tutorials\|General Mod Creation]]

SypheDMar: /* tbm vs tbl */

2011-06-04T08:50:29Z

tbm vs tbl

← Older revision		Revision as of 08:50, 4 June 2011
Line 127:		Line 127:
	The advantage of a .vp file is ease of distribution. A .vp file is a container used to maintain the file structure. All that is required is that they are all placed in the mod folder. The problem with changing them is that if you edit one and get it wrong, you may have to reinstall the mod because there is no way for mod/FSO support teams to know what you have done to the .vp, and they have enough on their plate without having to user fix a problem that shouldn't have happened.		The advantage of a .vp file is ease of distribution. A .vp file is a container used to maintain the file structure. All that is required is that they are all placed in the mod folder. The problem with changing them is that if you edit one and get it wrong, you may have to reinstall the mod because there is no way for mod/FSO support teams to know what you have done to the .vp, and they have enough on their plate without having to user fix a problem that shouldn't have happened.

	==~~tbm vs tbl~~==		==.TBM VS. .TBL==

	A tbl is the core table file of that type and only one can be loaded into ~~freespace~~ at any one time tbl files provide the structure to the engine and ~~usually~~ require all basic elements to be present to work.		A .tbl is the core table file of that type, and only one can be loaded into FreeSpace at any one time. .tbl files provide the structure to the engine and require all basic elements to be present to work.
	tbm (called [[Modular Tables]]) on the other hand is an additional file to the tbl, usually providing additional data to the tbl or overriding it if needed. ~~Until~~ you ~~get to the stage of building mods for more than adding~~ a ~~few ships~~ you ~~will probably only use tbm if available for that table type~~. tbm also ~~has~~ the advantage that FS2 can handle multiple tbm files of any given type though avoid conflicting entries at all costs.
			A .tbm (called [[Modular Tables]]) file, on the other hand, is an additional file to the .tbl, usually providing additional data to the .tbl or overriding it if needed. Generally, you'll be using a .tbm unless you're planning on doing a total conversion. .tbm files also have the advantage that FS2 can handle multiple .tbm files of any given type, though a modder should avoid conflicting entries at all costs.

	==Closing Words==		==Closing Words==

SypheDMar: /* On VP files */

2011-06-04T08:46:10Z

On VP files

← Older revision		Revision as of 08:46, 4 June 2011
Line 121:		Line 121:
	You have downloaded some mod. You played it, and you have beaten it. However, you want to change something. Perhaps you feel the anti-fighter turrets are too weak or that there is a different ship you want to use. <b> Do NOT add, remove, or change anything in the actual folder!</b> This is because you will change the mod as long as the altered files are in there. What you should do is create a mod as explained in 'Adding A Ship' and place a mod.ini referencing the folder name for whatever mod you wish to alter in the secondary mod line. Then place the edit-that-you-want-to-make (e.g. model, .tbm, etc.) into this new mod. Once you have done all of that, select the new mod folder in the Freespace launcher’s mod tab and run. Because of the reference to the original in the mod.ini, that and any mods referenced by that mod will be loaded, but the changes you made will override the original. This way, you get to play your twist on the mod whenever you want without having to alter the original mod to play it.		You have downloaded some mod. You played it, and you have beaten it. However, you want to change something. Perhaps you feel the anti-fighter turrets are too weak or that there is a different ship you want to use. <b> Do NOT add, remove, or change anything in the actual folder!</b> This is because you will change the mod as long as the altered files are in there. What you should do is create a mod as explained in 'Adding A Ship' and place a mod.ini referencing the folder name for whatever mod you wish to alter in the secondary mod line. Then place the edit-that-you-want-to-make (e.g. model, .tbm, etc.) into this new mod. Once you have done all of that, select the new mod folder in the Freespace launcher’s mod tab and run. Because of the reference to the original in the mod.ini, that and any mods referenced by that mod will be loaded, but the changes you made will override the original. This way, you get to play your twist on the mod whenever you want without having to alter the original mod to play it.

	==On VP ~~files~~==		==.VP==

	Because of the ease in damaging data key to a mod or indeed retail <b>IT IS STRONGLY ADVISED THAT .VP FILES ARE NOT EDITED IN ANY WAY!</b>		Because of the ease in damaging data key to a mod or indeed retail, <b>IT IS STRONGLY ADVISED THAT .VP FILES ARE NOT EDITED IN ANY WAY!</b>

	The ~~significant~~ advantage of a VP file is ease of distribution. ~~in simple terms a VP~~ file is a container used to maintain the file structure ~~between users because all~~ that is required is that they are all placed in the ~~Mod~~ folder. ~~the~~ problem with changing them is that if you edit one and get it wrong ~~the simple fix and in all likely hood the fix~~ you ~~will be told to do is~~ to reinstall ~~fs2/~~the mod ~~as appropriate~~ because there is no way for mod/FSO support teams to know what you have done to the VP and they have enough on their plate without having to user fix a problem that shouldn't have happened ~~especially as the mod folders feature has been provided as a means achieving the same effect that requires no modifying of VPs~~.		The advantage of a .vp file is ease of distribution. A .vp file is a container used to maintain the file structure. All that is required is that they are all placed in the mod folder. The problem with changing them is that if you edit one and get it wrong, you may have to reinstall the mod because there is no way for mod/FSO support teams to know what you have done to the .vp, and they have enough on their plate without having to user fix a problem that shouldn't have happened.

	==tbm vs tbl==		==tbm vs tbl==

SypheDMar: /* Mod.ini */

2011-06-04T08:41:49Z

Mod.ini

@@ Line 80: / Line 80: @@
 Unlike other files, the mod.ini does not go in the data folder of a mod. Instead, this file goes in the main directory for the mod (e.g. Freespace2\New Ship for the above example) and adds the final polish to a mod. It performs useful tasks like linking other mods. Like many of the files in Freespace 2, this is basically a renamed .txt file and can be opened by any text editor. Let’s take a look at one.
-* image255x112:  Location of a 255x112 bmp you wish to display in the launcher
+This is the contents of the mod.ini for a sample mod.
-* infotext:      Text that will appear in the launcher
+Anything following a # is a comment and is ignored by the launcher.
 The first section is information for the FreeSpace launcher and contains the following:
-* modname: the mod’s name,
+* modname: the name of the mod
 * image255x112: the name of a 255x112 pixel .bmp to use as a mod image
 * infotext: the area where you can put info about the mod and/or a tag line
-* website: this activates the website button in the mod selection tab of your launcher and links it to your mod’s website if you have one
+* website: the link to your website that will be linked to the Website button in the launcher
-* forum: as above but for a forum.
+* forum: the link to your forum that will be linked to the Forum button in the launcher
 In the example shown both website and forum are commented out but if you remove the # and save they will be read by the launcher.
-The next bit links the mod into other ones, the example above will call the 3.6.12 version of the media vps to enhance the visuals of anything in Freespace 2 that is not touched by your mod, for example if you turn the Ravana green, because MediaVPs_3612 is in the secondary line it will not override this but it might do if you place it in primary.  Most of the time you will only use secondary list and this is the one you are recommended to use unless you know exactly what you are doing.
+The next bit links the mod into other ones, the example above will call the 3.6.12 version of the mediavps to enhance the visuals of anything in FreeSpace 2 that is not touched by your mod. For example, if you turn the Ravana green, the Ravan will not be red because the mediaVPs_3612 is in the secondary line. However, it will become red if you have the mediavps_3612 in your primarylist.  Most of the time, you will only use secondary list. This is the one you are recommended to use unless you know exactly what you are doing.
 ===Changing Other Mods===