.:Serenity Guide:.

[iBotPeaches]

Made by

Monkey Terd. Credit to him

Seeing as many people are dumbfounded aboutusing Serenity, I decided to write a full, in depth tutorial on usingall of the aspects of Serenity. (Because for some reason, people alwayscomplain about how "hard" Serenity is to use, when infact, I find itthe easiest to use.)

 

All of this is using the most up to date Serenity (Currently Serenity 3.30). So if you don't have it, you will most certianly need it.

 

Part 1:Adding Serenity to your Windows Shell.

 

Adding Serenity to your Windows Shell, is byfar the easiest andmost convenient way to access Serenity. When you first download a.Serenity file, your computer will not recognize the file extensiontype...

 

http://www.ibotmodz.net/forum/uploads/remoteimages1/2674-628.png

 

 

Step 1:

Locate a .Serenity file, and double click on it. (A dialog should pop up, asking you what you would like to open it with.)

 

 

http://www.ibotmodz.net/forum/uploads/remoteimages1/2674-629.png

 

 

Step 2:

In the dialog, select "Serenity" from the listbox, if "Serenity"is not listed, use the browse button to locate it. (Make sure that the"Always use this program to open this type of file" checkbox ischecked.)

 

Now, if you locate your .Serenity file, you will notice thatinstead of being solid white, you see the Serenity Icon in the center.

 

http://www.ibotmodz.net/forum/uploads/remoteimages1/2674-630.png

 

Now everytime you double click on a .Serenity file, it will launchSerenity, and fill in the Patch, Source Map, and Output MapAutomatically.

 

 

 

Part 2:Applying a Serenity Patch

 

Applying a Serenity Patch is way simpler then people make it out tobe. If you have added Serenity to your Windows Shell, it is evensimpler.

 

Step 1:

Locate your Serenity Patch (for this tutorial, I will be using "End of the Line",By: Zenon). Once you have located the patch, double click on it, andSerenity should launch, automatically filling in the information foryou. If you wish to change the information, you may do so.

 

If you are changing the information,

 

Patch: Is the Serenity file (Duh)

Source Map: Is a clean copy of the original map.

Output Map: Is the location for which Serenity will place the modified map (So your original map is kept clean).

 

http://www.ibotmodz.net/forum/uploads/remoteimages1/2674-631.png

 

Step 2:

Verify that you have a copy of the original map (In my case Headlong)in the same directory as the Serenity Patch. If you do, then go aheadand click "Apply Patch".

 

Step 3:

There is no step 3. Applying a patch is so simple it's only 2 steps. http://www.ibotmodz.net/forum/uploads/remoteimages1/2674-632.gif

 

Note: With Serenity, it automaticallyfixes the map's Encryptomatic Signature, so there is no reason for youto need to resign the map after patching it.

 

 

 

Part 3: Creating a Serenity Patch

 

There are quite a few features Serenity has when creating patches. Whenyou goto the "Create" tab, you will see 2 checkbox's and 2 selectionbuttons. (Which of coarse each has it's own purpose)

 

http://www.ibotmodz.net/forum/uploads/remoteimages1/2674-633.png

Checking the "Secure Patch" box, will encrypt the patch (and themap of all who apply the patch) to be unreadable in map editors. If youwish to see what I mean, you can try opening "Cassiopia", By: Aequitas in a map editor.

 

Note: The only catch to using this feature, is that you map has to be "Proper" with no holes.

 

 

Serenity used to have a restriction that it would only create a patchif your map was "Proper", but with the release of Serenity 3.0, came anew feature, to bypass this restriction.

 

http://www.ibotmodz.net/forum/uploads/remoteimages1/2674-634.png

 

Checking the "Non-Compliant" box will allow you to make a patch ifyour map is not proper. To find out if your map is proper or not, youcan either scan for "Holes" with UberAnalyzeToolâ„¢, or try creating a Serenity patch with the "Non-Compliant" box unselected.

 

 

http://www.ibotmodz.net/forum/uploads/remoteimages1/2674-635.png

The next options you will find are the "LZMA" and "ZIP" selectionbuttons. These are the 2 compression methods that Serenity uses whencreating patches. I suggest using the "LZMA" option, as the patcheswill be at their maximum compressed size, and will be smaller than ifyou rar'd a "Zip" patch (most likley). The only noticable diffrencebetween the two, is that the "Zip" method is a little faster whengenerating a patch.

 

