NEW: Gravitational Energy Thrust Converter

The place to discuss scripting and game modifications for X²: The Threat.

Moderators: Scripting / Modding Moderators, Moderators for English X Forum

User avatar
nuclear_eclipse
Posts: 1129
Joined: Thu, 2. Sep 04, 01:54
x3tc

NEW: Gravitational Energy Thrust Converter

Post by nuclear_eclipse »

This is my first scripting effort ever, and it took me about two days from start to finish. I would have to say X scripting is the most unique type of programming I've done, and almost the most annoying on a slow computer where the menus are slow to move through. :) As a software engineer though, I think I picked it up pretty quickly, with help on a couple question from the fine members of this forum. Thanks to everyone who answered my questions when I asked. I hope EVERYONE enjoys this script as much as I do, and as always, PLEASE give me as much feedback as you can, I want to make this script as best and balanced as possible.

The current release is version 1.02, which has only a couple minor fixes over 1.00, namely stuff that should have been in 1.00 in the first place. This script can be downloaded here without signing up or anything.

P.S. If someone could do the translations for me, that would be super swell, and I would greatly appreciate it.

P.P.S. Maybe if Ticaki and Burianek are nice, this might be something that could possibly get signed, since I tried my best to balance everything pretty well. ;) I doubt it though, just wishing as always. :lol:

Code: Select all

############################################################################
#    Gravitational Energy Thrust Converter  v1.02                          #
############################################################################
#                                                                          #
#    An X2 The Threat add-on script                                        #
#    Created by John Reese, LeetCode.net                                   #
#                                                                          #
#    Find more of X at X.LeetCode.net                                      #
#                                                                          #
############################################################################

ABOUT:

THE GRAVITATIONAL ENERGY THRUST CONVERTER (GETC) was conceived as a better 
form of the official Mk1 Engine Booster as released by Egosoft in the Bonus 
Plugins pack.  It is VERY LOOSELY based upon theoretical physics and 
quantum theory.  I figured that if Egosoft could take some liberties, 
I could too.  :)

The concept is to use Quantum Tubes and Computer Components to convert
gravity from other space objects into forward momentum.  The Quantum Tubes
act as a filter to catch gravitons and the Computer Components act to 
calculate the optimum arrangement of tubes in order to squeeze maximum
performance out of every last tube. 

Unlike the Mk1 Booster, the GETC system does not use energy cells for
its power source.  The whole system does not require much external power
to operate; therefore, the onboard systems power the computer components
as necessary, and the rest of the energy comes from space itself.

This also means that the GETC system is not limited to a short time period
of use, and needs no cool-down time since the system itself does not get
hot at all.  You can use the GETC system for as long as you like.

However, the only downfall is due to the nature of quantum mechanics.
The fluctuations of particles and the laws of quantum physics work against
the GETC system.  The system itself is susceptible to the extraordinarily
high quantum fluctuations as predicted by quantum theory.  These high
spots, although very rare yet unpredictable, act to overload the package,
which causes burnout of some of the equipment.  

These overloads tend to happen every 12-16 hours, but are completely random.
They could happen almost immediatly, or they could never happen. Welcome to
quantum physics pilot! :)

############################################################################

HOW TO USE:

This package can be found at any Split Equipment Dock for about 98k credits,
even in custom galaxy games in any form.  My setup script runs through 
EVERY sector to find every Split EQ Dock and places one their.  Why the 
Split?  Well, they do love their speed, especially at the expense of cargo 
and shields, so I figured that would be a good place for such an upgrade 
to exist.

The GETC is a bit complex to prepare for use.  While finding the necessary
supplies is insanely easy to find in comparison to the Gunnery Crew, getting
the amount you need / want is the hardest part.  You will need to find both
Computer Components and Quantum Tubes in certain amounts depending on the
level of speed increase you would like. Also, in order to make the GETC 
system's job easier, your ship MUST have a full complement of engine tunings 
to supplement the power from the GETC.

