> For the complete documentation index, see [llms.txt](https://wiki.rhythm-plus.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.rhythm-plus.com/development/rhythm-plus-v2.md).

# Rhythm Plus V2

### 🎉 Welcome to Rhythm Plus V2.0.0!

After 3 years of intensive development and 2000+ commits, we're excited to finally share the biggest update in Rhythm Plus history! This isn't just an update - it's a complete transformation of the game with groundbreaking new features, performance improvements, and an entirely redesigned experience.

***

### 🚀 **Major New Features**

#### 🎵 **Advanced Chart Editor**

* **Complete beatmap editor** with professional-grade tools
* **Timing system** with BPM changes and scroll velocity points
* **Visual grid system** with beat snapping and alignment tools
* **Note manipulation** - drag, select, copy, delete, and transform notes
* **Osu!mania import** - Direct import of .osu beatmap files
* **Real-time preview** and test mode for instant feedback
* **Undo/redo system** with comprehensive history tracking for all operations including timing changes
* **Advanced timing tools** including metronome and BPM estimation
* **Version control** for maps with save/load functionality
* **Context menu** - Right-click support for quick access to common operations
* **Shortcuts panel** - Visual display of all available keyboard shortcuts
* **Scroll wheel speed control** - Customizable seek speed for precise timeline navigation
* **BGA position toggle** - Keyboard shortcut for background video positioning
* **Auto-mod** - Enhanced violation detection with automatic snapping and fixing
* **Uniform spacing** - Better visual spacing for scroll velocity and BPM markers

#### 🎮 **Enhanced Gameplay Experience**

* **Multiple rendering engines**: PixiJS v8, Canvas 2D, and Babylon.js 3D
* **New game modifiers**:
  * Auto Play with perfect accuracy simulation
  * No Fail mode for practice
  * Cascade notes for visual effects
  * Fade In/Out effects
  * Speed adjustment options
* **Advanced visual effects**:
  * Particle systems and hit effects
  * Fever mode with special animations
  * 3D perspective mode with depth
  * Customizable visual filters and shaders
* **Improved audio system** with better synchronization
* **Recording and replay system** for sharing gameplay

#### 🎨 **Complete Visual Overhaul**

* **Modern UI redesign** with smooth animations and transitions
* **Advanced theming system** with multiple game skins
* **Customizable key mapping** with visual indicators
* **Responsive design** optimized for all screen sizes
* **New visual effects**: confetti, zoom text, glow filters
* **Background video support** with position controls
* **Improved loading screens** with better user feedback

#### 👥 **Community & Social Features**

* **User profiles** with statistics and achievements
* **Username/handle system** - Unique usernames with validation and profile URLs
* **Result sharing** with detailed performance metrics
* **Friends system** with social interactions
* **Public beatmap sharing** and discovery
* **Rating system** for community feedback
* **User-generated content** tools and management
* **Comment system** - Full-featured commenting on beatmaps, songs, and more
* **Bug reporting** - Built-in bug report system accessible from user controls

***

### 🎯 **Gameplay Improvements**

#### 🎹 **Enhanced Controls**

* **Customizable key bindings** with multiple profiles
* **System hotkeys** - Fully configurable keyboard shortcuts for all game functions
* **Touch controls** optimized for mobile devices
* **Controller support** including DualShock vibration
* **Improved input handling** with better precision
* **Visual feedback** for key presses and timing
* **Key indicator** - Optional on-screen keyboard display

#### 🔧 **Quality of Life Features**

* **Audio offset calibration** - Fine-tune audio timing to match your device
* **Performance mode** - Automatic device detection and optimization
* **Break detection** - Osu-style break system
* **Loading troubleshoot** - Smart error handling
  * Alternative audio source detection
  * Automatic source suggestions
  * Related song recommendations
  * YouTube synchronization options
  * Change source functionality with drawer interface

#### 📊 **Advanced Scoring System**

* **Detailed performance metrics** and statistics
* **Score calculation** improvements
* **Combo system** with visual effects
* **Accuracy tracking** with timing windows
* **Performance charts** and progress visualization
* **Hold note improvements** - Enhanced judgment system with better miss detection and conflict handling
* **Result list enhancements** - Better replay and result viewing on user profiles

#### 🎪 **Visual Enhancements**

* **Multiple game skins** with customizable themes
* **Advanced hit effects** and animations
* **Particle systems** for enhanced visual feedback
* **Smooth transitions** and micro-animations
* **Customizable UI elements** and layouts
* **Upscroll support** - Play with notes scrolling upward
* **Popularity system** - Fire icons indicating map popularity with tooltips
* **Replay skin support** - Use replay skin when viewing replays
* **Mobile optimizations** - Enhanced mobile responsiveness and touch interactions
* **Image fallback handling** - Automatic fallback to YouTube thumbnails for playlists and songs

#### 🔍 **Search & Discovery Improvements**

* **Relevance sorting** - Smarter search algorithm that finds what you're looking for
* **Encoded search terms** - Better URL handling for special characters
* **Artist search** - Click artist names to search for more songs
* **Top songs API** - Featured and popular songs on homepage
* **Advanced filtering** - Enhanced song and playlist filtering options

#### 📁 **Playlist Enhancements**

* **Playlist images** - Visual thumbnails for playlists
* **Sort by date added** - Organize songs by when they were added
* **Random offset** - Add variety to playlist displays
* **User playlists on profile** - View user's created playlists
* **Improved layout** - Better grid layout with mobile support
* **Anonymous playlist handling** - Better support for guest users

***

### 🔧 **Technical Improvements**

#### ⚡ **Performance Enhancements**

* **Optimized rendering** with multiple engine options
* **Memory management** improvements
* **Reduced bundle size** and faster loading
* **Better frame rate stability** with FPS monitoring and performance-based quality adjustments
* **Advanced caching** strategies for assets and data
* **Automatic performance mode** - Device detection and optimization

#### 🛠 **Developer Experience**

* **Modern tech stack**: Nuxt 3, Vue 3, TypeScript
* **Advanced build system** with optimizations
* **Analytics integration** for performance monitoring
* **Service worker** for offline capabilities
* **PWA support** for app-like experience

#### 🔒 **Security & Stability**

* **Enhanced authentication** with multiple providers
* **Improved error handling** and user feedback
* **Better state management** with Pinia
* **Comprehensive testing** and validation
* **Firebase integration** for reliable backend services
* **Input validation** - Username validation and sanitization

***

### 🌐 **Platform & Compatibility**

#### 📱 **Mobile Support (WIP)**

* **Responsive design** for all screen sizes
* **Touch-optimized controls** and interactions
* **Mobile-specific UI adaptations**
* **Performance optimizations** for mobile devices
* **iOS and Android compatibility** improvements

#### 🌍 **Internationalization (WIP)**

* **Multi-language support** with i18n integration
* **Localized content** and UI elements
* **Regional optimizations** and content delivery
* **Community translation** support

***

### 🔄 **Migration & Compatibility**

#### 📁 **Data Migration**

* **Automatic user data migration** from v1
* **Preserved user progress** and achievements
* **Backward compatibility** for existing content
* **Import tools** for legacy formats

#### 🔗 **API Updates**

* **Modern API design** with TypeScript support
* **Enhanced query system** with better caching
* **Real-time features** with improved synchronization
* **Developer-friendly** endpoints and documentation

***

### 🐛 **Bug Fixes & Stability**

#### 🔧 **Critical Fixes**

* **Audio synchronization** improvements
  * Better audio duration calculation
  * Fixed audio flash on game end
  * Improved audio timing break detection
  * Enhanced YouTube player behavior during breaks
* **Memory leak** prevention
* **Performance bottlenecks** resolved
  * Optimized cascade modifier conflict detection from O(n²) to O(n×k)
  * Improved note visibility threshold calculation for high speeds
* **Cross-browser compatibility** enhanced
* **Touch interaction** bugs fixed
* **Editor fixes**
  * Fixed editor time synchronization issues
  * Resolved note start timing in middle of songs
  * Fixed hold note clipping in editor
  * Fixed judge line Y position not resetting when switching themes
  * Improved grid and marker positioning
* **Game logic fixes**
  * Fixed hold note inside cascade rendering
  * Prevented multiple score uploads
  * Improved game end handling
  * Fixed break detection and visibility logic
  * Better note map parsing
  * Fixed cascade logic issues
* **UI/UX fixes**
  * Fixed button sizes and styling
  * Improved drawer animation transitions
  * Fixed route parameter handling after navigation
  * Resolved BGM conflict issues
  * Fixed number input validation
  * Enhanced form behavior with better auto-focus and error handling
  * Fixed tag deletion issues
  * Improved anonymous user playlist and username overflow handling

#### 🛡️ **Security Updates**

* **Dependency updates** for security patches
* **Input validation** improvements
* **XSS protection** enhancements
* **Authentication security** strengthened

***

### 🚀 **What's Next**

This is just the beginning! We're already working on:

* **Arena mode** for competitive play
* **Campaign mode** with story progression
* **Multiplayer features** for real-time battles
* **Advanced editor features** and tools
* **Community marketplace** for content sharing

***

### 🎮 **Getting Started**

* **Visit** [**v2.rhythm-plus.com**](https://v2.rhythm-plus.com/) to start playing
* **Join our** [**Discord**](https://discord.com/invite/ZGhnKp4) for community support

***

*This changelog represents over 2000+ commits and countless hours of development. Thank you to everyone who contributed to making Rhythm Plus v2.0.0 a reality!*

**Happy playing! 🎵✨**