• Play
  • About
  • News
  • Forums
  • Yppedia
  • Help
Personal tools

Yohoho Tools

From YPPedia

(Redirected from Narya Scene Editor)
The Yohoho Tools interface.
The Yohoho Tools interface.

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 for your platform (Windows, Mac or Linux):

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/ (link currently broken). 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

  1. 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.
  2. Windows XP. It may work with Windows 2000. It may not work with anything older.
  3. 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

Converting a Scene from the Client

Puzzle Pirates scene files are stored in the scenes\Ocean.puzzlepirates.com\ directory of the Puzzle Pirates folder. On Windows, this is usually C:\Program Files\Three Rings Design\Puzzle Pirates\.

You can find the correct scene file for an island by searching in the scene directory for the file containing the text name of the island you are looking for, like "wrasse" or "cnossos". Finding scene files for rooms of buildings or vessels is more difficult; you can search for the room name, like "main hold" or "attic", but there are likely to be many of these. Another way to find scenes is to open the ocean's scene folder and delete most of the scene cache, like all the files with numbers over 1000. Then visit the scene in game. The most recent new scene you visited will be the most recent file in the directory.

The scene files are frequently out of date, you can force Puzzle Pirates to update the scene file by deleting it and then going to the corresponding scene in game.

Once you've found the scene file(s) you wish to use, you will need to have them in XML format. The best way to do this is to use the scenetoxml batch converter. This is a small utility written in Java that can take any number of scene files on the command line, and convert them to the XML format used by Yohoho Tools.

History

Yohoho Tools was updated with a new version on 2006-04-07.

External Links

Retrieved from "http://yppedia.puzzlepirates.com/Yohoho_Tools"
Powered by MediaWiki
Attribution

Puzzle Pirates™ © 2001-2008 Three Rings Design, Inc. All Rights Reserved.TermsPrivacy