Commandos Developing Toolkit

F.R.C.

Source Package http://files.cnblogs.com/Rex/CommDevToolkitSrc.rar
Binary Package http://files.cnblogs.com/Rex/CommDevToolkit.rar



1 General Introduction

The toolkit is mainly used in modification in Comm2 or Comm3.
See "UpdateLog.en.txt" for version and newest changes.
As there is a lack of time, I do not do much exception handling. Sorry.
If there is someone who want to write help or translate the toolkit, then do it. If you contact me, I'll be very happy.
If someone want to join the project, or have found a bug, or have some suggestions, please contact me at the following URL.
http://www.cnblogs.com/Rex/Contact.aspx?id=1



2 File Format List

Supported File Format

Y64Manager         Y64
PCKManager         Comm1_DIR PCK CSF_PAK
SECConverter       SEC
ImageConverter     Comm1_RLE GRL
BsmbDecoderShell   BSMB(AN2 ANI BAS BIN BRI DAT GSC MIS MSB)

Public File Format

Text File          Comm1_SCR Comm1_TIL Comm1_TIP Comm1_VOL CFG DAT FAC GMT LIS MAC MAN OGC ROL STR TXT TUT CSF_FLI CSF_PRP
Image File         BMP JPG PNG
Sound File         WAV CSF_rws(need Vorbis Codec)
Video File         POP(need Indeo Codec) BIK(need RAD Video Tools)
D3DX Texture File  DDS(Photoshop)

Not Supported

Encoded Text File  CSF_CSSFBS(BDD CFG FBS TXT)
Image File         Comm1_RLC Comm1_WAD ABI ARLC DES
Others             Comm1_FNT Comm1_ZOM FNC FNM MA2 MBI PK CSF_FNT

All file formats above refer to files in resource folders or packages.
File formats without a version belong to Comm2 or Comm3, or for all versions, or public formats.
There are some repetition, as there are different formats share the same name. (ex. encoded and not encoded text files)



3 System Requirement

The software needs Microsoft .Net Framework 2.0.
http://download.microsoft.com/download/5/6/7/567758a3-759e-473e-bf8f-52154438565a/dotnetfx.exe

This framework will not be able to be installed on older operation systems such as Win98 or Win2k, for lack of WindowsInstaller 3.1.



4 License

The software is freeware without charge, the main license is in FFPL.txt, but in Chinese.
The main meaning is that you can do all(copy, modify(except for the license), translate,  etc) but you can not publish it in the original name when it's not the original software, and that we promise nothing.
There is an aditional restriction as follows:
The software and softwares which use codes from the software are not put it into commercial use directly or indirectly.

The copyright of the library Firefly.Core.dll shipped with the software is held by me. And I permit it use the same license of the software. The library is separately published, see http://www.cnblogs.com/Rex/archive/2008/11/08/1329759.html
The copyright of the library zlib.net.dll shipped with the software is held by ComponentAce. Refer to zlib.net-license.txt for its license.
The copyright of the documents obj_format.en.txt and mtl.en.txt are held by Wavefront, Inc.



5 Reference

Source Code of the Toolkit               Src\

Documents of the Toolkit                 Src\Doc\

URF's Website(Chinese)                   http://www.faqy.cn

neoragex2002's BLOG(Chinese)             http://neoragex2002.cnblogs.com

My BLOG(Chinese)                         http://rex.cnblogs.com

Sina Commandos Forum(Chinese)            http://bbs.games.sina.com.cn/?h=http%3A//bbs.games.sina.com.cn/g_forum/00/92/08/&g=15

Commandos Editing Center(Russian)        http://cec.h1.ru/files



The Current Version is 2007.06.28.0 with a tool called MA2Handler.
It supports exporting MBI's internal images and MA2's data dumping.
It's not globalized 'cause it may be cancelled later on.

If someone want to know the file formats, see Src\Doc\.

The toolkit is updated.
wyel2000 has released a mission with my toolkit in http://bbs.cga.com.cn/BBS_content/65/2007/7/27/908269.asp?tid=908269
(Chinese)
------------------------------------
Source Package http://www.cnblogs.com/Files/Rex/NDGrapherAndCommDevToolkitSrc.rar
Binary Package http://www.cnblogs.com/Files/Rex/CommDevToolkit.rar
------------------------------------
2007.07.29.0
Merged in NDGrapher solution, which is my first project since I started programing, to prepare for the following SECEditor.
Changed the licence of NDGrapher and its sub-projects to FFPL to open soure.
Enhanced Comm3_MBI->Comm2_MBI, by removing exceptional objects like sunshine.
Enhanced Comm3_Y64->Comm3_Y64, by adding an option "Replace with Comm2 Palette".
Hint: You can adjust the colors of the target Y64 by change this option and the Lightness Factor, the Saturation Factor below.

