Kodiċi tas-sors ta' logħba HTML5: ftaħna pakkett veru

Il-kodiċi tas-sors ta' logħba HTML5 jista' jfisser tliet affarijiet differenti: build lest biex jitla', il-fajls tal-iżviluppatur li teditja, jew proġett li jinfetaħ biss f'editur partikolari. Mudell ta' logħba HTML5 bil-kodiċi tas-sors mill-marketplace tagħna huwa l-ewwel tnejn flimkien, bħala fajls tal-web sempliċi, u din il-gwida tiftaħ pakketti veri biex turi kif jidher dan.

Aħna nbigħu dawn il-mudelli, għalhekk aqra dan bħala żjara fil-pakketti tagħna stess, mhux stħarriġ newtrali tas-suq. Għaddejna minn diversi edizzjonijiet, l-aktar Velvet Pool, Puttide u Sunset Rally, qrajna l-manwali pubbliċi tagħhom u t-termini tal-ħanut, u ktibna x'hemm fil-kaxxa, x'għandek bżonn biex tħaddimha u x'mhux hemm. Kull manwal huwa marbut mill-paġna tal-oġġett tiegħu, għalhekk tista' tiċċekkja kull linja qabel tħallas.

Xi jista' jfisser “kodiċi tas-sors ta' logħba HTML5”

Il-bejjiegħa jużaw il-kliem kodiċi tas-sors b'mod laxk. Tliet mistoqsijiet jiċċaraw x'qed jinbiegħ verament.

Build, sors għall-iżviluppatur, jew it-tnejn?

Build huwa l-logħba lesta kif jitellagħha l-brawżer: index.html, scripts, stampi u fajls tal-ħoss. Tista' tospitah kif inhu. Is-sors għall-iżviluppatur huwa l-verżjoni magħmula biex in-nies jeditjawha, bil-fajls maqsuma skont ix-xogħol tagħhom. Pakkett bil-build biss huwa xi ħaġa li tista' ttella' imma ma tistax tbiddel b'mod komdu. Pakkett bis-sors biss jista' jeħtieġ għodod qabel ma jaħdem xejn. L-edizzjonijiet f'din il-gwida jpoġġu t-tnejn f'ZIP wieħed: normalment folder game/ biex tippubblika u folder source/ biex teditja (f'Ricopop, game/ huwa nnifsu s-sors).

Jinqara jew minifikat?

Il-minifikazzjoni tagħfas l-iscripts fi ftit linji densi b'ismijiet qosra, li jitniżżlu aktar malajr u jinqraw ħażin ħafna. L-offuskazzjoni tmur pass 'il quddiem u tħawwad l-ismijiet apposta. L-ebda waħda minnhom ma tagħmel ħsara lil sit live. It-tnejn jagħmlu ħsara jekk xtrajt il-kodiċi biex tbiddlu. Qabel tħallas, iftaħ script wieħed tad-demo diretta fid-developer tools tal-brawżer tiegħek u ara jekk tistax issegwih.

Fajls sempliċi jew proġett ta' editur?

Xi mudelli jaslu bħala proġett għal editur speċifiku tal-logħob, u tista' tiftaħhom biss f'dak l-editur. Oħrajn huma fajls tal-web sempliċi li jiftaħhom kwalunkwe editur tal-kodiċi. L-edizzjonijiet f'din il-gwida huma mit-tieni tip: HTML, CSS, JavaScript u JSON, b'TypeScript f'xi wħud minnhom.

Ara l-mudelli

X'hemm f'pakkett ta' Polar Games

Ħu Velvet Pool, l-edizzjoni tal-biljard 8-ball tagħna. Il-manwal tiegħu jiddeskrivi erba' folders fiz-ZIP:

• game/ huwa l-edizzjoni lesta għat-tlugħ u l-uniku folder li tippubblika.
• source/ huwa l-istess logħba bħala edizzjoni editjabbli għall-iżviluppaturi, b'README, package.json u testijiet.
• documentation/ fih il-gwida illustrata u l-istampi tagħha.
• THIRD-PARTY-LICENSES/ fih it-testi tal-liċenzji tal-fonts u sommarju README.txt.

Fil-librerija tiegħek l-istess pakkett huwa offrut bħala żewġ tniżżiliet: il-pakkett komplut (sors u manwal) jew il-logħba biss, lesta biex tiġi ospitata.

