Skip to content

BeatUp Engine v1.0

Choose a tag to compare

View all tags
@bishpop bishpop released this 07 Oct 16:13
· 9 commits to main since this release
v1.0
41143fd
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

BeatUp Engine v1.0 — Changes from v0.6.1

Detailed changelog based on the “What’s new since v0.6.1” section of the BeatUp Engine v1.0 project HTML.

Overview

BeatUp Engine v1.0 is the first stable release.

Compared with v0.6.1, v1.0 focuses on:

  • a new scoring and ranking system
  • a redesigned result screen
  • a cleaner in-game score display
  • faster and more flexible chart authoring
  • improved project/bookmark workflow
  • several bug fixes and polish improvements

Compatibility

The v1.0 release explicitly states that the following continue to work from v0.6.1:

  • existing charts
  • .bu project files
  • themes
  • Patcher content

This means the release is presented as a continuation of the existing workflow rather than a format-breaking transition.

1. Scoring & Results

1.1 New rank system: S+ to F

v1.0 introduces a new rank scale ranging from S+ down to F.

Rank calculation is based on the player's Perfect share:

  • Perfect results increase the rank.
  • Miss, Bad, and Cool results lower the rank.
  • Great results are neutral and do not lower the rank.
  • A Full Combo provides an additional bonus.

This replaces the previous result presentation with a more explicit performance grade.

1.2 Redesigned result card

The result screen has been redesigned to make the final score easier to understand.

The new result card includes:

  • a dedicated rank badge
  • a judgment breakdown
  • an explanation line showing exactly how the rank was calculated

This makes the final result more transparent instead of only presenting a final grade.

1.3 Compact in-game score bar

The gameplay HUD now uses a compact score bar.

Changes include:

  • the score bar follows the currently selected theme
  • the previous five thick lines are replaced by one distribution bar
  • the new presentation is visually smaller and cleaner during gameplay

1.4 Challenger failure always results in F

A failed Challenger Mode run is now always assigned rank F.

This is applied consistently to:

  • the result card
  • the leaderboard

2. Chart Editor

2.1 Snap switching with Alt + Left/Right

The chart editor now provides a dedicated hotkey for changing the current snap:

Alt + ← / Alt + →

The snap cycles through:

  • 1/4
  • 1/8
  • 1/16

The currently selected snap is always displayed in the menu bar, regardless of the current editor view.

This makes snap changes faster during charting without requiring the user to interact with the interface directly.

2.2 Optional Numpad Charting

v1.0 adds an optional Numpad Charting input mode.

When enabled, notes can be placed using the same numpad-oriented layout used for gameplay:

Input Action
Num 7 Note
Num 4 Note
Num 1 Note
Num 9 Note
Num 6 Note
Num 3 Note
Num 0 / Num 5 Space
Num + Finish

The purpose is to make chart authoring faster by allowing mappers to place notes using a gameplay-oriented key layout.

2.3 Project-aware bookmarks

v1.0 adds chart bookmarks through:

Ctrl + B

A bookmark can contain custom text and is displayed in the chart as a clickable label.

Most importantly, bookmarks are saved inside the .bu project itself.

That means bookmarks:

  • persist between editing sessions
  • travel with the project
  • are part of the saved charting workflow rather than temporary editor annotations

2.4 Duplicate-note warnings

The editor now provides a clearer visual warning when duplicate notes are present.

Duplicate notes are marked with:

  • a bold red band
  • a warning sign next to the beat

This makes accidental duplicate placements easier to spot while charting.

3. Improvements & Fixes

3.1 Saving no longer places an accidental Space note

The Ctrl + Shift + S save shortcut has been fixed.

Previously, using the save shortcut could also place a Space note.

In v1.0:

  • Ctrl + Shift + S saves the project
  • saving no longer inserts an unintended Space note

3.2 Settings now persist in protected install locations

Settings are now retained even when BeatUp Engine is installed in a protected Windows directory such as:

Program Files

This fixes cases where application settings could previously fail to persist because of folder permissions.

3.3 Responsive chart playback bar

The playback bar in chart view has been improved.

It now:

  • adapts to the current window size
  • avoids overlapping other controls
  • remains usable across different window dimensions

3.4 Patcher offsets are fully active

Per-song timing offsets are now fully active in the Patcher.

The v1.0 behavior also keeps the time display correct when no song is loaded.

This builds on the per-song Patcher offset support already introduced in v0.6.1 and makes that functionality behave consistently.

3.5 Auto-Play score/combo recalculation

Score and combo are now recalculated correctly when jumping through the chart using Auto-Play.

The release also removes the previous issue where jumping through the chart could produce a burst of Perfect sounds.

3.6 Editor playback speed is isolated from the Patcher

Playback speed changes made in the Editor no longer carry over to the Patcher.

In addition, color changes are preserved after restarting the application.

This prevents editor-specific state from unexpectedly affecting the Patcher and improves persistence of visual settings.

3.7 App and documentation polish

The v1.0 release also updates the surrounding product experience:

  • a new application icon
  • website links in the main menu
  • GitHub links in the main menu
  • an updated user manual

4. Release Summary

New in v1.0

Area Change
Ranking New S+ → F rank system
Ranking Perfect-based rank calculation
Ranking Full Combo bonus
Results Redesigned result card
Gameplay HUD Compact, theme-aware score bar
Challenger Failed runs always receive F
Chart Editor Alt + ←/→ snap switching
Chart Editor Optional Numpad Charting
Chart Editor Ctrl + B text bookmarks
Chart Editor Bookmarks saved in .bu projects
Chart Editor Duplicate-note warnings
Saving Fixed accidental Space-note placement on save
Settings Persistent settings in protected folders
Chart Editor UI Responsive playback bar
Patcher Fully active per-song offsets and correct time display
Auto-Play Correct score/combo recalculation
Audio Removed burst of Perfect sounds while jumping
Playback Editor speed no longer affects the Patcher
Persistence Color changes survive restart
Project polish New app icon, website/GitHub links, updated manual

5. Migration / Upgrade Notes

For users upgrading from v0.6.1, the HTML does not describe a breaking migration step.

The documented compatibility statement is:

  • charts continue to work
  • .bu projects continue to work
  • themes continue to work
  • Patcher content continues to work

The main user-facing changes are therefore in scoring, result presentation, charting controls, editor feedback, and bug fixes/polish, rather than file-format migration.

6. Version Context

v1.0

First stable release

Key additions explicitly listed in the version history:

  • new ranks and result card
  • compact score bar
  • snap hotkeys
  • Numpad Charting
  • bookmarks stored in projects

v0.6.1

Released 24 Sep 2026.

The version history describes v0.6.1 as introducing:

  • Receptor Bar in the Editor
  • receptor theming
  • per-song Patcher offsets

v1.0 therefore builds on that foundation while adding the scoring, charting, and polish changes documented above.

7. Quick Reference — New Controls

Shortcut New / relevant v1.0 behavior
Alt + ←/→ Cycle snap: 1/4 → 1/8 → 1/16
Ctrl + B Create a text bookmark
Num 7 4 1 9 6 3 Place chart notes in Numpad Charting mode
Num 0 / 5 Place Space notes in Numpad Charting mode
Num + Place Finish notes in Numpad Charting mode
Ctrl + Shift + S Save .bu without placing an unintended Space note

Source

This changelog is derived directly from the BeatUp Engine v1.0 HTML release section, including the “What’s new since v0.6.1” and Version History sections.

Reference release:
https://github.com/bishpop/beatupengine/releases/tag/v1.0

Assets 2
Loading