Rütmimängu lähtekood: noodikaardid, ajastus ja laulude lisamine

Rütmimängu lähtekood on tegelikult kaks asja: kood, mis hindab ajastust, ja andmed, mis ütlevad, millal iga noot saabub. Ostjad tahavad peaaegu alati muuta teist, sest uued laulud teevad rütmimängust just sinu oma. Riffvolt, meie neljarajaline rokirütmimäng, hoiab laulude nimekirja ühes manifestifailis ja iga noodikaardi omaette failis, nii et laulu lisamine on andmetöö selge kontrollnimekirjaga.

See juhend käib paketi läbi: mida see mängib, kus asuvad ajastus ja punktid, kuidas lisada laulu, kuidas uuesti koostada ja majutada, mida litsents lubab ning mida väljaanne ei sisalda. Failinimed pärinevad mänguga kaasasolevast ostujuhendist.

Üks fakt tasub algusest peale meeles pidada: erinevalt mõnest meie mallist vajab Riffvolt pärast lähtekoodi muutmist või laulude lisamist uuesti koostamist. Antud mängukausta majutamiseks piisab ainult staatilisest veebihostist.

Mida see rütmimängu lähtekood mängib

Riffvolt on valmis neljarajaline rokirütmimäng brauserile. Mängijad tabavad noote õigel ajal, hoiavad pikki noote lõpuni, painutavad neid whammy'ga (kitarri hoob) ja täidavad mõõdiku ROCK (gauge), mis käivitab ülevõimenduse (overdrive). See on valgusshow, mis punkte ei lisa ja lõpeb mis tahes möödalaskmisel. Ajastuse täpsus kasvatab punkte ja kombot.

• 12 täisloos, igaühel Easy (lihtne), Normal (tavaline) ja Hard (raske) kaart, ning Rock God, mis avaneb pärast turneed: kokku 48 noodikaarti.
• Turnee läbi nelja koha, Garage (garaaž), The road (tee), Festival (festival) ja Arena (areen), igas kolm laulu. Esimestest kahest kogutud tähed avavad lisaloo (encore) ja selle lõpetamine avab järgmise koha koos loolõikude ja kosmeetiliste preemiatega, nagu jäljed ja raamid.
• Vaba mäng: iga lugu igal raskusastmel, isiklikud rekordid salvestatakse loo kaupa brauserisse.
• Juhtnupud: vaikimisi D, F, J ja K, puuteekraanil radade puudutamine või mängupult. Klahvide seaded asuvad jaotises Settings (seaded).
• Mugavus: helikalibreerimine nihke jaoks, mis aitab Bluetooth-kõrvaklappide puhul, vähendatud liikumine ja valgustundlik režiim, mis summutab välke ja välgusähvatusi.
• 14 liidese keelt.

Vaata Riffvolti kirjeldust, demot ja juhendeid

Kuidas failid on korraldatud

Allalaadimine sisaldab kausta game/ (üleslaaditavad failid), source/ (TypeScripti projekt), documentation/ (illustreeritud juhendid inglise ja portugali keeles) ja licenses/ (kolmandate osapoolte teated). Kaustas source/ on laulude andmete ja mängu loogika vaheline jaotus puhas.

• public/manifest.json: laulude kataloog, iga loo kestus, helivariant ja kaartide teed.
• public/charts/: 48 noodikaarti.
• public/audio/: lugude salvestused.
• src/core/chartValidate.ts: kaardi skeem ja ajastuse kontroll.
• src/core/judge.ts: ajastuse hinnangud.
• src/core/scoring.ts: punkti- ja kombo reeglid.
• src/game/campaign.ts: turnee edenemine.
• src/game/session.ts: loo elutsükkel ja tulemuse arvutus.
• src/i18n/locales.ts: 14 liidese sõnastikku.
• src/net/localRecords.js: kohalikud isiklikud rekordid.
• src/ui/style.css: liides ja reageeriv paigutus.

