ToEE Editor Utilities (TEU) v1.1 Build 2

ToEE Editor Utilities (TEU) Package Build 2
(C) 2006 by Michael "Agetian" Kamensky, Circle of Eight, all rights reserved.
==================================================

NOTE: This set of tools requires Microsoft .NET Framework v2.0 or newer.
NOTE: This is a release candidate version and may contain various bugs.
You are encouraged to make backups when using SectorSort. Feedback on
the performance of tools is very much appreciated.

TEU is a package that includes a number of small utilities which can be very
helpful during the process of editing ToEE with the World Builder (ToEEWB).
These tools are meant to be used in conjunction with other editing utilities
available at the Circle of Eight (ToEE World Builder, ProtoEd, and other).
These utilities are based on a new object file format codec (ObjectFormat.dll)
written by the author of this package. This codec is very fast and allows mass
parsing of game objects of various kinds.

TEU and the object codec (ObjectFormat.dll) are not open-source and won't be
for a while. However, the fully commented source code is available by request
directly from the author. The source code is available for our MODDERS ONLY.
Do not bother PMing the author if you are not a modder, you will NOT receive
the source code.

Please do not redistribute publicly outside the Circle of Eight community
without prior written permission from the author. The author can be contacted
at the Circle of Eight (http://www.co8.org) - please send a private message
to Agetian.

ScriptOverrider v1.0
------------------------

ScriptOverrider is a tool that allows you to override scripts in mobile objects.
Launch the tool, load the mobile object you want to modify script overrides for,
and set up the overrides the way you want (specify the action type and the script
ID in the boxes below, and use the 'set' button to set the override or 'delete'
button to remove the override). Then save the mobile object and it should override
the scripts. This tool is meant as an extension of the ToEE World Builder's mobile
object editing capabilities.

ObjView v0.61 Beta
-----------------------

ObjView is a utility that allows you to view mobile objects' contents. Start it,
point to the folder with the mobile object files (*.mob), and ObjView will
display a tree-like hierarchical view of all objects and their properties.
This is not an editor for now, just a viewer - please use ToEE World Builder to
edit mobile objects.

Currently ObjView will show mostly the 'raw' representation of data, e.g. the
waypoints and standpoints will just be shown block-by-block without actually
showing what is what (yeah, I'm too lazy to implement it all over for now),
also the flag names currently only exist for obj_f_flags and obj_f_npc_ai_flags64.
Other flags will be shown as "Flag #1", "Flag #2", etc.

ObjView will try to decypher hashed strings whenever possible - it uses the
temple.dll string dump (ObjView.dat) in order to look up internal strings.

SectorSort v1.0
------------------

!!! THIS TOOL IS VERY IMPORTANT !!!
SectorSort allows you to sort the embedded static objects in sector files accor-
ding to the standard ToEE loading order. This will help prevent various hard-to-trace
bugs like disappearing door icons upon revisit, disappearing scenery, weird appearance
of special effects, and other bugs that usually happen upon entering a custom area
for the second time. The bug is that ToEEWB simply appends an object into the end
of the static objects list, while in ToEE they should be sorted in the coordinate
loading order (the "Ys first, Xs last" rule).

Just load this tool, hit the sort button, and point to a folder with sector files
that you'd like to sort. The tool is fully automatic and very fast and will auto-
matically sort all objects in all sectors within the folder you pointed to.
Note: This is an early version, so you are highly encouraged to make backups.

IMPORTANT: Remember to run this tool often on your custom maps' folders in order
to prevent and avoid bugs.

The Object File Format Codec v1.0.2.19
----------------------------------------------

The object file format codec is located in ObjectFormat.dll and provides means to
read, parse, and write objects in the object file format type 0x77 which is a
standard for both Arcanum and ToEE. The current version of the codec includes both
a raw configurable implementation (class "ObjCodec") and the preconfigured codec
for use with ToEE files (class "ToEE"). The codec is very fast and can parse all possible
data structures in the object files (429 out of 429 fields in ToEE).

You can use the object file format codec by adding a reference to ObjectFormat.dll
in your Visual C#.NET or Visual Basic.NET project.

Right now there is no documentation for the codec itself, but a commented source
code is available for the Circle of Eight modders in case of necessity.

Enjoy!
- Agetian

 

Re: ToEE Editor Utilities (TEU) v1.0

Upcoming TEU Series tools, in order of their creation priority:

- ToEEPC Player data viewer (and possibly editor in the future)

-----------------------
List of updates and changes:

UPDATE 06/20/06: I forgot some last-minute changes in ObjView. I reuploaded the package. Please redownload if you downloaded before this message appeared. Sorry for the inconvenience.

UPDATE 06/21/06:
Released Build 2 (version 1.1). Changes in this build:

[+] Added a new tool: ScriptOverrider v1.0 (makes it possible to override scripts in mobile objects, MOBs).
[+] Added previously unknown fields in obj_f_scripts_idx to the ObjView (updated to v0.61b).
[*] Fixed: a bug in the hash parsing routine in the object codec that prevented the permanent mods and conditions from saving correctly.

[*] Fixed: the object file format codec had some redundant code which was removed to avoid bugs with custom objects.

 

Re: ToEE Editor Utilities (TEU) v1.0

UPDATE 06/20/06: I forgot some last-minute changes in ObjView. I reuploaded the package. Please redownload if you downloaded before this message appeared. Sorry for the inconvenience.

 

Re: ToEE Editor Utilities (TEU) v1.0

UPDATE 06/21/06:
Released Build 2 (version 1.1). Changes in this build:

[+] Added a new tool: ScriptOverrider v1.0 (makes it possible to override scripts in mobile objects, MOBs).
[+] Added previously unknown fields in obj_f_scripts_idx to the ObjView (updated to v0.61b).
[*] Fixed: a bug in the hash parsing routine in the object codec that prevented the permanent mods and conditions from saving correctly.

[*] Fixed: the object file format codec had some redundant code which was removed to avoid bugs with custom objects.

- Agetian

 

This thread has been unstuck because the TEU tools are now available in the new ToEE World Builder v2.0.1 package in the integrated form. Please check out the ToEEWB thread for the latest setup package which includes a newer version of the TEU tools.

- Agetian