Step 1: Once you have selected the "Type" of patch you want to make, fill in the textbox's with the appropriate information.

 

Patch: The name of the patch, and location you want it to be saved.

Original Map: The file location of the clean original map.

Modified Map: The file location of the map you are creating a patch for.

 

Step: 2 Hit "Generate Patch" and wait for Serenity to do it's stuff, and thats all there is to making a Serenity Patch.

 

 

 

Part 4: Using the Mainmenu Features

 

The Mainmenu Features of Serenity can be used both when applying a patch, or creating a patch.

 

Alright, here, we are going to use the mainmenu options while applying a patch.

 

Step 1: Navigate to the "Mainmenu" tab of Serenity, and select the "Use Main Menu" box.

 

http://www.ibotmodz.net/forum/uploads/remoteimages1/2674-636.png

 

Serenity Patches can store the Mainmenu information within thepatch itself. You can find many patches that already have mainmenusettings in the patch, such as "End of the Line", at the Serenity Repository.

 

http://www.ibotmodz.net/forum/uploads/remoteimages1/2674-637.png

 

Note: If the patch you are using does notcontain Mainmenu data, you can enter everything yourself, and Serenitywill still add the map to your mainmenu.

 

Step 2:Check again, and make sure that the "Use Main Menu" box is checked,then go back to the "Apply" tab and apply the patch. Doing so will notonly turn the original map into the modded one, but will also add themap to you Mainmenu (If it is in the same directory as the map),complete with Title, Image, and Description.

 

Creating a patch with Mainmenu data is just about the same. Beforeyou "Generate the Patch", just make sure the "Use Main Menu" box ischecked, and enter a name, description, and a DDS image (Must beAxRxGxB format, with a size of 224x207), and that will be saved intothe Serenity that you create, so others can use it too.

 

 

 

Part 5: The Serenity Repository

 

The Serenity Repositoryisn't really a feature of Serenity, but a clever script made byAequitas, that grabs Serenity Patches with complete MainmenuInformation from hosted .Serenity files, and organizes them into a niceclean webpage.

 

If you want a mod added to The Repository, (Assuming its decentenough), Simply host a .Serenity file here on Halomods (must be under10mb), with the "Name", "Description","Image", and "Author" entry's inthe hosted file.

 

[image by Aequitas and his sexy MCE PC] XD

http://uploads.sixfactorial.com/serenity_mainmenu.gif

 

 

 

Part 6: Errors

 

As with all Halo 2 programs (with the exception of ADI), while usingSerenity you may experience a few errors. (None of which are Serenity'sfault though http://www.ibotmodz.net/forum/uploads/remoteimages1/2674-632.gif )

 

Error 1: Source Map does not match the original...

http://i64.photobucket.com/albums/h169/HMMonkeyTerd/Serenity%20Tutorial/error.png

 

That just means that when you are applying a patch, that the map youentered as "Source Map" did not match the same as the person who madethe patch. (Most of the time, meaning you did not use a clean map, ifyou were, then the person who created the patch did not create it usinga clean map.)

 

Error 2:Removing tags is not yet supported. This just means that you have somestuff unrefrenced in your map (Holes) and it couldn't generate a patch.To fix, simply check the "Non-Compliant" box.

 

http://i64.photobucket.com/albums/h169/HMMonkeyTerd/Serenity%20Tutorial/error1.png

 

Error 3:Unableto add [...], please verify the path under setup, and try again. Thissimply means that it tried to add a map to your mainmenu, and couldn'tfind your mainmenu. To fix, just go to the "Setup" tag, and refrenceyour maps folder.

 

http://i64.photobucket.com/albums/h169/HMMonkeyTerd/Serenity%20Tutorial/error2.png

 

And amazingly those are the only three errors I have ever encountered with this miraculous program.

 

 

 

 

.

 

 

 

Edit 2: Thanks to Iron_Forge for pointing out to me that I wrotethe compression method's wrong. LZMA compresses slower, butconsiderably smaller than the Zip method.

[firefoxx04@yahoo.com]

is there a way to apply a patch then edit it to your own "needs". i have a sweat map but i want to tweak it. dot halo and all that stufff wont open it up

[iBotPeaches]

After you apply the patch to the map of your choice dothalo should open it up. Otherwise it cannot open the patch file directly since its not a map to open, just bits and pieces of a map.

[noodle1119]

It's because the maker encrypted the map so you cant steal the content.