Kodici sors tal-logħba rhythm: notes, timing u kif iżżid kanzunetti

Il-kodici sors tal-logħba rhythm huwa fil-verità żewġ affarijiet: il-kodiċi li jiġġudika t-timing, u d-dejta li tgħid meta kull nota tasal. Il-bejjiegħa kważi dejjem iridu jbiddlu t-tieni, għax il-kanzunetti ġodda huma dak li jagħmel logħba rhythm tiegħek. Riffvolt, it-template tagħna tar-rock rhythm b'erba' linji, iżomm il-lista tal-kanzunetti f'manifest wieħed u kull chart tan-notes fil-fajl tiegħu, allura żieda ta' kanzunetta hija xogħol ta' dejta b'checklist ċara.

Din il-gwida timxi fuq il-pakkett: x'jilgħab, fejn jinsabu t-timing u l-punteġġ, kif iżżid kanzunetta, kif terġa' tibni u tospita, x'tippermetti l-liċenzja u x'ma tinkludix l-edizzjoni. Ismijiet tal-fajls ġejjin mill-gwida tal-bejjiegħ li tiġi mal-logħba.

Fatt wieħed li għandek iżżomm f'moħħok mill-bidu: differenti minn xi wħud mit-templates tagħna, Riffvolt jeħtieġ build mill-ġdid wara li tbiddel is-sors jew iżżid kanzunetti. Li tospita l-fowlder tal-logħba mogħti ma jeħtieġ xejn ħlief host statiku tal-web.

X tilgħab dan il-kodici sors tal-logħba rhythm

Riffvolt huwa logħba rhythm rock b'erba' linji, lesta għall-browser. Il-plejers jilagħbu n-notes fil-ħin, iżommu n-notes twal sal-aħħar, idawwruhom bil-whammy u jimlew il-ROCK gauge li jibda l-overdrive: wirja ta' dwal li ma tagħti l-ebda punti u tispiċċa f'kull għajbien. L-akkuratezza tat-timing tibni l-punteġġ u l-combo.

• 12-il track sħiħ, kull wieħed b'chart Easy, Normal u Hard, u Rock God, li jinfetaħ wara t-tour: 48 chart tan-notes b'kollox.
• Tour minn erba' venues (Garage, The road, Festival u Arena), tliet kanzunetti għal kull wieħed. L-istilel mill-ewwel tnejn jiftħu l-encore, u li tlesti l-encore tiftaħ il-venue li jmiss, b'xeni tal-istorja u premijiet kosmetiċi bħal trails u frames.
• Free play: kull kanzunetta f'kull diffikultà, b'rekords personali maħżuna kanzunetta b'kanzunetta fil-browser.
• Kontrolli: D, F, J u K b'default, it-tapping tal-linji fuq screen tat-touch, jew gamepad. Il-key bindings jinsabu f'Settings.
• Komdu: kalibrazzjoni tal-awdjo għall-offset, li tgħin b'headphones Bluetooth, moviment imnaqqas u mod fotosensittiv li jnaqqas il-flashes u l-bruqi.
• 14-il lingwa tal-interface.

Ara l-paġna ta' Riffvolt, id-demo u l-manwals

Kif huma organizzati l-fajls

