Welcome to Illusion Wizzard

Version is 0.4.6 beta, release date 21.02.2010

===========================================================
Before you use the tool, backup any files you want to mod.
Don't say I didn't warn you!
And read the damn readme file - that's what I wrote it for :D
===========================================================
purpose of the program and what is included in the distribution
=================================================
The program will insert mods into Illusion games. It comes with a graphical
user interface. The following programs are included in this distribution:
- Illusion_Wizzard.exe (the main program), Version 0.3d beta
- SchoolMateDecrypt_to_Retail.exe (thanks to Alamar)
- AG3Decrypt_to_AG3Demo.exe (thanks to Alamar)
- 7zip.exe (command line version)
- TextureMethods.dll (thanks to Alamar)
- PPExtractor.exe (thanks to ScumSuckingPig)
setting up the wizzard for first time use
===============================
- extract all the files in the archive into a directoy of your choise. Please
make sure that you keep the directory structure within the archive intact.
- you need .net version 2.0 installed to run the gui application
- for each new game, run wizzard once with the game profile to auto
generate the directory structure for that game
- open illusion_wizzard.exe and you will see all the mods in the mod list
"window"
how to add and apply a mod
==================
- copy all the mods archives you want to use into the \mods subdirectory
do not unpack/extract them, just copy the archive
- select the game you want to mod in the game selection screen
- click on any mod to see the preview picture and the description on the right
side
- click the apply button to apply the mod to your illusion game
- if the mod has been applied already and for one reason or another you want
to apply it again, use the "force mod" button. In that case the undo/backup fi
les
will not be changed.
game profiles
============
- the game profiles are stored in the sub directory \_general\game_profiles
of the illusion wizzard installation path
- the game profile defines where certain game files are stored, what functions
are supported by the wizzard and so on
- each game needs a well set up game profile to be supported by illusion wizzard
- do not mess with the game profiles until you know exactly what you are doing
status tab
========

- the status tab gives you information about directory settings of the game(s)
- the status tab also holds the information about available/necessary tools
and their availability status
options tab
========
- the options tab allows you to specify all kinds of settings for the wizzard
- switch on detailed logging: log file shown in the box when a mod is applied
will include more details when switched on
- expert mode: will bypass some of the checks and allows to select more than
one mod at a time and apply them all
- time to switch to next picture: is used to change the intervall between change
s
from one preview picture to another - is only used when picture switching is
not turned off
- turn off picture switching: well this turns picture switching off :)
- collision detection settings (only supported for the specific game are shown):
-- ask: a box will appear and ask you any time a collison has been detected
-- auto/overwrite: if there is a free slot, wizzard will use it, otherwise
the mod overwrites the line specified in the lst file
-- auto/ask: if there is a free slot, wizzard will use it, otherwise a box
will appear and ask you what you want to do
-- off/overwrite: no collision detection is done, each mod uses the line from
its lst file
- specify <xx> folder manually: allows you to specify a game or addon folder
manually in case there is a problem with your registry settings
- specify game/addonx exe button: will activate the buttons on the top right of
the main window to start the exe specifed
- game selector settings: allows you to skip the game selector screen and to aut
o
load the game profile selected in the drop down box
- contig file defragmenter settings: will defrag the pp files after changes have
been made to them
save patcher (AG3)
==============
- list of all girls is shown together with information on names, world
- no preview pic means the girl has not yet been saved at least once in make.exe
- load/refresh list: well it will refresh the list of girls
- edit girl skin: will start the skin editor for the selected girl
- edit girl basefile: will start the basefile editor for the selected girl
- edit girl savefile: will start the savefile (that's the one that links the gir
l
to a world/guy) editor for the selected girl
special section on girl skin editor (AG3)
===================================
- this editor will only work if you use standard names in your girl's pp file
-- body skin: aa15_00_00.bmp inside body.xx
-- face skin: ab01_01_02.bmp inside head.xx
-- pubic hair: ab24_01_01.tga inside body.xx (please note that ab24_01_02.tga,
ab24_01_03.tga, ab24_01_04.tga are not supported, so you will need an
uncensor mod)
-- vagina: ab24_03_01.tga inside body.xx
-- anus: ab24_07_01.tga inside body.xx
-- nipple: aa16_00_00.tga inside body.xx
-- body ref: a15_ref01.bmp inside body.xx