game/ u source/ għandhom l-istess struttura. Għal Velvet Pool il-manwal jgħid li teditja l-fajls f'source/ u tikkopja dawk mibdula fl-istess mogħdija f'game/. Xejn ma jiġi kkompilat bejniethom.

Ara l-edizzjoni ta' Velvet Pool

Ġewwa Velvet Pool: il-mappa tal-fajls

Mappa tal-fajls hija l-irħas mod kif tiġġudika codebase qabel tixtrih. Din hija dik fil-manwal ta' Velvet Pool, b'mogħdijiet relattivi għal source/ jew game/:

• src/core/physics.js: is-simulazzjoni tal-blalen, l-ispin u r-reazzjoni tal-bordura.
• src/core/rules.js: ir-regoli tal-8-ball u d-deċiżjonijiet dwar il-fouls.
• src/core/ai.js: kif is-CPU jagħżel tir.
• src/game/controls.js: l-input tal-immirar, tal-qawwa u tal-ispin.
• src/game/progress.js: il-kisbiet, id-drappijiet, l-istikek u l-punteġġ tal-logħbiet.
• src/game/i18n.js: it-test f'14-il lingwa.
• src/game/localRecords.js: l-istorja lokali tal-punteġġi.
• src/game/audio.js: l-effetti tal-ħoss u d-daqq tal-mużika.
• css/style.css u css/fonts.css: it-tema, il-layout responsiv u d-dikjarazzjonijiet tal-fonts.
• assets/: arti, awdjo u fonts, b'subfolder logo/.

Innota l-qasma. Ir-regoli, il-fiżika u s-CPU jgħixu f'src/core. L-input, is-saves, it-testi u l-ħoss jgħixu f'src/game. Il-manwal jitolbok tbiddel karatteristika waħda kull darba, u din l-istruttura tagħmel dan realistiku: tibdila fil-bordura u korrezzjoni fit-traduzzjoni jmissu fajls differenti.

Il-manwal jgħid ukoll li l-kodiċi f'source/src u game/src huwa JavaScript sempliċi u ffurmatjat, mingħajr fajls minifikati jew bundled. Velvet Pool huwa Vanilla JavaScript fuq WebGL2 u ma juża l-ebda librerija tal-kodiċi, inkluż Three.js. Il-changelog jikkonferma dan: il-verżjoni 1.0.1 qasmet strings twal ta' linja waħda fl-awdjo, fit-traduzzjonijiet u fix-shaders f'linji li jinqraw, mingħajr bidla fl-imġiba.

Puttide: l-istess struttura, flimkien ma' libreriji

Puttide, l-edizzjoni tal-mini golf 3D tagħna, juża l-istess erba' folders u jżid ħaġa waħda: żewġ libreriji ta' terzi li teħtieġ il-logħba. Three.js r186 (MIT) u Rapier 3D 0.21.0 (Apache-2.0) jinsabu f'lib/three/ u lib/rapier/, u l-import map f'index.html tgħid lill-brawżer fejn isibhom. Il-FAQ ta' Puttide tgħid li xejn ma jitla' minn CDN, għalhekk il-logħba teħtieġ biss il-host tiegħek. Il-manwal iżid li l-fajls tal-libreriji huma ffurmatjati biex jinqraw, bl-imġiba mhux mibdula.

Il-mappa tal-fajls tiegħu, għal darb'oħra relattiva għal source/ jew game/:

• src/course/courses.js: l-ordni tal-korsijiet u r-rekwiżiti biex jinfetħu.
• src/course/holes.js: il-ġeometrija, il-par u l-ostakli tal-kors Ruins. pier.js, ice.js, lava.js u sky.js fihom l-erba' l-oħra.
• src/sim/constants.js: l-irfinar tal-fiżika.
• src/game/economy.js: id-definizzjonijiet u l-prezzijiet tal-blalen, tat-trails u tal-ilbiesi.
• src/ui/i18n.js u tliet fajls oħra ta' dizzjunarju: it-test tal-lingwi.
• css/style.css: il-kuluri tal-interfaċċja, il-fonts u l-istili responsivi.
• fonts/ u music/: il-web fonts bil-liċenzji tagħhom u żewġ binarji tal-mużika.

