README_BoomBeach.md

Boom Beach Progress Tracker

A Python-based tool to track your personal progress in Boom Beach.
Instead of manually remembering your base and troop levels, this tracker keeps a permanent, organized record so you can see your progress over time and plan your next upgrades.

Features

• Track HQ level — quickly see your current Headquarters level.
• Track Armory level — record upgrades and when they happen.
• Track Landing Craft — store the number you own and the level of each one.
• Record troop or building levels — easily expand to track other stats like Sculptor, Radar, or specific troop upgrades.
• Customizable — add new categories or structures without changing the core logic.
• Simple interface — quick input and instant display of your progress.

Requirements

• Python 3.8+
• No external dependencies

Usage

1. Clone or download this repository:

   git clone https://github.com/YourUsername/boom-beach-progress-tracker.git
   cd boom-beach-progress-tracker

2. Run the tracker:

   python tracker.py

3. Follow prompts to:
   • Update HQ level
   • Update Armory level
   • Update number of Landing Craft
   • Update the level of each Landing Craft
   • View your current progress in a clean, readable format
4. Data is saved in a JSON file so it’s easy to back up or modify.

Example

Example JSON data:

{
    "timestamp": "2025-07-13 13:40:52",
    "Michael": {
      "HQ": 25,
      "Armory": 25,
      "Player Level": 69
    },
    "Capt. Bizzy": {
      "HQ": 11,
      "Armory": 8,
      "Player Level": 27
    },
    "Lt. Randy": {
      "HQ": 11,
      "Armory": 9,
      "Player Level": 29
    },
    "Crenchlowe": {
      "HQ": 12,
      "Armory": 9,
      "Player Level": 31
    }

Future Ideas

• Graph progress over time
• Highlight the next recommended upgrades
• Add date stamps to each change for historical tracking

License

This project is licensed under the MIT License — see the LICENSE file for details.