2007.07.21.0
Fixed a problem in SECConverter with the target file dialog displaying "Open".
Fixed a bug in PCKManager with canceling readonly attribute when opening PAK files of CSF.

2007.07.20.0
Found a new version 1010 for Comm2_ABI. Refreshed document Comm2_ABI.zh.htm and the program.
Modified Y64Manager and corrected the errors. Canceled the limitation in converting and creating Y64 files in Comm3. But I haven't decoded the unknown data in Comm3_Y64 yet. I am sure that it contains MA2 data by converting it to Comm2_Y64 and back.
Moved the MBI convertion into ImageConverter.
Separated the source pack from the binary pack again. With the source pack you can quickly create binary files quickly by Build.cmd.

2007.07.10.0
Corrected a problem with MBI convertion.

2007.07.07.0
Added MBI file analysis for Comm3. Refreshed document Comm2_MBI.zh.htm. Added auto convertion when handling MBI files of Comm3 to MA2Handler.

2007.07.03.0
Modified the analysis of ABI format in Comm2_ABI.zh.htm. Finished the unpacking the images in ABIs of Comm2 and Comm3. Other information in ABI (such as .max, .o) are not handled. Added ABI->Gif in ImageConverter.

2007.06.29
Found a bug in Comm3's Y64 format analysis. It affects the handling of Comm3 in Y64Manager.
The newest available version without the bug is 2007.02.10.0.

nobody replys u...
WO DING!

I am having trouble converting .mbi files from commandos 3 to commandos 2 with multiconverter.exe, the new files do not work propperly =[

thanks for the tools! =]

i gta contact rex to help u...

@ENV
Can you describe it in detail? Or give some screenshots?

Check if the SEC file with the same main name is also converted and used. It's coupled with the MBI. Without the same SEC, the terrain will be weird.

I think I should notice you that there are tools from NeoRAGEx2002 which can be used to examine ABIs and MBIs.

ABI Viewer
http://www.cnblogs.com/neoragex2002/archive/2007/08/20/863005.html [Chinese]
http://www.cnblogs.com/Files/neoragex2002/Comm_3D_Abi.rar

MBI Viewer
http://www.cnblogs.com/neoragex2002/archive/2007/08/15/856505.html [Chinese]
http://www.cnblogs.com/Files/neoragex2002/Comm_3D_Mbi.rar

Notice: Managed DirectX Runtime(2.23M) is needed.
http://www.cnblogs.com/Files/Rex/MDX_Runtime.rar
http://files.cnblogs.com/neoragex2002/mdx_redist_11.rar


And some update log for the Commandos Developing Toolkit:
If you download from the previous link recently. You need not to download it again.

2007.11.02.0
A bug in MultiConverter relating INI file is fixed.

2007.11.01.0
Auto environment variable appending and file convertion from inside PCK is applied to MultiConverter.

2007.10.31.0
Finished MultiConverter, which is made for creating batch files to convert Comm3 mission resources to Comm2.

2007.10.28
SECConverter is renamed to MultiConverter, and its functions are partially moved to SECEditor.

2007.10.13.0
An improvement has been applied to the determination of to-be-deleted Comm3 polygons in MBI program.

2007.10.12.0
A rouding error in the determination of to-be-deleted Comm3 polygons has been removed from the MBI program.

2007.10.11.0
Refreshed something in MBI document and program relating the semi-transparence of the floor in the hall in Berlin mission.
Fixed a bug in MBI's program where textures are wrongly supposed to be 256*256.
The binary package doesn't contain formats documents any more, see http://www.cnblogs.com/Rex/archive/2007/10/03/913427.html
for documents.

2007.09.30
Refactored SECEditor and GraphSystem to get more extensiablity for pickable objects.

2007.09.18.0
SECEditor
With the delayed loading technic, it's possible to use the GDI+ interface without Managed DirectX Runtime.
Added the right mouse button rotation function following "Homeworld".
Adjusted the colors of some kinds of districts.
Added status bar info. Hided the debug info, which can be shown with F1 button.

