iesh - Simple Python shell for exploring Infinity Engine-based data files
If you are installing from the source package, type
# python ./setup.py install
If you are installing from the binary package, untar the tarball
to a usual directory, e.g. /usr/local
iesh - the shell
infinity - python module package dealing with the reading of IE files
infinity/formats/* - various modules for reading the specific IE file formats
data/ - directory for storing exported data, provided for convenience
examples/ - some example code snippets
- directory where the game you are interested in is installed
- names of RESREF and STRREF index files, located in game_dir.
Edit the names if the case does not match
Just type ./iesh or python ./iesh and you should see
dots marking progress as the program loads CHITIN.KEY and DIALOG.TLK.
!!! This might take *extremely* long time on a slow computer and
a significant portion of memory. If it's too slow or too big, then
this proggie just is not for you :( !!!
Once the files are loaded, you get Cmd: prompt, where you can type
Now you can load files, inspect their contents, search them and export
objects out of them.
The following resource formats are recognized in this version:
Type list_formats() to print list of recognized file formats.
Type `?' or `help' to get some online help and `q', `quit' or ^D
to exit the program.
key - field name, used as a key in the resulting object
type - data type used for read/write and presentation
off - field offset, relative to struc's offset 0x0000
enum - map of field values to their descriptions or IDS filename
mask - map of bit masks[FIXME: or bit nums?] to their descriptions
size - num of bytes for BYTES data type
count - count of fields of the same type and description
label - label printed for this field
License, disclaimer and similar stuff:
Copyright (C) 2004-2008 by Jaroslav Benkovsky, <email@example.com>
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.