Mini Putt - Classic Mini Golf Game

Seele01-Flash
By
Mini Putt is the beloved classic mini golf game that defined an era of online gaming. Master precision putting across challenging courses with realistic physics and compete for the perfect score.

Prompt

MODEL: Seele01-Flash
Please use Three.js to generate a **mobile-first game** with the theme "Mini Putt". Please read the following detailed game design requirements first, and then generate the code accordingly: ### 1. Assets & Environment * **Visual Style**: Recreate the classic "Flash Game" aesthetic using Three.js but with a 2.5D approach. Use an **Orthographic Camera** fixed in a top-down view to mimic the original 2D perspective while allowing for subtle 3D depth on the walls and ball. * **Course Design**: Generate a modular mini-golf course. * **Floor**: Bright green plane (`MeshBasicMaterial` or `MeshLambertMaterial`) with a subtle noise texture to simulate grass. * **Walls**: Wooden-colored rectangular borders that enclose the course to prevent the ball from falling out. * **Obstacles**: Darker green patches (rough grass) that increase friction, and geometric blocks (cubes) acting as barriers. * **The Ball**: A simple low-poly white sphere. * **The Hole**: A cylindrical depression or a black circle on the floor mesh. * **Visual Aids**: Implement a **trajectory guide** consisting of yellow dots (sprites or small spheres) that extend from the ball opposite to the drag direction, indicating power and aim. * **Mobile Optimization**: Use simple geometries (BoxGeometry, CylinderGeometry) to keep the polygon count extremely low. Use shared materials to reduce draw calls. Lighting should be simple (e.g., a single DirectionalLight + AmbientLight) to ensure high FPS on mobile devices. ### 2. Audio Requirements * **BGM**: A loop of relaxing, retro-style "elevator music" or light Bossa Nova (MIDI style) to capture the 2005 Flash game vibe. * **Sound Effects (SFX)**: * **Putting**: A distinct "thwack" sound when the club (or impulse) hits the ball. * **Rolling**: A subtle rolling loop that changes volume based on ball speed. * **Collision**: A wooden "tock" sound when hitting walls. * **Hole-in**: A satisfying "rattle-and-plop" sound when the ball enters the cup. * **UI**: Generic clicks for menus. ### 3. Gameplay Loop * **Phase 1: Placement**: At the start of a level, the user can tap within a designated "Tee Area" (a semi-transparent box) to place their ball. * **Phase 2: Putting**: The player aims and shoots (see Controls). * **Physics Engine**: Use a simple physics implementation (e.g., Cannon.js or a custom simple Verlet integration). * **Friction**: The ball must decelerate naturally on the grass. Darker grass patches should apply 2x friction. * **Restitution**: Walls should have moderate bounciness. * **Scoring**: * Track the number of strokes (shots taken). * Compare strokes against a "Par" value (e.g., Par 3). * Display "Birdie," "Par," or "Bogey" upon completing the hole. * **Win Condition**: The ball's center must be within the hole's radius, and velocity must be below a certain threshold (to prevent the ball from skimming over the hole). ### 4. Mobile Controls & Interaction * **Screen Orientation**: **Landscape Mode** is preferred to view the layout of the hole, but the camera should zoom/pan if the course is long. * **Touch Controls (Slingshot Mechanic)**: * **Touch Start**: Touching anywhere on the screen (or specifically near the ball) initiates aiming. * **Touch Drag**: Dragging the finger *away* from the target pulls back the "power meter." The yellow dotted line grows in the opposite direction of the drag. * **Touch End**: Releasing the finger applies an impulse force to the ball in the direction of the aim line. * **Haptic Feedback**: Trigger a short vibration (using `navigator.vibrate`) when the ball hits a wall or sinks into the hole for tactile immersion. * **UI/UX**: * Scorecard display in the corner (large text, easily readable). * A "Restart Hole" button (minimum 44x44px touch area) in the top right. * Prevent touch scrolling/zooming on the canvas (`touch-action: none`) to ensure the drag gestures work smoothly. Do not ask for clarification. Do not request confirmation. Directly execute the generation task based on the given instructions.

Game Introduction

About Mini Putt

Mini Putt is the iconic mini golf game that captured the hearts of millions during the golden age of browser gaming. This timeless classic combines simple controls with challenging physics-based gameplay, making it accessible to beginners while offering depth for serious golf enthusiasts. The game features clean 2D graphics, intuitive mouse controls, and progressively challenging courses that test your precision and strategy.

Core Features

Classic Mini Golf Experience

Mini Putt delivers an authentic mini golf experience with realistic ball physics and carefully designed courses. Each hole presents unique challenges, from simple straight shots to complex multi-bounce scenarios that require careful planning and precise execution.

Physics-Based Gameplay

The game's physics engine creates realistic ball movement, accounting for momentum, surface friction, and obstacle interactions. Players must master the relationship between shot power and ball trajectory to achieve optimal scores.

Progressive Difficulty

Courses are designed with increasing complexity, starting with straightforward holes and advancing to intricate layouts featuring multiple obstacles, tight corners, and strategic challenges that demand skillful shot placement.

Score Competition System

Track your performance across all courses and compare final scores with friends. The game encourages competitive play by maintaining clear scoring records and promoting friendly competition among players.

Cross-Platform Compatibility

Originally a Flash game, Mini Putt has been updated to HTML5, ensuring compatibility with modern browsers on both desktop and mobile devices without requiring additional downloads or plugins.

Game Mechanics

Shot Placement and Aiming

Begin each hole by positioning your ball at the optimal starting location. Use the yellow trajectory line to aim your shot, considering obstacles, walls, and the hole's position to plan the most effective path.

Power Control System

Adjust shot power by extending or shortening the aiming line. Longer lines generate more powerful shots, while shorter lines provide gentle, controlled putts. Mastering power control is essential for navigating tight spaces and avoiding overshooting.

Course Navigation

Each course presents unique layouts with various obstacles, including walls, barriers, and strategic pathways. Success requires understanding how the ball will interact with different surfaces and planning multi-shot strategies for complex holes.

Controls and Interface

Simple Mouse Controls

The game uses intuitive mouse-only controls. Click and drag to position your ball, aim using the yellow guide line, and click to execute your shot. The streamlined control scheme ensures players can focus on strategy rather than complex input combinations.

Visual Feedback System

Clear visual indicators help players understand shot power, trajectory, and course layout. The yellow aiming line provides immediate feedback on shot direction and approximate power level.

Why Play Mini Putt

Timeless Appeal

Mini Putt represents the golden age of browser gaming, offering pure gameplay without unnecessary complications. Its enduring popularity stems from perfectly balanced difficulty and rewarding skill progression.

Skill Development

The game develops spatial reasoning, precision control, and strategic thinking. Players naturally improve their ability to judge angles, power, and physics interactions through repeated play.

Social Competition

Compare scores with friends and family to determine the ultimate Mini Putt champion. The competitive element adds replay value and encourages skill improvement.

Accessibility

Free to play, requires no downloads, and works on virtually any device with a web browser. This accessibility has made Mini Putt a favorite for casual gaming sessions across different platforms and age groups.

Perfect for Quick Sessions

Each course can be completed in just a few minutes, making Mini Putt ideal for short breaks, casual entertainment, or competitive challenges with friends and colleagues.

Frequently Asked Questions (FAQ)