Skip to content

misterlihao/ChroMapper-MappingAssistant

BranchesTags

Repository files navigation

ChroMapper - Mapping Assistant

Language / 語言 / 言語: English | 繁體中文 | 日本語

demo gif

English

A mapping assistant plugin for ChroMapper that helps creators make Beat Saber maps more efficiently with consistent and systematic performance.

Features

  • Style Parameter Recording: Adjust multiple characteristic dimensions of your map through intuitive sliders, using experimentally optimized scale divisions
  • Style Parameter Display: Automatically displays current parameters as you play or navigate through the map, providing convenient reference while mapping
  • Customizable Interface: Customize slider labels by modifying the configuration file in the ChroMapper data folder

System Requirements

  • ChroMapper: v0.13.892
  • Operating System: Windows
  • Map Version: v2/v3 (v4 does not support any customData, requires separate data management, not yet implemented)

Installation

  1. Download the latest plugin file (*.dll)
  2. Copy ChroMapper-MappingAssistant.dll to the Plugins folder in your ChroMapper installation directory
    • Default path is usually: <ChroMapper Installation Directory>\Plugins\
  3. Launch ChroMapper, and the plugin will load automatically

Usage

Opening the Interface

  1. In the ChroMapper editor, click the Mapping Assistant icon button in the right toolbar
  2. The assistant panel will open, displaying various data for the current map. Hold Shift to drag the panel

alt text

Adjusting Map Style

Use the six sliders in the panel to adjust different parameters of your map:

  • Move sliders left to enhance left-side characteristics (such as Power, Stretch, etc.)
  • Move sliders right to enhance right-side characteristics (such as Soft, Compress, etc.)
  • After adjustment, map parameters will be recorded at the current beat position and saved with the map file

Sliders have nine levels, conceptually representing (using power as an example): Extreme power, Super power, Normal power, Slight power, Neutral, Slight soft, Normal soft, Super soft, Extreme soft. You can also simply choose adjustments based on your intuition as a mapper.

When finally creating the map, you can configure blocks according to the predetermined parameters, helping mappers maintain the correct direction and reducing the amount of information to process at once.

These six parameters are a recommended map analysis method. Mappers using this plugin can replace them with any parameters they prefer

Current Parameter Source

The button in the top-left corner displays a number representing the beat position where the current parameter is set. Clicking the button jumps back to that beat, allowing you to modify the same data again.

If there is already data at the current position, this button will display "X". Clicking it will delete that data.

Copy and Paste

The button in the top-right corner displays copy/paste. If there is recorded data at the current beat position, clicking the button executes copy; otherwise it executes paste.

  1. Click the "copy" button in the top-right corner to prepare copying to another beat position
  2. Move to another beat
  3. Click the "paste" button to apply the previously copied settings

Configuration File

Plugin settings are stored at:

%USERPROFILE%\AppData\LocalLow\BinaryElement\ChroMapper\ChroMapper-MappingAssistant.json

Custom Labels

You can customize slider label text by editing the configuration file. Example configuration files are located in the settings_example/ folder:

  • ChroMapper-MappingAssistant.zh.json - Chinese label example
  • ChroMapper-MappingAssistant.jp.json - Japanese label example

Copy the example file to the configuration file location mentioned above and modify the label content as needed.

Usage Example

If you need an example, you can open map ID 4e3ed in ChroMapper and play the map to observe how these parameters are configured.

Development Information

Building the Project

  1. Ensure Visual Studio 2022 or newer is installed
  2. Create ChroMapper-MappingAssistant.csproj.user (in the same folder as ChroMapper-MappingAssistant.csproj) and set the ChroMapper installation location
  3. Open ChroMapper-MappingAssistant.sln
  4. Build the project (Debug mode automatically copies the DLL to the Plugins folder)

ChroMapper-MappingAssistant.csproj.user:

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="Current" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <ChroMapperDir>YOUR_CHROMAPPER_LOCATION</ChroMapperDir>
    <ReferencePath>$(ChroMapperDir)\ChroMapper_Data\Managed;$(ChroMapperDir)\Plugins</ReferencePath>
    <ProjectView>ShowAllFiles</ProjectView>
  </PropertyGroup>
</Project>

Acknowledgments

Note: This plugin is a third-party tool, not officially developed by ChroMapper or Beat Games. Use at your own risk and remember to back up your map data regularly.

繁體中文

一個用於 ChroMapper 的製譜輔助插件，幫助創作者更有效率地製作 Beat Saber 譜面，並讓表現更一致、更系統化。

功能說明

  • 風格參數紀錄：透過直觀的滑桿調整譜面的多個特性維度，以實驗得出的最佳刻度切分方式進行操作
  • 風格參數顯示: 隨著播放或是譜面跳轉自動顯示目前參數，方便製作譜面時參考
  • 可自訂介面：透過修改 chromapper 資料夾的設定檔案可以自定義滑桿文字

