Yohoho Tools
From YPPedia
Yohoho Tools is the Puzzle Pirates scene editor (also known as the Island Editor). It is used for various contests such as Beat the Champs (Island Design). There are currently no plans to update the software as it is a low priority.
It is not directly tied into the game, so it cannot be used to alter Yohoho! Puzzle Pirates.
Contents |
Installation
Download the official editor from http://www.puzzlepirates.com/yotools/, which is available for Windows and UNIX platforms. If you are running on a Mac, you may still have luck with the UNIX variant, but if you don't, you might wish to try downloading a player-created version from http://download.blacksails.org.uk/YohohoTools/Download/. If you find you're having difficulties getting it to run, especially if you're not running Windows, check the links below.
Windows patching
If you find your editor does not have the most recent objects (such as the snow pirate, Easter eggs (2007), and so on), then you can download this file. (You'll probably want to right-click, save As, but it doesn't really matter). Save it somewhere you can easily find it again.
System Requirements for the patcher
- Both the most recent version of YPP (the game) and the "newer" version (the one that is silver) of the tools must both be installed in their default installation directories. The older version of the tools (the one with the mostly blue interface) will not read the newly parsed file properly.
- Windows XP. It may work with Windows 2000. It may not work with anything older.
- Drive letters Y and Z must be available. If they are not, you will need to tweak the script accordingly. This is more for readability and ability to adjust locations of the tools and the game more than anything else.
Operation
To run the patcher, you can either double-click it, or open a command prompt and run it that way (which will allow you to peruse the logs, should something fail). You will be asked if you want to skip copying the files. Answer N if you are not getting all the most recent tiles from the game (which is almost always the case).
The rest of the script should operate normally, and you should not see any errors. If you do, please copy and paste the error to this forum thread.
Alternate patch method
If you absolutely cannot get the official download to work (again, under Windows), then you may download Emerson's pre-built, patched editor, which can be downloaded from here (26MB). Bear in mind that this is rarely updated, so even after you install that one, you will still need to patch by the method mentioned above.
To install Emerson's version, after it is downloaded, double-click it, and make sure to extract to C:\. This will cause the self-extractor to place the files in the default installation location of the editor. If you extract anywhere else, the paths will be broken, and the editor will not work.
Typical problem with alternate patch
The most common problem with the alternate patch is the inability for the desktop shortcuts to locate Java, due to the fact that not everyone is running the same version. The fix is relatively easy, but can be intimidating to casual users.
Right-click on your Puzzle Pirates game icon, and select properties. Copy the entire entry from the Target text box, which should look something like this: "C:\Program Files\Java\jre1.5.0_10\bin\javaw.exe" -jar getdown-dop.jar . (including the period). Paste it into the Target text box for the Yohoho Tools icon, and the tools should then work.
Using Yohoho Tools
Yohoho Tools can be used to create exterior or interior scenes using the same graphics and rendering as the game client.
Controls
Yohoho Tools is mainly controlled with the mouse, though a few keyboard shortcuts exist.
- Left button clicking places a tile of the selected type.
- Left button clicking and dragging places a block of tiles (only available in the Base Layer.)
- Right button clicking removes an object of the current layer.
- Right button clicking and dragging removes a block of tiles of the current layer.
- Middle wheel clicking brings up the rendering options menu. Be patient; this sometimes takes a few moments.
- Middle wheel scrolling scrolls through the different instances of the selected tile type.
Keyboard shortcuts include ctrl-N for "New," ctrl-O for "Open," ctrl-S for "Save," ctrl-Q for "Quit, " ctrl-D for "Make default base tile," ctrl-shift-C for "Display object commodity counts," and Ctrl-; for "Preferences."
Menu Items
Menu items can be found under the "Actions" menu bar at the top of the interface.
- Update mini view will re-render your scene preview to create a minimap. Make your window smaller (skinnier) if you are getting black spots as it renders.
- Display Commodity Object Counts will give you a list of how many commodities you have placed. Herbs and minerals will only be counted if set to the right type and color.
- Save Overview Map will save a rendering of your island in the install directory (C:\Program Files\Three Rings Design\Yohoho Tools\Snapshot.png by Windows default, or just do a search for Yohoho). If the screenshot doesn't take, try again or make your island smaller!
- Make Default Base Tile changes what the "empty" space renders as. For islands, the base tile must be water.
Creating scenes
Yohoho Tools utilizes a two-layer system: a base layer and an object layer. To create a new scene, navigate to File, then New.
Base Layer
The base layer is composed of all the ground tiles used to create the shape and textures on your island. Almost all base tiles can be walked on by players. Exceptions include water, lava, bog and fissures. The eight tiles adjacent to a single tile of any of these types are also un-walkable.
Object Layer
The object layer contains objects that are used to populate the island, such as plants and buildings. Objects are obstructions—no matter what the size—and players cannot walk on them. Generally, objects disappear when another object (such as a building) is placed on top of them in game. However, some objects—including herbs, minerals, and cliffs—will not allow buildings to be placed on top of them.
For more complete information on the actual creating of an island, please check out the island design guide
Commodities: A complete list of what objects correspond to what commodities.
Bush(herb1):
Madder (red), Old Man's Beard (brown),
Yarrow (white), Sassafras (black),
Iris Root (grey)
Bush (herb2): Weld (yellow), Broom Flower (pink), Lobelia (violet), Pokeweed Berries (purple), Indigo (navy), Elderberries (blue)
Bush (herb3): Cowslip (aqua), Lily of the Valley (lime), Nettle (green), Butterfly Weed (orange)
Bush (sugarcane) Sugarcane
Bush (hemp) Hemp
Mineral (large): Lorandite (red), Leushite (brown), Tellurium (white), Thorianite (black), Chalcocite (grey), Papagoite (blue)
Mineral (small): Cubanite (yellow), Serandite (pink), Sincosite (green), Masuyite (orange)
Rocks (Granite) Stone
Rocks (Iron) Iron
Tree (oak) Wood
History
Yohoho Tools was updated with a new version on 2006-04-07.
External Links
- Forum thread discussing how to get Yohoho Tools to work
- Island editor basics & help
- Island critique - post your island design to get comments & help from other pirates
- New Tiles Update and XML converter for game scene files
- How to get Yohoho Tools to work on yer Apple Mac Computer