Now, Tubes and Computers need to purchased in certain amounts for each level
of upgrade you would like to have.  Computer Component requirements increase
linearly for each level, starting with 2 Components at Level 1.  However,
Quantum Tubes muct be purchased in powers of 2 for each level, also 
starting with 2 Tubes for level 1.  And depending on the class of ship that
you are equipping, you must start at different levels to compensate for the
greater hull size.  Also, due to the massive size of M1, M2, and TL class
capital ships, and the small size of the M5 scout ships, the GETC can not 
be used onboard any of those classes.

As shown below are the different levels of upgrades available, as well as a 
listing of which ship classes can use that level of upgrade.

Level           Computers       Tubes           M4  M3  M6  TS  TP  GO
-----           ---------       -----           --  --  --  --  --  --
 1               2               2              X                    
 2               3               4              X   X                
 3               4               8              X   X           X   X
 4               5               16             X   X       X   X   X
 5               6               32             X   X   X   X   X   X
 6               7               64                 X   X   X   X   X
 7               8               128                    X   X   X    
 8               9               256                    X   X   X    
 9               10              512                    X   X        

When you activate the GETC system, it will find the proper level of boost
based upon the Tubes and Computers found onboard.  If the number of Tubes 
or Computers onboard drops below the level needed to sustain the system,
it will fail and shut off, requiring a restart.  If more Tubes or Computers
are detected later on, they will NOT be utilized, and the system will
assume they are cargo to be transported.

The amount of speed boost that you get from each level is approximately 20 
m/s for each ship, with M6's getting about 30 m/s per level.  At the max 
level for each class, you wont be going as fast as you would with the Mk1
Engine Booster, but I figured that along with the huge drop in cargo space
would balance out with the fact that you get non-stop juice from the GETC.

Speaking of non-stop, the GETC system *WILL* eventually fail as stated in
the ABOUT section up above.  The chances are very slim, and the general 
occurence is random, but about every 12-16 hours or so.  When this happens,
you won't lose the GETC script like you do with the Mk1 Booster, but you
will lose a random amount of Quantum Tubes and Computer Components based.

The amount lost is at most one half of WHAT WAS USED for the script. This 
means that you will NOT lose any extra Tubes or Computers you happen to be 
toting around with you, making it safe to make trade runs with Tubes and
Computers bound for somewhere else, or even keep extras to use as backups.

Overall, I feel that I have balanced this script as much as possible, and
it does not serve to make all your ships go insane speeds.  It is intended
as a way to give a slight advantage to your fighting fleet and your traders.
If you want insane speeds, this script IS compatible with the Mk1 Engine
Booster.  Try engaging BOTH at the same time for a really great rush; but
be warned that you will use your ENTIRE cargo bay for top speed like this.

############################################################################

VERSION HISTORY:

v1.02 - 2005-04-25
 - Bug Fix
   - Fixed a mistake on my part to erase out a test line that causes the 
       GETC system to fail out almost immediatly

v1.01 - 2005-04-25
 - Feature Changes
   - Fixed the audio to only play when used on the player's ship
   - Different audio clips play when activated on a different ship
   - Message sent to log with audio cue when overload occurs on other ships

v1.00 - 2005-04-24
 - Created the base script with the following features
   - Basic script functionaltiy
   - Sounds for starting/stopping the script and overloads
   - setup script that places the ware in Split EQ Docks
 - Bugs found and fixed
   - SETA would cause one script to get ahead of the other and GETC 
       would fail and turn off
   - Minor performance issues corrected.
   - Corrected an issue when using Mk1 Engine Booster with GETC

############################################################################

INSTALLATION:

INSTALLATION of the Gravitational Energy Thrust Converter (GETC) is very
simple and just like every other unsigned script:  

 - Unpack the Leetcode.*.xml files into your X2\scripts directory
 - Unpack the setup.Leetcode.*.xml files into your X2\scripts directory
 - Unpack the xx1337.xml files into your X2\t directory
   - You only need one of these depending on your language:
     - 331337.xml for French
     - 391337.xml for Italian
     - 441337.xml for English
     - 481337.xml for Polish
     - 491337.xml for German

############################################################################

COMPATIBILITY ISSUES:

THIS SCRIPT is compatible with all official Bonus Plugins as of 04-24-2005.
It utilizes the COMMAND_TYPE_SHIP_27 slot, the ware slot 5833, and the
language file slot 31337.  If you feel that it better belongs elsewhere, 
or you are hurt because it conflicts with your script that is much cooler, 
let me know, and I'll be willing to work it out with you.