系統需求

  • ChroMapper：v0.13.892
  • 作業系統：Windows
  • map 版本: v2/v3 (v4 不支援任何 customData，需要另外管理資料，暫未實作)

安裝方式

  1. 下載最新版本的插件檔案（*.dll）
  2. 將 ChroMapper-MappingAssistant.dll 複製到 ChroMapper 安裝目錄下的 Plugins 資料夾
    • 預設路徑通常為：<ChroMapper安裝目錄>\Plugins\
  3. 啟動 ChroMapper，插件將自動載入

使用方法

開啟介面

  1. 在 ChroMapper 編輯器中，點擊右側工具列的 Mapping Assistant 圖示按鈕
  2. 將開啟輔助面板，顯示當前譜面的各項數據。按住 shift 可以拖動面板

alt text

調整譜面風格

使用面板中的六個滑桿來調整譜面的不同參數：

  • 向左移動滑桿以增強左側特性（如 Power、Stretch 等）
  • 向右移動滑桿以增強右側特性（如 Soft、Compress 等）
  • 調整後將在當前 beat 位置紀錄譜面參數，保存譜面同時記錄於譜面檔案中

滑桿分為九級，設想中的意義為 (以 power 為例) 極限 power、超級 power、普通 power、稍微 power、中性、稍微 soft、普通 soft、超級 soft、極限 soft。也可以單純的根據 mapper 的直覺選擇如何調整。

最終製作譜面的時候便可以根據原本決定好的參數來配置方塊，幫助 mapper 保持正確方向，也減少一次要處理的資訊。

此六項參數是推薦的譜面分析方式，使用此 plugin 的 mapper 可以更換成自己喜歡的任意參數來使用

目前參數的來源

左上角的按鈕會顯示數字，代表目前參數設定的位置 (以 beat 數值表示)。點擊按鈕會跳回該 beat，可以再次修改同一份資料。

如果目前位置已經有一份資料，此按鈕會顯示 "X"，此時點擊按鈕會刪除該資料。

複製與貼上

右上角的按鈕會顯示 copy / paste。如果目前 beat 位置有紀錄資料，點下按鈕會執行 copy，否則會執行 paste。

  1. 點擊右上角的「copy」按鈕以準備複製到別的 beat 位置
  2. 移動到其他 beat
  3. 點擊「paste」按鈕以應用之前複製的設定

設定檔

插件的設定儲存在以下位置：

%USERPROFILE%\AppData\LocalLow\BinaryElement\ChroMapper\ChroMapper-MappingAssistant.json

自訂標籤

您可以透過編輯設定檔來自訂滑桿的標籤文字。範例設定檔位於 settings_example/ 資料夾：

  • ChroMapper-MappingAssistant.zh.json - 中文標籤範例
  • ChroMapper-MappingAssistant.jp.json - 日文標籤範例

將範例檔案複製到上述設定檔位置，並根據需要修改標籤內容。

使用範例

如果需要使用的範例，可以使用 chromapper 打開譜面編號 4e3ed 並播放譜面，觀察裡面如何設置這些參數。

開發資訊

建置專案

  1. 確保已安裝 Visual Studio 2022 或更新版本
  2. 建立 ChroMapper-MappingAssistant.csproj.user (位於 ChroMapper-MappingAssistant.csproj 同資料夾內)，並設定 chromapper 的安裝位置
  3. 開啟 ChroMapper-MappingAssistant.sln
  4. 建置專案（Debug 模式會自動複製 DLL 到 Plugins 資料夾）

ChroMapper-MappingAssistant.csproj.user:

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="Current" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <ChroMapperDir>YOUR_CHROMAPPER_LOCATION</ChroMapperDir>
    <ReferencePath>$(ChroMapperDir)\ChroMapper_Data\Managed;$(ChroMapperDir)\Plugins</ReferencePath>
    <ProjectView>ShowAllFiles</ProjectView>
  </PropertyGroup>
</Project>

致謝

注意：本插件為第三方工具，非 ChroMapper 或 Beat Games 官方開發。使用時請自行承擔風險，勤加備份譜面資料。

日本語

ChroMapper用のマッピングアシスタントプラグインで、Beat Saberの譜面をより効率的に作成し、一貫性のある体系的なパフォーマンスを実現します。

機能説明

  • スタイルパラメータ記録：直感的なスライダーで譜面の複数の特性次元を調整し、実験的に最適化されたスケール分割を使用して操作
  • スタイルパラメータ表示: 再生中または譜面のナビゲーション時に現在のパラメータを自動表示し、マッピング時の参照を便利に
  • カスタマイズ可能なインターフェース：ChroMapperデータフォルダの設定ファイルを編集してスライダーラベルをカスタマイズ可能

