Commenting edits and wrldbox study

README.md

@@ -24,6 +24,10 @@ Clone the repository. Once you have navigated to the folder, you can run:
 
 - `make`
 
+## 🌳 This Branch
+
+This is the branch for the cube-based RPG.
+
 ## 🏅Credits
 
 This project was impossible without the support of all three `wholeworldcoding` members.

home/p7mj/idea.txt

@@ -0,0 +1,13 @@
+Develop a particular branch of this game into a RPG with a storyline and characters as cubes.
+
+So the storyline I can think of now is:
+
+You are a cube (pick name w/o numbers or symbols, and color)
+
+You are in school
+
+You like another cube, but the cube likes someone else
+
+they get together and u get angry, first few missions is sabotage daily life of the other cube's xxxfriend
+
+then it evolves into all out war

src/main.c

@@ -20,20 +20,20 @@ int main(void)
 
     SetTargetFPS(60);
 
-    // Now we actually start the code
-    InitWorld();
+    InitWorld(); // from world.h
 
     printf("WrldBox engine started\n");
     printf("Gravity = %.2f\n", g);
 
-    // until we close the window, expect inputs
     while (!WindowShouldClose())
     {
+
+        // Calculate delta time for consistent performace across different FPSes
         float dt = GetFrameTime();
 
         if (IsKeyPressed(KEY_P))
         {
-            // If it's simulating, stop simulating. If it isn't simulating, start simulating.
+            // Toggle simulation
             isSimulating = !isSimulating;
         }
 
@@ -45,8 +45,7 @@ int main(void)
 
         if (IsKeyPressed(KEY_Q))
         {
-            // We're gonna have to rewrite the entity logic at some point. Because an actual game doesn't just contain a bunch of blocks. But whatever for now...
-            // Q key pressed? -> Poof, box, random position, random size, random color.
+            // Test feature: spawn random cube
             SpawnEntity(
                 GetRandomValue(50, 950),
                         GetRandomValue(20, 150),
@@ -88,6 +87,7 @@ int main(void)
 
         ClearBackground(RAYWHITE);
 
+        // Ground line
         DrawLine(
             0,
             (int)ground_y,
@@ -95,6 +95,7 @@ int main(void)
                  (int)ground_y,
                  DARKGRAY);
 
+        // Ground Text
         DrawText(
             "GROUND",
             10,
@@ -102,9 +103,9 @@ int main(void)
                  20,
                  DARKGRAY);
 
-        DrawEntities();
+        DrawEntities(); // from render.c
 
-        DrawRectangle(
+        DrawRectangle(  // title box
             0,
             0,
             screenWidth,
@@ -133,6 +134,8 @@ int main(void)
                  20,
                  BLACK);
 
+
+        // if player exists, draw position and velocity
         if (player)
         {
             DrawText(
@@ -173,10 +176,10 @@ int main(void)
         DrawText("Q = Random Cube", 700, 105, 18, BLACK);
         DrawText("P = Pause | R = Reset", 700, 125, 18, BLACK);
 
-        EndDrawing();
+        EndDrawing(); // end the current draw loop
     }
 
-    // When the window wants to close, close it. What a surprise.
+    // At this point the window was closed
     CloseWindow();
     return 0;
 }