Zdrojový kód rytmické hry: noty, časování a přidání vlastních písní
Jak Riffvolt ukládá 12 skladeb a 48 partitur, kde se rozhoduje o časování a bodování a co obnáší přidat vlastní píseň.
Zdrojový kód rytmické hry jsou vlastně dvě věci: kód, který posuzuje časování, a data, která říkají, kdy každá nota dorazí. Kupující téměř vždy chtějí měnit to druhé, protože nové písně jsou to, co z rytmické hry dělá jejich hru. Riffvolt, naše čtyřpruhová rocková rytmická šablona, drží seznam písní v jednom manifestu a každou partituru not v samostatném souboru, takže přidání písně je datová práce s jasným kontrolním seznamem.
Tento průvodce prochází balíčkem: co hra přehrává, kde žijí časování a bodování, jak přidat píseň, jak hru znovu sestavit a hostovat, co licence dovoluje a co edice nezahrnuje. Názvy souborů pochází z průvodce kupujícího, který je součástí hry.
Jedna věc, kterou mějte od začátku na paměti: na rozdíl od některých naších šablon potřebuje Riffvolt po změně zdrojového kódu nebo přidání písní nové sestavení. Hostování dodané složky hry ale potřebuje jen statický webový hosting.
Co tento zdrojový kód rytmické hry přehrává
Riffvolt je hotová čtyřpruhová rocková rytmická hra pro prohlížeč. Hráči trefují noty v rytmu, dlouhé noty drží až do konce, ohýbají je pomocí whammy a plní měřič ROCK, který spouští overdrive, světelnou show, jež nepřidává body a skončí při jakémkoli minutí. Přesnost časování buduje skóre a combo.
- 12 celých skladeb, každá s partiturami Easy, Normal a Hard, a navíc Rock God, který se otevře po turné: celkem 48 partitur not.
- Turné čtyřmi místy (Garage (garáž), The road (silnice), Festival a Arena), vždy tři písně. Hvězdičky z prvních dvou otevřou přídavek (encore) a dokončení přídavku otevře další místo, se scénami příběhu a kosmetickými odměnami, jako jsou stopy a rámečky.
- Volná hra: jakákoli píseň v jakékoli obtížnosti, s osobními rekordy ukládanými u každé písně v prohlížeči.
- Ovládání: standardně klávesy D, F, J a K, klepání na dráhy na dotykové obrazovce nebo gamepad. Klávesové zkratky jsou v Settings (nastavení).
- Pohodlí: kalibrace zvuku pro offset, která pomáhá se sluchátky Bluetooth, omezený pohyb a režim pro fotosenzitivní hráče, který tlumí blikání a blesky.
- 14 jazyků rozhraní.
Podívejte se na stránku Riffvolt, demo a příručky
Jak jsou soubory uspořádány
Stažení obsahuje složku game/ (soubory k nasazení), source/ (projekt v TypeScriptu), documentation/ (ilustrované příručky v angličtině a portugalštině) a licenses/ (oznámení třetích stran). Uvnitř source/ je dělení mezi daty písní a herní logikou čisté.
- public/manifest.json: katalog písní s délkou každé písně, verzí zvuku a cestami k partiturám.
- public/charts/: 48 partitur not.
- public/audio/: nahrávky skladeb.
- src/core/chartValidate.ts: schéma partitur a kontrola časování.
- src/core/judge.ts: hodnocení časování.
- src/core/scoring.ts: pravidla pro body a combo.
- src/game/campaign.ts: postup turné.
- src/game/session.ts: životní cyklus písně a výpočet výsledku.
- src/i18n/locales.ts: 14 slovníků rozhraní.
- src/net/localRecords.js: lokální osobní rekordy.
- src/ui/style.css: rozhraní a responzivní rozložení.
Protože soudce (judge) a bodování jsou v oddělených souborech, můžete okna časování zpřísnit nebo zjemnit, aniž byste se dotkli toho, jak se body sčítají, a naopak. Právě na toto dělení se dívejte u jakéhokoli rytmického kódu.
Přidání vlastní písně krok za krokem
Tuto změnu kupující rytmických her chtějí řešit jako první. Balíček neobsahuje editor partitur, takže partitury jsou psány jako data a příručka přesně uvádí, co každý soubor potřebuje.
- Vložte nahrávku do složky public/audio/. Používejte jen zvuk, na který máte práva pro svůj koncový produkt.
- Vytvořte jednu partituru pro každou podporovanou obtížnost ve složce public/charts/. Každá partitura potřebuje odpovídající songId, difficulty, audioVersion, offset a noty v pořadí.
- Přidejte píseň do public/manifest.json s jedinečným id, délkou, BPM, tématem, audioVersion a cestami k partiturám.
- Zkontrolujte každou partituru validátorem v chartValidate.ts.
- Přehrajte celou skladbu na každé obtížnosti a potvrďte synchronizaci. Validátor kontroluje strukturu a pravidla časování, ne to, zda nota působí správně.
- Sestavte znovu a nahrajte nové sestavení.
Pokud chcete celý nový soundtrack místo jedné další písně, plánujte práci po partiturách: 12 písní na čtyřech obtížnostech je 48 partitur a každá si zaslouží celé projití před vydáním.
Sestavení a co dalšího změnit
Doporučuje se Node.js 24 LTS. Ve složce source/ spusťte npm ci, poté npm run typecheck a npm run build a publikujte jen obsah složky dist/. Příkaz npm run preview servíruje lokální sestavení ke kontrole. Nenahrávejte složku node_modules/. Vite používá relativní základ, takže sestavení funguje i v podsložce. Dodaný běhový kód je naformátovaný pro čtení; příručka při sestavování žádá ponechat minify:false a cssMinify:false, aby ho mohl další člověk stále číst.
- Značka: barvy a rozložení v src/ui/style.css, plus vaše logo. White label je povolen, takže vaše značka může nahradit naši.
- Texty: src/i18n/locales.ts, pro jazyky, které dodáváte.
- Turné: pořadí míst a to, co co odemyká, v campaign.ts.
- Obtížnost: okna časování v judge.ts, poté pravidla pro body a combo v scoring.ts.
- Písně: jako poslední, protože každá nová partitura potřebuje celé projití.
Před úpravou zálohujte, měňte jednu funkci najednou a po každé změně otestujte menu, píseň, pauzu, obrazovku výsledků a znovunačtení stránky. Id položek a klíče ukládání držte stabilní, aby si stávající hráči uchovali své rekordy.
Hosting nebo vložení do portálu
Obsah složky game/ nahrajte do složky na svém HTTP(S) hostingu, zachovejte relativní cesty a otevřete adresu. Není potřeba PHP, databáze ani účet. Neotevírejte index.html přes file://; pro lokální test spusťte uvnitř složky game/ příkaz python -m http.server 8765.
- Prohlížeč potřebuje JavaScript, ES moduly, Canvas 2D a Web Audio.
- Prohlížeče odemknou zvuk až po prvním klepnutí nebo kliknutí, takže tichá první obrazovka je normální.
- V iframe povolte celou obrazovku a automatické přehrávání.
- Soubory .js servírujte s MIME typem JavaScriptu, nikdy jako text/plain.
- Všechny běhové assety, písma a knihovny jsou uvnitř sestavení. Žádné povinné CDN není potřeba, ale nejde o aplikaci pro instalaci a offline použití.
Uložená data patří původu prohlížeče, takže přesun hry na jinou doménu spustí hráče od začátku. Tato edice používá vlastní klíče ukládání, oddělené od našich edic pro portály. Projekty nativních aplikací nejsou zahrnuty; vydání v obchodě je samostatná práce.
Co edice nezahrnuje
Riffvolt je lokální edice pro prohlížeč. Nemá online místnosti ani multiplayer, online žebříček ani sdílený žebříček, reklamní SDK ani účty, editor partitur, nativní aplikace ani hosting. Osobní rekordy a postup turné zůstávají v prohlížeči hráče.
Pokud se do vašeho katalogu hodí hudební hra, dvě další šablony s časováním od nás se k ní mohou hodit.
Pinloop: arkádová hra s časováním na jedno tlačítko a 30 cíli
Ricopop: arkádová hra s odrazy a 50 úrovněmi
Licence a cena
Riffvolt stojí 49 USD. Do 30. listopadu 2026 platí akce Black Friday, která sníží cenu o 15 %, takže stojí 41,65 USD, a koupě dvou nebo více šablon v jedné objednávce přidá slevu za balíček 5 % až 20 %. Licence je trvalá a nevýhradní, pro jeden koncový produkt, váš nebo jednoho vašeho klienta. Kód, grafiku a zvuk můžete měnit, nahradit naši značku vaší a hru nabízet zdarma nebo s reklamami. Dodané skladby používejte jako součást toho koncového produktu; samotnou šablonu, její kód ani assety nesmíte dál prodávat. Šest měsíců podpory je v ceně, nebo dvanáct s rozšířením; nové písně, integrace a hosting se nabízejí zvlášť.
Přečtěte si celé podmínky licence
Často kladené otázky
Mohu do zdrojového kódu rytmické hry přidat vlastní písně?
Ano. Přidejte zvuk, jednu partituru pro každou obtížnost a záznam do public/manifest.json, ověřte partitury, projděte je hrou a poté sestavte znovu. Editor partitur není součástí balíčku.
Potřebuji k použití Riffvoltu Node.js?
K hostování dodané složky hry ne. Node.js 24 LTS se doporučuje jen k opětovnému sestavení po změně TypeScriptu nebo přidání písní.
Funguje to s dotykovými obrazovkami a gamepady?
Ano. Hráči mohou klepat na dráhy nebo použít gamepad a ovládání se nastavuje v Settings. Výkon závisí na zařízení, takže otestujte ta, na která míříte.
A co sluchátka Bluetooth a latence?
V nastavení je kalibrace zvuku, která nastaví offset zvuku a pomáhá se sluchátky Bluetooth.
Je k dispozici online žebříček?
Ne. Osobní rekordy se ukládají u každé písně a obtížnosti v prohlížeči hráče. Neexistují vzdálení soupeři ani sdílené žebříčky.
Komu se koupě hodí
Riffvolt se hodí portálu nebo webu, který chce ve svém katalogu hudební hru, studiu, které dodává značkovou rytmickou hru jednomu klientovi, a vývojáři, který chce číst, jak hra na Canvas 2D a Web Audio posuzuje časování v TypeScriptu. Méně se hodí tam, kde potřebujete vizuální editor partitur pro lidi bez znalosti programování nebo online soutěž; obojí je zakázková práce.