システム要件

  • ChroMapper: v0.13.892
  • オペレーティングシステム: Windows
  • 譜面バージョン: v2/v3 (v4はcustomDataをサポートしていないため、別途データ管理が必要で、未実装)

インストール

  1. 最新のプラグインファイル（*.dll）をダウンロード
  2. ChroMapper-MappingAssistant.dllをChroMapperインストールディレクトリのPluginsフォルダにコピー
    • デフォルトパスは通常：<ChroMapperインストールディレクトリ>\Plugins\
  3. ChroMapperを起動すると、プラグインが自動的に読み込まれます

使用方法

インターフェースを開く

  1. ChroMapperエディタで、右側のツールバーにあるMapping Assistantアイコンボタンをクリック
  2. アシスタントパネルが開き、現在の譜面の各種データが表示されます。Shiftキーを押しながらパネルをドラッグ可能

alt text

譜面スタイルの調整

パネル内の6つのスライダーを使用して、譜面のさまざまなパラメータを調整します：

  • スライダーを左に動かして左側の特性（Power、Stretchなど）を強化
  • スライダーを右に動かして右側の特性（Soft、Compressなど）を強化
  • 調整後、現在のビート位置で譜面パラメータが記録され、譜面ファイルと共に保存されます

スライダーには9つのレベルがあり、概念的には（powerを例にすると）：極限power、スーパーpower、通常power、わずかなpower、中立、わずかなsoft、通常soft、スーパーsoft、極限softを表します。マッパーとしての直感に基づいて調整を選択することもできます。

最終的に譜面を作成する際は、事前に決定されたパラメータに従ってブロックを配置でき、マッパーが正しい方向を維持し、一度に処理する情報量を削減できます。

これらの6つのパラメータは推奨される譜面分析方法です。このプラグインを使用するマッパーは、好みのパラメータに置き換えることができます

現在のパラメータソース

左上隅のボタンには、現在のパラメータが設定されているビート位置を表す数字が表示されます。ボタンをクリックすると、そのビートに戻り、同じデータを再度変更できます。

現在の位置に既にデータがある場合、このボタンには「X」が表示されます。クリックするとそのデータが削除されます。

コピー＆ペースト

右上隅のボタンにはcopy/pasteが表示されます。現在のビート位置に記録されたデータがある場合、ボタンをクリックするとcopyが実行され、そうでない場合はpasteが実行されます。

  1. 右上隅の「copy」ボタンをクリックして、別のビート位置へのコピーを準備
  2. 別のビートに移動
  3. 「paste」ボタンをクリックして、以前にコピーした設定を適用

設定ファイル

プラグイン設定は以下の場所に保存されます：

%USERPROFILE%\AppData\LocalLow\BinaryElement\ChroMapper\ChroMapper-MappingAssistant.json

カスタムラベル

設定ファイルを編集することで、スライダーのラベルテキストをカスタマイズできます。サンプル設定ファイルはsettings_example/フォルダにあります：

  • ChroMapper-MappingAssistant.zh.json - 中国語ラベルの例
  • ChroMapper-MappingAssistant.jp.json - 日本語ラベルの例

サンプルファイルを上記の設定ファイルの場所にコピーし、必要に応じてラベル内容を変更してください。

使用例

使用例が必要な場合は、ChroMapperで譜面ID 4e3edを開いて譜面を再生し、これらのパラメータがどのように設定されているかを確認できます。

開発情報

プロジェクトのビルド

  1. Visual Studio 2022以降がインストールされていることを確認
  2. ChroMapper-MappingAssistant.csproj.userを作成（ChroMapper-MappingAssistant.csprojと同じフォルダ内）し、ChroMapperのインストール場所を設定
  3. ChroMapper-MappingAssistant.slnを開く
  4. プロジェクトをビルド（Debugモードは自動的にDLLをPluginsフォルダにコピー）

ChroMapper-MappingAssistant.csproj.user:

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="Current" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <ChroMapperDir>YOUR_CHROMAPPER_LOCATION</ChroMapperDir>
    <ReferencePath>$(ChroMapperDir)\ChroMapper_Data\Managed;$(ChroMapperDir)\Plugins</ReferencePath>
    <ProjectView>ShowAllFiles</ProjectView>
  </PropertyGroup>
</Project>

謝辞

注意：このプラグインはサードパーティツールであり、ChroMapperやBeat Gamesの公式開発ではありません。ご利用は自己責任でお願いします。譜面データは定期的にバックアップしてください。

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases 1

v0.13.8 Latest
Feb 1, 2026

Packages

No packages published

Languages