Tree [c14c3c] /
History



File Date Author Commit
examples 2008-02-27 Jaroslav Benkovsky Jaroslav Benkovsky [0e48a2]
formats 2008-02-27 Jaroslav Benkovsky Jaroslav Benkovsky [31d333] Added ARE resource format and other changes
ie_shell 2008-02-27 Jaroslav Benkovsky Jaroslav Benkovsky [ef3886]
COPYING 2005-03-02 Jaroslav Benkovsky Jaroslav Benkovsky [42ca9f] Initial revision
Makefile 2005-03-02 Jaroslav Benkovsky Jaroslav Benkovsky [42ca9f] Initial revision
README 2006-07-03 Jaroslav Benkovsky Jaroslav Benkovsky [8dd04f] Added IDS and DLG formats
examples.py 2008-02-27 Jaroslav Benkovsky Jaroslav Benkovsky [c14c3c] Moved things a bit
ie_shell.py 2006-07-03 Jaroslav Benkovsky Jaroslav Benkovsky [8dd04f] Added IDS and DLG formats
iesh 2008-02-27 Jaroslav Benkovsky Jaroslav Benkovsky [c14c3c] Moved things a bit
setup.py 2008-02-27 Jaroslav Benkovsky Jaroslav Benkovsky [c14c3c] Moved things a bit

Read Me

ie_shell - Simple Python shell for exploring Infinity Engine-based game files
==============================================================================


Installation:
-------------
None at present, just untar the tarball somewhere convenient.

Package contents:
  ./ie_shell.py
  ./data/ - directory for storing exported data, provided for convenience

  ./formats/format.py
  ./formats/stream.py
  ./formats/bam.py
  ...
  ./formats/wmap.py

  ./plugins/core.py
  ./plugins/builtins.py
  ./plugins/...


Configuration:
--------------

Edit ie_shell.py:

game_dir 
    - directory where the game you are interested in is installed

chitin_file
dialog_file 
    - names of RESREF and STRREF index files, located in game_dir.
      Edit the names if the case does not match

Other files:
  $HOME/.iesh_profile
  $HOME/.iesh_history


Running:
--------
Just type ./ie_shell.py or python ./ie_shell.py 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
python statements.

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:
  BAM
  BIFF  (only file records)
  CHUI
  CRE   (only partial)
  IDS
  ITM
  KEY
  TLK
  WMAP

Type `?' or `help' to get some online help and `q', `quit' or ^D
to exit the program.



License, disclaimer and similar stuff:
--------------------------------------

Copyright (C) 2004-2006 by Jaroslav Benkovsky, <edheldil@users.sf.net>

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.