Id-download fih game/ (il-fajls li titqiegħed fuq server), source/ (il-proġett TypeScript), documentation/ (manwals illustrati bl-Ingliż u bil-Portugiż) u licenses/ (avviżi ta' partijiet terzi). Ġewwa source/, il-qasma bejn id-dejta tal-kanzunetti u l-loġika tal-logħba hija nadifa.

• public/manifest.json: il-katalgu tal-kanzunetti, b'id-durata ta' kull kanzunetta, il-verżjoni tal-awdjo u l-paths tal-charts.
• public/charts/: l-48 chart tan-notes.
• public/audio/: ir-reġistrazzjonijiet tat-track.
• src/core/chartValidate.ts: l-iskema tal-chart u l-verifika tat-timing.
• src/core/judge.ts: il-ġudizzji tat-timing.
• src/core/scoring.ts: ir-regoli tal-punteġġ u tal-combo.
• src/game/campaign.ts: il-progressjoni tat-tour.
• src/game/session.ts: iċ-ċiklu ta' kanzunetta u l-kalkolu tar-riżultat.
• src/i18n/locales.ts: id-dizzjunarji tal-interface fl-14-il lingwa.
• src/net/localRecords.js: ir-rekords personali lokali.
• src/ui/style.css: l-interface u l-layout responsive.

Għax il-judge u l-punteġġ huma fajls separati, tista' tagħmel it-tieqa tat-timing aktar stretta jew aktar tolleranti mingħajr ma tmiss kif jiżdiedu l-punti, u viċi versa. Dik hija l-qasma li għandek tfittex f'kull kodiċi rhythm.

Iż-żieda ta' kanzunetta tiegħek, pass pass

Din hija l-bidla li l-bejjiegħa tar-rhythm jistaqsu dwarha l-ewwel. Ma hemm l-ebda editur tal-chart fil-pakkett, allura l-charts miktuba bħala dejta, u l-manwal jelenka eżattament x'jeħtieġ kull fajl.

1. Poġġi r-reġistrazzjoni f'public/audio/. Uża biss awdjo li għandek id-drittijiet tiegħu għall-prodott finali tiegħek.
2. Oħloq chart wieħed għal kull diffikultà appoġġjata f'public/charts/. Kull chart irid il-songId korrispondenti, id-difficulty, l-audioVersion, l-offset u n-notes f'ordni.
3. Żid il-kanzunetta f'public/manifest.json b'id uniku, durata, BPM, tema, audioVersion u l-paths tal-charts.
4. Iċċekkja kull chart mal-validator f'chartValidate.ts.
5. Ilgħab it-track sħiħ f'kull diffikultà biex tikkonferma s-sinkronizzazzjoni. Il-validator jiċċekkja l-istruttura u r-regoli tat-timing, mhux jekk nota thossx tajba.
6. Ibni mill-ġdid, imbagħad uplowda l-build il-ġdid.

Jekk trid saundtrack sħiħ ġdid minflok kanzunetta żejda, ippjana x-xogħol skont il-chart: 12-il kanzunetta f'erba' diffikultajiet huma 48 chart, u kull wieħed jeħtieġ play-through sħiħ qabel ir-rilaxx.

Terġa' tibni u x'tista' tibdel ieħor

Node.js 24 LTS huwa rakkomandat. Ġewwa source/, mexxi npm ci, imbagħad npm run typecheck u npm run build, u ippubblika biss il-kontenut ta' dist/. npm run preview iservi l-build lokali għall-ispezzjoni. Tgħabbix node_modules/. Vite juża base relattiv, allura l-build jaħdem f'subfolder. Ir-runtime mogħti huwa ffurmattjat biex jinqara; il-manwal jitlob li tħalli minify:false u cssMinify:false meta terġa' tibni, sabiex il-persuna li jmiss tibqa' tistaʼ taqrah.

1. Brand: kuluri u layout f'src/ui/style.css, flimkien mal-logo tiegħek. White label huwa permess, allura l-brand tiegħek jista' jieħu post tagħna.
2. Testi: src/i18n/locales.ts, għal-lingwi li tibgħat.
3. Tour: l-ordni tal-venues u dak li jiftaħ x', f'campaign.ts.
4. Diffikultà: it-tieqat tat-timing f'judge.ts, imbagħad ir-regoli tal-punteġġ u tal-combo f'scoring.ts.
5. Kanzunetti: l-aħħar, għax kull chart ġdid jeħtieġ play-through sħiħ.

Agħmel backup qabel teditja, ibdel karatteristika waħda kull darba, u ittestja l-menu, kanzunetta, pause, l-iskrin tar-riżultat u reload wara kull bidla. Żomm l-IDs tal-oġġetti u s-save keys stabbli, sabiex il-plejers eżistenti jżommu r-rekords tagħhom.

Hosting, jew embedding f'portal

Itgħabba l-kontenut ta' game/ f'fowlder fuq l-host HTTP(S) tiegħek, żomm il-paths relattivi u fetaħ l-indirizz. M'hemm bżonn ta' PHP, database jew kont. Tiftaħx index.html permezz ta' file://; għal test lokali, mexxi python -m http.server 8765 ġewwa game/.

• Il-browser irid: JavaScript, ES modules, Canvas 2D u Web Audio.
• Il-browsers jiftħu l-awdjo biss wara l-ewwel tap jew klikk, allura skrin ewwel bla ħoss huwa normali.
• Ġewwa iframe, ħalli l-fullscreen u l-autoplay.
• Servi l-.js b'JavaScript MIME type, qatt bħala text/plain.
• L-assi kollha tar-runtime, il-fonts u l-librerijiet jinsabu ġewwa l-build. M'hemm l-ebda CDN obbligatorju, imma din mhix app offline li tista' tiġi installata.

Is-salvataġġi jappartjenu lill-origin tal-browser, allura jekk tmexxi l-logħba għal dominju ieħor il-plejers jibdew mill-bidu. Din l-edizzjoni tuża s-save keys tagħha stess, separati mill-edizzjonijiet tal-portal tagħna. Il-proġetti tal-app nattivi m'humiex inklużi; il-ħruġ fil-ħanut huwa xogħol separat.

Dak li l-edizzjoni ma tinkludix

Riffvolt hija l-edizzjoni lokali tal-browser. M'għandhiex kmamar online jew multiplayer, l-ebda klassifika online jew leaderboard kondiviż, l-ebda SDK tar-reklami jew kont, l-ebda editur tal-charts, l-ebda app nattiva u l-ebda hosting. Ir-rekords personali u l-progress tat-tour jibqgħu fil-browser tal-plejer.

Jekk logħba tal-mużika taqbel mal-katalgu tiegħek, żewġ templates oħra tagħna bbażati fuq it-timing jistgħu jmorru tajjeb magħha.

Pinloop: logħba arkada tat-timing b'buttuna waħda u 30 target

Ricopop: logħba arkada ta' ricochet b'50 livell

Liċenzja u prezz

Riffvolt jiswa $49 bil-prezz ta' lista. Sal-30 ta' Novembru 2026 il-promozzjoni tal-Black Friday tnaqqas 15%, allura jiswa $41.65, u jekk tixtri tnejn jew aktar templates f'ordni waħda tikseb tnaqqis ta' bundle minn 5% sa 20%. Il-liċenzja hija perpetwa u mhux esklussiva, għal prodott finali wieħed, tiegħek jew ta' klijent wieħed. Tista' tibdel il-kodiċi, l-arti u l-awdjo, tissostitwixxi l-brand tagħna bit-tiegħek, u toffri l-logħba b'xejn jew bir-reklami. Uża t-tracks inklużi bħala parti minn dak il-prodott finali; ma tistax terġa' tbigħ it-template, il-kodiċi tiegħu jew l-assi tiegħu waħedhom. Sitt xhur ta' support huma inklużi, jew tnax bl-estensjoni; kanzunetti ġodda, integrazzjonijiet u hosting jiġu kkwotati separatament.

Aqra t-termini sħaħ tal-liċenzja

Mistoqsijiet frekwenti

Nista' nżid kanzunetti tiegħi mal-kodiċi sors tal-logħba rhythm?

Iva. Żid l-awdjo, chart wieħed għal kull diffikultà u entry f'public/manifest.json, ivvalida l-charts, ilgħabhom kollha, imbagħad ibni mill-ġdid. Editur tal-charts mhuwiex inkluż.

Neħtieġ Node.js biex nuża Riffvolt?

Mhux biex tospita l-fowlder tal-logħba mogħti. Node.js 24 LTS huwa rakkomandat biss biex terġa' tibni wara li tbiddel it-TypeScript jew iżżid kanzunetti.

Jaħdem ma' screens tat-touch u gamepads?

Iva. Il-plejers jistgħu jilmsu l-linji jew jużaw gamepad, u l-kontrolli jiġu ssettjati fis-Settings. Il-prestazzjoni tiddependi mill-apparat, allura ittestja dawk li timmira għalihom.

X'jingħad dwar headphones Bluetooth u latency?

Is-Settings fihom kalibrazzjoni tal-awdjo, li tissettja l-offset tal-awdjo u tgħin b'headphones Bluetooth.

Hemm klassifika online?

Le. Ir-rekords personali jinħażnu skont il-kanzunetta u d-diffikultà fil-browser tal-plejer. M'hemm l-ebda avversarji remoti jew klassifiki kondiviżi.

Min għandu jixtri

Riffvolt jaqbel ma' portal jew sit li jrid logħba tal-mużika fil-katalgu tiegħu, studjo li jwassal logħba rhythm bil-brand għal klijent wieħed, u żviluppatur li jrid jaqra kif logħba Canvas 2D u Web Audio tiġġudika t-timing f'TypeScript. Jaqbel inqas jekk teħtieġ editur viżwali tal-charts għal nies li mhumiex żviluppaturi, jew kompetizzjoni online; it-tnejn huma xogħol personalizzat.

Ipprova d-demo ta' Riffvolt u ixtri l-liċenzja

Kanzunetti ġodda jew verżjoni bil-brand? Itlob kwotazzjoni