- if you use the editor for a girl the first time, a backup of all the files
listed above is created
- modding object: the part/object you want to mod - simply click on the desired
button and the corresponding file will show
- modding action:
-- overlay: this option will overlay the selected modding file over the
"result image" using alpha transparency - standard option if original file
is in bmp24bit format. Please note that overlay on a tga file will keep
the original alpha channel and only overlay the three rgb bytes
-- replace: this option will replace the "result image" with the modfile, this
is the standard option if original is in tga32bit format
- Actions to take:
-- restore original: this will restore the backup and show it in the
"result image" picture box
-- restore current: this will copy the "current image" to the "result image"
-- color overlay percentage: you can specify the percentage the chosen color
will be overlayed with the "result image", 0 means no overlay, 100 means
"result image" will get the selected color
-- change overlay color: to change the overlay color, click on the small color
symbol right beside the text: "Color"
-- preview(color): this will overlay the "current image" with the selected
color and overlay percentage and show the result in the "preview image"
-- apply(color): if you are satisfied with the preview color, you can use
apply(color) to overlay the"result image" with the color
-- apply modfile: this will overlay/replace the "result image" with the select
ed
modfile
-- refresh mods: this will referesh the file list displayed in "modding file l
ist"
-- save: this will finally save the "result image" as "current image" replacin
g
the file inside the girl's pp
-- close: well obviously this will close the girl skin editor, please note tha
t
there is no check about changes and no warning to save
- other objects on the screen:
-- modding file list: only tga32bit files are supported to be used as modfiles
they have to be saved in the folder:
<wizzard install dir>\AG3\skins\<modding object>
the folder structure will be auto created if you start the girl skin editor
for the first time
-- preview image: this will show the modfile overlaying or replacing the "curr
ent
image"
-- result image: if you click apply/apply modfile, the color/modfile will be
applied to the "result image" (not was is shown in the preview, only the
color/modfile itself is applied)
-- current image: The image currently stored inside the girl's pp file
-- if you right click on any of the picture boxes, you will get a context menu
that allows you to see the pic in 512x512, 1024x1024 size or save it to hd
in
bmp32bit/bmp24bit or tga32bit format (tga is only supported if source mater
ial
is a tga)
supported functions
================
- support of game profiles to hopefully support new illusion games
- support of illusion games with up to 4 add ons

- autodetection of the game and addons installation directories and display

of the information in the status tab (with support for 64bit windows)
- manual overwrite of the installation dirs in the options tab, values are saved
in
the ini file, manual setting will be indicated in the status tab
- can insert any file into any existing .pp file
- can modify exisiting .lst files using the Afker/darkhound lst insertion format
(this is done through an integrated class)
- supports mod archives in the following formats: 7z, zip and rar (any of those
file extensions will work, even if the archive is in another format, because
7zip will autodetect the format)
- for each applied mod, an undo/backup mod archive will be created - so the mod
can be "uninstalled"
- a description and a preview picture will be displayed if they are inside the
mod archive, no need to copy them somewhere manually. The picture has
to be in jpg format and the description in plain txt.
- multiple pictures can be included for one mod now, they will be rotated
automatically, the first picture has to be named like the mod (.jpg) next
picture modname1.jpg, modname2.jpg and so on, maximum number of
preview pictures for one mod is 10
- time to switch between pictures can be specified (1 to 9 seconds)
- preview picture switching can be turned off completely
- various filters including a quick filter can be set on the Mods and installed
Mods tabs
- additinal pp files are copied to the game\data folders
- several mods can be "queued" and then be applied with one click
- queue management functions (delete single entry, clear all)
- a mod patch log with runtime in seconds will be displayed for each mod
- game and addon exe files can be specified in the options tab - the games
can then be launched with the click of a button
- possibility to delete mod files from the HD in illusion wizzard (Mods and inst
alled
Mods)
- double clicking the preview picture will show a full size version in an
additional form within Illusion Wizzard
- expert_mode switch to bypass some of the messages and to allow multiple
selections in the mods list and to force/apply multiple mods with one click
- the queue can be saved to a file and reloaded from a file
- hotkey support for the following fuctions is now available:
apply mod (ctrl + a) / force mod (ctrl + f) / send to queue (ctrl + s)
- direct copy of files into the m_tex subfolders of Artificial Girl 3
- second version of savefile editor functionality for AG3 is inluded
- possibility to defrag files using contig.exe
- build in girl skin editor
- HAKO save and memory file editor included
structure of the mod archive files
==========================
This is an important part for all modders out there. This section describes how
the directory and file
structure has to be set up within the mod archive so that the mod will work with
sb3_insert.
directory structure, asuming the mod file is named:
[gameID][Clothes][All girls][test].7z
gameID --> directory: all the files that have to go into the gameID pp-file dire
ctory have to be put there
|- pp-filename1 --> subdirectory of gameID: all the files that are in this direc

