Tribalwars: Premium Features

A desktop userscript that adds practical tools for managing TribalWars villages, maps, reports and routine tasks.

Some features reproduce conveniences normally associated with a Premium Account. Others are independent utilities. Automation is optional and may not be allowed on every world.

Important: This project is intended for players without an active Premium Account. Some features may not work at all or may have compatibility issues.

Requirements

• Tampermonkey or another userscript manager that supports @require.
• A desktop browser. Mobile pages are ignored.
• A TribalWars address matching https://*.tribalwars.*/*.

Installation

Install the published script from main.user.js, or use the raw GitHub URL:

https://github.com/joelcosta2/Tribalwars_Script/raw/master/main.user.js

After installation, open the script settings in TribalWars and enable the features you need. Most features are disabled or configurable individually.

Features

Navigation and Widgets

Village Navigation

Adds previous and next village controls. The A and D keys can also be used to switch villages. Adds popup village list by groups.

Custom Navigation Bar

Create shortcuts to frequently used TribalWars pages and arrange them in your preferred order.

Village Notepad

Keep a separate note for each village. The editor supports common BBCode tags and resolves players, tribes and coordinates from game data.

Notepad Features

Notes can be added not only to your own villages, but to any village's profile page, including villages belonging to other players. All notes, for your own and other villages, can be viewed, edited, exported and imported as JSON from the notepad page.

Recruitment Widget

Recruit troops from the sidebar. Costs, population, resources, training queues and the maximum affordable amount update as you edit the form.

Building Queue Widget

Manage upgrades from the sidebar. The script can keep a local waiting queue and submit upgrades when resources and server slots are available.

Coin Minting

Mint coins from any village with a built Academy, from a sidebar quick-link popup. Shows available resources per village and blocks minting when resources are insufficient.

Village Groups Widget

Shows which Custom Map Groups and manual Overview Villages groups the current village belongs to, from the sidebar. - EXPERIMENTAL, NOT TESTED

Overview

Visual Building Overview

Adds building levels, resource information and queue timers to the overview page. Also supports non visual screen.

Overview Villages

Enhances the all-villages overview with building queues, one troop column per unit type, storage fill times, a trader/market tab, manually assignable village groups, village notes and customizable quick links.

This view requires at least two villages. Troop values may need a manual refresh and can be temporarily stale.

Map and Commands

Large Map

Use a larger map and choose its size from the map controls.

Village Hover Information

Adds extra village information, including recent attacks, loot, discovered resources and morale, when hovering over a village on the map.

Village Outgoing Commands and Travel Times

Displays outgoing command icons from your selected village and calculates travel times for available unit types.

Attack Heatmap

Highlights enemy villages from stored attack reports using one of two modes: Resources shows three levels of discovered resources plus empty or possibly stocked villages, while Time shows attacks from the last 3 days in red, yellow and green bands. Own villages are excluded. Resource thresholds are defined as constants in features/mapHeatOverlay.js.

Custom Map Groups

Create coloured groups matching village coordinates, players or tribes. Groups are stored per world and player, and the first matching group takes priority.

The Map Groups action is also available from the native village context menu wherever a village is listed, including reports, reservation lists and notepad links. A quick-add link next to the TWStats link on player, tribe and village profile pages also lets you toggle groups.

Village Reservations

Reserve or release villages from the native village context menu. The action is available on the map and wherever the game displays a village context link, using the reservation planner and local reservation cache.

Troop Templates

Create, edit, delete and apply custom troop templates in command forms and map attack menus.

Map Context Action Buttons

Adds quick action buttons to the map context menu for quick attacks using saved troop templates, quick reservations and quick addition of villages to map groups.

Map SDK

The local SDK adaptation is based on the Map SDK by Thomas "Sass" Ameye: https://shinko-to-kuma.com/scripts/mapSdk.js. Thank you to the author for providing the original foundation.

Farm Assistant (Local)

A free alternative to the Premium Farm Assistant. Navigate to screen=am_farm_twp to see a list of previously attacked villages (built entirely from cached attack reports), with one-click troops sending from the current village.

Only villages that already have a cached attack report are listed — there is no automatic discovery of new targets, and building-target selection for catapults/rams is not supported.

Reports and Simulator

Report to Simulator

Opens the simulator with attacker troops, defender troops, away defenders, wall level, luck, morale, religion and applicable buffs filled from an attack report.

TWStats Player History

Adds extra player history and ranking information to player profiles using a request to TWStats.

This feature depends on the external twstats.com service and may stop working if its pages or availability change.

Automation

Auto Daily Bonus

Collects the daily bonus when it is available and schedules the next check using server time.

Auto Build Instant Free

Completes an eligible active building upgrade during TribalWars' final three-minute free window.

Interface and Settings

Settings

Enable or disable features, arrange widgets, configure automation and export or import all script settings as JSON.

Languages

The interface is available in English and Portuguese.

Small Interface Improvements

Optional utilities include hiding Premium promotions, redirecting training buildings to recruitment pages and keeping the page active while it is open.

Bot Protection Handling

When TribalWars displays an anti-bot screen, the script can stop its features automatically to prevent continuous requests while the protection is active, helping reduce the risk of bans. This behavior is controlled in the settings.

Data and Limitations

• IndexedDB stores structured data for build queues, recruitment data, reports, notes and map data.
• localStorage stores settings and selected world- or player-specific data.
• The extra building queue is a local waiting queue. It does not increase the server's real queue limit: normally two slots for free accounts and five for Premium accounts.
• The browser tab must remain open for the local build queue and scheduled automation to run. (It's not recommended to leave the tab open on overview_villages page.)
• Mobile pages are not supported.
• Some overview and troop data is cached and may require a refresh.
• Map and report information depends on the data available from TribalWars pages.
• The script includes server-timezone handling and is expected to work across different countries and worlds. Some features scrape HTML text, so language or markup changes may cause problems. Please report them so they can be investigated.
• The custom quick-link source and some anti-bot cache/offline settings are not implemented.
• The dark-mode module exists in the codebase but is not currently exposed as an active setting.
• The Farm Assistant (screen=am_farm_twp) relies on TribalWars serving its normal page layout for an unrecognised screen name; only targets with an existing cached attack report are shown, and there is no in-page navigation link — the URL must be opened manually.

Local Development

main.user.js is the distributable entry point and loads the published files from GitHub.

main_local.user.js is the local-development entry point. Its @require paths must point to local files using the file:///... format. In Tampermonkey, enable Allow access to file URLs for the browser extension.

Edit the feature files directly, then reload the TribalWars page to test them. Reinstall the local userscript only when changing its metadata or local @require paths.

License and Disclaimer

This project is licensed under the Personal Use License.

The code may be used, copied and modified for personal, non-commercial purposes only. Selling the project, selling modified versions, sublicensing it or including it in a commercial product or service is not permitted without prior written permission from the author.

This project is not affiliated with, endorsed by or sponsored by InnoGames or TribalWars. TribalWars and InnoGames are trademarks of their respective owners.

This project is provided for personal use and experimentation. Automation may violate the Terms of Service or local rules of a TribalWars world.

The software is provided "as is", without guarantees of availability, accuracy or compatibility. It may not work on every world, country, language or game version. Some features interact with external services or parse TribalWars HTML, which may change without notice.

The building queue is a separate feature from these bots and has reportedly worked with at least 10 villages without a ban.

A note from an entirely unnamed experimental subject: “The queue works. Tested with 10 villages. Still not banned.”

Enable automation only if you accept the risks. The author is not responsible for bans, restrictions or data loss.