Kodici sors tal-logħba pool: ġewwa pakkett HTML5 tal-8-ball
Il-fiżika, ir-regoli, is-CPU u s-salvataġġi f'fajls separati: x'fih is-sors ta' Velvet Pool u x'jibdel il-bejjiegħ l-ewwel.
Il-kodici sors tal-logħba pool jiswa xiri meta tliet affarijiet jgħixu f'fajls separati u jinqraw: il-fiżika tal-ballijiet, ir-regoli tal-8-ball u l-avversarju bil-kompjuter. Jekk dawk huma marbutin flimkien, kull bidla fil-kulur tal-qmaxx jew fid-diffikultà tas-CPU ssir sessjoni ta' debugging. Velvet Pool, it-template tagħna tal-8-ball, iżommhom separati, u din il-gwida timxi fuq il-pakkett tiegħu fajl b'fajl.
Din il-gwida tkopri kif hu organizzat il-kodici, x'jibdel tipikament il-bejjiegħ l-ewwel, kif tospitah jew tgħalqu bħala app, x'tippermetti l-liċenzja u x'ma tinkludix l-edizzjoni. Kull isem ta' fajl hawn taħt ġej mill-gwida tal-bejjiegħ li tiġi mal-logħba.
Il-verżjoni qasira: Velvet Pool huwa JavaScript sempliċi fuq WebGL2, mingħajr librerija 3D u mingħajr passi tal-build. Timmodifika fajl, tikkopjah fil-fowlder tal-logħba u terġa' tgħabbi l-paġna.
X fih il-kodici sors tal-logħba pool
Velvet Pool huwa logħba 8-ball lesta, mhux engine u mhux starter kit. Id-download għandu erba' fowlders: game/ huwa l-build lest għall-upload, source/ huwa l-istess logħba bħala edizzjoni tal-iżviluppatur b'README, package.json u testijiet, documentation/ fih il-gwida illustrata bl-Ingliż u bil-Portugiż, u THIRD-PARTY-LICENSES/ iżomm it-testi tal-liċenzji tal-fonts.
Il-logħba nnifisha tilgħab 8-ball b'fouls, ball-in-hand u solids jew stripes. Hemm tliet livelli tas-CPU (Easy, Medium u Hard), mejda ta' prattika bla ħlas b'undo, tqegħid tal-ballijiet u re-rack, u partiti għal tnejn fuq apparat wieħed. Il-plejers jużaw follow, draw jew side spin fuq il-cue ball, u l-achievements lokali jiftħu ħames kuluri ta' qmaxx u ħames stili ta' cue. L-interface jiġi f'14-il lingwa.
- Stack: JavaScript vanilla, ES modules u WebGL2. M'hemm l-ebda Three.js jew librerija oħra tal-kodiċi.
- Kodiċi: JavaScript sempliċi u ffurmattjat f'source/src u game/src. Xejn ma jiġi minified jew bundled.
- Testijiet: fakultattivi, b'Node.js 20 jew aktar. Jiċċekkjaw il-fiżika, ir-regoli tal-8-ball, il-partiti tas-CPU u ċ-ċwievi tat-traduzzjoni.
- Verżjoni fil-ħin tal-kitba: 1.1.0, aġġornata fit-22 ta' Ottubru 2026.
Ara l-paġna ta' Velvet Pool, id-demo u l-manwal
Kif huma organizzati l-fajls
game/ u source/ għandhom l-istess layout, allura path f'fowlder jindika l-istess fajl fl-ieħor. Il-qasma li tgħodd l-aktar għal logħba tal-pool hija bejn src/core/ (is-simulazzjoni u r-regoli) u src/game/ (kull ma jmiss lill-plejer).
- src/core/physics.js: is-simulazzjoni tal-ballijiet, l-ispin u r-rimbalz mill-kuxxin.
- 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 il-kulp tiegħu.
- src/game/controls.js: l-input għall-immirar, il-qawwa u l-ispin.
- src/game/progress.js: l-achievements, il-qmaxx, il-cues u l-punteġġ tal-partiti.
- src/game/i18n.js: it-testi fl-14-il lingwa, elenkati f'LANGS.
- src/game/localRecords.js: l-istorja lokali tal-punteġġi.
- src/game/audio.js: it-tħaddim tal-effetti u tal-mużika.
- css/style.css u css/fonts.css: it-tema, il-layout responsive u d-dikjarazzjonijiet tal-fonts.
- assets/: l-arti, l-awdjo u l-fonts, bil-fajls tal-logo f'assets/logo/.
Għax il-fiżika, ir-regoli u s-CPU huma modulli separati, tista' tagħmel is-CPU aktar tolleranti mingħajr ma tmiss kif jiċċaqalqu l-ballijiet, jew tbiddel regola tal-foul mingħajr ma terġa' tissintonizza l-kuxxin. Dik is-separazzjoni hija l-ħaġa prinċipali li għandek tfittex f'kull kodiċi tal-billiards li tixtri.
X jibdel il-bejjiegħ l-ewwel
Ħafna proġetti jsegwu l-istess ordni. Ibda b'dak li l-plejers jaraw, imbagħad mur għal dak li jħossu, u ħalli r-regoli għall-aħħar, għax ir-regoli huma l-aħjar post biex jidħol bug.
- Brand: ibdel il-fajls tal-logo f'assets/logo/ u aġġusta d-daqsijiet korrispondenti fil-CSS. White label huwa permess, allura l-isem tiegħek jew tal-klijent tiegħek jista' jieħu post tagħna.
- Dehra tal-mejda: il-kuluri u l-fonts jinsabu f'css/style.css. Id-definizzjonijiet tal-qmaxx u tal-cue jinsabu f'progress.js. Żomm l-IDs stabbli, jew il-plejers jitilfu l-kosmetiċi li diġà fetħu.
- Testi u lingwi: kull stringa tinsab f'i18n.js. Editja l-kliem li tixtieq; il-lista tal-lingwi tinsab f'LANGS.
- Diffikultà tas-CPU: l-għażla tal-kulp tinsab f'ai.js. Aġġusta livell wieħed kull darba u ilgħab partita sħiħa kontrieha.
- Fiżika: il-frizzjoni, l-ispin u r-rimbalz mill-kuxxin jinsabu f'physics.js. Bidliet żgħar jagħmlu ħafna hawn, allura mexxi t-testijiet wara kull waħda.
- Regoli: il-varjanti tad-dar għandhom joqogħdu f'rules.js. Ittestja l-fouls u l-ball-in-hand b'idejk kif ukoll mas-suite.
Il-proċess huwa l-istess għalihom kollha: editja l-fajl f'source/, ikkopjah fl-istess path f'game/, servih mill-fowlder permezz ta' HTTP u erġa' tgħabbi. Il-gwida tal-bejjiegħ tissuġġerixxi li tbiddel karatteristika waħda kull darba u tittestja l-menu, partita, pause, l-iskrin tar-riżultat u reload wara kull bidla.
Hosting, embedding jew tgħalqu bħala app
Hosting huwa l-parti l-aktar sempliċi. Itgħabba kull ma hemm ġewwa game/ f'fowlder bħal public_html/velvet-pool/, żomm is-subfowlders, u fetaħ l-indirizz. M'hemm l-ebda npm, terminal, PHP, database jew kont min-naħa tas-server. Pjan li jservi fajls statiċi permezz ta' HTTPS huwa biżżejjed.
- Tiftaħx index.html bid-doppju klikk: il-browsers jimblukkaw il-modules tal-logħba fuq file://. Għal test lokali, mexxi python -m http.server 8765 ġewwa game/.
- Jekk il-screen jibqa' vojt, iċċekkja li WebGL2 hu attiv u li l-ismijiet tal-fajls iżommu l-kapitali u l-minuskoli kif inhuma.
- Jekk il-browser jirrifjuta module, is-server tiegħek qed jibgħat .js b'MIME type ħażin.
- Ġewwa iframe fuq portal, ħalli l-fullscreen u l-autoplay.
Kull ma l-logħba teħtieġ waqt it-tħaddim jinsab ġewwa game/, allura xejn ma jitgħabba minn CDN jew sit ieħor. Iftaħ il-paġna mill-ġdid u l-host tiegħek jintlaħaq, allura mhijiex app offline li tista' tiġi installata. Taħdem fuq screens tat-touch: il-plejers jimmiraw fuq il-mejda u jiġbdu l-kontroll tal-qawwa.
Il-proġetti tal-app nattivi m'humiex parti mill-pakkett. Jekk tixtieq il-logħba fuq Google Play jew l-App Store, wrapper bħal Capacitor, li l-kreaturi tiegħu jiddeskrivuh bħala runtime nattiv multipjattaforma biex jinbnew apps mobbli bil-kodiċi tal-web, hija triq komuni waħda. Il-bini u ż-żamma tal-proġett tal-store huma x-xogħol tiegħek, jew servizz li nikkwotaw separatament.
X ma tinkludix l-edizzjoni
Velvet Pool hija l-edizzjoni lokali tal-browser. M'għandhiex multiplayer online jew kmamar privati, l-ebda klassifika online, l-ebda kontijiet fuq il-cloud u l-ebda SDK tar-reklami. Żewġ persuni jistgħu jilagħbu fuq apparat wieħed, u punteġġi personali minn partiti eliġibbli kontra s-CPU jinħażnu fil-browser. Il-prattika u l-partiti fuq l-istess apparat ma jisalvawx punteġġ.
Il-logħba online teħtieġ is-server tiegħek u żvilupp tiegħek. Dak proġett reali, allura ibbaġitjah minn qabel, għax it-template ma jikbirx waħdu biex jilħqu. Jekk il-katalgu tiegħek jeħtieġ aktar logħbiet sport, dawn it-tnejn jinbiegħu wkoll bħala edizzjonijiet tal-browser lesti għall-hosting.
Puttide: mini golf 3D b'30 toqba, ukoll f'JavaScript sempliċi
Golazo: football tal-mejda b'50 tim nazzjonali
Liċenzja u prezz f'paragrafu wieħed
Velvet Pool jiswa $39 bil-prezz ta' lista. Sal-30 ta' Novembru 2026 promozzjoni tal-Black Friday tnaqqas 15% fuq kull template, allura jiswa $33.15, u l-ordnijiet ta' tnejn jew aktar templates jieħdu tnaqqis ulterjuri ta' 5% sa 20%. Kull xiri huwa liċenzja perpetwa, mhux esklussiva, għal prodott finali wieħed, tiegħek jew ta' klijent wieħed. Tista' tibdel il-kodici, l-arti u l-awdjo ġewwa dak il-prodott u tpoġġi l-brand tiegħek fuqu. Il-plejers jistgħu jilagħbuha b'xejn jew bir-reklami. Ma tistax terġa' tbigħ it-template jew il-kodiċi tiegħu waħdu. Sitt xhur ta' support huma inklużi, jew 12 bl-estensjoni fil-checkout; xogħol personalizzat, hosting u integrazzjoni ta' SDK jew ta' portal jiġu kkwotati separatament.
Aqra l-liċenzja u t-termini kompleti tas-support
Mistoqsijiet frekwenti
Il-kodici sors tal-logħba pool jinqara jew huwa minified?
Jinqara. Il-JavaScript f'source/src u game/src huwa sempliċi u ffurmattjat, b'l-ebda fajl minified jew bundled.
Irid Node.js jew passi tal-build?
Le. Editja l-fajls f'source/ u ikkopjahom f'game/. Node.js 20 jew aktar huwa meħtieġ biss jekk trid timmexxi t-testijiet fakultattivi.
Nista' nagħmel is-CPU aktar faċli jew aktar iebsa?
Iva. L-għażla tal-kulpijiet tas-CPU tinsab f'src/core/ai.js, separata mill-fiżika, allura tista' tissintonizzaha mingħajr ma tbiddel kif jiċċaqalqu l-ballijiet.
Taħdimx fuq it-telefons?
Iva. Hemm appoġġ għat-touch u l-kontrolli jadattaw għall-iskrin. WebGL2 huwa meħtieġ, u l-prestazzjoni tiddependi mill-apparat, allura ittestja t-telefons li jużaw il-plejers tiegħek.
Il-plejers se jżommu l-progress jekk inbiddel il-logħba għal dominju ġdid?
Le. Is-salvataġġi jappartjenu lill-origin tal-browser, allura bidla fid-dominju tibda lill-plejers mill-bidu. Agħżel l-indirizz finali qabel il-launch.
Nista' nżid multiplayer online?
Mhux b'din l-edizzjoni waħedha. Teħtieġ is-server tiegħek u żvilupp. Nistgħu nikkwotawh bħala xogħol personalizzat.
Lil min jaqbel dan il-kodici tal-pool
Jaqbel portal jew sit li jrid logħba 8-ball fil-katalgu tiegħu, aġenzija li twassal logħba tal-billiards bil-brand għal klijent wieħed, u żviluppatur li jrid jaqra kif huma miktuba l-fiżika u r-regoli tal-pool mingħajr librerija 3D fit-triq. Jaqbel inqas jekk il-pjan tiegħek jiddependi fuq partiti online jew klassifika kondiviża.
Ilgħab id-demo fuq telefon u fuq laptop qabel tixtri, u fetaħ il-mappa tal-fajls tal-manwal. Jekk il-qasma bejn il-fiżika, ir-regoli u s-CPU taqbel mal-mod kif tippjana taħdem, il-bqija huwa ftit ġranet ta' bidliet.