tory will be inserted into the pp file: pp-filename1.pp

|- pp-filename2 --> subdirectory of gameID: all the files that are in this direc
tory will be inserted into the pp file: pp-filename2.pp
|- newfile.pp --> file in directory SB3: the file newfile.pp will be copied in
to the gameID pp-file directory
|- LST_INSERT --> special subdirectory of gamID: Into this directory the moddi
ng files for lst have to go. One or several lst modfiles can be used. Filename c
an be anything you want to use.
The lst modfile in this directoy will mod the lst file for gameID specified in t
he game profile
|- TGA_INSERT --> (so far this function is schoolmate only) only tga files may
be put into this directory. The tga file has to be exactly 128x96 pixels (tga f
ormat 32bit with alpha layer).
The filename has to be [line number in lst file]<lstfilename>.tga - e.g. [0]cat_
a01.tga. In the example, the wizzard will look in line 0 (first line) of the lst
file cat_a01.lst and get the pp file and the tga file to be changed.
From the line number the wizzard will know which part of the tga file to modify.
And voila it will be possible to change only 1 preview pic for the clothes.
|- M_TEX
--> (so far this function is AG3 only) you need to create subdirs
in this directories with the same
name as in the game's save\m_tex\<subdirs>. Any file you put into this <subdir>
will be copied to the game
save\m_tex\<subdir>. Any existing file will be replaced and a copy will be crea
ted in the backup to undo
the mod
|- M_COS
--> (so far this function is AG3 only) you need to put files or c
reate subdirs in this directory
Any file you put into the M_COS directory will be copied to the game save\m_cos\
directory. Any file
in the M_COS\<subdir> will be copied to the game save\m_cos\<subdir>. Missing di
rectories will be created.
Any existing file will be replaced and a copy will be created in the backup to u
ndo the mod
addon1ID --> all the files that have to go into the addon1 pp-file directory hav
e to be put there
|- pp-filename1 --> --> subdirectory of addon1ID: all the files that are in this
directory will be inserted into pp-filename1
|- newfile.pp --> file in directory addon1ID: the file newfile.pp will be copied
into the addon1ID pp-file directory
|- LST_INSERT --> special subdirectory of addon1ID: Into this directory the modd
ing files for lst have to go. One or several lst modfiles can be used. Filename
can be anything you want to use.
The lst modfile in this directoy will mod the lst file for gameID specified in t
he game profile
[gameID][Clothes][All girls][test].txt --> description file not in any directory
, has to have the same name as the modfile with extension .txt
[gameID][Clothes][All girls][test].jpg --> preview pic not in any directory, has
to have the same name as the modfile with extension .jpg
[gameID][Clothes][All girls][test]1.jpg --> preview pic not in any directory, ha
s to have the same name as the modfile +1 with extension .jpg
[gameID][Clothes][All girls][test]2.jpg --> preview pic not in any directory, ha
s to have the same name as the modfile +2 with extension .jpg
known issues
===========
- free disk space is not checked before a mod is applied, so make sure you got e
nugh free disk space on the drive you intstalled illusion wizzard

