夜光編輯器入門
十分鐘做出第一首貼得進遊戲的譜
你手上有什麼
三種人走三條路，先確認你是哪一種：
| 你手上的東西 | 走哪條路 |
|---|---|
| 什麼都沒有，想從零寫一首 | 這一頁，從第一節開始往下讀 |
| 一份別人給你的 MML 文字 | 標題列的剪貼簿 → 從剪貼簿貼上。細節看剪貼簿那一節 |
一個 MIDI 檔（.mid） | 標題列的檔案 → 選擇檔案。細節看 MIDI 轉 MML 教學 |
這一頁只走第一條。走完你會得到一首七個音的短曲，而且真的貼得進遊戲的空白樂譜——重點不是那首曲子，是路上經過的每一個地方你都知道它在幹什麼。
還不知道 MML 是什麼？可以先讀 瑪奇 MML 語法教學，但不是必要的——這一頁不用你會寫任何一個字母。
介面五區
編輯器從上到下是五區，中間夾著一條可以拖的分隔線：
| 這一區 | 做什麼 |
|---|---|
| 標題列 | 四個進出口：剪貼簿（跟遊戲之間搬譜）、檔案（匯入匯出）、分享（產生連結）、設定 |
| 工具列 | 左半邊是播放，右半邊是編輯：畫音符用的工具、縮放、復原重做，以及速度／力度／移調／優化／合併五個功能 |
| 鋼琴捲簾 | 用滑鼠畫音符的地方。左邊是琴鍵（點得出聲），上面那條細的是小節尺 |
| 樂譜編輯區 | 上面一排是分頁，下面是 MML 文字。一個分頁＝一份要發給某個人的完整樂譜 |
| 狀態列 | 最下面一行：幾份譜、幾個音、速度、總長度、暫存時間、引擎狀態 |
先把兩個詞分清楚，後面全部靠它。
樂譜（分頁）是一份要發給某個人的譜——它有自己的樂器、自己的名字。最多 15 份。
音軌是一份譜裡面的四段：旋律／和音1／和音2／歌唱，也就是遊戲空白樂譜的四個逗號段。字數上限是每一條音軌各自算的。
一、先聽一次
開站看到的不是白紙，是一首現成的曲子（十份樂譜、十種樂器）。什麼都別動，先按工具列左邊的 ▶ 演奏。
三件事會同時發生，值得各看一眼：
- 鋼琴捲簾上有一條線從左往右掃過去——那是導播線，它走到哪就在響哪
- 畫面自己往後翻頁。那是 捲軸同步 這顆在作用；播放中你自己去拖水平捲軸，它會自動關掉（因為你顯然想自己看別的地方），按一下可以再打開
- 文字區的 MML 跟著亮起來，亮到哪就是正在唱哪一個字母
按鈕會變成 ❚❚ 暫停，再按是 ▶ 繼續；停止則是回到頭。演奏與停止沒有鍵盤快捷鍵，只能點按鈕。
想只聽中間一段：在小節尺上左鍵點一下設開始、右鍵點一下設結束，工具列的部份會亮起來。按全部會清掉那兩條線回到整首。旁邊的循環是播到底立刻從頭再來一次。
播放中兩邊都不能編輯。 捲簾與文字區在播放時是唯讀的，這是刻意的——要改東西先按暫停或停止。暫停中可以改，改動會在按繼續之後生效。
二、清出一張白紙
要自己寫，得先把那首示範曲清掉。位置在標題列 → 檔案 → 最下面的「清空」→ 清空所有音符。
它會清掉全部 15 份樂譜、留下 1 份空白的，檔名與調號保留、樂器回到預設。按 Ctrl+Z 可以復原，所以放心按。
想把示範曲叫回來，點左上角的「夜光 MML工坊」。 那顆的意思是「重來一次」——它會把你暫存的東西清掉再重載示範曲。它會先問你一次，但按了確定就Ctrl+Z 也救不回來，所以上面那個「清空所有音符」才是你在這一步該用的（那個復原得回來）。
三、畫出七個音
我們畫小星星的開頭七個音：Do Do Sol Sol La La Sol。選它不是因為簡單，是因為你聽得出對錯——音階畫錯一個音沒人會發現，小星星錯一個當場就聽出來。
先看工具列中間那一排。只選取是箭頭模式（不會畫東西），右邊 1 到 32 六顆是音符長度：全音符、二分、四分、八分、十六分、三十二分。
按 3 選四分音符（或直接點那顆 4）。然後在捲簾上照這個順序左鍵點七下：
Do Do Sol Sol La La Sol
音高看左邊的琴鍵找——點琴鍵會發出那個音，聽到對的再往右邊那一格點下去。中央 Do 在 o4 那一列。
畫的時候可以用的四個動作，工具列右邊那行提示也寫著同一句話：
| 動作 | 結果 |
|---|---|
| 左鍵點空白處 | 放一個音，長度用你選的那一顆 |
| 拖曳音符 | 搬動它（上下換音高、左右換位置） |
| 拖音符的右邊框 | 改長度 |
| 右鍵點音符 | 刪掉它（變回同長度的休止符，後面的音不會位移） |
最後那個 Sol 想拉長成二分音符：拖它的右邊框往右拉一格。放開之前想取消就按 Esc。
畫完按 ▶ 演奏。聽起來是小星星就對了。畫錯的音右鍵刪掉重畫，或按 Ctrl+Z。
Delete 也可以刪：先點選音符，再按 Delete。但它只在焦點不在文字區的時候是這個意思——在文字區裡 Delete 就是刪字。這件事在總覽頁講得完整。
四、看一眼文字區
低頭看下面的文字區。你剛剛畫的七個音已經變成一行 MML 了，大概長這樣：
l4ccggaag2
實際的數字看你畫在哪一列（會多一個 o4 之類的八度記號），但形狀是一樣的。
捲簾與文字區是同一份資料的兩種樣子，不是兩個檔案。這句話有三個立刻用得到的後果：
- 直接在文字區打字改 MML，捲簾馬上跟著變
- 在文字區選一段文字，捲簾上那幾個音會跟著被選起來——反過來也一樣
- 在捲簾上雙擊一個音（要在只選取模式下），文字區的游標會跳到那個音的位置。長譜上找音就靠這個
用捲簾編輯會重新產生整條音軌的 MML。 音符內容一個都不會變，但你手寫的註解與排版會消失。所以習慣是：先用捲簾把音符弄對，最後才手動排版；不要反過來。
五、加一條和音
文字區有三個並排的框，從左到右是旋律／和音1／和音2——這就是一份樂譜的三條音軌（畫面窄的時候會變成上下排列，手機上變成三個小頁籤切換）。
剛剛畫的東西在旋律裡。點一下和音1那個框，捲簾的焦點就換到那條音軌上，然後照同樣的方法畫幾個長音當伴奏——例如 Do Do Fa Do，每個用二分音符（按 2）。
畫的時候你會看到旋律那條音軌的音符還在，只是變成外框；你正在編輯的那條是實心的。同一份譜裡其他音軌、以及其他樂譜的音符都在畫面上，深淺不同——這是為了讓你對得準位置。
再按演奏，兩條線一起響。
一條音軌同時只能響一個音。 和弦要拆到不同音軌去（旋律一個音、和音1 一個、和音2 一個），不能寫成 [ceg]——那個寫法遊戲不吃，本站也停用了。詳見 常見問題。
要寫歌唱譜的話，把樂器列上的樂器譜下拉改成歌唱譜：那時只有一條歌唱音軌。切換不會弄丟另一邊的內容，切回來東西還在。
六、調速度
速度不要在文字區手打，用工具列的速度按鈕——它會把 t 寫到對的地方，也會處理跨過速度變化的長音。
- 按速度
- 設置位置選音軌開頭（曲子中途要換速度才選「選擇的音符前」，那要先選一個音）
- 拉速度（BPM）的滑桿。旁邊有試聽，會用固定的節拍型讓你聽速度本身
- 按執行
每一份樂譜都要自己帶速度。 這是這個版本最容易吃虧的地方：一份譜是複製給一個人的，缺了 t 那個人就照他自己的預設速度彈。
而且站上聽起來會是對的——播放一律照速度基準換算，所以你在這裡完全聽不出問題，只有進遊戲才脫拍。速度不一致時狀態列會常駐一行提示，旁邊就是修好它的按鈕；速度對話框裡也有同步所有樂譜可以一次把每一份對到基準那一份。
七、看字數
每條音軌右邊都有一組數字，例如 7 音 · 12/1600 字。那是匯出後的字數，空白與換行不計——所以你可以放心用換行分小節。
四條音軌的上限各自不同：
| 音軌 | 上限 |
|---|---|
| 旋律 | 1600 字 |
| 和音1 | 1200 字 |
| 和音2 | 900 字 |
| 歌唱 | 1200 字 |
這是遊戲的硬限制，超過就貼不進空白樂譜。超了字數會變紅，但不會擋住你繼續編輯。畫面上顯示的才是目前實際生效的上限，跟這張表對不上時以畫面為準。
真的超了怎麼壓：工具列的優化，先選無損壓縮（一個音都不會動）。它不夠再考慮別的，那幾種會改變聲音。詳見總覽頁的優化那一節與 常見問題。
八、貼進遊戲
最後一步。標題列 → 剪貼簿 → 右邊的「複製目前樂譜」。
那會把目前這一份譜複製成一段 MML@…; 的文字，四段（旋律／和音1／和音2／歌唱）都包在裡面，直接貼進遊戲的空白樂譜就行。複製時會去掉空白，那才是遊戲算的字數。
如果有音軌超過上限，它照樣複製給你，但會講一聲「這一份貼不進遊戲的空白樂譜」——那時先回去壓字數。
合奏的情形：一份樂譜給一個人，所以要各自切到那個分頁按複製。旁邊的複製全部是多行的，不能整段貼進遊戲——但每一行各自都可以，而且那段文字貼回本站會連樂譜名與樂器一起還原，適合備份或傳給朋友。
你的東西留在這台電腦的瀏覽器裡（設定抽屜的自動存檔），重新整理或關掉重開都接得回來，不會上傳到伺服器。要給別人一條連結就用分享，那需要登入。
接下來
- 編輯器功能與快捷鍵總覽——每一顆按鈕、每一個鍵，以及力度、移調、合併音軌怎麼用
- 瑪奇 MML 語法教學——想直接手寫文字的話
- MIDI 轉 MML 教學——把現成的曲子變成樂譜，不用一個音一個音畫
- 常見問題——音色、存檔、字數上限、分享