TGLPG - The Guardian Legend Password Generator
Written by Michael Hayes
linktr.ee/intylab
Date Of Last Modification: February 15, 2022
__________

"What is this?"

This is a graphical application written in Python using Tkinter.  It
creates a password for you based on any game data you wish to have for
The Guardian Legend for NES.
__________

What is included:

readme.txt - what you are reading now
  tglpg.py - the program itself
 config.py - a configuration file that you can tweak
  icon.png - program icon
   assets/ - a subfolder containing all the graphics files
__________

Setup

A. Install Python with the following commands:
   pkg install python
   pkg install python-tkinter
B. Create a folder called "projects" on your Home Folder.
C. Unzip tglpg.zip from this "projects" folder.  It will create a
   subfolder called "tglpg/" and copy everything into there.
D. Add Execute permission to tglpg.py with the commands:
   cd
   chmod +x projects/tglpg/tglpg.py
E. You will probably want to create a Symbolic Link from your Home
   Folder.  Use the following commands:
   cd
   ln -s projects/tglpg/tglpg.py tglpg
__________

How to use:

From your Home Folder, just type "tglpg" to begin.

A window will appear with a set of controls on the right, and the Map
to the left.  There is a scrollbar for the map.  If your display size
is greater than 720p (1280x720), you'll probably want to make an
adjustment so the entire map fits onto the screen.  We'll do that in a
minute.  First, let's get familiar with the controls.

A. In the top right corner are the Command Buttons.  You can click on
   the "Instructions" button for more detailed instructions.  After you
   set the other controls how you want them, click on the "Get Password"
   button to get your password.  The "About" and "Quit" buttons should
   be self-explanatory.
B. Below the Command Buttons and Password display and four additional
   Frames.  Two of them contain sliders (called "Scale widgets"), and
   there are a couple numeric text fields as well (called "Spinbox
   widgets").  Click on the "?" buttons for more information about these
   variables, and set them to whatever values you choose.
C. The other two frames in the bottom right corner contain buttons that
   let you toggle having individual Keys and having individual Optional
   Weapons.  You can also set the power level of the Optional Weapons.
D. The Map is full of buttons that you can click to toggle whether
   you've collected each of the "free" items, whether you've defeated
   each "miniboss" and collected the prize, whether you've purchased an
   item in each "shop", and whether you've cleared each "corr"idor and
   collected the prize (and key).  A red "X" will appear over the image.
     i. The red-bordered squares indicate rooms where you can obtain a
        password.  You can actually start anywhere on the map you like,
        including spaces that are not part of the map.
    ii. The white-bordered squares indicate corridors.  The one space
        that's red in the middle is for Corridor 21.
   iii. There's also an image of Miria in the room where the game
        begins.  When you "Get Password", she will move to the room
        indicated by the Location sliders.

When you click on the "Get Password" button, the last digit of your
Score will change to 0 if necessary (the 0 that is always at the end of
your score is not part of the password), and your Enemy Eraser count
will be recuded to 255 if it is higher than that.  Miria will also move
on the Map if you updated her Location.  Your password is displayed in
the Password Frame.

From here, you can make changes if you like and get another password, or
you can quit.
__________

Configuration:

If you're on a higher-resolution display (1080p or higher), you'll want
to make a couple adjustments.  The "out-of-the-box" configuration is to
accomodate for resolutions as low as 720p.

Open config.py using any text editor you choose.  A few lines down are
the Cosmetic settings.  The "canvasheight" and "canvaswidth" variables
are the ones you want.  Change them to 912.  Anything higher than that
will just be capped at 912.

If you don't like the window to appear in the top
left corner, you can change the "geometry" variable as well.

The other cosmetic settings are for fonts and colors.  Everything else
should be left alone.
__________

License stuff

There is no license or warranty of any kind.  The standard precaution
applies that use of this program is at your own risk.  As it is free,
neither I nor Midnight Blue International, LLC assume any responsibility
for detrimental effects to your or your device(s) as a result of its
use, either direct or indirect.

Do let me know if you encounter any bugs or passwords that don't work.
I keep the Encryption Key fixed at 0.

This program is based on the Password FAQ posted on GameFAQS by
FatRatKnight.
__________

EOF
