An Open Manifesto to Scorewarrior: Why Total Battle Needs a Read-Only API and a Mercenary Exchange Rework

Hello everyone, and hello to the Total Battle development team.

I am writing this manifesto as an independent developer and a passionate player. For me, creating analytical tools for this game is a hobby and a way to support the community. I provide all my services completely free of charge because I believe that tools for coordination and statistics should be accessible to every player, not sold for real money.

Right now, Total Battle is facing a silent crisis. The lack of official tools has created a massive, unfair black market of paid bot services. This breaks the game's balance, compromises security, and literally kills the game servers.

Here is why the current system is failing, and how we can fix it together.

1. The Monopoly of Paid Bots vs. The Need for a Read-Only API

The Problem: Clans heavily rely on data—chest tracking, activity logs, and clan performance metrics. Because there is no official API, a shadow industry of commercial bots has emerged. Wealthy alliances pay subscription fees to "pirate" developers to get advanced statistics and automated tracking, leaving ordinary players and casual clans with zero chance to compete.

The Illusion of Security: The development team tries to stop this by adding extra encryption to network traffic. But as previously discussed in the community's API thread, players have already found various ways to easily bypass these barriers. Any data sent to the client can and will be decrypted.

I am not even a professional programmer, yet it took me just one single day to decrypt the game's network streams. Rigid encryption does not stop pirates; it only creates an arms race that developers will always lose.

The Solution: Introduce an official, secure Read-Only API (via OAuth authentication).

• Benefits for Scorewarrior: This will instantly destroy the commercial value of pirate bots. Players will spend their money inside the game rather than paying third-party shady developers.
• Benefits for Servers: Instead of thousands of fake "twin" accounts constantly sitting online and scraping data, a single optimization request from a free community web service every 10 minutes will consume thousands of times less server power.

2. The Mercenary Exchange Crisis and Server Lag

The Problem: Finding Mercenary Exchanges has evolved into a lucrative illegal business. Pirate services instantly parse the world map, extract exchange coordinates, and sell access to private Discord channels with automated pings. A regular player searching the map manually stands absolutely no chance.

The Destruction of Performance: We all feel the terrible lag on Mercenary Days. The servers are literally choking under millions of parasitic requests from map-scraping bots. Forcing heavier encryption on these packets does nothing to solve the issue—the data is still easily parsed through various methods, but the heavy decryption process overloads the server CPUs during peak hours.

The Solution: We need to change the mechanic itself. The root cause for map-scraping must be removed.

• Proposal: Completely decouple the purchase of mercenaries for silver from shared physical objects on the world map. Instead, move this mechanic into an individual interface (e.g., inside the City or the Tavern) unique to each player. Alternatively, remove the current exchange system entirely to relieve the world map and server infrastructure.

A Call to Action for the Community and Developers

I am not asking for any privileges for myself. If given the legal tools, I am ready to spend my own time building free, transparent, and open-source services for all players to level the playing field.

To the Players and Clan Leaders: If you are tired of unbearable lag on Mercenary Days, and if you believe that basic clan statistics shouldn't require paying money to pirates, please upvote and support this manifesto. Let’s make our voices heard.

To Scorewarrior: Please look at this from a business and architectural perspective. An open Read-Only API and a rework of the exchange mechanics will save your servers, protect your users' data, and return financial flows back into the game’s economy. Let's work together to make Total Battle better.