Only4BMS

7 keys? No thanks. 

This is a Pygame-based BMS driver that **forcefully rearranges** all BMS charts into **4 keys (DFJK)** for playback.

⚠️ Important: Music Data Not Included "Only4BMS is a BMS Player engine, not a standalone rhythm game with built-in songs. To play, you must manually provide your own BMS data. Please place your song folders into the bms directory within the game folder before launching.

Project Overview

Only4BMS was created for 4-key purists who face complex BMS charts like 7-key or 14-key and think, “How am I supposed to play all this?”

This project uses Pygame to parse BMS files and provides an environment where you can enjoy any chart format **remapped into 4 lanes** along with key sounds.

Key Features

Forced 4-Key Mapping: Automatically assigns 5-key, 7-key, 10-key, and 14-key charts to 4 lanes (D, F, J, K) using mathematical algorithms.

Density Checker: Checks and visualizes note density when 7-key charts are consolidated into 4-key

Transparency Statement:

Only4BMS is a passionate solo project.

To streamline the production process, I’ve incorporated AI-assisted technology for code.

This allowed me to push the boundaries of what a single person can create, ensuring that the final game feels polished and complete.

minwook-shin/Only4BMS: Because 7 keys are too many for my 4 fingers. Pygame-based BMS player that remaps everything to 4 lanes

v1.3.0 Change Log

Main Updates:

• Visualized the PPO perception range with a robotic "Scanner Area" (including glowing eyes and "AI Vision" text).
• Differentiated hit effects for Bar/Circle notes, refined note dimensions, and perfected vertical alignment.
• Halved judgment line thickness and adjusted its position for a sharper, more reactive feel.
• Implemented settings persistence and improved settings menu navigation.

v1.2.0 Change Log

🚀 New Features & Improvements

• Full support for long note patterns and dynamic BPM gimmicks.
• Added support for .bml and .pms file formats.
• Improved end-timing logic to wait for audio completion.
• Added long-note combo ticks and UI bounce animations.

v1.1.0 Change Log 

Major Updates 

New AI Battle Mode: You can now challenge the AI in two different difficulty levels: Normal and Hard. 

Improvements & Bug Fixes Enhanced Judgment System:

Human-like AI Behavior: Refined AI logic to occasionally make human-like mistakes, making the battle feel more natural and less like playing against a perfect machine.