Vector Tutorial


This tutorial assumes you have knowledge of XML and know how to import files into a Package using S3PE or Packer.

Many of you may find the following instructions similar. It is simply a rehashed versions of the Careers Tutorial.

Before You Begin


One must be acquainted with the use of a Sims 3 Package Editor.

If you are running Windows, then you should be able to run the Packer available here : Packer
  • Packer is specifically designed to work on my style of mods, and will work for custom career packages.
  • It does have a couple of limitations. So you may want to use S3PE for more advanced work.

For everyone else, I would suggest the use of S3PE, available by googling Simlogical.

You must also know how to read XML and understand the format enough to at least copy/paste existing XML and change it.

Steps


  1. Create a copy of the NRaas_VectorDataMinor.package and rename it to be something new, the name of file can be whatever you feel like.
    • The NRaas_VectorDataMinor.package can be located here Vector Minor.
    • For this example I will call the file "Bobs_VectorData.package".
  2. Open your package with a package editor (I will be using Packer for this tutorial)
  3. Within the package you will find the following:
    • NRaas.VectorMinor.Resistances
    • NRaas.VectorMinor.Scoring
    • NRaas.VectorMinor.Symptoms
    • NRaas.VectorMinor.Vectors
    • Strings_* - These files contain the language localization strings used by the careers
  4. First thing we must do is change all the Instance IDs so they do not conflict with the original set of career data
    • Choose a name for your career data... Ensure that you make it unique. In this example I will use the following names:
      • Bobs.Vector.Resistances
      • Bobs.Vector.Scoring
      • Bobs.Vector.Symptoms
      • Bobs.Vector.Vectors
    • To do so, right click on each line and use the "Details"menu interaction.
      • Type in the new name for the _XML file, and press the OK button.
    • You must ensure that the names you specify are unique, or you will run into conflicts with other mods.
  5. You should probably save now.
  6. Now you may open each file using the "Edit"menu interaction in order to change the information within them.
    • You can delete all the data for the default careers, as that data is still in the original copy of the package.
    • You can also use the Export menu interaction to dump the contents to an XML file so you can edit using another editor. Once complete, simply use the Import menu interaction to load the changes back into the package.
  7. Next step... Exposing "Bobs_VectorData.package" to the Vector mod itself.
  8. Download the attached zip and extract to its own folder
  9. Run BootStrapCreator.exe and the program will create a new DLL with a randomly generated name.
    • This is your personal scripting mod dll.
  10. Go back you package in Packer. Look for the S3SAline that says 31917047733732.dll .
    • There are two, so make sure you select the S3SA tagged line.
  11. Right click on that line and use the Detailsmenu operation.
    • Change the name of the file to match the name that BootStrapCreator created for you.
  12. Right click on the line and use the Importmenu operation, navigate to the location of your dll and select it.
    • You have just imported a custom S3SA file into the package.
    • This is an important step, because that custom file defines from which _XML file your career is read.
  13. Now right click on the _XML line that says 31917047733732.dll and use the "Details" operation on it as well.
    • Change this to match your custom S3SA file.
  14. Now open that _XML file.
    • In it is the <Vector> data that links your data-set into the Vector mod.
  15. Within that file you need to enter a reference to your newly created XML files.
    • Change the values listed in that file to match the names of the _XML files you renamed in Step 4.
    • Here is what the XML for this example would look like:
    • <!--?xml version="1.0"?-->
      <Vector>
        <VectorMethodFile>
          <File></File>
        </VectorMethodFile>
        <VectorMethodFile>
          <File>Bobs.Vector.Scoring</File>
        </VectorMethodFile>
       
        <InstigatorsFile>
          <File></File>
        </InstigatorsFile>
        <InstigatorsFile>
          <File>Bobs.Vector.Instigators</File>
        </InstigatorsFile>
       
        <SymptomsFile>
          <File></File>
        </SymptomsFile>
        <SymptomsFile>
          <File>Bobs.Vector.Symptoms</File>
        </SymptomsFile>
       
        <ResistancesFile>
          <File></File>
        </ResistancesFile>
        <ResistancesFile>
          <File>Bobs.Vector.Resistances</File>
        </ResistancesFile>
       
        <VectorsFile>
          <File></File>
        </VectorsFile>
        <VectorsFile>
          <File>Bobs.Vector.Vectors</File>
        </VectorsFile>
      </Vector>
  16. Save that file.
  17. Now comes the big part regarding actually entering in the details for your disease.
  18. Once you have completed filling in those files, you must now create the language localization file for at least English.
  19. Firstly, you must choose a new Instance ID for the STBL files. If you do not, your STBL will conflict with the Vector Minor..translation.
    • Right click on any STBL line, and use the "STBL \ Rename All" operation to renumber all the STBL in your file in a single step.
    • The application automatically used the unique name of your S3SA file to create a unique ID for each STBL line.

  20. For creation of the STBL, Packer..uses a <KEY><STR> formatted UNICODE text file.
    • An an example of a translation is available here : Vector Minor English.
    • To import these files, simply double click on a STBL line and locate the file you wish to import.
    • Packer chooses a specially formatted name by default, so if you name your translation files using that format it will be easier to import them.
  21. Once you have completed importing the required string tables. Save the file.
  22. Now copy all the files, including the new "Bobs_VectorData.package", into the appropriate location in your Mods folders.
  23. Run the game, and your new career should appear.

Related Pages