Ir-riċetta tal-manwal għal toqba ġdida: idduplika definizzjoni fil-fajl tal-kors it-tajjeb, agħtiha id uniku, issettja l-par, il-pożizzjonijiet tat-tee u tat-toqba, żidha mal-kors, imbagħad żid isimha u l-parir tagħha mad-dizzjunarji tal-lingwi. Aqra riċetta bħal din qabel tixtri. Jekk tidher xogħol li tista' tagħmel, il-pakkett jaqbillek.

Ara l-edizzjoni ta' Puttide

Meta s-sors jeħtieġ pass tal-build

“L-ebda pass tal-build” huwa minnu għal xi edizzjonijiet u mhux għal oħrajn, għalhekk iċċekkja l-edizzjoni, mhux il-ħanut. Hawn ħamsa minn tagħna ħdejn xulxin, bil-prezzijiet tal-lista tagħhom. Il-ħanut tagħna bħalissa juri 10% inqas mill-prezz tal-lista, l-offerta tal-prezz dirett mill-istudjo f'kull paġna ta' oġġett: Velvet Pool, pereżempju, juri $35.10 minflok $39.

• Velvet Pool, prezz tal-lista $39: moduli JavaScript sempliċi fuq WebGL2. Editja source/, ikkopja f'game/. Node.js 20+ biss għat-testijiet fakultattivi.
• Puttide, $39: moduli JavaScript sempliċi b'Three.js u Rapier f'lib/. L-ebda pass tal-build. Node.js huwa fakultattiv u biss biex timmaniġġja l-verżjonijiet tal-libreriji.
• Ricopop, $39: moduli HTML, CSS u JavaScript sempliċi, u game/ huwa nnifsu s-sors. Għodod fakultattivi għall-iżviluppaturi (Node.js 20+): server lokali, kontrollur tal-livelli u testijiet.
• Pinloop, $24: TypeScript b'Vite. Il-folder game/ fih JavaScript u CSS li jinqraw. Node.js 22.12+ u npm biss biex teditja u terġa' tibni s-sors.
• Sunset Rally, $39: TypeScript b'Three.js r184 u Vite. Il-folder game/ huwa diġà mibni u mhux minifikat. Node.js biss jekk terġa' tibni.

Għal Sunset Rally il-manwal jirrakkomanda Node.js 24 LTS. Ġewwa source/ tħaddem npm ci, npm run typecheck u npm run build, imbagħad tippubblika biss il-kontenut ta' dist/. Jitolbok ukoll iżżomm minify u cssMinify mitfija meta terġa' tibni, għax ir-runtime mogħti huwa ffurmatjat biex jinqara. Tella' r-riżultat, qatt node_modules/.

Ara l-edizzjoni ta' Sunset Rally

L-hosting: xi jfisser “statiku” fil-prattika

Hosting statiku jfisser li l-host tiegħek iservi biss fajls. Il-manwali ta' Velvet Pool u Puttide jagħtu l-installazzjoni kollha fi tliet passi:

1. Iftaħ (extract) iz-ZIP.
2. Tella' kollox minn ġewwa game/ f'folder fuq is-sit tiegħek, pereżempju public_html/velvet-pool/, bl-FTP jew bil-file manager tal-host tiegħek, billi żżomm is-subfolders.
3. Iftaħ dak l-indirizz fi brawżer.

M'hemm bżonn l-ebda npm, terminal, pass tal-build, PHP, database jew kont. Dak li jfixkel lin-nies, skont l-istess manwali:

• Tagħfasx darbtejn fuq index.html. Il-brawżers jimblukkaw il-moduli tal-logħba fuq file://. Għal test lokali, ħaddem python -m http.server 8765 ġewwa game/ u iftaħ http://localhost:8765/.
• Is-server tiegħek irid jibgħat il-fajls .js b'tip MIME ta' JavaScript u .wasm bħala application/wasm. Tip MIME ħażin jidher bħala żball ta' modulu rrifjutat.
• Uża HTTPS għall-hosting pubbliku.
• Is-saves jappartjenu lill-oriġini tal-brawżer (protokoll, host u port). Iċċaqlaq il-logħba għal dominju ieħor u l-plejers jibdew minn żero.
• Tlugħ ġdid tal-paġna xorta jeħtieġ il-host tiegħek, għalhekk din mhix app offline li tista' tiġi installata.

Fejn jinsabu l-logo, il-kuluri, ir-regoli u t-traduzzjonijiet

Kull manwal għandu taqsima dwar l-adattament, u dak li tkopri jvarja minn edizzjoni għal oħra. Dan hu dak li jgħid kull wieħed.

Velvet Pool

• Logo u marka: ibdel il-fajls f'assets/logo/ u aġġusta d-dimensjonijiet korrispondenti fis-CSS.
• Stili tad-drapp u tal-istikka: id-definizzjonijiet tagħhom jinsabu f'progress.js. Żomm l-IDs tal-oġġetti stabbli biex il-kosmetiċi ssejvjati jibqgħu jaħdmu.
• L-imġiba tas-CPU f'ai.js, il-fiżika f'physics.js. Wara li tbiddel ir-regoli jew il-fiżika, ħaddem it-testijiet tal-8-ball.
• Traduzzjonijiet: src/game/i18n.js, bil-lista tal-lingwi f'LANGS.

Puttide

• Kuluri u fonts: css/style.css.
• Fiżika: src/sim/constants.js. Prezzijiet tal-kosmetiċi: src/game/economy.js, billi żżomm l-IDs eżistenti.
• Mużika: ikkopja fajl b'liċenzja f'music/ u aġġorna l-mapping tal-binarji f'src/audio/audio.js.
• Toqob, par u dak li jinfetaħ: il-fajls tal-korsijiet deskritti hawn fuq.

Gridspark u Sunset Rally

F'Gridspark, skont il-FAQ tal-oġġett tiegħu, it-test tal-interfaċċja jinsab f'src/locales.js, il-kostanti tar-regoli u l-paletta f'src/config.js, u r-regoli tal-puzzle f'game.js, board.js, generator.js u shapes.js. F'Sunset Rally il-logħbiet tal-kampanja u l-kundizzjonijiet tal-istilel jinsabu f'Campaign.ts, il-postijiet f'Places.ts, il-fiżika f'physics.ts u l-punteġġ f'match.ts. L-istrings bl-Ingliż u bil-Portugiż tiegħu jinsabu f'src/i18n.ts, it-12-il lingwa l-oħra f'src/locales/.

Innota x'iħallu barra l-manwali. Il-manwal ta' Puttide jkopri l-kuluri, il-fiżika, it-toqob, il-prezzijiet u l-mużika, imma m'għandux pass biex tibdel il-logo, u l-manwal ta' Sunset Rally m'għandux taqsima apposta għall-marka. Jekk il-marka hija l-ewwel ħaġa li se tbiddel, staqsi qabel tixtri.

Ara l-edizzjoni ta' Gridspark

Testijiet awtomatiċi: x'jiċċekkjaw u x'ma jiċċekkjawx

Il-folder source/ ta' Velvet Pool jinkludi sett ta' testijiet. B'Node.js 20 jew aktar ġdid, iftaħ terminal ġewwa source/ u ħaddem npm test, li huwa l-istess bħal node tests/run.js. M'hemm bżonn tinstalla l-ebda dipendenza. Skont il-manwal, is-sett jiċċekkja l-fiżika, ir-regoli tal-8-ball, il-logħbiet kontra s-CPU u l-konsistenza taċ-ċwievet tat-traduzzjoni, u ma jissostitwixxix it-testijiet fil-brawżers u fuq apparati veri.

Kontroll taċ-ċwievet tat-traduzzjoni huwa t-tip ta' test li teħtieġ logħba b'14-il lingwa: iżżid ċavetta f'lingwa waħda, tinsa oħra, u bniedem jista' ma jindunax għal ġimgħat.

Mhux kull edizzjoni għandha testijiet. Il-manwal ta' Puttide ma jiddeskrivi l-ebda wieħed, biss kontrolli manwali. Pinloop u Beep Out jelenkaw npm test fost il-kmandi għall-iżviluppaturi tagħhom, u l-għodod għall-iżviluppaturi ta' Ricopop jinkludu kontrollur tal-livelli.

Liċenzja, avviżi ta' terzi u l-changelog

Taħt it-termini tal-ħanut, kull xiri jagħti liċenzja perpetwa u mhux esklussiva biex tuża l-edizzjoni fi prodott finali wieħed, tiegħek jew ta' klijent wieħed. Tista' tbiddel il-kodiċi, l-arti u l-awdjo ġewwa fih, u l-plejers jistgħu jużawh b'xejn jew permezz tar-reklamar. Ma tistax terġa' tbigħ, taqsam jew tqassam mill-ġdid il-mudell, is-sors tiegħu jew l-assi tiegħu waħedhom, bħala mudell, kit jew pakkett ta' assi, jew ġo prodott ieħor maħsub għall-iżviluppaturi. Il-liċenzja ma tiskadix meta jintemm l-appoġġ.

Il-partijiet ta' terzi jżommu l-liċenzji tagħhom, u int iżżomm l-avviżi tagħhom mal-prodott tiegħek. F'Velvet Pool dan ifisser żewġ fonts, Manrope u Fraunces, taħt is-SIL Open Font License 1.1, bit-testi f'THIRD-PARTY-LICENSES/ u ħdejn il-fonts. F'Puttide l-lista żżid Three.js (MIT), Rapier (Apache-2.0) u l-fonts Rubik u Fredoka (OFL 1.1).

Il-changelog juri kif pakkett jiġi mieħu ħsiebu. Velvet Pool 1.0.1 (18 ta' Ottubru 2026) qasam strings twal f'linji li jinqraw u ġabar l-avviżi tal-liċenzji f'folder wieħed ċatt. Il-verżjoni 1.1.0 (22 ta' Ottubru 2026) ġabet l-interfaċċja għal 14-il lingwa. Dawk id-daħliet jinsabu fil-paġna tal-oġġett. It-termini jgħidu li l-aġġornamenti tal-istess edizzjoni jidhru fil-librerija tiegħek meta jiġu ppubblikati, mingħajr wegħda ta' aġġornamenti għal perjodu fiss.

Kif taqra l-kodiċi ta' logħba li xtrajt f'siegħa

Dan huwa pjan issuġġerit, mhux ħin imwiegħed. Isegwi l-istruttura ta' Velvet Pool u juża biss dak li jagħtik il-pakkett.

1. Minuti 0 sa 10: iftaħ iz-ZIP, agħti ħarsa lejn ir-README f'source/ u lejn il-mappa tal-fajls tal-manwal. Iftaħ index.html u ara liema scripts u stylesheets jitella'.
2. Minuti 10 sa 20: ħaddem npm test ġewwa source/ (Node.js 20+) biex ikollok bażi ħadra.
3. Minuti 20 sa 35: aqra src/core qabel src/game. Ibda b'rules.js, imbagħad ai.js, imbagħad physics.js. Dik hija l-logħba nnifisha. Il-kontrolli, il-progress, it-testi u l-ħoss huma l-plumbing madwarha.
4. Minuti 35 sa 40: innota li l-IDs tal-oġġetti u ċ-ċwievet tas-saves iridu jibqgħu stabbli, inkella l-plejers jitilfu l-kosmetiċi ssejvjati tagħhom.
5. Minuti 40 sa 55: agħmel bidla żgħira, bħal definizzjoni ta' drapp f'progress.js. Ikkopja l-fajl fl-istess mogħdija f'game/, servi game/ b'python -m http.server 8765 u ħares lejn ir-riżultat. Qatt tiftħu permezz ta' file://.
6. Minuti 55 sa 60: erġa' ħaddem it-testijiet.

L-ES modules isemmu dak li għandhom bżonn fil-linji tal-import tagħhom, għalhekk tista' ssegwi l-katina mill-ewwel script li titella' l-paġna. Għalhekk edizzjoni b'fajls sempliċi tista' tinqara b'dan ir-ritmu.

Mistoqsijiet li għandek tagħmel qabel tixtri kodiċi tas-sors