The script is also completely compatible with any Custom Galaxy as long as
it has any race's Equipment Dock somewhere that is owned by the Split. If
it is presented to me that this may cause an issue with some Custom 
Galaxies, I will add in the ability to throw it in a different race's EQ
Dock if no Split EQ Dock was found.  But for now, that would be extra lines
that aren't needed...

If there are any other incompatibilities that are found later on, please let
me know and I will do everything I can to remedy the situation if at all
possible to do so.

############################################################################

BUGS:

So far, I have gotten every bug that I could find, and I did some pretty
extensive testing of the script in all classes of ships.  As far as I know,
there are no bugs, but as with any project, they are bound to crop up.

If you find any, please let me know as much information about the bug as 
you can, including when and where it happened, on what ship, and what other
circumstances there may be.  I will do my best to replicate the problem and
fix the issue in my next release.

############################################################################

DISCLAIMER:

THIS SCRIPT may not be altered or redistributed without prior written 
consent from me alone.  It may not be modifed for use with other scripts
unless I personally allow it.  

############################################################################

CONTACT ME:

If you have any questions about the script, me, or anything, I can be 
reached at nuclear_eclipse@leetcode.net and I will get back to you quickly.
User avatar
nuclear_eclipse
Posts: 1129
Joined: Thu, 2. Sep 04, 01:54
x3tc

Post by nuclear_eclipse »

As a note to anyone who downloaded v1.01, there was a mistake on my part that would cause the script to overload on you almost immediatly. If you download the new v1.02 script from the link in the first post, you will have the updated version without that problem. Simply Reinit Script Cache from the editor and run it again.

My apologies. :oops:
User avatar
TSM
Not a Moderator
Posts: 2947
Joined: Thu, 1. Jul 04, 12:31
x4

Post by TSM »

I d/loaded will give it ago tommorow evening one questino though does it work in conjunction with MK1 Tuning or is it a replacement?
FAQ's Egosoft Interactive FAQ
Egosoft Wiki
User avatar
nuclear_eclipse
Posts: 1129
Joined: Thu, 2. Sep 04, 01:54
x3tc

Post by nuclear_eclipse »

TycoonSpaceMan wrote:I d/loaded will give it ago tommorow evening one questino though does it work in conjunction with MK1 Tuning or is it a replacement?
It works completely in conjunction with the official Mk1 Booster plugin. You can choose to use either or both, one at a time or together. My script is simply a way to speed up your ships in a more permanent fashion than the Mk1 Booster. Allows those Nova pilots that extra speed they need for taking down more enemy threats at once.
Stealth
Posts: 1732
Joined: Wed, 6. Nov 02, 20:31
x2

Post by Stealth »

You forgot a very imortant and probable possibility for the quantum tubes - that they'd be both working and destroyed at the same time (as per quantum physics) :mrgreen:

Very nice. Will take a look at it when I get home.
Last edited by Stealth on Sun, 15. May 05, 22:35, edited 1 time in total.
User avatar
nuclear_eclipse
Posts: 1129
Joined: Thu, 2. Sep 04, 01:54
x3tc

Post by nuclear_eclipse »

16 downloads so far, any feedback yet :?:
User avatar
Thalass
Posts: 1009
Joined: Wed, 6. Nov 02, 20:31
x2

Post by Thalass »

Downloaded and installed. I'm starting a new game in the terradyne universe, though. So it might take a while 'till I can afford it. :P
Legitimate Businessman. Honest.
User avatar
LifeMatrix
Posts: 53
Joined: Wed, 18. Feb 04, 07:34
x2

Link is broken... and the author doesn't have a copy

Post by LifeMatrix »

The download link is broken. So if anybody happens to have a copy of this rare script, please let me know.

I contacted nuclear_eclipse about this and he told me that, due to a hard drive crash, he lost all his X2 material. :o

So unless someone still has a copy, it's gone for good. :(
"I'm going to hang up this phone and then I'm going to show these people what you don't want them to see. I'm going to show them a world without you. A world without rules and controls, without borders or boundaries. A world where anything is possible." - Neo, The Matrix

Return to “X²: The Threat - Scripts and Modding”