3 This is part of the YARRG website. YARRG is a tool and website
4 for assisting players of Yohoho Puzzle Pirates.
6 Copyright (C) 2009 Ian Jackson <ijackson@chiark.greenend.org.uk>
7 Copyright (C) 2009 Clare Boothby
9 YARRG's client code etc. is covered by the ordinary GNU GPL (v3 or later).
10 The YARRG website is covered by the GNU Affero GPL v3 or later, which
11 basically means that every installation of the website will let you
14 This program is free software: you can redistribute it and/or modify
15 it under the terms of the GNU Affero General Public License as
16 published by the Free Software Foundation, either version 3 of the
17 License, or (at your option) any later version.
19 This program is distributed in the hope that it will be useful,
20 but WITHOUT ANY WARRANTY; without even the implied warranty of
21 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 GNU Affero General Public License for more details.
24 You should have received a copy of the GNU Affero General Public License
25 along with this program. If not, see <http://www.gnu.org/licenses/>.
27 Yohoho and Puzzle Pirates are probably trademarks of Three Rings and
28 are used without permission. This program is not endorsed or
29 sponsored by Three Rings.
32 This Mason component generates the introduction.
37 <style type="text/css">
39 body { margin: 0; color: #000000; background: #c5c7ae; }
41 margin-left: 1em; padding-left: 1em; padding-top: 0.01em;
42 margin-right: 1em; padding-right: 1em; padding-bottom: 0.05em;
46 <div class="navoptbar">
51 <h1>Guide to YARRG</h1>
53 YARRG (Yet Another Revenue Research Gatherer) is a third-party tool
54 for helping find profitable trades and trade routes in Yohoho Puzzle
55 Pirates. It was inspired by
56 <a href="http://pctb.crabdance.com/">PCTB</a>.
60 Information about commodity prices is collected by pirates like you
61 and uploaded to the YARRG server, using the special yarrg upload
62 client. You can then query and search on this website for commodity
63 prices and good trade routes.
69 <h2>Quick start for experts</h2>
71 <h3>Straight to the commodity prices database</h3>
73 If you already know about trading on Puzzle Pirates, understand what
74 the YARRG website is for, and just want to get down to playing with
75 it right away, simply select your ocean:
79 % my @oceans= ocean_list();
81 % foreach my $ocean (@oceans) {
82 % my $uri= URI->new('lookup');
83 % $uri->query_form('ocean', $ocean) if $ocean ne 'Midnight';
84 <% $delim %><a href="<% $uri->path_query() |h %>"><% $ocean |h %></a>
89 <h3>But before you start ...</h3>
91 If you are going to use YARRG seriously you will almost certainly want
92 to upload your own data. See <a href="upload">Uploading to YARRG</a>
97 You will also probably at some point want to read the
98 <a href="docs">Documentation for Experts</a> which covers some
99 features of the website which you might not guess just from using it.
103 <h2>How to use the YARRG website</h2>
105 YARRG is designed to help pirates make profitable trades. It is not
106 designed as a trading tutorial and some familiarity with trading in
108 href="http://yppedia.puzzlepirates.com/Trading">yppedia.puzzlepirates.com/Trading</a>
109 contains some advice on trading basics.
111 <h3>So how do I use it then?</h3>
113 <p> First look at the top of the page. You need to select your Ocean,
114 the sort of Interface you would like and the type of Query you wish to
119 <h3>Selecting your Ocean</h3>
123 Which ocean do you want to trade on?
124 Just click on that ocean's name.
128 <h3>Selecting your Interface</h3>
130 <p> You can choose to enter commodity and island names by typing them
131 into a text entry field or by selecting them from a drop down menu.
132 The "select from menu" option allows only a restricted number of
133 options to be entered into each field.
137 <h3>Type of Query</h3>
141 There are currently four types of query available which answer
142 slightly different questions.
146 <h4>Trades for route</h4>
150 <b>For pirates who know where they are going.</b> Trades for route allows
151 you to enter a route that you are planning to sail and find out if
152 there are any profitable trades you can make along the way. This is
153 for pirates who already have a definite sailing plan for some reason.
154 Under "Enter Route" you need to type (or select from menus) the names
155 of the islands or Archipelagoes that you plan to visit. If you wish
156 to know about arbitrage opportunities at an island you can enter just
157 that island name. If you enter only one Archipelago then you will get
158 arbitrage opportunities in that archipelago; if you enter the same
159 archipelago twice you'll get trades within that archipelago.
163 <h4>Prices for commodity</h4>
167 <b>For pirates wanting to sell or buy a specific commodity</b> prices for
168 commodity returns the best buy and sell prices for the selected
169 commodity at each island where trades are available. Type (or select
170 from a menu) the name of one commodity at a time. This is useful for
171 pirates wishing to purchase or sell a specific commodity and wanting
176 <h4>Offers at location</h4>
180 <b>For pirates wanting more details about commodity prices at specified
181 locations.</b> Offers at location returns all the offers to buy and sell
182 wood at the selected location(s). Type (or select) a commodity and the
183 islands (or achipelagos) you are interested in. This is useful when
184 the best buy or sell offer is for only a small quantity: you can check
185 what the others offers are like.
189 <h4>Find Profitable route</h4>
193 <b>For pirates just wanting to make some poe moving commodities about.</b> Find
194 Profitable Route finds you a profitable trading route: first select
195 either "open-ended" (which might take you anywhere) or "circular"
196 (which takes you back to where you started) then type (or select) your
197 starting point (or points - you may for instance have two ships in
198 different locations either of which you could use).
206 Data age tells you how long ago data was uploaded from each island in
207 your ocean. Data changes very quickly and trusting old data to be
208 accurate is unlikely to be rewarding.
212 <h3>What do the results mean</h3>
216 Prices for commodity and offers at location give very similar results;
217 there will be two tables: the first titled Offers to BUY your
218 commodity, the second offers to SELL it. The tables can be resorted
219 by your prefered heading by clicking on the arrows.
223 Trades for route and Find profitable route both return voyage plans.
224 Find profitable route has an additional step to get at your results -
225 when you enter your query you are given a list of 15 good routes for
226 total profit and 15 good routes for profit per league which visit
227 different islands. Select your prefered route: perhaps you will choose
228 to take the best profit or perhaps you need to miss out one island
229 because it is blockaded or another because you don't have the charts
230 to get to or from it. If you have asked for a trade for route or
231 after selecting the profitable route you prefer you will get a Voyage
232 trading plan - this provides you with instructions for what to do (buy
233 this, sell that, sail there).
237 Sometimes no useful trades are available. In this case the results
238 section says simply "No profitable trading opportunities were found".
242 After this there is a table reporting the age of the data used. And
243 then a table of Relevant trades which lists just about everything you
244 could want to know about each trade the plan suggests you make (yes,
245 this table is fairly complicated). The ticky boxes down the side of
246 this table allow you to choose which trades you like the look of -
247 untick any that you are not interested in (for instance you may be
248 uninterested in trades with a low profit margin).
252 <h3>What are the Advanced options</h3>
256 These options are very useful, and not very advanced, but not needed
257 for searching the data.
265 You can't trade more than fits in your hold. If you don't say
266 anything YARRG assumes that you have infinite hold space (perhaps you
267 will go over the route many times). You can enter a ship-type, a mass
268 or a volume; additionally you can subtract quantities of commodities
269 from a ship-type (for instance 'sloop - 10 grog' gives the capacity of
270 a sloop that has 10 grog already on board); click the ? by this field
271 to get a full description of permitted entries here.
279 How much poe do you have? If you don't say anything YARRG assumes you
280 have infinite poe to spend, but you probably don't. Enter the amount
281 you are willing to spend on commodities for trading with.
285 <h4>Expected losses</h4>
289 How much do you expect to lose to the dasterdly brigands? enter either
290 a % (as eg - 1%) or a fracition (as eg - 1/100) of the goods you
291 expect to loose to Brigands. Brigands take 10% if they defeat you,
292 but only you know how often you are defeated. Note that this doesn't
293 include rum-consumed so you will need to account for that
298 <h4>Max distance</h4>
302 How far are you willing to sail today? The default is 20 leagues, the
303 maximum supported is 35. Are you willing to sail all the way accross
304 the ocean for a profit? or would you prefer to go only a short way?
308 <h3>Other fairly useful information</h3>
312 The search information is encoded in the URL - you can bookmark pages
313 for searches you want to perform a lot and go straight to them without
314 re-entering you data (or you can copy the URL and tell your hearties
315 and crew mates if you want to). There's no need to come back to the
316 introductory page each time.
320 Javascript magic: when you type things into the text entry fields
321 YARRG will try to guess what you meant. If you pause for a moment then
322 beneath the text entry field you'll see what YARRG thinks you meant.
323 If it's got it correct you don't have to type any more of that
324 commodity/island name: just go on to the next one.
328 You'll probably want to upload data to ensure you have fresh data
329 available. Unfortunately YARRG only has a Linux upload client at
330 present (a windows one is in the works). You should <a
331 href="upload">read about how to upload</a>: particularly the linked
332 README page for information about the client which contain
333 easy-to-follow instructions to download, install and run it in the
334 form of a few comand line instructions that you can copy and paste.
338 It's all free, both free-as-in-beer or free-as-in-speach. If you're
339 interested, read the <a href="devel">Development pages</a> for more
340 info about how to contribute or how to run your own website using
341 YARRG data (perhaps you don't like our colour choices)
345 <h2>Contacting the YARRG developers</h2>
347 Email Ian Jackson ijackson (at) chiark.greenend.org.uk. Or talk to
348 any Fleet Officer or above of the crew Special Circumstances on the