Modding Tutorials And History New Horizons is a community modding effort by the members of www.piratesahoy.net Compiled and edited by Thagarr Table of Contents Basic information about the code......................................................................................................................................5 Unsorted info......................................................................................................................................................................10 Ghost references.................................................................................................................................................................12 PMT Tutorial Adding Characters to POTC........................................................................................................................13 Testing………………………………………....………………………….………………………………………………19 Adding a Command to the Options Screen..….......………………………………………………………………….…..23 Creating New Items………………………………...……………………………………………………………….……24 Adding Ships………………………………………...…………………………………………………………….……..29 Sails Ropes and Flags………………………………...………………………………………………………….……….34 Adding Skins to Tailor………………………………...…………..……………………………………………..……….36 Create Fantom..………………………………………...………………………………………………………..………..41 Creating New Locations………………………………...…………………………………………………….………….42 Customizing the Main Character………………………...…………………………………...……………..……………45 PMT Tutorial – Item Locators……………………………...……………………………………………...……………..48 Location Cloning……………………………………………...………………………………………….………………53 Location Cloning Pt 2…………………………………………...………………………………………..………………80 Making a Character Portrait……………………………………..……………………………………...………………..95 Executing arbitray code during the game………………………..…………………………………...…………………..97 Making a New Ship………………………………………………..………………………………..……………………98 QuestWinConditions………………………………………………..……………………………..…………………….100 Retexturing Tutorial…………………………………………………..…………………………………………………104 Inez' Diaz tool for PotC model editing……………………………….………..…..……………………………………114 Understanding and Making Ship Walk Files………………………….…….…………………………………………..120 History of the Build Mod!................................................................................................................................................123 Willemstad Builders' Trials.......................................................................................................................................124 Build 14: New Horizons Default Key Assignments....…………….……………………...……………...………..125 Build 14 Beta 3.2 WIP ............................................................................................................................................ 126 New Officer System………………………………………………….……………...……………………………..161 Maturins weather Mod v1.02………………………………………….…………...………………………………164 DirectSail 1.0………………………………………………………….…………...………………………………165 DirectSail 1.1………………………………………………………….………...…………………………………168 Pirates of the Caribbean Codepage...........................................................................................................................171 Build 13 ReadMe Files…………………………………...…………….……...…………………........………………..173 Build 12 ReadMe Files………………………………………...……….……...………………………........…………..225 Build 11 ReadMe Files.....................................................................................................................................................278 Keywords used in POTC...................................................................................................................................................315 Credits!..................................................................................................................,,,........................................................320 Tutorials We tried to keep as much of the "boring" material out of the actual game manual as much as possible because we wanted to keep peoples attention and keep them focused on the actual game it's self. So now, here we have an almost 320 plus page supplemental manual full of "boring" material for your reading pleasure! Seriously though, these pages are packed full of information of all kinds. And if you are even the slightest bit interested in what we did, and how we did it, then this might not be that boring to you after all! There is some real great information here, and as you read through it, you can see just what a stable base the original modders tried to give us to work from. We thank them greatly, because now we don't have to worry about their mistakes and we can concentrate fully on making our own! The following tutorials were created by their original authors during earlier development of the build mods. They were originally posted on the original POTC wiki. They have been added here to make sure they are preserved and are not lost to the sands of time. I have edited them only to correct some minor spelling errors, and to reformat the code sections so they are more readable in this format. I have also added a few pictures to try and improve the aesthetics. Some of the sections have missing pictures that I was not able to recover. Some of the code boxes span more than one page, I tried to limit that as much as possible, so you may notice some formatting irregularity's in some parts. If I have messed anything up, or you notice I have failed to give proper credit for something, please stop by Pirates Ahoy! and post about it or PM me, I will correct it as soon as possible. A lot of the content, if not most, is still relevant to the game today. There have been some code changes to build 14 that do some things just a little differently. If you are having problems getting something to work correctly, please stop by the forums and post about it! We will do our best to figure out just what is going on. Unlike most corporate game companies, we want you to help us develop our games! We need your input, in fact, we thrive on it! If in your opinion we could have done something better or more efficiently, or you just think that we got something plain wrong, then fix it yourself! We are even going to show you how! History At the end of the tutorials, you will find a history of the build mod built from info texts that were cluttering up the old "buildinfo" folder and included with each previous release. Now they are safely and neatly stuffed in here! This history is not complete and doesn't cover in detail everything included in the mods. But it does cover all of the major addons and code fixes prior to New Horizons. Some of the files may be out of order, as I went by file dates, and some of those were not original. I have had to reformat some of the texts to get them to fit into this format. I have done my best to make sure that everyone has been properly credited, if I have made any mistakes or missed something, again please contact me, Thagarr on the Pirates Ahoy forum. Setting Error Logs : If you are experiencing issues with mods and want to give feedback to the mod team, it helps to give them as much information as possible. This short tip explains how you can generate error logs when a bug occurs. In engine.ini file, set the following settings: tracefilesoff = 0 runtimelog = 1 tracefiles = 1 (It won't hurt to have everything in the [script] section set to 1.) Then you play the game, the log files show up in your main POTC directory. Simply attach them with a bug report for the team. You can always find the most up to date information and coding tutorials for New Horizons on our forums at www.piratesahoy.net! You can also find regularly updated information and tutorials on our MODDB page :http://www.moddb.com/mods/new-horizons BASIC INFORMATION ABOUT CODE by Verruckt CHAPTER 1: The really basic stuff Contents 1.1 PRIMITIVES 1.2 SEMICOLONS 1.3 VARIABLE TYPES 1.4 TONGS 1.5 COMMENTS 1.6 BASIC MATH OPERATORS 1.7 SYNTAX 1.8 FUNCTIONS 1.9 REFERANCES & ARRAYS 1.1 PRIMITIVES There are a few types of variables you'll see. int double float long string char bool #define Each can be used in different situations and has different rules of what it can hold and how it can be used. INT: An int can hold integers only and has a limit number.... but I forgot it... so an int would hold something like 1, 2, 56,3568, etc. These are great for any situation that can't have a fraction of something, like crew numbers, Number of cannonballs, or populations. DOUBLE: A double can have decimal places and can hold twice as much as an int. These can be used for things like Money, stats, number of cakes(2.5 cakes? all for me?) FLOAT: Like a double, except a bigger number can be held. LONG: Also like a double, except the number can be alot bigger. STRING: Holds words, sentences, paragraphs, etc. things like ?cutlass?, ?The pirate went to the bar and drank orange soda?, and other things would be found in these. They are pretty useful for situations where something has to be displayed on the screen. CHAR: Can hold a single letter, like A, b, C, c... I don't use these often maybe someone can edit this and add some useful info. BOOL: These can be either ?true? or ?false?, with such limited functionality one would thing these are useless, but no my friends, these are great and can be used all the time. For instance, you make a quest to get a car, and a NPC girl in the game won't talk to you until you have a car, so you set a car variable to false at the start of the game, and upon finishing the quest for the almighty car, it switches to ?true?. Then in the NPC girls dialog you have a check to see whether car