Explinations
 

Now... as I have been working on a new components.bmp file, I am going to need to start working on the components.txt file to make use of the new GraphX.

I need to have the functions of the components explained, since I did not find a line-by-line explination of the template files in the modding document.

------
* - Self Explanatory, no details needed.

Class Name := *
Name := *
Description := *Allowed Vehicle Types := *
Restriction Type := ?
Restriction Value := ?
Space Object XFile Name := *
Picture Bitmap Index := ?? &lt;&lt; <font color="blue"> Biggie: How does the graphic engine parse image files? I know it can parse a file longer than 520 pixels, can it parse wider than 400 pixels? How does it parse the end of a 'line' of images and move down to the next?</font> &gt;&gt;
Placement Locations := *
Default Repair Priority := *
Tonnage Space Taken := *
Tonnage Structure := *
Level Minimum := 1 &lt;&lt;<font color="blue">Required level to find in stores or use?</font>&gt;&gt;
Illegal Cargo := *
Uses Levels := *
Is Commodity := *
Event ID := 0 &lt;&lt;<font color="blue"> The availability of items in the store or as discarded cargo can be set to a particular event? How??</font>&gt;&gt;
Base Credit Value := *
Credit Value Inc Pct Per Level := *
Energy Consump Inc Per Level := *
Sound Filename := * &lt;&lt;<font color="blue">A good place to find new sound FX would be nice...</font>&gt;&gt;
Energy Consumption := 10 &lt;&lt;<font color="blue">[Is this per second, per shot??</font>&gt;&gt;
Weapon Type := *
Weapon Target := *
Weapon Damage Point Blank := *
Weapon Damage Dec Per 10 Rng := 1 &lt;&lt;<font color="blue">[I have not seen how this works at all, unless it means afterthe tenth range box??</font>&gt;&gt;
Weapon Damage Inc Per Level := *
Weapon Damage Maximum Range := * &lt;&lt;<font color="blue">[What is the max effective range any weapon can reach in SF?</font>&gt;&gt;
Weapon Damage Type := *
Weapon Reload Rate MS := *
Weapon Display Effect Name := APB beam &lt;&lt;<font color="blue">[How does the game determine beams and parse the beam image files, since there are multiple files?</font>&gt;&gt;
Weapon Beam Duration := 50 &lt;&lt;<font color="blue">[Milliseconds?</font>&gt;&gt;
Weapon Explosion Effect Name := *
Weapon Beam Burn Color := 255, 65, 255 &lt;&lt;<font color="blue">[I have seen no change in the game after altering this.</font>&gt;&gt;
Weapon Autofires := *
Weapon Tonnage Structure := *
Number of Effects := 1 &lt;&lt;<font color="blue">[Where can I get a list of effects to know what can be used here?</font>&gt;&gt;
Effect 1 Type := Energy Maximum
Effect 1 Base Amount := 50
Effect 1 Amount Per Level := 0
Number of Requirements := 0 &lt;&lt;<font color="blue">[Same question.</font>&gt;&gt;

Anti - Proton Beam Beam S, F Normal 3000 30 25 20 15 10 5 0 0 0 0 0 &lt;&lt;<font color="blue">What does the S, F mean? Since there are only ten range boxes, how do these damage listings affect the 20 range boxes in the game?</font>

Anti-Proton Beam Beam Beam 10 &lt;&lt;<font color="blue">How does it know where beam 10 is? There are four beam files.</font>&gt;&gt;

Re: Explinations
 

irst thing's first. That second to Last entry is NOT VALID. I strongly suspect the Last one isn't either. This is the actual Anti Proton Beam record:

Class Name := Anti - Proton Beam
Name := Anti - Proton Beam
Description := Focused energy beam used as a medium range weapon.
Allowed Vehicle Types := Ship, Base, Satellite, Fighter
Space Object XFile Name := Cargo Pod
Picture Bitmap Index := 18
Placement Locations := Weapon (Light)
Default Repair Priority := 6
Tonnage Space Taken := 30
Tonnage Structure := 30
Level Minimum := 1
Uses Levels := TRUE
Restriction Type := None
Restriction Value := 0
Illegal Cargo := FALSE
Is Commodity := FALSE
Event ID := 0
Base Credit Value := 3000
Credit Value Inc Pct Per Level := 20
Sound Filename := Anti - Proton Beam
Energy Consumption := 30
Energy Consump Inc Per Level := 0
Weapon Type := Beam
Weapon Target := Ship, Base, Fighter, Satellite
Weapon Damage Point Blank := 25
Weapon Damage Dec Per 10 Rng := 5
Weapon Damage Inc Per Level := 5
Weapon Damage Maximum Range := 60
Weapon Damage Type := Normal
Weapon Reload Rate MS := 3000
Weapon Display Effect Name := Beam 10
Weapon Explosion Effect Name := Explosion
Weapon Beam Burn Color := 72, 235, 0
Weapon Beam Duration := 50
Weapon Autofires := FALSE
Weapon Tonnage Structure := 0
Number of Effects := 0
Number of Requirements := 0

Picture bitmap index is pretty simply. Look at the components.bmp file. It starts at either 0 or 1 for the Bridge and the index number goes up by one with each new square. Once it hits ten it goes back to the begining of the file and starts over at 10 or 11. You can make the file longer, but not wider.

Not sure on the level minimum; never used it.

Event ID is a bit tricky. Certain events have fields for this so you can indeed remove or add components. E.g. you could set it so anytime a cargo of event ID 3532 was picked up it would show a text message.

Soundfilename- no help there.

Energy consumpion is per shot.

Weapon Damage Dec Per 10 Rng is how many damage points the weapon looses per 10 LS of distance to the target.

Weapon Damage Maximum range sets the max range it can fire to. It can be pretty much as large as you like, but depending on what the previous field says it might not actually get that far (i.e. its damage hits zero before max range)

Weapon Display Effect Name: refers to Main_BitmapEffects.txt. (which also sets shot speeds, FYI)

Beam duration is in milliseconds IIRC.

Burn color refers to the color created when the weapon hits the shield also IIRC.

The effects lists comes from effects.txt in the Data folder. Requirements can IIRC only be used to limit the number of components per ship.

EDIT: Two other notes. One, the game treats a blank line as the end of a component. Two, the game treats a double blank line as a end of file marker.

Re: Explinations
 

Okay... help?? http://forum.shrapnelgames.com/image...s/confused.gif

I've been trying to experiment with the main_components.txt file, insofar as changing the pointers to new graphic coordinates.

But it's totally ignoring any new 'picture bitmap index' pointer that I put into the file (line six in the component record) . All other changes are there, but not the new graphic. It still looks in the old slot, regardless. http://forum.shrapnelgames.com/image...s/confused.gif http://forum.shrapnelgames.com/images/smilies/mad.gif http://forum.shrapnelgames.com/image...s/confused.gif

<font color="red">HELP!</font>

Re: Explinations
 

That's strange..what component are you trying to change?

EDIT: better question- you are starting a new game with the same campaign you made the change to, right? Modding an existing savegame can work, but often components already on ships or in spacedocks don't get modified- only the newly generated components do.

Re: Explinations
 

All of them. See my thread 'GraphX'. Essentially I'm taking much of the art from SE4, and several mods for it, and creating a new components.bmp file.

Unfortunately it is refusing to pay attention to the new bitmap indexing I add to the components.txt file... as if it's still reading that from some other file somewhere else, and it's got me stymed.

I've tried both. I get the same results either way. http://forum.shrapnelgames.com/image...s/confused.gif

Re: Explinations
 

Where is the changed components.bmp? In order for it to work you either have to change the default file OR make sure its in (Campaign Name)/Images/Components/Components.bmp. If you do the latter the changes will only apply to that particular campaign.

Re: Explinations
 

There is no 'images' directory in the campaign directory tree. There's only the one components directory under the image directory, which is directly under the starfury root. P&amp;N has an image directory, but it contains only some effects that I guess override or suppliment the existing image files.

I have changed the original file, replacing it with an entirely new components.bmp - and in the game, since for some reason it is not reading the image bitmap index line in the components.txt file, I am seeing completely different graphics in the game (whatever I've put into the slot it addressed previously).

Q:
Does the game engine look at another file altogether to parse its component images? That is the only explination I can seem to think of as to wny my altered components.txt file is not functioning correctly. http://forum.shrapnelgames.com/images/smilies/mad.gif

Re: Explinations
 

You can create Images folder in the campaing you want as well as XFiles and Sounds folders and their subfolders. Then when running the campaign the game will look for the images at the campaign folder first and if it doesn't find them it will search the original images folder. Same goes for x files and sounds.

For my knowledge the components.txt doesn't refer to anything else expect to the components.bmp and to that only with slot number. If I recall correctly each slot is 40x40 in the image. My alterations have all worked fine if not counting the few background problems. The pink color wasn't so pink so the objects showed a thin purple line around them.

Re: Explinations
 

You are seeing different icons, then? The only thing I can think of at this point is that you aren't actually setting the components.txt correctly. Can you post the components.txt and your new components.bmp please?

Re: Explinations
 

I suspect that I might be.. in which case I would have expected either a crash, or an absolute hash of the images. But neither happened. I got images, but the wrong ones (since slot 1 was replaced with a weapon, my 'bridge' in the game was that weapon... even though in the components.txt file the index number for 'bridge' was 191).

Here is my components.txt file. You can find my components image file (in JPG format for size) in my GraphX thread.

As for the purple/pink line around the items... I've solved that problem and it'll be clean in the finished components.bmp file.
Photoshop replace color is a handy tool... http://forum.shrapnelgames.com/image...es/biggrin.gif

Re: Explinations
 

umm. I'm not seeing a file in either thread, actually..

Re: Explinations
 

Just below the reply subject header is a line at the end of which is a hyperlinked attachment

Re: explinations [Re:Phoenix-D]
#296823 - 09/20/04 08:31 PM <font color="red">Attachment</font> (1 downloads)

Same situation for the graphX thread, with the second post.

<font color="blue">Components.txt</font>
http://www.shrapnelcommunity.com/thr...?Number=296823

<font color="blue">Components.JPG</font>
http://www.shrapnelcommunity.com/thr...?Number=296183

Re: Explinations
 

Ah, oops. http://forum.shrapnelgames.com/image...s/rolleyes.gif Haven't used attachments on this board before.

Re: Explinations
 

http://forum.shrapnelgames.com/images/smilies/wink.gif Took me a bit to figure it out as well, and this is the first group I've found that allows attachments. http://forum.shrapnelgames.com/images/smilies/smile.gif

Any luck understanding the file(s)?

Note
I'm completely redoing the components file all over from scratch again, so the one in the above thread is no longer really valid (though it is for the comp.txt file I attached). I've expanded my ideas for My Little Mod. http://forum.shrapnelgames.com/image...es/biggrin.gif

Re: Explinations
 

I plugged both of them in- the component I resaved as components.bmp in my main folder and the other got plopped into campaign 1.

I don't see any problem at all. The pictures are occuring exactly as how you set them. They don't make any SENSE, but they're appearing correctly. For example your standard shield generator is component image ID 121.

Picture 121 may be many things but it doesn't look like a shield to me. Even weirder you have standard armor with a bitmap ID of 157. There is NOTHING in square 157! Its just a purple blotch.

Re: Explinations
 

Hrm... I think that jpg might not be working right anyway. I did some minor tinkering after posting it, but things should've remained in place unless my indexing was way off. The next file will have line-by line numbering so I know where I'm looking before I start mapping the new component slots.

I'm glad it worked clearly for you, though. Was being an absolute bugger for me.

Because I wanted to have a visual difference between say... 2 ton standard armor and 20 ton, I was looking for some way of making them look similar but obviously bigger or whatnot. Some came out looking wonky at the first attempt. I found a decent armor set for the next comp.bmp attempt. How they look in the game has yet to be seen. http://forum.shrapnelgames.com/images/smilies/happy.gif

Re: Explinations
 

Oh, your numbering and the actual file was fine..its just the numbers you assigned in components.txt didn't make any sense.

Re: Explinations
 

I suggest you use PNGs in the future. They have lossless compression, so you do not get wacky pictures resulting from jpg conVersion. Or just zip the bmps before uploading them. JPGs should be avoided at all costs, except as a demo when absolutely necessary (PNGs are better in that situation anyways... a bit larger, but no color loss).