2007.09.15.0
Refreshed some info about SEC in Comm2_SEC.zh.htm.

2007.09.12.0
Fixed the error relating maximize and minimize the window.
Added the district picking ablity. Added the district attributes editing function.

2007.09.07.0
Fixed some bugs relating the SECEditor controls.
Ensured to run SECEditor with Comm2 main program simultaneously.
Improved the performance of SECEditor.

2007.09.06.0
Added supports for Direct3D graphics interface to SECEditor refering 3D .Sec Viewer by NeoRAGEx2002. And the painting scheme is also used.
Modified some structures in GraphSystem to reduce coupling.
Added cubic display of districts to SECEditor. Improved the keyboard control system.

2007.08.15.2
Found a special data in MA2, and added handling for it.

2007.08.15.1
Fixed a big mistake that ImageConverter is missing. It's because of the failure in conditional compiling and the neglect of checking automatic compiling result.
Modified Comm2_MBI.zh.html following NeoRAGEx2002's opinion.

2007.08.15.0
Fixed a out-of-bound error in the Bmp file reading and writing when the horizontal offset is not zero.
Added *EX.MA2->Gif & Bmp and Y64<->Bmp in ImageConverter.
Notice: *EX.MA2->Gif & Bmp will be changed to *EX.MA2->Gif in future release. It's not realized now because the results of Bmp->Gif in .Net Framework is awful, and that I haven't understood the fast DCT (a good quantization algorithm).
Fixed the SEC problem in fixing it in 2007.07.31.0.

2007.08.14
Fixed a problem in Comm2_Y64->Comm3_Y64.

2007.08.13
Finished the decompression of the sub render data of MA2.
Fixed a bug relating creating new files with Y64Manager.
Fixed many problems with the reading and writing dismatch in ini file entries.

2007.08.04
Modified the graphic algorithm of NDGrapher, and made fps the priority. Some suppositions are added to speed up the graphics.

2007.08.03
Tested and found that in a flame of a typical SEC graph, the world transformation needs 40-60ms, and the clipping, perspective transformation and drawing cost 1000-2000ms.

2007.08.02
Optimized the calculation sequence of the congruence transformations.
Added the MA2 write-to-file functions.

2007.07.31.0
Started the SECEditor project.
Fixed a bug with opening the Comm3\DATA\MISIONES\ST1\ST1_03.SEC.

2007.07.30.0
Enhanced Comm3_MBI->Comm2_MBI, by recovering some normal objects like ladders. But all enterable doors in all walls will show something purple(#FF00FF), which means transparent. Now I can only turn them black.

Hi guys.
After a long time, we can finally create complete new maps in Commandos 2.


Although only the interior 3D scenes are fully supported currently, we can expect something new.

The toolkit is released at
http://www.cnblogs.com/Rex/archive/2008/05/31/1211298.html

Direct download link

Source Package
http://www.cnblogs.com/Files/Rex/NDGrapherAndCommDevToolkitSrc.rar

Binary Package
http://www.cnblogs.com/Files/Rex/CommDevToolkit.rar


Maybe it's too late as it's nearly 7 years since Commandos 2 released, and 10 years since the original Commandos came out.

Usage:
The example under Bin\Examples\ is the main part. Drag them onto ImageConverter.exe and you'll get a SEC and a MBI.
Obj files in the example can be imported into and exported from the 3DSMAX.
The procedures are stated at Src\Doc\OBJ_ConvertProcedure.zh.htm, which will later be localized to English. But only the images in it will give a lot of information.

Feel free to contact me.
http://www.cnblogs.com/Rex/contact.aspx?id=1

this is great! Nice Work Rex. If you manage to create maps, we can start making new commandos stories. Fans would surely appreciate. Maybe Pyro will release a new version of the Commandos 2 engine so that it can be much more interesting to play..

It is never too late...

since we have already had c3 missions converted into c2 mission...i think we should update the c2 version number...1.34 is not enough...at present we can play 48 missions in c2..

hey...im late...

If you could include all the missions in one file, we could start making a new mod with a new name and version, something like Commandos Chronicles, featuring all the missions from C1 to C3. I could fill each level with enemies like I did with DP.

moding........

very nice, my compliments :OK!:

up