- collision check is only supported for schoolmate so far

- save patcher for schoolmate is not included
- TGA_INSERT functionality for schoolmate will only work when standard file size
tga are used (256x384 for 8x and 128x96 for 1x)
what to expect in future releases
==========================
- more bug fixes when bugs show up
- support of multiple languages with language files
- improved error detection and error handling
credits and thanks
===============
- to Alamar for all the great tools and pp file decrypters/encrypters
- to Dili from hongfire, I took a lot of good ideas from the illusionist program
(general
layout, not coding)
- go to nobody123 from hongfire forum for all the good ideas and work done on
ilusion files, he also posted the basics behind encryption/decryption of .lst
files.
Without his work this tool would not have been possible
- to wurlox from hongire forum for all the work on illusion games and basics beh
ind.
Without him, it would only be only 1/2 has much fun.
- to Afker from hongfire forum for his idea for this excelent file structure to
simplify
the modding of lst files. Without his ideas and the kick to get me started, th
is
program would not exist.
- to Rawmonk for his work on the .xx file structure.
- to Anand and wurlox for many new ideas that have been integrated into the
wizzard
- to warior for alpha testing
- to theshadow for bugging me about my programming style and for helping to
improve the program :)
- to Alamar again for his dll to have easy access to the texture files
(and again for his help in making the update to support AHM)
- to ScumSuckingPig for all his great work on the illusion games and for
the pp extractor for HAKO also thanks for the update to support AHM
- to everybody else addicted to modding illusion games
=========================================================
If you find any bugs pm darkhound at hongfire forum.
If anyone wants to know:
Illusion_wizzard.exe is written in VB.net
I hope you like this little piece of software
=========================================================
version history
===========
[0.4.6 beta] - Yuusha bug fixes and RGF
bug fixes:
- Saga horns are now hidden correctly
new features:

- game profile for RGF added

- new ppExtractor.exe added (thanks to SSP)
[0.4.5 beta] - new features for Yuusha
bug fixes:
- some small bugs in texture editor ini files fixed
new features:
- character size adjustment for Yuusha added
- Yuusha "humanization" settings can be adjusted
- Yuusha texture editor now supports all 60 slots
[0.4.4 beta] - release to better support Yuusha
bug fixes:
- pp format detection for yuusha should be fixed
new features:
- game profile for Yuusha is now included
- texture editor for Yuusha added
- ppextractor 7.1 included to support Yuusha (thanks SPP)
- texturemethods.dll has been updated (thanks alamar)
[0.4.3 beta] - bug fixes and some new features
bug fixes:
- using addon2 will work now (was broken in v0.4.2)
- refresh button in AG3 save patcher has been corrected
- memory leak problem with switching of preview pics fixed
new features:
- girls can now be sorted by any field in save patcher for AG3
- profiles to support AHM + Photo + ESKMate added
- ppextractor 6.2 included to support AHM (thanks SPP)
- texturemethods.dll has been updated (thanks alamar)
[0.4.2 beta] - bug fixes and AG3 guy size changer
bug fixes:
- AG3 girl size changer window size is now fix
new features:
- AG3 guy size changer has been added
[0.4.1 beta] - bug fixes for AG3 texture editor and size changer
bug fixes:
- backup of guy textures is now correct and they can be restored
- fixed a bug in the AG3 save patcher screen when using refresh
new features:
- girl hair numbers up to 80 can be used now
- girl and costume size changer has been added
[0.4.0 beta] - bug fix for HAKO save game editor
bug fixes:
- fixed a bug that let to crashes i the hako save editor
if certain characters were in the girl's name

- fixed a bug when save files were reloaded

