tcamps

Non-stop Poster
Reaction score
109
Author
tcamps
Contributors
vahtos
Quickbar Entry
Get a script from https://v.tylercamp.me/register or from your tribemates that use the vault
Public?
Public
The 'Vault' script hosted at https://v.tylercamp.me/script/main.js (and subsequently vault.js) has been approved as of:

03/09/2018 - Ticket #12638710 (Maeve, JawJaw) (.NET/.US)
13/12/2018 - Ticket #12834909 (Maeve, JawJaw) (.NET/.US)
05/22/2019 - Ticket #13202005 (Ekimilson R.) (.COM.PT)
06/25/2019 - Ticket #13235356 (Joris) (.NL)
00/00/0000 - Automatic due to .NET approval (.COM.BR) (Still needs translation)
10/12/2019 - Ticket #13456511 (2oceano) (.IT)
12/11/2019 - https://forum.fyletikesmaxes.gr/index.php?threads/26717/#post-464530 (.GR)
23/04/2020 - Ticket #13879348 (.AE) (Not entirely verified; someone else submitted the ticket with a response in Arabic and assured me it's confirmed, taking their word for it)

9/9/2019 - Ticket #13389170 (Kozmicz)
Kozmicz said:
This script is not allowed on our server.
Script was submitted but denied without any reason. They were having trouble getting it working (I still don't know why) and they were unable to give enough info to troubleshoot the problem.
This was a weird process. Two Discord users, "Tim_"/"Daydream" (Tim_#1776) and "Tec" (Tec#5775), were involved in the evaluation process. "Tec" was confirmed to be TW staff for approval, no ticket was submitted. Apparently "Tim_" acted as a tester for scripts before they're passed through "Tec". "Tim_" required that he have time to translate the script and test it first. I added support for .FR but wasn't given any updates for almost two months. At that point (30/1/2020) I decided that I needed an update or I'd remove .FR support, since it still technically wasn't approved. I was given this response:

Tim_ said:
Hi tcamps, sorry i'm a little bit late xD Humm I used it for some weeks and ... This tool don't match with my requirements. But you did a great job ;) Thank you for your time ;)
The script was approved for a few months, but was banned near the end of 2020. https://forum.tribalwars.co.uk/index.php?threads/approval-of-vault-script.26622/#post-472273

The Vault will shut down on Nov. 1st, 2021, at 4PM EST.
See my latest comment for more info: https://forum.tribalwars.net/index.php?threads/vault.282252/page-6#post-7141604

New: The Vault has been shut down early, as of Oct. 24, 2021. Scripts can no longer be generated from the Public Vault. Someone else will need to host the Vault.

Full source code (with some config files) is now at: https://github.com/tylercamp/twvault

You can deploy your own Vault, but it will need to be approved individually.

Video on deploying a Vault server -

Text installation guide here - https://github.com/tylercamp/twvault/tree/master/installer

vvv Original Post vvv

This previously private script is now open for general use. Each user must get their own script for each world - instructions below.

This script takes your reports, commands, incomings, and troops, and uses this to provide useful information. (See screenshot below.) Tribemates that upload will add to the pool of data that the vault has to use, and benefits everyone using the script in your tribe. (e.g. if you upload a report, scripts for other tribemates will take your report into account automatically.) There are 5 big features in this script (and many, many smaller ones):

- In-game map overlay
- Automatic backtime search and planning
- Tag incomings
- Tribe council easily sees troops and participation from all tribe members
- Action notifications, ie notification when an ally uploads an incoming train to the Vault, showing target village and landing time

Qpt0JWV.jpg

