Skip to content
2028badiviPublic

About

petRPG is a web-based, block-programming simulation game developed for the TJHSST FBLA 2026 Intro to Programming competition. The project earned 2nd place at the Northern Virginia FBLA Regional Conference. The game combines grid-based RPG mechanics with structured scheduling logic.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

44 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TJHSST FBLA 2026 Intro to Programming

petRPG

  • This is petRPG, a game for TJFBLA Intro to Programming 2026 where users move around a grid and enter stations to make scheduling commands to take care of the pet.

Controls

  • Move with WASD or Arrow keys.
  • Interact with stations using Space.

Overall Flow of petRPG and Brief Overview

  • The goal: Keep your pet healthy by planning a day using block code. The better your schedule, the longer you survive.

  • When you start the game, you start off at level 1 with $50.

    • Your pet has 5 variables:
    • health,
    • hygiene,
    • hunger,
    • energy,
    • and happiness.
  • Your character has 3 variables:

    • currentFood,
    • lives,
    • and level.
  • Gameplay is infinite. However, as you level up, the game gets harder, as incrementing variables costs more money and variables decrease faster. The game ends when you lose 2 "hearts."

  • You lose a heart when your cash or any pet care variable goes to 0 or below after executing your schedule/day.

  • This game is all about logical planning and scheduling a day for the future. A running total of all your expenses is in the "status section".

  • To increase these variables, a user has to use block logic to plan their day, which teaches the user how to logically think along with planning for the future.

  • Each simulation (i.e. each time you click "Execute All") is one full level.

  • Every 2 levels, a random event occurs. These events could include the day being a rainy day, which may decrease some care variables. Some might even help you. Saving money and planning accordingly for these events are crucial to leveling!


How do you schedule?

  • Walk to a station and press Space.
  • Use Blockly blocks to create actions (you are “programming” the day).
  • Your planned actions are saved and shown in the Scheduled Actions sidebar.
  • Press "Execute All" to simulate a day and run everything you scheduled across all stations.
  • You are limited to 10 code blocks per simulation.

Stations

  • Home: this is where you play with pet, Wash pet. Contains logic editor for automation (repeat blocks, if-statement blocks).
  • Grocery Store: Buy food ($1/ea), Feed pet. Contains logic editor.
  • Vet: Heal pet ($10), Daily check-up ($2). Contains logic editor.
  • Work: Work for a set amount of hours (0-24). Every hour you work, care variables decrease by a higher value. Contains logic editor.

Features

  • Sidebar: Shows "Scheduled Actions" summarized by Blockly logic.
  • Execute All Button (Blue): Runs all logic across all stations at once.
  • Stats: Health, Hunger, Happiness, Hygiene, Money, User Level, Current food, Lives.
  • Automation: Use the Blockly editor in each station to create "Schedules".
  • Analytical Report: After every day simulation, a report shows how all your global variables changed as consequences of your actions.

How to run the game:

  • The game is web-based. Open the project in Visual Studio Code. Use a local host or the Live Server VS Code extension, and create it for the HTML file.
  • From there, you will be prompted to make an account with a name, a pet name, and a certain pet (dog, cat, or rabbit).
  • After these steps, you are all set! Make sure you read the Q&A and use the AI chatbot using the Groq API if you have any extra questions on how to play.

Built with

  • HTML
  • CSS
  • JavaScript
  • Blockly.js
  • Groq API (for the AI interactive chatbot)

Credits

  • Piskel art used for ALL pixel art https://www.piskelapp.com/
  • Blockly.js library for the logic editor
  • Source code for all blocks created using Google Blockly Developer Tool
  • Groq API for AI Interactive Q&A feature
  • Visual Studio Code
  • Github (this app!)
  • HTML Template: https://gist.github.com/MrChuffmanSnippets/2043416
  • Pixel Art to CSS: https://pixelartcss.com/ -used for the human pixel art and other art to embed as box shadow for css Used CSS button generator and other tools from bestcssbuttongenerator.com to render buttons and overlays:

https://www.bestcssbuttongenerator.com/

Official javascript documentation: https://developer.mozilla.org/en-US/docs/Web/JavaScript

Official HTML documentation: https://developer.mozilla.org/en-US/docs/Web/HTML

Official CSS documentation: https://developer.mozilla.org/en-US/docs/Web/CSS

Advice from public forums (debugged using advice from Stack Overflow)

Used for markdown parsing for AI output: https://markdown-tools.com/markdown-ai-agents

XML parsing guide https://developer.mozilla.org/en-US/docs/Web/XML/Guides/Parsing_and_serializing_XML

About

petRPG is a web-based, block-programming simulation game developed for the TJHSST FBLA 2026 Intro to Programming competition. The project earned 2nd place at the Northern Virginia FBLA Regional Conference. The game combines grid-based RPG mechanics with structured scheduling logic.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages