Izvorni kod igre ritma: karte nota, tempiranje i dodavanje pjesama

Izvorni kod igre ritma zapravo su dvije stvari: kod koji procjenjuje vrijeme i podaci koji kažu kada stiže svaka nota. Kupci gotovo uvijek žele promijeniti drugo, jer su nove pjesme ono što igru ritma čini njihovom. Riffvolt, naš ritam predložak za rock s četiri trake, drži popis pjesama u jednoj datoteci manifesta, a svaku kartu nota u vlastitoj datoteci, pa je dodavanje pjesme posao s podacima i jasnim popisom za provjeru.

Ovaj vodič prolazi kroz paket: što igra, gdje žive vrijeme i bodovanje, kako dodati pjesmu, kako ponovno izgraditi i postaviti igru, što licenca dopušta i što izdanje ne uključuje. Nazivi datoteka dolaze iz vodiča za kupca koji ide uz igru.

Jednu činjenicu imajte na umu od početka: za razliku od nekih naših predložaka, Riffvolt treba ponovnu gradnju nakon što promijenite izvorni kod ili dodate pjesme. Postavljanje isporučene mape igre treba samo statički web-poslužitelj.

Što ovaj izvorni kod igre ritma pokreće

Riffvolt je gotova ritam igra s rock glazbom i četiri trake za preglednik. Igrači pogađaju note u taktu, drže duge note do kraja, savijaju ih pomoću whammyja i pune ROCK mjerač koji pokreće overdrive (pojačani režim), svjetlosnu predstavu koja ne donosi bodove i završava na svakom promašaju. Točnost vremena gradi bodove i combo.

• 12 punih pjesama, svaka s težinama Easy (lako), Normal (normalno) i Hard (teško), plus Rock God (rock bog), koji se otključava nakon turneje: ukupno 48 karti nota.
• Turneja kroz četiri lokacije, Garage (garaža), The road (cesta), Festival (festival) i Arena (arena), po tri pjesme na svakoj. Zvjezdice iz prve dvije otvaraju bis, a završetak biza otvara sljedeću lokaciju, uz scene priče i kozmetičke nagrade poput tragova i okvira.
• Slobodna igra: bilo koja pjesma na bilo kojoj težini, a osobni rekordi spremaju se pjesmu po pjesmu u pregledniku.
• Upravljanje: tipke D, F, J i K zadano, dodir po trakama na ekranu osjetljivom na dodir ili gamepad. Tipke se postavljaju u postavkama.
• Udobnost: kalibracija zvuka za pomak, što pomaže s Bluetooth slušalicama, smanjeno kretanje i način za fotosenzitivne osobe koji ublažava bljeskove i munje.
• 14 jezika sučelja.

Pogledajte stranicu Riffvolta, demo i priručnike

Kako su datoteke organizirane

Preuzimanje sadrži game/ (datoteke za postavljanje), source/ (TypeScript projekt), documentation/ (ilustrirane priručnike na engleskom i portugalskom) i licenses/ (obavijesti trećih strana). Unutar source/ podjela između podataka o pjesmama i logike igre je čista.

• public/manifest.json: katalog pjesama, s trajanjem svake pjesme, verzijom zvuka i putanjama karata.
• public/charts/: 48 karti nota.
• public/audio/: snimke pjesama.
• src/core/chartValidate.ts: shema karti i provjera vremena.
• src/core/judge.ts: ocjene vremena.
• src/core/scoring.ts: pravila za bodove i combo.
• src/game/campaign.ts: napredak kroz turneju.
• src/game/session.ts: životni ciklus pjesme i izračun rezultata.
• src/i18n/locales.ts: 14 rječnika sučelja.
• src/net/localRecords.js: lokalni osobni rekordi.
• src/ui/style.css: sučelje i responzivni raspored.

Budući da su sudac i bodovanje u zasebnim datotekama, možete učiniti vremenske prozore strožima ili blažima bez diranja načina na koji se bodovi zbrajaju, i obrnuto. To je podjela koju treba tražiti u svakom kodu za ritam.

Dodavanje vlastite pjesme, korak po korak

Ovo je promjena koju kupci ritam igara najprije traže. U paketu nema uređivača karata, pa su karte zapisane kao podaci, a priručnik točno navodi što svaka datoteka treba.

1. Stavite snimku u public/audio/. Koristite samo zvuk na koji imate prava za svoj krajnji proizvod.
2. Napravite jednu kartu po podržanoj težini u public/charts/. Svaka karta treba odgovarajući songId, difficulty, audioVersion, offset i note poredane redom.
3. Dodajte pjesmu u public/manifest.json s jedinstvenim id-om, trajanjem, BPM-om, temom, audioVersion i putanjama karata.
4. Provjerite svaku kartu validatorom u chartValidate.ts.
5. Odsvirajte cijelu pjesmu na svakoj težini i potvrdite sinkronizaciju. Validator provjerava strukturu i pravila vremena, a ne to je li nota dobra za osjećaj.
6. Ponovno izgradite, zatim učitajte novu verziju.

Ako želite potpuno novi soundtrack, a ne jednu dodatnu pjesmu, planirajte posao po karti: 12 pjesama na četiri težine daje 48 karti, a svaka treba cijelo odigravanje prije izdanja.

Ponovna gradnja i što još promijeniti