Kuna hindaja ja punktiarvestus on eraldi failid, saad ajastusaknad rangemaks või leebemaks muuta, puutumata punktide kogumist, ja vastupidi. Seda eraldust tasub igas rütmikoodis otsida.

Oma laulu lisamine samm-sammult

Seda muudatust küsivad rütmimängu ostjad esimesena. Paketis ei ole kaardiredaktorit, seega kaardid kirjutatakse andmetena ja juhend loetleb täpselt, mida iga fail vajab.

1. Pane salvestus kausta public/audio/. Kasuta ainult heli, mille õigused on sul oma lõpptoote jaoks.
2. Tee üks kaart toetatud raskusastme kohta kausta public/charts/. Iga kaart vajab vastavat songId-d, raskusastet, audioVersion-it, nihet ja noote järjekorras.
3. Lisa laul faili public/manifest.json koos unikaalse id-, kestuse, BPM-i, teema, audioVersion-i ja kaardi teedega.
4. Kontrolli iga kaarti chartValidate.ts-i valideerijaga.
5. Mängi kogu lugu läbi igal raskusastmel, et kinnitada sünkroon. Valideerija kontrollib struktuuri ja ajastusreegleid, mitte seda, kas noot tundub õige.
6. Koosta uuesti ja laadi uus koostis üles.

Kui tahad terve uue helirajatise, mitte ühte lisalugu, planeeri töö kaupa: 12 laulu neljal raskusastmel on 48 kaarti ja iga kaart väärib enne avaldamist täielikku läbimängimist.

Uuesti koostamine ja muu muutmine

Soovituslik on Node.js 24 LTS. Kaustas source/ käivita npm ci, seejärel npm run typecheck ja npm run build ning avalda ainult kausta dist/ sisu. npm run preview serveerib kohaliku koostise kontrolliks. Ära laadi üles kausta node_modules/. Vite kasutab suhtelist baasi, seega koostis töötab alamkaustas. Käitusaja failid on vormindatud lugemiseks; juhend palub uuesti koostamisel jätta minify:false ja cssMinify:false, et järgmine inimene saaks neid ikka lugeda.

1. Bränding: värvid ja paigutus failis src/ui/style.css ning sinu logo. Valge silt (white label) on lubatud, seega sinu bränd võib meie asendada.
2. Tekstid: src/i18n/locales.ts, sinu tarnitavate keelte jaoks.
3. Turnee: kohtade järjekord ja see, mis mida avab, failis campaign.ts.
4. Raskusaste: ajastusaknad failis judge.ts, seejärel punkti- ja kombo reeglid failis scoring.ts.
5. Laulud: viimasena, sest iga uus kaart vajab täielikku läbimängimist.

Tee enne muutmist varukoopia, muuda korraga ühte funktsiooni ja testi pärast iga muudatust menüüd, laulu, pausi, tulemuste ekraani ja lehe uuesti laadimist. Hoia eseme id-d ja salvestusvõtmed stabiilsena, et olemasolevad mängijad säilitaksid oma rekordid.

Majutus või manustamine portaali

Laadi game/ sisu oma HTTP(S) hosti kaustale, säilita suhtelised teed ja ava aadress. PHP-d, andmebaasi ega kontot pole vaja. Ära ava index.html-i file:// kaudu; kohaliku testi jaoks käivita game/ kaustas python -m http.server 8765.

• Brauser vajab: JavaScripti, ES-mooduleid, Canvas 2D-d ja Web Audio'd.
• Brauserid avavad heli alles pärast esimest puudutust või klõpsu, seega on vaikne esimene ekraan normaalne.
• Iframe'is luba täisekraan ja automaatne esitus.
• Serveeri .js-faile JavaScripti MIME-tüübiga, mitte kunagi text/plain-ina.
• Kõik käitusaja varad, fondid ja teegid on koostises. Kohustuslikku CDN-i ei ole, kuid see ei ole installeeritav võrguvaba rakendus.

Salvestised kuuluvad brauseri päritolule, seega mängu kolimine teise domeeni alustab mängijaid nullist. Selles väljaandes on oma salvestusvõtmed, erinevad meie portaalide väljaannetest. Natiivseid rakenduste projekte ei ole kaasas; poe väljaanne on eraldi töö.

Mida väljaanne ei sisalda

Riffvolt on kohalik brauseriväljaanne. Sellel ei ole võrgutubasid ega mitmikmängu, võrgus tulemustetabelit ega jagatud edetabelit, reklaami-SDK-d ega kontot, kaardiredaktorit, natiivseid rakendusi ega hostimisteenust. Isiklikud rekordid ja turnee edusammud jäävad mängija brauserisse.

Kui muusikamäng sobib su kataloogi, võivad sellele kõrvale sobida veel kaks meie ajastusel põhinevat malli.

Pinloop: ühe nupuga ajastusarkaad 30 sihtmärgiga

Ricopop: põrkeliigutusega arkaadmäng 50 tasemega

Litsents ja hind

Riffvolt on tavahinnaga 49 $. Kuni 30. novembrini 2026 kehtib Black Friday soodustus 15%, seega maksab see 41,65 $, ja kahe või enama malli tellimusel tuleb veel 5% kuni 20% kogumi soodustust. Litsents on igavesti kehtiv ja mitteeksklusiivne, ühe lõpptoote kohta, kas sinu või ühe kliendi oma. Võid muuta koodi, graafikat ja heli, asendada meie brändi enda omaga ning pakkuda mängu tasuta või reklaamidega. Kaasasolevaid laule kasuta selle lõpptoote osana; malli, selle koodi ega varasid eraldi edasi müüa ei tohi. Tugi kestab kuus kuud või kaksteist koos laiendusega; uued laulud, integratsioonid ja majutus pakutakse eraldi.

Loe litsentsitingimusi täielikult

Korduma kippuvad küsimused

Kas saan rütmimängu lähtekoodi lisada oma laule?

Jah. Lisa heli, üks kaart iga raskusastme kohta ja kirje faili public/manifest.json, valideeri kaardid, mängi need läbi ja koosta siis uuesti. Kaardiredaktorit ei ole kaasas.

Kas Riffvolti kasutamiseks vajan Node.js-i?

Antud mängukausta majutamiseks ei vaja. Node.js 24 LTS on soovitatav ainult uuesti koostamiseks pärast TypeScripti muutmist või laulude lisamist.

Kas see töötab puuteekraanide ja mängupultidega?

Jah. Mängijad saavad puudutada radu või kasutada mängupulti ning juhtnupud seatakse jaotises Settings (seaded). Jõudlus sõltub seadmest, seega testi neid, mida sihid.

Mis saab Bluetooth-kõrvaklappide ja viivituse (latency) puhul?

Seadetes on helikalibreerimine, mis seab heli nihke ja aitab Bluetooth-kõrvaklappide puhul.

Kas on võrgus edetabelit?

Ei. Isiklikud rekordid salvestatakse loo ja raskusastme kaupa mängija brauserisse. Kaugvastaseid ega jagatud edetabeleid ei ole.

Kellele see sobib

Riffvolt sobib portaalile või saidile, mis tahab kataloogi muusikamängu, stuudiole, mis tarnib ühele kliendile brändiga rütmimängu, ja arendajale, kes tahab lugeda, kuidas Canvas 2D ja Web Audio mäng hindab TypeScriptis ajastust. Nõrgem sobivus on siis, kui vajad mittearendajatele visuaalset kaardiredaktorit või võrgus võistlemist; mõlemad on kohandatud töö.

Mängi Riffvolti demot ja osta litsents

Uued laulud või brändiga versioon? Küsi pakkumist