Zdrojový kód rytmickej hry: noty, časovanie a vlastné piesne
Ako Riffvolt ukladá 12 skladieb a 48 máp, kde sa rozhoduje o časovaní a bodovaní a čo treba na pridanie vlastnej piesne.
Zdrojový kód rytmickej hry sú v skutočnosti dve veci: kód, ktorý posudzuje časovanie, a dáta, ktoré hovoria, kedy každá nóta príde. Kupujúci takmer vždy chcú meniť to druhé, lebo nové piesne robia z rytmickej hry ich hru. Riffvolt, naša rocková rytmická šablóna so štyrmi dráhami, drží zoznam piesní v jednom manifeste a každú nótovú mapu v samostatnom súbore, takže pridanie piesne je úloha s dátami a jasným kontrolným zoznamom.
Tento sprievodca prechádza balíkom: čo hrá, kde žije časovanie a bodovanie, ako pridať pieseň, ako zostaviť a hostovať hru, čo povoľuje licencia a čo vydanie vynecháva. Názvy súborov pochádzajú zo sprievodcu pre kupujúcich, ktorý sa dodáva spolu s hrou.
Jeden fakt, ktorý treba mať od začiatku na pamäti: na rozdiel od niektorých našich šablón Riffvolt po zmene zdrojového kódu alebo pridaní piesní potrebuje nové zostavenie. Hostovanie dodaného priečinka hry nepotrebuje nič iné než statický webový hosting.
Čo hrá tento zdrojový kód rytmickej hry
Riffvolt je hotová rytmická hra pre prehliadač so štyrmi dráhami v rockovom štýle. Hráči zasiahnu noty v správnom čase, dlhé noty podržia až do konca, ohnú ich páčkou whammy a napĺňajú indikátor ROCK, ktorý spúšťa overdrive. Overdrive je svetelná šou bez bodov, ktorá končí pri akomkoľvek omyle. Presnosť časovania buduje skóre a combo.
- 12 celých skladieb, každá s režimami Easy (ľahká), Normal (normálna) a Hard (ťažká), plus Rock God, ktorý sa otvorí po turné: spolu 48 nótových máp.
- Turné cez štyri miesta, Garage (garáž), The road, Festival a Arena, po troch piesňach. Hviezdy z prvých dvoch miest otvoria prídavok a dokončenie prídavku otvorí ďalšie miesto, s príbehovými scénami a kozmetickými odmenami, ako sú stopy a rámčeky.
- Voľná hra: ľubovoľná pieseň v ľubovoľnej obtiažnosti, osobné rekordy sa ukladajú pre každú pieseň v prehliadači.
- Ovládanie: predvolene klávesy D, F, J a K, klepanie na dráhy na dotykovej obrazovke alebo gamepad. Klávesové skratky sú v Settings (nastavenia).
- Pohodlie: kalibrácia zvuku pre posun, čo pomáha pri Bluetooth slúchadlách, znížený pohyb a režim pre citlivosť na svetlo, ktorý tlmí blesky a záblesky.
- 14 jazykov rozhrania.
Pozrite si stránku Riffvolt, demo a manuály
Ako sú súbory organizované
Stiahnutie obsahuje game/ (súbory na nasadenie), source/ (projekt TypeScript), documentation/ (ilustrované manuály v angličtine a portugalčine) a licenses/ (oznámenia tretích strán). V source/ je rozdelenie medzi dátami piesní a herným kódom čisté.
- public/manifest.json: katalóg piesní s dĺžkou každej piesne, verziou zvuku a cestami k mapám.
- public/charts/: 48 nótových máp.
- public/audio/: nahrávky skladieb.
- src/core/chartValidate.ts: schéma máp a kontrola časovania.
- src/core/judge.ts: hodnotenie časovania.
- src/core/scoring.ts: pravidlá skóre a combo.
- src/game/campaign.ts: postup turné.
- src/game/session.ts: životný cyklus piesne a výpočet výsledku.
- src/i18n/locales.ts: 14 slovníkov rozhrania.
- src/net/localRecords.js: lokálne osobné rekordy.
- src/ui/style.css: rozhranie a responzívne rozloženie.
Keďže hodnotenie a bodovanie sú v samostatných súboroch, môžete okná časovania spraviť prísnejšie alebo zhovievavejšie bez zásahu do sčítavania bodov, a naopak. Toto rozdelenie hľadajte v akomkoľvek rytmickom kóde.
Pridanie vlastnej piesne krok za krokom
Toto je zmena, na ktorú sa kupujúci rytmických hier pýtajú ako prvú. V balíku nie je editor máp, takže mapy sa píšu ako dáta a manuál presne uvádza, čo každý súbor potrebuje.
- Nahrávku vložte do public/audio/. Používajte len zvuk, na ktorý máte práva pre váš konečný produkt.
- Vytvorte jednu mapu pre každú podporovanú obtiažnosť v public/charts/. Každá mapa potrebuje zodpovedajúce songId, difficulty, audioVersion, offset a noty v poradí.
- Pridajte pieseň do public/manifest.json s jedinečným id, dĺžkou, BPM, témou, audioVersion a cestami k mapám.
- Skontrolujte každú mapu validátorom v chartValidate.ts.
- Prejdite celú skladbu na každej obtiažnosti a potvrďte synchronizáciu. Validátor kontroluje štruktúru a pravidlá časovania, nie to, či nóta pôsobí správne.
- Zostavte znova a nahrajte nový build.
Ak chcete celý nový soundtrack namiesto jednej piesne navyše, plánujte prácu po mapách: 12 piesní na štyroch obtiažnostiach je 48 máp a každá si zaslúži celé prehratie pred vydaním.
Zostavenie a ďalšie zmeny
Odporúča sa Node.js 24 LTS. V source/ spustite npm ci, potom npm run typecheck a npm run build a nahrajte len obsah dist/. Príkaz npm run preview spustí lokálny build na kontrolu. Priečinok node_modules/ nenahrávajte. Vite používa relatívnu základnú cestu, takže zostavenie funguje v podpriečinku. Dodaný runtime je formátovaný na čítanie; manuál žiada pri zostavení ponechať minify:false a cssMinify:false, aby ho ďalší človek mohol stále čítať.
- Značka: farby a rozloženie v src/ui/style.css, plus vaše logo. White label je povolený, takže vaša značka môže nahradiť našu.
- Texty: src/i18n/locales.ts, pre jazyky, ktoré dodávate.
- Turné: poradie miest a to, čo čo odomyká, v campaign.ts.
- Obtiažnosť: okná časovania v judge.ts, potom pravidlá skóre a combo v scoring.ts.
- Piesne: nakoniec, lebo každá nová mapa potrebuje celé prehratie.
Zálohujte pred úpravou, meňte jednu funkciu naraz a po každej zmene otestujte menu, pieseň, pauzu, obrazovku výsledku a obnovenie stránky. Kľúče položiek a ukladania držte stabilné, aby existujúci hráči zachovali svoje rekordy.
Hosting alebo vkladanie do portálu
Nahrajte obsah game/ do priečinka na vašom HTTP(S) hostingu, zachovajte relatívne cesty a otvorte adresu. Nie je potrebný PHP, databáza ani účet. Neotvárajte index.html cez file://; na lokálny test spustite v game/ príkaz python -m http.server 8765.
- Prehliadač potrebuje JavaScript, ES moduly, Canvas 2D a Web Audio.
- Prehliadače odomknú zvuk až po prvom klepnutí alebo kliknutí, takže tichá prvá obrazovka je normálna.
- V iframe povoľte celú obrazovku a automatické prehrávanie.
- Súbory .js posielajte s typom JavaScript MIME, nikdy ako text/plain.
- Všetky runtime assety, fonty a knižnice sú vnútri zostavy. Nie je povinná žiadna CDN, no nejde o aplikáciu na inštaláciu pre offline režim.
Uloženie patrí k pôvodu prehliadača, takže presun hry na inú doménu spustí hráčov od nuly. Toto vydanie používa vlastné kľúče ukladania, oddelené od našich portálových vydaní. Projekty natívnych aplikácií nie sú zahrnuté; vydanie v obchode je samostatná práca.
Čo vydanie nezahŕňa
Riffvolt je lokálne vydanie pre prehliadač. Nemá online miestnosti ani multiplayer, online rebríček ani spoločnú tabuľku, reklamné SDK ani účet, editor máp, natívne aplikácie ani hosting. Osobné rekordy a postup turné zostávajú v prehliadači hráča.
Ak sa hudobná hra hodí do vášho katalógu, vedľa nej môžu pasovať dve ďalšie naše šablóny s časovaním.
Pinloop: jednotlačidlová arkáda s časovaním a 30 cieľmi
Ricopop: arkáda s odrazmi a 50 úrovňami
Licencia a cena
Riffvolt je v katalógu za 49 $. Do 30. novembra 2026 platí promo Black Friday, ktoré znižuje cenu o 15 %, takže stojí 41,65 $. Objednanie dvoch alebo viacerých šablón v jednej objednávke pridá zľavu za balík 5 % až 20 %. Licencia je trvalá a nevýhradná, na jeden konečný produkt, váš alebo jedného klienta. Kód, grafiku a zvuk môžete meniť, svoju značku nahradiť vašou a hru ponúknuť zadarmo alebo s reklamami. Zahrnuté skladby používajte ako súčasť toho konečného produktu; šablónu, jej kód ani jej assety samostatne ďalej predávať nemôžete. Šesť mesiacov podpory je v cene, alebo dvanásť s rozšírením; nové piesne, integrácie a hosting sa ponúkajú samostatne.
Prečítajte si úplné podmienky licencie
Často kladené otázky
Môžem pridať vlastné piesne do zdrojového kódu rytmickej hry?
Áno. Pridajte zvuk, jednu mapu pre každú obtiažnosť a záznam v public/manifest.json, skontrolujte mapy, prejdite ich a potom zostavte znova. Editor máp nie je súčasťou.
Potrebujem Node.js, aby som mohol používať Riffvolt?
Nie na hosting dodaného priečinka hry. Node.js 24 LTS sa odporúča len na nové zostavenie po zmene TypeScriptu alebo pridaní piesní.
Funguje to s dotykovými obrazovkami a gamepadmi?
Áno. Hráči môžu klepať na dráhy alebo použiť gamepad a ovládanie sa nastavuje v Settings (nastavenia). Výkon závisí od zariadenia, takže otestujte tie, na ktoré cielite.
Čo Bluetooth slúchadlá a oneskorenie?
Nastavenia obsahujú kalibráciu zvuku, ktorá nastaví posun zvuku a pomáha pri Bluetooth slúchadlách.
Je tu online rebríček?
Nie. Osobné rekordy sa ukladajú pre každú pieseň a obtiažnosť v prehliadači hráča. Nie sú tu vzdialení súperi ani spoločné rebríčky.
Komu sa hodí
Riffvolt sa hodí pre portál alebo stránku, ktorá chce hudobnú hru vo svojom katalógu, pre štúdio, ktoré doručuje značkovú rytmickú hru jednému klientovi, a pre vývojára, ktorý chce čítať, ako hra na Canvas 2D a Web Audio posudzuje časovanie v TypeScripte. Menej sa hodí, ak potrebujete vizuálny editor máp pre nevývojárov alebo online súťaženie; obe sú zákazková práca.