Project OLED"

Huge shout-out to everyone who participated (me).

Thank you for visiting the repo page of 'Project OLED"! This is a terminal-ui action-puzzle python mini-game presented proudly by me and my dearest teammates. Made as a group project submission for a programming course that I took (ENGG1330, fyi) BUT the game itself is very playable and complete (and quite fun if you ask me).

Screenshots

---

How to Launch This Game

1. Unzip all files (preferably into a dedicated folder)
2. Click and run "main.py"

Note: There should only be a single executable. I learned how to make my own modules just to make this a clean-enough presentation for you.

That's it. You're set. Remember to size the terminal window large enough.

Also remember to play the tutorial (under the 'Play Project OLED" sub-menu).

Have fun with the game! I think I've amounted 40 hours of total playtime already at this point.

You can navigate the main menu with WASD+C+X. Arrow keys & Enter are also supported.

---

Extra: How to Set Up Your Own "oled_connectivity" Module

If your distribution of the game only comes with a connectivity template (named "oled_connectivity.data.template"), you might want to set up your own online scoreboard for your family and friends.

Double-click and open the template in your text editor of choice. You should now see three fields:

1. CSV_URL

Create a Google Form with a single short-answer field called "scores".

The Form will auto-create a linked Google Sheet ("Responses").

In the Sheet: File → Share → Publish to the web → Entire Sheet → CSV

Copy the CSV publish URL; it looks like:

https://docs.google.com/spreadsheets/d/.../pub?output=csv

Paste it into the CSV_URL field.

2. FORM_URL

In the Form editor: Preview (eye icon), open your browser's dev tools, submit once, then in the Network tab find the formResponse request.

Save its URL; it looks like:

https://docs.google.com/forms/d/e/<FORM_ID>/formResponse

Paste it into the FORM_URL field.

3. FIELD_NAME

Also copy the input name for your field; it will be something like:

entry.123456789

Paste it into the FIELD_NAME field.

That's it. Your file should now look somewhat like this:

{'CSV_URL': 'https://docs.google.com/spreadsheets/d/e/.../pub?output=csv', 'FORM_URL': "https://docs.google.com/forms/u/0/d/e/.../formResponse", 'FIELD_NAME': 'entry.xxxxxxxxxx'}

Remove the ".template" suffix, and place it back into the home directory of the game (same folder as "main.py").

You should now be able to switch on the "Enable Connectivity" toggle in the settings page.

---

P.P.S.

Easiest ways to find the Google Forms field name (entry.xxxxxxxxxx):

1. Open your form's Preview (eye icon). You should be at a URL ending in /viewform.
2. Right-click → Inspect the single text box you created (label "payload", etc.).
3. In the HTML, look for the <input> element and read its name attribute.
4. It will look like name="entry.xxxxxxxxxx".
5. That whole string is your FIELD_NAME.