*** UPDATED 13 JUNE 2008  ***

* * *

IMPORTANT: SIMPE USERS PLEASE READ

Each and every SimPE version always includes the latest version of these files.

Therefore, you don't need to download them (this thread is to be used only

by the SimPE developing team).

* * *

TRCN are labels for the BCONs (Behaviour Constants), while TPRP are labels for the Parameters and the Locals used in BHAVs. When editing a BHAV, PJSE can display, next to each mentioned BCON, Parameter or Local, the related "readable" name, as stored in the TRCN and TPRP files.

Please read how to install these packages and how to contribute to the development of this project in the following post. Here you will find the most updated versions of the TRCN/TPRP packages, along with a changelog, so that you can know when an update occurred.

NOTE: the attached packages are not complete, i.e. they contains labels whose meaning is still unknown. The unknown labels are marked as [To Do]. Anyone is welcome to help us to complete the existing packages, and to provide new ones.

CREDITS

Most of TRCNs and TPRPs were initially provided by Christianlov, Morague, Tunaisafish, Syberspunk and myself. A newer version of the Includes, much more complete, were provided by EA/Maxis themselves within the "Stories" games, and have been cleaned up and slightly updated by me. Now, these files are maintained by Inge Jones and myself, occasionally grabbing info from DisaSims2 by Dizzy2/Shy.

Thanks a million to Inge and Peter Jones for the PJSE in the first place, and for having promoted and supported the development of the TRCN/TPRP packages.

Attachments:

SimPE_PJSEIncludes.7z (684.70 kb, 464 downloads)
Updated 20th September 2008 

HOW TO INSTALL THE TRCN/TPRP PACKAGES

SimPE installs the latest version of the Includes automatically in the following path:

SimPE\Data\Plugins\pjse.coder.plugin\Includes

HOW TO USE THE TRCN/TPRP PACKAGES

The packages are automatically loaded by SimPE at startup; when editing a BHAV, PJSE will use the info stored in the packages to display descriptive labels next to each BCON reference, Parameter or Local used in the BHAV. If the needed TRCN/TPRP is not found in the packages, no labels are displayed.

Sometimes, the label *is* displayed, but it reads: [To Do]; this means that the TRCN/TPRP *is* defined in the packages, but the meaning of that particular label is still unknown. So, if you know what it means, read on, and tell us!

HOW TO CONTRIBUTE TO THE TRCN/TPRP PROJECT: MISSING LABELS

1)      Labels displayed as [To Do]. These labels are already contained in the packages; if you know what they mean, post here the following info: GroupID or name of the SemiGlobal you are working with, Instance # of the BCON (for Constant values) or the BHAV (for Parameters and Locals), Line # (for BCONs) or Param/Local # (for BHAVs), and lastly the  Label you suggest.

            Example 1: StoveGlobals - BCON 0x2003 line 0x07 = "Sandwich"

            Example 2: StoveGlobals - BHAV 0x201E Param 0x0000 = "ID of meal"

            Example 3: StoveGlobals - BHAV 0x201E Local 0x01 = "Use count"

2)      Labels not displayed at all. These TRCN/TPRP are not defined at all in the packages, or perhaps a new EP has added some lines to an existing BCON and the existing TRCN doesn't include those new lines. In these cases, you can just provide the info as explained above; or you can create a new TRCN/TPRP and then post on the forum a package containing only the new TRCN/TPRP created by you.

a)      To create a new TRCN (for BCON values), select the BCON and click on the button “Make Labels”; if you are asked whether to “keep the existing labels” or not, click YES (this means that some labels are already defined for that BCON, so it’s better to keep them).

The new TRCN will be created, with the same name and instance number of the BCON; select it and edit at will the undefined labels (i.e. the ones named Label 1, Label 2 etc.; please don’t edit the existing labels: read the following point 3, instead).

b)      To create a new TPRP (for BHAV params and locals), select  the BHAV and click “Make Labels” (make sure the “Special Buttons” checkbox is checked); if you are asked whether to “keep the existing labels” or not, click YES (this means that some labels are already defined for that BCON, so it’s better to keep them).

The new TPRP will be created, with the same name and instance number of the BHAV; select it and edit at will the undefined labels (i.e. the ones named Param 1, Param 2, Local 1, Local 2,  etc.; please don’t edit the existing labels: read the following point 3, instead).

3)      Labels correctly displayed, but that you disagree with. It may happen that the original creator of a TRCN/TPRP has made a mistake, or has misunderstood the meaning of a constant, parameter or local. If you think to have a better idea about an existing label, please don’t edit the official packages; instead, tell us your opinion and we can discuss it on the forum.

UPDATE 12 AUG 2007:

Added: CakeGlobals (just a couple of BCONS)

Updated: GLOBALS, FoodGlobals, LampGlobals (just few modifications)

01 June 12008 - Updated the Includes attached to the first post.

13 June 2008 - Small additions/modifications for some TRCNs:

GLOBALS:

- 0x0142 (Lot Zoning Types)
- 0x016C (Category2)
- 0x016F (EP7 Constants)

SEMIGLOBALS:

- Bookcase_globals:
- - 0x2000 (Bookcase - Tuning)
- - 0x2001 (Book - Study Interaction Indices)
- - 0x2004 (Bookcase - Genre Interactions)
- - 0x2006 (Tuning - Enthusiasm)

- Fridge_globals:
- - 0x2001 (Menu Type Flags)

- Food_globals:
- - 0x2004 (Menu Type Flags)

Did you use the most recently (QA) distributed includes as a basis, or did you return to your own last edited version?  I do from time to time add labels to them myself as I discover things, and then we distribute those.

In fact as the Includes form part of both the QA and Release distributions now, is this thread still a good idea?  In its present form I mean.  We can still use the thread to share info and resources.

I used the latest QA version (I thought they were my own ones, I didn't know you added new info yourself).

It's OK for me: we can remove the packages and just use this thread to share info. I guess this means that you will be in charge of adding the new findings to the "official" packages, right?

I have had an idea.   I have to give Quaxi the Includes and Help each time he prepares a release, so that means having them online somewhere for him anyway.   As Admin I can edit your post and upload attachments to it.  So why don't we maintain this thread as a joint effort between us - just making sure that we download the latest attachment before making our changes.   Then whenever Quaxi wants to make a release, he can know to get the latest Includes from this thread!  The only thing is, you need to pack the Includes along with their directory structure (from the level that they could be unarchived and the contents dropped into the SimPE parent folder) as that's what I was doing for him.   Then they work seamlessly with the installer.

We just need to make a comment in the top post that the Includes are distributed with the program so people don't actually *have* to get them from this thread.

And we'll post a new message each time we updated, with some rough idea of the areas we changed.

Why, can't Peter upload the Includes directly into the svn? However, I've looked into: <svn>\fullsimpe\__Installer\LatestWorkingAppfiles\Non-Core\Numenor, and the folder it's empty; and into: <svn>\fullsimpe\__NonCore the subfolder "Numenor" is missing completely, so I guess that Quaxi (or Peter) are managing the Includes manually.

Therefore, I perfectly agree with you: I'm going to edit the text in the first post and then will leave up to you to post the updated Includes.

Peter kept trying to upload to the SVN but it kept balking part-way through.  In the end he gave up.  But in a way it's worked out for the best, seeing as it's you and me who create the Help and Includes, and this way leaves us free to update when and if without bothering Peter.

I didn't know you had your own folder there, as the SVN is something I am excluded from.  Was that where you had been uploading the includes, or was it your installer?