new features:
- added support for face shapes 6 to 10 for HAKO
[0.3g beta] - HAKO save editor included
bug fixes:
- save patcher tab for hako was shown for ag3 and sm
- mod removal was not logged correctly
new features:
- save game patcher for HAKO *.sav and *.cdt files added
- new version of SPP's "PPExtractor.exe" included
(now supports HAKO Vignette)
[0.3f beta] - HAKO and more AG3+ support and new features
bug fixes:
- some bugs in addon detection have been fixed
new features:
- added support for HAKO
- added AG3+ hair styles support
- girl skin editor now supports 24bit bmp files
[0.3e beta] - bug fixes and AG3+ support
bug fixes:
- fixed a bug in the free line detection
- fixed another length > 0 bug when game dir was specified manually
- manual settings for addons will now be displayed in the options
- filter options have been fixed to display all mods correctly
new features:
- values from different girls can be "mixed" now using the girl basefile editor
- queue names can now be specified when loading/saving queues
- when updating the girl's js3cmi file, the js3csi can now be updated as well
- girl texture editor can now edit the guy as well
- added a mod history file named "mod_history.txt"
- Wizzard now supports the expansion voice types J, Y and S
[0.3d beta] - bug fixes and new features
bug fixes:
- fixed the length must be greater zero bug that occured under certain
circumstances
- queue function has been fixed and should work now
new features:
- girl texture editor now got the possibilty to save "models" for certain areas
of the girl (e.g. face or body) and copy it easily to another girl.
[0.3c beta] - bug fixes and new features
bug fixes:
- fixed a bug that prevented the girl skin editor from saving a file to the pp f
ile
- removed some testing code that tried to save a file "c:\test.tga" which could
have caused problems on windows vista os

t
-

refresh list button in the girl texture editor will no longer remove the resul
image
setting the game path manually should work now
removing the manual game path setting when it has been saved before will
no longer auto pop up the directory selection resulting in an endless loop

new features:
- color overlay for overlay images added to girl skin editor
- missing options for girl base file editor have been added
- greatly improved speed of girl texture editor
- progress bar added to girl texture editor
- AG3 game profile has been adjusted to be able to start AG3_Play as
addon1
- check for write protected pp files has been added
- free space check for game drive and wizzard drive has been added
[0.3b beta] - improvement of girl skin editor, collision detection for AG3, bug
fixes
bug fixes:
- fixed some crashes when a file was not found in the girl skin editor
new features:
- collision detection for AG3 has been added
- filecopy into the game's \save\m_cos\ and <subdir> folders is now supported
- girl skin editor has been renamed to girl texture editor
- girl texture editor can now be configured by via ini file
- girl texture editor supports more texture files now
[0.3a beta] - bug fix release
bug fixes:
- fixed a bug that prevented wizzard from working if Contig.exe is not present
in the tools directory
[0.3 beta] - bug fixes, improvement of save file patcher, new girl skin editor
bug fixes:
- mod queue function has been fixed and should now work again
new features:
- Illusion_wizzard_install_check.txt file is now written
- save patcher for girl's profile has been enhanced
- option to skip game selection screen has been added
- contig.exe support to defrag files has been added
- girl skin editor has been added
[0.2 beta] - save editor for AG3 and M_TEX copy support
bug fixes:
- none that I remember
new features:
- the last game you selected is now "remembered" by wizzard
- first version of the save file editor for AG3 has been added
- filecopy into the game's \save\m_tex\<subdir> folders is now supported
[0.1b beta] - collision detection for SM and bug fixes
bug fixes:

- fixed a bug that made the wizzard create wrong undofiles for lst_insert
- fixed a bug that let wizzard crash when any lst file had an unexpected line le
ngth
- allows to delete mods from the HD now
- game selector .jpg file has been updated
new features:
- schoolmate: support for collision detection
[0.1a beta] - bug fix release and support for AG3 make trial
bug fixes:
- corrected a bug in the lst insert routines that could crash the wizzard
new features:
- game profile for AG3_MAKE_TRIAL is now inlcuded
- AG3Decrypt_to_AG3Demo.exe is now included
[0.1 beta] - first release