• Nista' naqra l-manwal u nilgħab demo qabel inħallas? Għall-edizzjonijiet tagħna, it-tnejn huma marbuta mill-paġna tal-oġġett.
• Hemm build lest biex jiġi ospitat u sors separat għall-iżviluppatur?
• Il-kodiċi jinqara jew huwa minifikat? Iftaħ script wieħed u ħares.
• Għandi bżonn Node.js, npm, PHP jew database, u liema verżjonijiet?
• Il-logħba ttella' xi ħaġa minn CDN jew minn sit ieħor?
• Liema libreriji ta' terzi hemm ġewwa, u taħt liema liċenzji?
• F'kemm-il proġett nista' nużah, u nista' nqassmu mill-ġdid?
• Kemm idum l-appoġġ u x'ikopri? Tagħna huwa 6 xhur, jew 12 bl-estensjoni magħżula fil-ħlas, u jkopri mistoqsijiet dwar l-installazzjoni u l-użu tal-fajls u difetti li jistgħu jiġu riprodotti.
• X'inhu mħolli barra?
• Hemm changelog u rilaxx riċenti?
• X'inhi r-regola tar-rimborż? Tagħna: il-mudelli huma prodotti diġitali, għalhekk nirrimborżaw biss jekk għadek ma niżżiltx il-mudell, jew jekk għandu difett li ma nistgħux nirranġaw. Titlob billi tikteb lill-istudjo bin-numru tal-liċenzja tiegħek.

X'ma jinkludux dawn l-edizzjonijiet

Xi edizzjonijiet iżidu extras fakultattivi. Ricopop u Zabum jinkludu leaderboard f'PHP ta' fajl wieħed li huwa mitfi b'mod awtomatiku. Huwa tabella tal-punti kondiviża u każwali li taħżen il-punteġġi f'fajl, mhux klassifika li ma tistax tiġi mqarrqa, u mhux multiplayer live.

L-appoġġ ikopri mistoqsijiet dwar l-installazzjoni u l-użu tal-fajls fornuti u l-korrezzjoni ta' difetti li jistgħu jiġu riprodotti fil-logħba fornuta. Dak huwa limitu, u aħjar tkun tafu mill-ewwel jum.

Mistoqsijiet frekwenti

X'inhi d-differenza bejn il-folder tal-logħba u l-folder tas-sors?

game/ huwa l-build li ttella' fuq il-host tiegħek. source/ huwa l-edizzjoni editjabbli għall-iżviluppaturi tal-istess logħba. F'Velvet Pool u Puttide għandhom l-istess struttura, għalhekk fajl li teditja f'source/ jiġi kkupjat fl-istess mogħdija f'game/. F'edizzjonijiet f'TypeScript bħal Sunset Rally, source/ huwa proġett li terġa' tibni, u tippubblika r-riżultat il-ġdid.

Għandi bżonn npm jew Node.js biex nuża l-logħba?

Mhux biex tospitaha. Node.js jidher biss għat-testijiet fakultattivi f'Velvet Pool (20 jew aktar ġdid) jew biex terġa' tibni edizzjonijiet f'TypeScript bħal Sunset Rally (24 LTS rakkomandat) u Pinloop (22.12 jew aktar ġdid).

Il-kodiċi tas-sors huwa minifikat?

Mhux fl-edizzjonijiet koperti hawn. Velvet Pool u Puttide huma JavaScript sempliċi u ffurmatjat, u l-verżjoni 1.0.1 tat-tnejn qasmet strings twal ta' linja waħda f'linji li jinqraw. Ir-runtime ta' Sunset Rally jingħata ffurmatjat, bil-minifikazzjoni mitfija.

Nista' nuża xiri wieħed għal diversi proġetti jew klijenti?

Il-liċenzja tkopri prodott finali wieħed, tiegħek jew ta' klijent wieħed. It-tieni prodott huwa barra minnha.

Nista' nerġa' nbigħ jew naqsam il-kodiċi tas-sors?

Le: mhux waħdu, mhux bħala mudell, kit jew pakkett ta' assi, u mhux ġo prodott ieħor maħsub għall-iżviluppaturi. Tista' tbiddel il-kodiċi, l-arti u l-awdjo ġewwa l-prodott finali tiegħek.

Nista' naqra l-manwal qabel nixtri?

Iva. Kull paġna ta' oġġett għandha link għall-manwal tiegħu u għal demo li tintlagħab tal-istess edizzjoni.

Iftaħ pakkett qabel tixtri wieħed

Agħżel edizzjoni, iftaħ il-manwal tagħha mill-paġna tal-oġġett, ilgħab id-demo, u aqra l-mappa tal-fajls kontra l-mistoqsijiet ta' hawn fuq. Jekk il-manwal iwieġibhom, il-pakkett suppost ukoll. Jekk le, ikteb lill-istudjo qabel tħallas.

Ara l-mudelli kollha