Getting the Script
If someone in your tribe already has the vault, you should ask them to send you a script. (They should have done so already - that's how the script is meant to be used.) If you're starting on a new world or want to set up the vault for your tribe, you can register with your world and in-game name at:

>>> https://v.tylercamp.me/register <<<

If you have any issues with registration, you can contact me:
- By posting here
- By PMing me here
- On Skype (astpgmr)
- On Discord (tcamps#9882)
- On Discord (dedicated server: https://discord.gg/hNDgrta)

Discord is generally the most reliable way to reach me. I strongly suggest posting any questions in the Vault discord server linked above, chances are someone else there will be able to answer your question too.

You'll get a script like:
Code:
javascript:window.vaultToken='00000000-0000-0000-0000-000000000000';$.getScript('https://v.tylercamp.me/script/main.js')

Requirements
You need Premium to use the Vault, and should use Google Chrome on desktop. The vault hasn't been tested on (or designed for use on) other browsers.

Instructions/Guide
There isn't a comprehensive guide for the vault. (It's too big and I'm too lazy to write everything.) The best way to learn it is to check the screenshot above for the general feel, and just try out the different features of the script.

Generally, uploading your data is the first thing that should be done. Upload frequently - the script skips data that it had already uploaded, so if you don't upload often you'll spend more time waiting.

An (incomplete) list of Vault features. (There's a lot and I can't remember everything or am too lazy to write everything.)

Run on the map to highlight villages based on data you've uploaded to the Vault:
- Nukes
- Stacks (color-coded stack size)
- Low wall
- Has Church/Watchtower
- Nobles
- Returning nukes

Hovering over villages after running the Vault will enhance the Tribal Wars popup showing various building levels, loyalty, troops, and an estimate of nukes required to clear any stacks. (Nuke estimate only reliable on non-archer worlds.)
Run while viewing the page for an enemy village to list all returning troops to that village, the troops associated with each command, and a button to automatically generate backtiming plans.
Open the main Vault interface and go to the Tools tab, then the "Find Backtimes" section. Tweak the options to your liking and click "Search" to get a BB-code table of launch plans for your nukes to backtime enemy nukes that are returning.
Open the main Vault interface and go to the Tools tab, then the "Fake Script" section. You can generate a dynamic fake script selecting players, tribes, and continents, and narrow down the selection by coordinate range or distance from a coordinate. From there you can get a fake script managed by the Vault, or you can get the current list of coords directly for use in your preferred fake script.
Spreadsheet Summary
Vault Admins can download a spreadsheet summary for others in their group that have uploaded to the vault. Go to the "Admin Options" tab in the main vault interface, under the "Tribe Stats" section. This spreadsheet contains nukes/DVs owned, at home, and traveling, DVs supporting others, DVs supporting self, number of outgoing attacks, number of incomings, DV support on a per-tribe basis, nobles, etc.
User Management
Vault admins can make scripts for new users, revoke scripts for users, and give or revoke admin privileges for users in their group.
Run this script on your Incomings page to open the tagger, which is an experimental feature, and can be used to tag incomings with various information stored in the Vault such as total # of attacks from that village, # of cats known in that village, # of troops from an enemy village that were traveling when an attack was sent, etc. The tagging format is customizable and an include things such as village name, player name, coordinates, etc. If you don't like the results of the tagging, there's a "Revert" button to undo the tagging and rename incomings to their original names.
Open the main Vault interface and go to the Stats tab to get info on the performance of your account and of others in your group over the last week, including # of fangs, fakes, and nukes sent.
Open the main Vault interface and go to the "Actions/Alerts" tab, which has various useful suggestions and tools. This includes Recap notifications (if an ally's village was recently taken and you have nobles nearby), Stack notifications (if a village has low defenses and there are possibly enough nukes currently incoming to clear it), Useless Stack notifications (stacks on villages that are too far from any enemy villages to be useful, or stacks to players outside of your group), Snipes notifications (list of villages that have a noble train incoming that you have enough defense nearby to snipe for), and Noble Targets (villages with low loyalty or low defenses that should be easy to take.)

This section also contains "Request Snipe", "Quick Support", and "Request Stack" sections, which can be used to get a list of player names that have troops available and nearby for a snipe/emergency support/long-term stack.
Open the main Vault interface and go to the "Support" tab, and then the "Translations" section. Here you can change your language and select a translation for the given language. This is useful for players that don't speak English well, or are playing Tribal Wars in a language other than English. You can make your own translations or create modified copies of existing translations to your liking, without needing to wait for me or another translator to build a translation for you.

Data Collection
All requests to the script are IP-logged for security. Data that you upload is visible to vault admins in your group (aka tribe) and nobody else. Information collected by this script will never be shared with any third parties or any unauthorized tribes/players. All requests through the script are logged with your IP, user ID, tribe ID, and various request information such as the endpoint.

Developer Disclosure
As the developer, I have access to various features and information not accessible to other players. I disclose these methods here for transparency and clarification.

1. I am able to but will never deliberately modify or expose data for the benefit of myself or my tribe. (This would quickly lead to banning of the vault script.)

2. As the developer, I have the following tools at my disposal but will not use them for the gain of myself or others, which are limited to debugging or development purposes:
- Script impersonation: I am able to use any player's Vault script and spoof the code to run as though I were the intended user (necessary to view problematic behavior without needing to record a user, connect to their machine, or sit their account; usually only used for problems with high scores or Admin spreadsheets)
- Manual privilege overrides: I am able to reassign any Vault user to a Standard, Admin, or System Admin token (necessary for permissions testing)
- Advanced data exports: I am able to directly connect to the Vault database and retrieve more detailed information than users have access to (necessary for cross-referencing incorrect data when troubleshooting an issue, usually only used for problems with incoming tagging or incorrect troop estimates)

3. As the developer, I may pull any data from the Vault database at my own discretion only for debugging, development, or analytics. I will not share this data with anyone other than player(s) that own the data.

Privacy/Security
The script was designed with various layers of protection to prevent spoofing/hacking. It is not perfect (no system is) but is more than sufficient to deter even experienced developers.

All features in the script were designed to provide features without leaking information. Privacy and security were major parts of the script's design. Features provide just enough information to be useful, without providing so much information that a single spy could compromise all of a tribe's data. Data is provided to Vault Admins in an aggregated form to promote accountability without leaking damaging information such as specific troop locations.

Integrity
I will never forcibly revoke scripts for the benefit of any person. Scripts may be revoked, and players may be banned from the Vault for inappropriate behavior – this includes hacking attempts, and general douchery. (ie, a council member sending troop spreadsheets to enemy tribes.) This gives the Vault a bad name and gives me a headache – I don’t want to deal with it.

If you're having issues with the Vault, you can message me. But first, try the following:

1. Make sure you've uploaded all of your data
2. Try using Google Chrome on Desktop
3. If getting a lot of errors whenever the script is ran, ask your vault admin if your script was disabled
4. If you're getting errors when uploading and your language in-game isn't English, go to the Support tab then the Translations tab, and select your language/translation to use. Translations are made by the community. Not all translations are usable - you may need to try different ones, or create your own
5. If the script isn't working at all despite using Chrome on desktop, check that the script looks like the example in the "Getting the Script" section above. Make sure that any quotation marks are regular and not the fancy-shmancy kind that are used by some messengers.

Q: Can others using the Vault on the same world see my info?
No - every time you make a new script through the Register page it's placed in a new "group" - any script can only see data from others in the same group. Whenever an admin makes a new script, it's automatically placed into their group. (So vault "admins" are really just "group admins".)

Q: I've got an Admin script and someone is sitting my account, should I delete my script/disable Admin?
No - If you have an admin script and someone sits your account, it will behave just like a regular non-admin script when they run it. No need to disable or revoke admin on a script during a sit.

Q: I've got a script from you, I can just share this with my tribemates right?
No - each script is tied to a single account on a single world. Vault Admins can make scripts for others by running the script and going to the "Admin" tab, under the "Manage Users" section. If I've given you a script, it will be set as an Admin script.

Q: Can I get another Vault script for our sister tribe, spies, etc.? / How do I share Vault info with my sister tribe, spies, etc.?
Each Vault script is limited to a "group", not to a tribe. You can make scripts for anyone on that server if you're an admin, including players in sister tribes/etc. They won't be able to see any of your tribe's information unless you set their script as an admin as well.

Q: Can you upgrade my script to Admin?
Probably not - If there are no other admins in your group that are actively playing, I'll upgrade your script to an Admin after doing some research. If there are any other active admins in your group I won't upgrade you to an admin - ask them instead.

Q: Can you add feature X?
No - I'm not actively working on this anymore. I'm only hosting, maintaining, and fixing (major) bugs for it.

Q: How much do I need to pay to use it?
Nothing, it's free to use. I do appreciate PP donations to this account (tcamps) so I can pay for premium to test and fix the script when necessary, or contributions on Patreon to support server hosting. But again, payment is not required or expected.

Q: Is this available on other servers?
The script is only approved for the servers listed at the beginning of this post. Other servers can be supported fairly easily, but the approval process is tough since I don't have a comprehensive guide yet (which is a requirement for approval. Here on .net it was incrementally approved, but a new complete description needs to be written for later submissions.) Some servers do automatically allow scripts approved for .net though - in this case, message me and we'll work something out.

Q: Why is the incoming tagger wrong?
The issue could be related to: missing data (everyone needs to upload their stuff), they might be using some movement speed buff, or daylight savings time might have recently passed. Those last two will break Vault's travel time estimations. I can't do anything about buffs, but plan to add a more permanent fix to DST transitions soon.

Q: Why are the "useless stacks"/"stacks needed" alerts always empty? / How do I register a tribe as an "enemy"?
For those alerts, enemy tribes need to be manually entered into the Vault by your vault admin. This can be done using the "Admin" tab, under the "Enemy Tribes" section. (Tribe names are case-sensitive.)

Q: How big is a "DV"?
20k pop of defensive units or 1.6m total defensive power (different parts of the script use different methods.)

Q: How big is a "nuke"?
18k pop of offensive units or 450k total offensive power (different parts of the script use different methods.) HC are counted as offensive if there are also over 100 axe owned by the village.

Q: What does the vault count as a "fang"?
An attack with at least 50 cats and less than 8k total population.

Q: How do we handle tribe changes when both sides are using the vault?
Data from different scripts can't be merged and a script can't change from one group to another. The tribe being joined should issue new scripts for new members, and the new members should stop using their old scripts and will need to re-upload all of their data.

Q: Can I host the script myself? / Can I look at the source code?
Sort of - the build I run is closed-source and obfuscated for security. Some work has been done for a Kubernetes helm chart to handle installation and hosting of the compiled/obfuscated script, but this hasn't been completed yet (and hosting will easily cost over $50 USD per month on a Linux VM.) A modified version of the vault (with encryption removed) is available below, but I don't recommend using it without adding your own encryption since it's easy to spoof and impersonate other players. https://github.com/tylercamp/twvault-trimmed

Q: I (or my co) don't speak english well, is there a translation?
Open the Support tab in the script and there will be a Translations section, where you can select a language and one of the translations available in that language. Here you can also create your own translation and customize it, which will also automatically be visible for others to use.

Q: Does this work on mobile?
No - or at least, it's not officially supported. The vault has only been tested on Chrome for the desktop. If it works on other platforms, that's a happy coincidence.

Nuke estimates are incorrect on worlds with archers enabled
Archer worlds use a different battle formula than non-archer worlds; there is code for handling this difference but it hasn't been tested well, and I can't be bothered to get it working right.

Incoming tagger may have poor accuracy
Usually this is from people not uploading their reports, but often there just isn't enough info to go on. The Vault bases its tagging off of "owned troops", which is an estimate of troops belonging to that village. Fakes to/from a village is usually what screws troop-tracking though we handle most cases automatically.

Generally, the incoming-tagging is an experimental feature which should be used to inform how to handle incomings rather than interpreted as "truth". The most reliable tagging feature is "returning troops" which is nearly always accurate. If an inc is tagged with >50% nuke returning, it's almost always a fake.

Script occasionally has errors when uploading
Usually this is a one-off thing - refresh your browser and re-running the script usually fixes it. If you have consistent errors, check that your script is enabled by your vault admin and that you are using a translation if your in-game language isn't English. Otherwise, send me a message so we can figure it out.

I'm not actively working on this script - minor/occasional errors/bugs probably won't get fixed. I will do my best to fix major script-breaking issues, e.g. incoming tagging is always incorrect, uploads always fail, admin troop spreadsheets are incorrect, etc. For major bugs you can contact me here or on Skype/Discord as mentioned above.

This section lists cases where I manually modified data in the Vault as part of administration. If you take issue with any of these actions, feel free to post here or PM me with questions/complaints.

20/11/2019 - Disabled all scripts on .NET HP/ENC1 for tribes "FULL" and "Contra" due to "a massive backstabbing and its getting abused" while vault was shared between those two tribes (players can still get new scripts and upload, but old data is no longer available)
 
Changelog
06/06/2019 - Fix bug causing some players to not appear in admin spreadsheet
15/06/2019 - Fix bug causing troop counts to be missing in admin spreadsheet, fix bug causing error in backtime calculator tool
16/06/2019 - A bug caused server to run slowly and break script for some users, bug is being investigated and server restarted
21/06/2019 - Added minimum-points filter to noble target suggestions notification
15/10/2019 - Fixed various usage of UTC time to use server time instead, fixes issues for non-UTC/BST servers
08/02/2020 - Bugfix for backtime search which required 500% nukes instead of 5%, add "Receiving Nukes" map overlay option
16/02/2020 - Improve time parsing by using TW-native translations from window.lang object
08/05/2020 - Revert native translations for time parsing since these weren't reliable (eg for Norwegian)
31/03/2021 - Remove old, unused data endpoints left over from early Vault development. Last-minute update included various other minor changes
01/04/2021 - Fix broken "Get Script" button for users on admin page
06/05/2021 - Fix "Manage Enemy Tribes" section which wouldn't recognize names/tags with a "?" in them
Last edited:
Upvote 13

tcamps

Non-stop Poster
Reaction score
109
Some minor updates and comments on messages I've received:

1. I see peoples' comments and want to say you're only sort of being ignored
- I'm putting time into supporting BLM-related projects which I'm prioritizing over requests here. I'm leaving these messages as unread so when I come back I'll be able to easily see what I've missed.

2. I've worked with some members of Cicada on w112 and for the first time we were able to start a private Vault, which they are now using with only a few minor reported issues. This was completed about 1-2 weeks ago. I've kept record of the steps involved and plan to use it as a template for making a proper Vault "installer" script. That will also need to wait until I've finished my other work. Progress has been made, but is now (once again) on pause. For anyone planning to also host their own Vault, we found that an Ubuntu VM with 2 cores and 4GB of memory was sufficient, since it was only being used by their tribe and is not public. That's just an FYI - I don't suggest reserving any VMs until I've finished the install script.

A further note/disclaimer on Cicada vault: Keep in mind that the Cicada vault has the same features as the main public vault; it has no new features and therefore no real advantages on its own. I will note that Cicada does now have the benefit of being able to deeply inspect all of their data since they have direct access to their database. They are able to build more detailed reports/spreadsheets than is possible for public vault users. While this may seem like an unfair advantage, I'm considering this "fair enough" since the value of the data depends on their ability to use it. I don't currently see it as a significant issue. Vault ToS apply to Cicada's private instance as well, and any reports of data misuse (eg masquerading their private vault as the public one, and tricking people into giving data) will lead to punitive action. The public vault is currently only available at v.tylercamp.me.
 
Last edited:

lodi94

Active Member
Reaction score
29
A further note/disclaimer on Cicada vault: Keep in mind that the Cicada vault has the same features as the main public vault; it has no new features and therefore no real advantages on its own. I will note that Cicada does now have the benefit of being able to deeply inspect all of their data since they have direct access to their database. They are able to build more detailed reports/spreadsheets than is possible for public vault users. While this may seem like an unfair advantage, I'm considering this "fair enough" since the value of the data depends on their ability to use it. I don't currently see it as a significant issue. Vault ToS apply to Cicada's private instance as well, and any reports of data misuse (eg masquerading their private vault as the public one, and tricking people into giving data) will lead to punitive action. The public vault is currently only available at v.tylercamp.me.

That's really interesting. Knowing how the db is organized would be possibile to overwrite some data whith data extracted from the tribe interface?
 

RedAlert

Senior In-Game Staff
Tribal Wars Team
Senior
Team
Script Moderator
Reaction score
608
Hey Tyler, is there any documentation on how to host the Vault. I own a VPS and have installed there Ubuntu server. Im currently hosting there twtools.ga.

Is there any doc on how to setup the Vault on your own server?

Also thank you for this great tool you have brought into the TribalWars world. I have used in the past another tool like this one so i know the help that tools such as this one can give.

Red.
 
Last edited:

One Last Shot...

Contributing Poster
Reaction score
1,552
2. I've worked with some members of Cicada on w112 and for the first time we were able to start a private Vault, which they are now using with only a few minor reported issues. This was completed about 1-2 weeks ago. I've kept record of the steps involved and plan to use it as a template for making a proper Vault "installer" script. That will also need to wait until I've finished my other work. Progress has been made, but is now (once again) on pause. For anyone planning to also host their own Vault, we found that an Ubuntu VM with 2 cores and 4GB of memory was sufficient, since it was only being used by their tribe and is not public. That's just an FYI - I don't suggest reserving any VMs until I've finished the install script.

A further note/disclaimer on Cicada vault: Keep in mind that the Cicada vault has the same features as the main public vault; it has no new features and therefore no real advantages on its own. I will note that Cicada does now have the benefit of being able to deeply inspect all of their data since they have direct access to their database. They are able to build more detailed reports/spreadsheets than is possible for public vault users. While this may seem like an unfair advantage, I'm considering this "fair enough" since the value of the data depends on their ability to use it. I don't currently see it as a significant issue. Vault ToS apply to Cicada's private instance as well, and any reports of data misuse (eg masquerading their private vault as the public one, and tricking people into giving data) will lead to punitive action. The public vault is currently only available at v.tylercamp.me.

Can I just say a huge thank you to you on behalf of the Cicada team for the time, effort and energy you put in that led to this happening. We have really appreciated your time and the quality of your work. And, as you said, only very minor issues (some of which we were able to find ways around that didn't require a fix).
 

tcamps

Non-stop Poster
Reaction score
109
@misteralb Please read my 2nd note on my above comment from Jun 10th

The closest thing to documentation I have is the list of commands I ran for Cicada vault, as well as a bunch of configuration files. I can't share these directly since they likely contain sensitive information, and even if they didn't, there were several periods where I made changes via nano/micro, so there's bound to be some missing info.

I plan to provide these instructions later, but I don't have the time for it right now since testing is a big time sink.
 

DeletedUser125401

Guest
Hi i am from spanish server, this script is amazing. It would be possible add the spanish server to the script? (guerrastribales.es)
 

Lethal Sleep Daddy

Active Member
Reaction score
47
Having issues with uploading commands. Its not uploading for most members. Some failed, but some passed with wrong numbers. Thanks.
 

One Last Shot...

Contributing Poster
Reaction score
1,552
Having issues with uploading commands. Its not uploading for most members. Some failed, but some passed with wrong numbers. Thanks.

Regarding the 'passed with wrong numbers', this is most likely not an 'issue', but actually what your members are sending.

Nukes only count if they are 20k+ population (ie, full).
Fangs only count if they are a certain setting - which you can control.
Fakes only count if they are under a certain size - so if you are on a fake limit world, you need to be keeping your fakes to a minimum for them to count towards numbers.

:)
 

Slim.

New Member
Reaction score
2
What are script rules/requirements on spanish servers? Needs to be approved first

Hey, the script has been approved by the spanish team, I sent you a message with detailed evidence. Thanks for your amazing script :)
 

tcamps

Non-stop Poster
Reaction score
109
Been doing some minor fixes, there may still be an outstanding issue with admin spreadsheet reports that I'm looking into.

Vault is currently down for regular maintenance and should be back in a couple of hours
 

GeeGee

Active Member
Reaction score
67
Question the "label as fakes" states experimental and not working 100% correctly
but can u tell me what the parameters are that its basing its judgement on so i know if its worth it and how accurate it should be for us and how we can influence the accuracy etc.
 

Akhenaten

New Member
Reaction score
0
Hi there!

The script has been approved in .es
Here

I took the trouble to translate this post there. With a few minor modifications.
:)
 

tcamps

Non-stop Poster
Reaction score
109
A recent TW update broke the Vault some time in the last 24 hours. The vault has been fixed and should now be usable again.

The Vault script uses jQuery frequently, a common utility for web developers. TribalWars includes this library for its own use, so scripters get to use it too. The recent TW update must have also updated this utility to a more recent version, since some of the Vault code using jQuery broke. In particular, error-handling for web requests now use a `.fail` function, rather than `.error`, which broke a good chunk of places using jQuery. The fix was simply to replace `.error` -> `.fail`.
 

tcamps

Non-stop Poster
Reaction score
109
Vault was down for ~30 minutes due to a power outage and should be back now
 
Top