Introduction [PyMS v1.2.1 by poiuy

PyMS v1.2.1 By: poiuy_qwert
Introduction PyGRP v3.8 PyPAL v1.5 PyLO v1.6 PyTBL v1.7 PyTRG v2.6 PyDAT v1.11 PyGOT v1.2 PyAI v2.4 PyICE v1.8 PyFNT v1.2 PyTILE v1.3 PyPCX v1.0 PyMPQ v1.0	Introduction PyMS is an (almost) all inclusive StarCraft Modding Suite, currently containing 13 programs to edit various StarCraft files. Because PyMS uses Python, it works on Windows, Mac, Linux, and many more operating systems. Note: This documentation is incomplete and will be updated in the future. Changes Source Installation Windows EXE Installation Usage Bugs Contact Credits

^

PyMS v1.2.1 (June 4, '09)

Added PyMPQ
Updated SFmpq.dll
Made a dependency error window which will pop up if you are missing PIL, or need SFmpq and arn't on Windows
Canceling the settings dialog when a file is missing at startup now exits the program instead of letting you continue till an error occurs
Fixed the problem with default files
Fixed some errors on systems that returned unicode strings
Fixed a problem on Mac's with the programs that use SFmpq

PyMS v1.2.0 (March 25, '09)

The "Remin me later" checkbox on the PyMS update dialog does not stay disable between versions anymore
Totally revamped MPQ and settings handling
No PyMS program should ever hog your MPQ's anymore
Changed the Libs\Default folder and combined it with Libs\Default\MPQ to create Libs\MPQ (PyDAT's SEMPQ.exe is now in Libs\Data)
On Windows all resizeable programs now save their maximized state between uses
Canceling in a save/open window will no longer resets the "last used directory"

PyMS v1.1.1 (Feb 23, '09)

Added PyPCX
The source release now includes PyTILE and not just a picture of it (i ziped the .png instead of .pyw, oops :X)
Reduced the size of EXE release
Added a "Remind me later" checkbox to the PyMS update dialog
Moved SFmpq.dll to the Libs folder
Fixed bugs when SFmpq could not be loaded
Fixed a bug when opening a file via file associations, if the program dealt with SFmpq
Fixed possible problems by changing the way the base directory is found/saved
Fixed a problem with setting programs as the default editor

PyMS v1.1.0 (Jan 8, '09)

Added PyTILE
Improved GRP loading speeds
PIL is now a requirement for source users (see Source Installation)
The version checker will no longer freeze the main program until closed when a new version is found

PyMS v1.0.0 (Dec 7, '08)

Find dialogs and other hidden persistant windows now load when first used
Added PIL support for faster images
Added MPQ support to PyICE, PyDAT, and PyAI (works only on Windows currently)
Added an online version checker
Fixed some bugs

PyMS v0.1e (Aug 27, '08)

Added PyFNT
Fixed various bugs

PyMS v0.1d (July 28, '08)

Added PyICE
Added a GUI for PyTRG
Fixed many bugs in various programs

PyMS v0.1c (Jun 13, '08)

Added an error tracing utility for easier bug catching
Totally revamped help file (as you can see)
More path bugs fixed, hopefully its the last of them
Folder setup changed
Bugs fixed in various programs
Program extensions changed from .py to .pyw
PyMS now comes in a folder
Fixed unitdef.txt
Fixed version inconsistancies
GUIs for PyAI, PyGRP, PyPAL, PyTBL, PyGOT, and PyLO

PyMS v0.1b (Feb 25, '08)

Added PyAI, a StarCraft AI editor
Added better error reporting to all programs
Fixed various bugs in all programs
Fixed path bugs
Changed all indentation from spaces to tabs

PyMS v0.1 (Jan 7, '08)

First public release.

^

Once that is done you can unzip PyMS somewhere on your computer . Now to be able to use PyMS, you will need to have the latest Python. If you are a Windows user, after installing Python, you will then have to change your environment variables. One way is to open your Command Prompt and type:

Command Line

set PATH=%PATH%;C:\Python25\

C:\Python25\ is only the default isntallation path of Python 2.5. If you have a different version of Python and/or installed it somewhere else, use that path instead.
Finally, as of PyMS v1.1.0, PIL (Python Imaging Library) needs to be installed for the source version to function. You can find it here (Mac) or here (Windows).

^

Just extract the PyMS folder somewhere on your computer and run the exe's, thats it.

^

Note: Angle brackets (like <example>) are required parameters (the only exception is if you specify the -h option, no <parameter> is required), square brackets (like [example]) are optional parameters.
All PyMS programs are run practically the exact same way. Start off with opening Command Prompt, and navigating to your PyMS directory. Then to run a program, it is just:

Command Line

python <program> [options] <parameters>

<program> is the program file (like PyGRP.pyw or PyAI.pyw), [options] are program specific flags, and <parameters> are the input and output of the program (usually in the form <input> [output]). For more details, check the respective programs documentation, or use the -h option on any program to print a list of options to the command line.

^

If one of the programs in PyMS says your file is corrupt, and you don't think it is, or you get a very weird error that looks something like:

Error

Traceback (most recent call last):
  File "PyXXX.pyw", line 6
    def main()
  File "YYY.py", line 1023
    var += blah
         ^
SomeError: some description

Please copy down the error, and send it to me along with information and whatever file you were using the program on when it happened (see Contact for contact info).

^

I would much rather you contact me through the Official PyMS Forums, but you can also send me a private message on any of these other sites:

Last, and the choice I least prefer, you can send an email to me at p.q.poiuy.qwert@gmail.com

^

First of all I would like to thank bajadulce for graciously hosting the official PyMS forum on his great site, BroodWarAI.com, thanks a million!
PyMS v1.1.1

Many people from SEN and WB
Lots of bug reports and ideas, thanks!

PyMS v1.1.0

FaRTy1billion
File specs for tile sets, and design ideas from Hawt Tiles
Hercanic
Many more ideas for things, and bugs

PyMS v1.0.0

ShadowFlare
Created SFmpq which is now used for MPQ handling on Windows
shaggydavid
Suggested implementing SFgrp's vertical style single BMP's
A_of_s_t
Found bugs.
Hercanic
Pressure to make previews in PyICE, finally got me to do it :P

PyMS v0.1d

ShadowFlare
Created IceCC which came with some help info for opcodes and animation types
ashara
Many many PyAI bug reports
A_of_s_t
Found bugs, gave suggestions, and tested PyTRG a bit

PyMS v0.1c

FaRTy1billion
Created TrigPlug and gave me the specs so I could add support ot PyTRG
MamiyaOtaru
Helped figure out Linux/Mac problems, thanks so much!!!
Spirus
Found a problem in PyAI (which also applied to PyTRG)
bajadulce:
   Found another PyTRG bug
   Helped track down the bug in PyAI mentioned above
   Found missing warning in PyAI

PyMS v0.1b

Heinermann:
AI Command list for PyAI
bajadulce:
Lots and lots of testing and ideas on PyAI (Thanks a lot!)
Found lost of PyTRG related bugs
modmaster50:
Lots more testing and ideas on PyAI (Thanks a lot!)
Zelduck:
Found bugs in PyAI
Lazer_Dude:
Notified me of major path bugs

PyMS v0.1

TeLAMoN:
GRP specs.
Sovereign Modding Empire:
Lots of specs.
BroodKiller and DatEdit:
DAT file specs, and all the information in the Data and Default folders of DatEdit.

Introduction

PyGRP »