Merge pull request 'homework5' (#5) from 20220552/homework5:main into 20220552

Reviewed-on: andrea/homework5#5

PROPOSAL_123456789.md

@@ -1,3 +0,0 @@
-# My proposal
-
-I hate this homework!

PROPOSAL_20220552.md

@@ -0,0 +1,115 @@
+# My proposal
+
+- name: Chaewon Lee
+- student ID: 20220552
+- [URL](https://git.prototyping.id/20220552/homework5)
+
+## Describe the game
+
+```
+what does the user have to accomplish? How do you win or lose? What type of interactions are possible?
+```
+
+**Orb.io** is a 3D survival game inspired by `.io-style` games, particularly [Slither.io](http://slither.com/io), reinterpreted in a _three-dimensional_ visual environment.
+
+The player controls a glowing sphere moving through a dark space filled with smaller orbs. While the gameplay mechanics are based on classic snake-like systems, the game presents them using 3D rendering and spatial depth.
+
+### Objective
+
+The player's goal is to survive as long as possible while collecting glowing orbs to increase their score and grow in size.
+
+### Core Mechanics
+
+- The player moves continuously across a 3D environment (constrained to a flat plane for clarity and control).
+- Small glowing orbs are scattered throughout the space.
+- When the player collects an orb, their score increases and their body grows longer.
+- The player leaves behind a trail of body segments that follow the head, forming a snake-like structure.
+- As the player grows, navigation becomes more difficult due to increased length and space constraints.
+
+### Win / Lose Conditions
+
+- There is no fixed win condition. The game is endless, and success is measured by the player's score and survival time.
+- The player loses if:
+  - They collide with their own body
+  - They hit obstacles or boundaries in the environment
+
+### Player Interactions
+
+The player can:
+
+- Control movement using keyboard (`WASD` or `arrow keys`) or mouse input
+- Collect orbs to grow and gain points
+- Avoid collisions with their own body and obstacles
+- Restart the game after losing
+
+The gameplay loop is simple and repetitive:
+`Play` → `Collect` → `Grow` → `Avoid` → `Fail` → `Restart`
+
+The simplicity of the mechanics allows for immediate understanding, while increasing difficulty creates tension and replayability.
+
+## How will the game look like?
+
+```
+What are the game elements (e.g. characters, world, interface) and how will they be implemented in code (e.g., modules, classes, objects, functions)? Feel free to use diagrams, flow-charts or any other visual representation to show your plan.
+```
+
+The game will feature a dark 3D environment with glowing spheres as the main visual elements, creating a clean and immersive experience.
+
+<img src="environment.png" style="max-height: 300px;">
+
+### Game Elements
+
+- **Player**: glowing sphere with trailing body segments
+- **Orbs**: collectible glowing spheres
+- **Obstacles**: larger objects that cause collision
+- **World**: bounded arena on a flat plane
+- **UI**: score, best score, start and game over screens
+
+### Code Structure
+
+The game will be organized into simple modules:
+
+`main.js`  
+ ├── `GameManager`  
+ ├── `Player`  
+ ├── `Orb`  
+ ├── `Obstacle`  
+ └── `UI`
+
+- **Player**: movement, growth, collision
+- **Orb**: spawning and collection
+- **Obstacle**: collision handling
+- **GameManager**: game state, score, restart
+- **UI**: display elements
+
+### Gameplay Flow
+
+![](flow.png)
+
+### Technical Approach
+
+- Built using **Three.js** for 3D rendering
+- Movement constrained to a plane for simplicity
+- Objects managed using classes and arrays
+- Collision detection using distance checks
+
+## challenges & features
+
+### Expected Challenges
+
+- 3D rendering (camera, lighting, materials)
+- Implementing smooth body-following behavior
+- Managing performance with multiple objects
+- Balancing _visual effects_ and _performance_
+
+### Relevant Course Concepts
+
+- **Types and Variables**: used to store positions, score, and game state
+- **Arrays and Objects**: used to manage body segments, orbs, and obstacles
+- **Functions**: used to organize update, rendering, and interaction logic
+- **Modules**: used to structure the project into components such as `Player`, `Orb`, and `GameManager`
+- **Event Handling**: used to process user input (keyboard or mouse)
+
+---
+
+> This proposal was written with the assistance of ChatGPT for structuring and language support.

PROPOSAL_20254236.md

@@ -1,5 +0,0 @@
-# My proposal
-
-Haeri Kim (20254236)
-https://git.prototyping.id/20254236/homework5
-