Features

Quick Target Features

• Quick Scout - - sends scouts to village (configurable)
• Quick Fake - - sends fake to village (configurable)
• Quick Farm - farms village on scout report (ingame configurable)
• Quick Hero - hero raids oasis - useful for conquering and early hero leveling

Report List Features

• Select all messages checkbox - like Plus
• Next Page Shortcut Key - SPACE
• Auto Report Delete per report type - 1 click deletes all report of that type

Message List Features

• Select all messages checkbox - like Plus
• Next Page Shortcut Key - SPACE

Messages / Ingame Forum Messages Features

• Coordinates Link To Target - ingame format coordinates: X|Y link to the target map location
• URIs Link To URIs - useful for user, alliance, reports, ...

Dorf1 - Resource Fields

• Resource Field Levels color coded (max'ed out / upgradeable / not upgradeable / )

Dorf2 - Inner City - Buildings

• Building Levels color coded (max'ed out / upgradeable / not upgradeable / )

Rally Point Features

• Village Troops Total - wherever they are
• Troop Group Links - jump to "troop the the way" or others
• Village Reinfs Away Coordinates

Marketplace Send Resources Features

• Overflow/Depletion Times - considering arriving all mercs
• Cumulative Resource Arrival (with times) - considering arriving all mercs
• Merchants Used - changing the resources to send shows merchants needed and the excess/available load
• Autocomplete - like Plus, auto completes own village names
• SendResourcesConfirmation - send to self autofocuses on ok (hit enter)
• Market Easy Send Resource Quantities (times 0, plus times 2, plus times 5)

Hero's Mansion Features

• Complete Hero Status

Residence / Palace Culture Points Features

• Total Villages available
• Time for next villages

Send Troops Features

• Delayed Send Troops - send attack after X time (needs improved interface)
• Autocomplete - like Plus, auto completes own village names

All Pages

• Title fix - put page header on title (on tab)
• Current village resources production
• Current village resources overflow/deplete timers

Single Village Features

• Adds Village List - usefull internally (and more, see instructions)

Statistics

• WW Village coords

Treasury

• Contruction Plan Village holder coords

Buildings / Fields / Troops / Research

• Time To Build - Each resource missing and timer to make stuff
• NPC Time To Build - Resources missing and timer for total resources to make stuff

Script

• GreaseMonkey Menu Command Check Version - check if userscripts.org already has a more recent version

Instruction details

• Time To Build
  • If the warehouse and/or granary needs to be upgraded each respective image is shown
  • Else, if any resource is missing some amount to complete any action:
    • show each resource amount that is missing
    • show a timer that indicates when is that amount going to be available
    • when the timer reaches 0, the page refreshes so that the action is available and can be clicked
• NPC Time To Build
  • If any resource is missing some amount to complete any action:
    • If total available resources (TAR) > total needed resources (TNR):
      • show a link to the Market, NPC trading
    • Else:
      • show a with the total missing resources
      • show a timer which indicates when will the TAR reaches the TNR
      • when the timer reaches 0, the becomes a link and the rest disappears
• Dorf1 - Resource Field Levels color code
  • Green - max level achieved
  • Yellow - upgradeable building with current resources
  • Red - lack of resources to upgrade building (considers resources on page load)
• Dorf2 - Inner City Building Levels color code
  • Green - max level achieved
  • Yellow - upgradeable building with current resources
  • Red - lack of resources to upgrade building (considers resources on page load)
• Rally Point Village Total Troops
  • Additional table at the top of the Rally point (above the "overview | send troops | simulator" links) with the total of troops from this town, no matter where they are at the moment.
• Message Text to Links
  • Coordinates to Link: ingame coordinates format only (just copy paste from profile): X|Y
  • URI to Link: complete URI only. Accepted format: something before :// and then until a space or minor (a <br/> is placed automatically at the end of a line). (regex: w+://[^s<] )
• Auto Report Delete
  • Click the button in the new table for the report type you want to delete
  • This will try indefinitely to delete all reports. It will stop when:
    • it reaches an empty reports page
    • the current page is not a reports list page
    • the current page is a reports list page, but not either of these:
      • report list of the type to be deleted
      • report list of the type "all reports" - after deleting 1 page of a type the next page has this url
  • As a result, if it is interrupted for any reason and no other page is visited (eg.: disabling script, ...) it may happen that this is resumed when the report list page is visited.
  • If this happens, just visit any other page while the script is enabled and the action should be stopped
• Quick Scout / Quick Fake / Quick Hero
  • on village links, the icons appear, just press and there they go
  • if no available troops, troop sending is canceled on SendTroopsPage
  • for now only configurable in the script (at the end, in the "CONFIG" vars)
• Quick Farm
  • Appears on scout reports (resource scout reports)
  • Raid/Attack pre-selection: raid = romans/teutons; attack = gauls (in case there are traps)
  • Troop amounts pre-selection: based on resources available with extra carrying space (...)
• Quick Target Features
  • Multitabbing
    • different targets: send troops simultaneously (while other tabs still processing)
    • same target: send troops one after the other (send, wait for all redirections, send next, ...)
  • notice that sending a lot of troops in multiple tabs at the same time may slow the browser a little... yeah, don't send 50 at the same time :P
• Delayed Send Troops
  • Set the arrival time, press the clock and the seconds to attack will appear
  • Interface needs improving
  • This is not exact... timeout skew, server delays...
• MarketPlace
  • Resources Overflow/Depletion
    • the script tries to understand which resources are arriving or are own merchants on the way
    • once understood, that info is saved and the script will always be able to distinguish them
    • easiest for the script to learn: make a trade (other town mercs arriving AND own merchants on the way)
• Complete Hero Status
  • total kills needed for current level
  • total kills needed for next level
  • kills done for current level
  • kills needed to get to the next level
  • on mouse over of the "kills done on this level" cell, you get the total kills done
• Single Village
  • visit the profile page to retrieve the name and coords of the village
  • visit the dorf3 (Use the "Villages" link) to get the proper village id
  • useful for getting to dorf3 early on
  • useful for other features in this script
  • usefull to activate scripts that only work on multiple villages
  • remember to make sure this script is above all scripts that may need this
• Configurable variables
  • some features can be enabled / disabled / changed by using the variables at the very end of the script

To Do

• Possible future features
  • Improve Timers (lightweight timers - not sure how to test - increase load?) (30 - 900 - 5 - 60 - 1)
  • Auto Avoid Attack - move troops away and cancel them to return after an attack (time configurable)
• Features to be added
  • Quick Farm - improve interface (now it is using english words)
  • Quick Targets - ingame fully configurable: quantities / attack types / cata targets
  • Target "Info" History - save "info" lines from attacks (ingame erasable) to display... somewhere (village link mouse-over?)
  • Quick Targets - if not enough troops, stop redirections at send troops confirmation (for a few seconds with cancel button?)
  • Incoming Attack Slowest Unit Calculation
  • Plus Feature: Archive IGMs/Reports
  • Plus Feature: Notes
  • Delayed Send Troops: Hop village in background so that you can prepare multiple attacks from multiple villages
  • Rally Point: Text to clipboard with the incoming attacks, town, granary, crop prod, curr crop,...
  • Improve general performance ( specially main )
  • Add a mailing list possibility to send IGMs to multiple people
  • Add retrieve all reinforcement reports to a exportable format and put it in QP clipboard
  • Market Send: show each cumulative Arriving Totals per merchant arrival in scrolable table
  • Market Send Resource Timers: when on negative production, add the possibility of the arriving resource maxing out the capacity - the rest it wasted
  • Market Send Resource: limit total resources sent to current merchants in town
  • Rally Point: Troop Group Links: try to make links without having the #
  • NPC Time To Build: On quantities calculate on keyup (troops)
• Requests
  • Update this with posts information
• Known bugs
  • delayed send troops timer may show strange values, but sends on time
  • --- Currently none ---

History

• 3.1.0 - 08-05-10
  • added: GreaseMonkey Menu Command to check for a newer version of this script
  • added: Rally Points Reinfs Distance
  • added: NPC Time To Build now fills the inputs at the NPC Merchant
  • improve: (NPC) Time To Build now compatible with graphic packs
  • bugfix: Market Send: Merchants Used now works after sending the 1st time
• 3.0.0 - 08-04-29
  • added: Time To Build feature
  • added: NPC Time To Build feature
  • improve: Rally Point Troop Group Links: "Costs" link (to upgrade building) is back
  • improve: Rally Point Troop Group Links: Oasis links mention the oasis and then what type of gourp it is
  • improve: Rally Point Troop Group Links: all links are now working again - oasis links were now links to the oasis page
  • improve: Delete Reports is now safe(r)
  • improve: Market Send Resources code cleanup
  • improve: Less output (on error console) as per default on release version
  • bugfix: Total Troop Table no longer wrong when there are Incoming Troops
  • bugfix: Rally Point Village Reinfs Away Coordinates - only applies on village links, not on user links so those "(NaN|NaN)" should all disappear
• Previous history inside script

Generic script goals

• simplify some tasks - repetitive tasks; too-many-steps tasks; ...
• no support for other browsers - using of firefox GM_set/GM_get to save permanent info
• no need for language translations - simple new icons OR words/icons from travian
• low priority on Plus support - Plus users already have benefits over others
• ultra low priority on country specific HTML support - some travian servers have changed HTML in the game

Script problems?

• Instructions for newbies
  • Install FireFox most recent stable version
  • Install Greasemonkey Addon for FireFox
  • Install QP Targets most recent version
• Firefox 3 BETA x
  • As long as FF3 is not final do not report any bugs please.
  • FF 3 beta (4) seems to have a problem with showing HTML so there are bound to be problems with scripts.
• Bugs / problems / etc...
  • Try the following:
    • Disable other GM scripts (for incompatibilities)
    • Check the Error Console - Tools, Error Console (for added info)
    • Change the DEBUG_VERBOSITY level down to DBG_LOWEST (for maximum possible info)
  • If the problem still exists please give me the following information:
    • Browser used, including version
    • Script version
    • Graphic pack used or if none is used
    • Travian server where you see the problem
    • Describe the problem the best you can
    • Information from the Error Console you believe can help

Configurations

• Enable / Disable Features
  • What: All features can be disabled (1 feature can be a requisite for another feature)
  • Where: Inside the function main()
  • How: Find a function call inside the main function and comment it out
    • To comment code place a // at the beggining of that line
    • Function names are self explanatory
    • If disabling a feature messes some other feature... undo it :)
• Feature configurations
  • What: Some features can have their behavior work in different ways (few even disabled)
  • Where: At the end of the script
  • How: Find a configuration variable, read the comments, and configure one of its possible values

Read above please!

• You are responsible for reading all this text above
• Asking something that is already answered above probably won't get you the answer you wanted...