Preporučuje se Node.js 24 LTS. Unutar source/ pokrenite npm ci, zatim npm run typecheck i npm run build, a objavite samo sadržaj mape dist/. npm run preview poslužuje lokalnu verziju za pregled. Ne učitavajte node_modules/. Vite koristi relativnu osnovu, pa verzija radi i u podmapi. Isporučeno izvođenje formatirano je za čitanje; priručnik traži da pri ponovnoj gradnji zadržite minify:false i cssMinify:false, kako bi sljedeća osoba i dalje mogla čitati kod.

1. Brend: boje i raspored u src/ui/style.css, plus vaš logotip. Bijela oznaka je dopuštena, pa vaš brend može zamijeniti naš.
2. Tekstovi: src/i18n/locales.ts, za jezike koje isporučujete.
3. Turneja: redoslijed lokacija i što se otključava, u campaign.ts.
4. Težina: vremenski prozori u judge.ts, zatim pravila bodova i comboa u scoring.ts.
5. Pjesme: na kraju, jer svaka nova karta treba puno odigravanje.

Napravite sigurnosnu kopiju prije uređivanja, mijenjajte jednu značajku u jednom trenutku i nakon svake promjene testirajte izbornik, pjesmu, pauzu, ekran rezultata i ponovno učitavanje. Držite id-ove predmeta i ključeve za spremanje stabilnima da bi postojeći igrači zadržali svoje rekorde.

Hosting ili ugradnja u portal

Prenesite sadržaj mape game/ u mapu na vašem HTTP(S) hostingu, zadržite relativne putanje i otvorite adresu. Nisu potrebni PHP, baza podataka ni račun. Ne otvarajte index.html preko file://; za lokalni test pokrenite python -m http.server 8765 unutar game/.

• Preglednik treba: JavaScript, ES module, Canvas 2D i Web Audio.
• Preglednici otključavaju zvuk tek nakon prvog dodira ili klika, pa je tihi prvi ekran normalan.
• U iframeu omogućite cijeli zaslon i automatsku reprodukciju.
• Poslužujte .js s JavaScript MIME tipom, nikada kao text/plain.
• Sve potrebne datoteke, fontovi i biblioteke nalaze se unutar izgradnje. Nema obaveznog CDN-a, ali ovo nije aplikacija za offline instalaciju.

Spremanja pripadaju izvoru preglednika, pa premještanje igre na drugu domenu kreće igrače ispočetka. Ovo izdanje koristi vlastite ključeve za spremanje, odvojene od naših portalskih izdanja. Projekti nativnih aplikacija nisu uključeni; objava u trgovini zaseban je posao.

Što izdanje ne uključuje

Riffvolt je lokalno izdanje za preglednik. Nema online soba ni višeigračkog načina, nema online ljestvice ni zajedničke ljestvice, nema oglasnog SDK-a ni računa, nema uređivača karata, nema nativnih aplikacija i nema hostinga. Osobni rekordi i napredak turneje ostaju u pregledniku igrača.

Ako glazbena igra odgovara vašem katalogu, dvije druge naše predloške temeljene na vremenu mogu sjesti uz nju.

Pinloop: arkadna igra s jednim gumbom i 30 meta

Ricopop: arkadna igra s odbijanjem i 50 razina

Licenca i cijena

Riffvolt košta 49 USD po cjeniku. Do 30. studenoga 2026. Black Friday promocija daje 15% popusta, pa košta 41,65 USD, a kupnja dva ili više predložaka u jednoj narudžbi daje dodatnih 5% do 20% popusta za paket. Licenca je trajna i nekskluzivna, za jedan krajnji proizvod, vaš ili jednog klijenta. Smijete mijenjati kod, grafiku i zvuk, zamijeniti naš brend svojim te ponuditi igru besplatno ili uz oglase. Uključene pjesme koristite kao dio tog krajnjeg proizvoda; predložak, njegov kod ili resurse ne smijete preprodavati zasebno. Šest mjeseci podrške je uključeno, ili 12 uz proširenje; nove pjesme, integracije i hosting nude se zasebno.

Pročitajte cijele uvjete licence

Često postavljana pitanja

Mogu li dodati vlastite pjesme u izvorni kod igre ritma?

Da. Dodajte zvuk, jednu kartu po težini i unos u public/manifest.json, provjerite karte, odsvirajte ih i zatim ponovno izgradite. Uređivač karata nije uključen.

Trebam li Node.js za korištenje Riffvolta?

Ne za postavljanje isporučene mape igre. Node.js 24 LTS preporučuje se samo za ponovnu gradnju nakon promjene TypeScripta ili dodavanja pjesama.

Radi li s ekranima osjetljivim na dodir i gamepadom?

Da. Igrači mogu dodirnuti trake ili koristiti gamepad, a upravljanje se postavlja u postavkama. Performanse ovise o uređaju, pa testirajte one koje ciljate.

Što je s Bluetooth slušalicama i kašnjenjem?

Postavke uključuju kalibraciju zvuka, koja postavlja pomak zvuka i pomaže s Bluetooth slušalicama.

Postoji li online ljestvica?

Ne. Osobni rekordi spremaju se po pjesmi i težini u pregledniku igrača. Nema udaljenih protivnika ni zajedničkih poredaka.

Za koga je

Riffvolt odgovara portalu ili stranici koja želi glazbenu igru u katalogu, studiju koji isporučuje brendiranu igru ritma jednom klijentu i programeru koji želi pročitati kako igra na Canvas 2D i Web Audio procjenjuje vrijeme u TypeScriptu. Slabije odgovara ako trebate vizualni uređivač karata za nedevelopere ili online natjecanje; oboje je prilagođeni rad.

Isprobajte Riffvolt demo i kupite licencu

Nove pjesme ili brendirana verzija? Zatražite ponudu