Implement Snake game for JLine3 terminal #1385
Draft
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This commit implements a classic Snake game as requested in issue #1317. The implementation provides a fully interactive terminal-based game using JLine3's Display class for fullscreen rendering. Features: - Classic Snake gameplay with growing snake and food collection - Score tracking and collision detection (walls and self) - Pause/resume functionality with P/Space keys - Arrow keys and WASD controls for movement - Responsive terminal UI with colored borders and status display - Proper signal handling for window resize and interrupts Technical implementation: - Single class design in builtins subproject (Snake.java) - Uses Display class for efficient fullscreen updates - BindingReader and KeyMap for advanced keyboard input handling - AttributedString for colored output and visual styling - Integrated as 'snake' command in Commands.java - Includes demo script (snake-demo.jline) for interactive introduction The game serves as both entertainment and a demonstration of JLine3's advanced terminal UI capabilities, showcasing fullscreen applications, real-time input handling, and efficient display updates. Fixes #1317
…tions - Wire Snake demo to build script and add SnakeDemo main class - Add options menu (m) with color mode, walls mode, difficulty, wrap-around - Add rainbow tail coloring and sparkle effect on eating - Add walls (border/random/none) and wrap-around toggle - Keep defaults compatible; formatting via Spotless; full build passes
…animation with bell, and persistent high score.\n\n- Visuals: head glow halo and crash ripple animation\n- UX: help overlay toggle (h), reset (r) without exiting, footer/help updates\n- Audio: terminal bell on eat and crash\n- Persistence: store/load high score with Preferences and display it (highlight when new)\n- Commands help text updated
…eption.\n\n- Game over: prompt [Y/n] (R=Reset, Q=Quit) and loop when accepted\n- Timing: reduce delay ~33% when moving horizontally to compensate cell geometry\n- Keep previous improvements (help overlay, reset, bell, high score)
This commit significantly enhances the Snake game with exciting new features: New Power-Up System: - Speed Boost (⚡): Doubles snake movement speed for 5 seconds - Double Points (💎): Doubles food scoring for 10 seconds - Shrink Snake (🔸): Removes 2 segments from snake tail - Invincible Shield (🛡): Prevents collision damage for 5 seconds Power-Up Mechanics: - Random spawning every 10 seconds with 5% probability - Visual indicators on game board with unique symbols - Active effects displayed in header status bar - Collision detection and automatic activation - Limited to 2 active power-ups on board simultaneously Enhanced Difficulty: - Added EXTREME difficulty mode (50ms delay) - Speed boost power-up provides dynamic gameplay acceleration - Improved speed calculation for horizontal vs vertical movement Achievement System: - Track total power-ups collected across games - Monitor maximum snake length achieved - Speed Demon achievement for reaching length 20 on EXTREME mode - Foundation for future achievement expansions Visual Improvements: - Power-up symbols rendered on game board - Real-time status indicators in header - Enhanced collision detection with invincibility effects - Improved game state management and reset functionality Technical Enhancements: - Robust power-up lifecycle management - Thread-safe power-up state tracking - Optimized rendering with power-up overlays - Clean separation of power-up logic from core game mechanics This update transforms the Snake game into a more engaging and dynamic experience while maintaining the classic gameplay that players love.
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Overview
This PR implements a classic Snake game for JLine3 as requested in issue #1317. The game demonstrates JLine3's advanced terminal UI capabilities using the Display class for fullscreen rendering. It is available directly as a demo:
./build demo snake.Features
Game Features
Controls
Visual Design and Effects
Options Menu (press 'm')
Technical Implementation
Architecture
org.jline.builtins.SnakeCommands.snake(...)org.jline.demo.SnakeDemowired to./build demo snakeDisplayBindingReaderandKeyMapFiles Added/Modified
snakeUsage
./build demo snakenew Snake(terminal).run()Testing and Build
This game both entertains and showcases JLine3 for fullscreen TUI apps, real-time input, and efficient rendering.
Fixes #1317