13 replies to this topic

[Ascension64]

I have attached here the current version of the TobEx Modder's Reference. Please note that the reference tells you nothing about how to achieve any modding goal. It only summarises the changes that TobEx makes to the engine, in an IESDP-like format.

Correct as of build 0.25.10.7 (test release).

Attached Files

•  TobExReference.htm   187.34K   1604 downloads

Edited by Ascension64, 06 October 2012 - 11:17 PM.

[phordicus]

awesome and handy.

[DavidWallace]

That's hugely useful, thanks.

[Galactygon]

Thanks for taking the time to do this; it will give us a chance to catch up.

-Galactygon

[Ascension64]

You can also find the most recent modder reference in the ./TobEx/TobEx_redist/readme directory.

[Avenger_teambg]

Walk sounds is also similar, but not the same, the 2da is named walksnd.2da
For example, skeleton looks like this:

           RESREF     MIN        MAX        RANGE 
SKELETON   WAL_19     0x6403     0x6403     5 

Any animation between MIN/MAX will have the WAL_19[a,b,c,d] walksounds.

There is a bloodcolor 2da too, bloodclr.2da.
The skeleton looks like this:

           VALUE      MIN        MAX        
MSKEL      0x25       0x6403     0x6403     

Any animation between MIN/MAX will have the 0x25 palette entry as blood color.

[Ascension64]

item_use.2da in gemrb is the equivalent of ITCREXCL.2DA in ToBEx

I can implement similar. However, what if people wanted different STRREFs for the different actions?

Walk sounds is also similar, but not the same, the 2da is named walksnd.2da

Does GemRB then search by animation name e.g. SKELETON rather than the anim ID? And what do you do for terrain-specific sounds?

[Avenger_teambg]

example, with only skeleton and default sound entry:

2DA V1.0
*
		   RESREF	 MIN		MAX		RANGE
SKELETON   WAL_19	 0x6403	 0x6403	 5
DEFAULT	SOUND	  0x7500	 0x77ff	 4

This will result in WAL_19, WAL_19a-d sounds for the animID 0x6403
The rowname is just for clarity.
When processing this table, gemrb already read avatars.2da. So it will simply go over it, setting up every matching entries.
We do the same for blood color and will probably do with other rare tweaks needed on avatars table.

Terrain specific sounds are listed in pathfind.2da, as you can see, we support multiple terrain specific sounds:

2DA V1.0
*
		 0 1 2 3 4 5 6 7 8 9 a b c d e f
PASSABLE 8 1 1 1 1 1 1 1 0 1 8 1 0 8 3 1
COST  10 4
SOUND * WAL_04 WAL_MT WAL_02 WAL_05 WAL_06 WAL_01 WAL_03 * WAL_02 * WAL_01 * * * WAL_04

There is code to resolve searchmap specific walksounds by matching the animation walksound to entries in pathfind.2da (row 2 and above). If there is a match, it gets the searchmap specific value.
This is similar to how random treasure or random spawngroup resrefs are resolved.

About the item_use table:
This (theoretical line): MISC88 ALORA 10219 3
would be equivalent with this:
MISC88 ALORA 10219 1
MISC88 ALORA 10219 2

You may change the second line's resref to anything, and it will be matched when needed.
In other words, we match the itemname, actorname, action flag.
If the action flag doesn't match, the line is ignored, but another line with the actor/item names would still be matched if found.

Edited by Avenger_teambg, 03 March 2012 - 04:00 AM.

[Ascension64]

Updated to most recent test build. I've added sections to summarise the changes to file formats (namely, extra bits added to flags).

[Ascension64]

Updated to reflect latest test build.

[The Imp]

Would there be any kind soul and turn this into a website instead of a downloadable web file ? This hampers the usability factor by x10. Well... people being lazy and all that.

[Sam.]

Would there be any kind soul and turn this into a website instead of a downloadable web file ? This hampers the usability factor by x10. Well... people being lazy and all that.

TobExReference

 

The page contains quite a few HTML coding errors.  I'll try to get around to fixing them eventually.  The URL won't change, tho, so you can go ahead and start linking to it if you like.

[Fiann of the Silver Hand]

Would there be any kind soul and turn this into a website instead of a downloadable web file ? This hampers the usability factor by x10. Well... people being lazy and all that.

You know you can just bookmark it in your browser to wherever it is on your hard drive.  Same exact thing as a web site, except accessible offline and editable.

Edited by Fiann of the Silver Hand, 14 January 2016 - 05:44 PM.

[Sam.]

The page contains quite a few HTML coding errors. I'll try to get around to fixing them eventually.

Several hundred edits/changes later, it should be more or less good-to-go. Note that I focused solely on the HTML syntax: the content should be unchanged.

Edited by Sam., 24 January 2016 - 04:47 PM.