Bilardimängu lähtekood: mis on 8-palli HTML5 paketis
Füüsika, reeglid, arvutivastane ja salvestused eraldi failides: mis on Velvet Pooli lähtekoodis ja mida ostja esimesena muudab.
Bilardimängu lähtekood on väärt ostmist, kui kolm asja asuvad eraldi ja loetavates failides: pallide füüsika, 8-palli reeglid ja arvutivastane. Kui need on omavahel sassis, muutub iga laudkatte värvi või arvuti raskusastme muutmine silumissessiooniks. Velvet Pool, meie 8-palli mall, hoiab need lahus, ja see juhend käib paketi läbi fail-faililt.
Räägime sellest, kuidas kood on korraldatud, mida ostja tavaliselt esimesena muudab, kuidas seda majutada või rakendusena pakendada, mida litsents lubab ja mida väljaanne ei sisalda. Iga allpool toodud failinimi pärineb mänguga kaasas olevast ostujuhendist.
Lühidalt: Velvet Pool on lihtne JavaScript WebGL2 peal, ilma 3D-teegita ja ilma koostamisetapita. Muudad faili, kopeerid selle mängukausta ja laadid lehe uuesti.
Mida see bilardimängu lähtekood sisaldab
Velvet Pool on valmis 8-palli mäng, mitte mootor ega alustamise komplekt. Allalaadimises on neli kausta: game/ on üleslaaditav valmiskoostis, source/ on sama mäng arendajaväljaandena koos README-, package.json- ja testidega, documentation/ sisaldab illustreeritud juhendit inglise ja portugali keeles ning THIRD-PARTY-LICENSES/ hoiab fontide litsentsitekstid.
Mäng ise mängib 8-palli rikkumistega, vaba pallipaigutusega ning täis- ja triibupallidega. Kolm arvutitaset (Easy (lihtne), Medium (keskmine) ja Hard (raske)), vaba harjutuslaud, mille juures on undo (tagasivõtt), pallide paigutus ja re-rack (uuesti kolmnurka paigutamine), ning kahe mängija mängud ühel seadmel. Mängijad annavad valgele pallile edasi-, tagasi- või külgpöörde ning kohalikud saavutused avavad viis laudkatte värvi ja viis kepi stiili. Liides on 14 keeles.
- Tehnoloogia: tavaline JavaScript, ES-moodulid ja WebGL2. Three.js-i ega muud koodiraamatukogu pole.
- Kood: lihtne ja vormindatud JavaScript kaustades source/src ja game/src. Midagi ei ole minimeeritud ega pakendatud.
- Testid: valikulised, Node.js 20 või uuem. Need kontrollivad füüsikat, 8-palli reegleid, arvutivastase mänge ja tõlkevõtmeid.
- Versioon kirjutamise ajal: 1.1.0, uuendatud 22. oktoobril 2026.
Vaata Velvet Pooli kirjeldust, demot ja juhendit
Kuidas failid on korraldatud
game/ ja source/ kasutavad sama paigutust, nii et ühe kausta tee viitab teises samale failile. Bilardimängu jaoks kõige tähtsam jaotus on src/core/ (simulatsioon ja reeglid) ja src/game/ (kõik, mida mängija puudutab) vahel.
- src/core/physics.js: pallide simulatsioon, pöörded ja bande vastus.
- src/core/rules.js: 8-palli reeglid ja rikkumiste otsused.
- src/core/ai.js: kuidas arvuti oma löögi valib.
- src/game/controls.js: sihtimine, jõud ja pöörde sisend.
- src/game/progress.js: saavutused, laudkatted, kepid ja mängu punktid.
- src/game/i18n.js: tekstid 14 keeles, loetletud failis LANGS.
- src/game/localRecords.js: kohalik tulemuste ajalugu.
- src/game/audio.js: efektide ja muusika taasesitus.
- css/style.css ja css/fonts.css: teema, reageeriv paigutus ja fontide deklaratsioonid.
- assets/: graafika, heli ja fondid, logofailid kaustas assets/logo/.
Kuna füüsika, reeglid ja arvuti on eraldi moodulid, saad arvutit leebemaks muuta, puutumata pallide liikumist, või muuta rikkumise reeglit ilma bande seadistust ümber häälestamata. See eraldus on peamine, mida igas ostetavas bilardikoodis otsida.
Mida ostja esimesena muudab
Enamik projekte järgib sama järjekorda. Alusta sellest, mida mängijad näevad, liigu siis selle juurde, mida nad tunnevad, ja jäta reeglid viimaseks, sest reeglid on kõige lihtsam koht vea sisseviimiseks.
- Bränding: asenda logofailid kaustas assets/logo/ ja kohanda CSS-is vastavad suurused. Valge silt (white label) on lubatud, seega võib sinu või su kliendi nimi asendada meie oma.
- Laua välimus: värvid ja fondid asuvad failis css/style.css. Laudkatete ja kepikeste määratlused asuvad failis progress.js. Hoia nende ID-d stabiilsena, muidu kaotavad mängijad juba avatud kosmeetika.
- Tekstid ja keeled: iga string on failis i18n.js. Muuda vajalikke sõnastusi; keelte loend on failis LANGS.
- Arvuti raskusaste: löögi valik on failis ai.js. Häälesta korraga üks tase ja mängi selle vastu täielik mäng.
- Füüsika: hõõrdumine, pöörded ja bande vastus on failis physics.js. Väikesed muudatused mõjutavad siin palju, seega käivita pärast igat muudatust testid.
- Reeglid: kohalikud variandid kuuluvad faili rules.js. Testi rikkumisi ja vaba palli käsitsi, mitte ainult testikomplektiga.
Töövoog on kõigi jaoks sama: muuda faili kaustas source/, kopeeri see samale teele kaustas game/, serveeri kaust HTTP-na ja lae uuesti. Ostujuhend soovitab iga muudatuse järel muuta ühte funktsiooni korraga ja testida menüüd, mängu, pausi, tulemuste ekraani ning lehe uuesti laadimist.
Majutus, manustamine või rakendusena pakendamine
Majutamine on kõige lihtsam osa. Laadi kõik game/ sees olev üles kausta, nagu public_html/velvet-pool/, säilita alamkaustad ja ava aadress. Serveripoolel ei ole vaja npm-i, terminali, PHP-d, andmebaasi ega kontot. Piisab hostist, mis serveerib staatilisi faile HTTPS-i kaudu.
- Ära ava index.html-i topeltklõpsuga: brauserid blokeerivad mängumoodulid failist file://. Kohaliku testi jaoks käivita game/ kaustas python -m http.server 8765.
- Kui ekraan jääb tühjaks, kontrolli, et WebGL2 on lubatud ja failinimed säilitavad suur- ja väiketähed.
- Kui brauser moodulit ei võta, saadab sinu server .js-faile vale MIME-tüübiga.
- Portaali iframe'is luba täisekraan ja automaatne esitus.
Kõik, mida mäng käivitamisel vajab, asub kaustas game/, seega ei laadita midagi CDN-ist ega teiselt saidilt. Iga uus lehe laadimine jõuab siiski sinu hostini, seega see ei ole installeeritav võrguvaba rakendus. Mäng töötab puuteekraanil: mängijad sihivad laual ja tõmbavad võimsuse juhtnuppu.
Natiivsed rakenduste projektid ei ole paketi osa. Kui soovid mängu Google Play-sse või App Store'i, on üks tavaline tee pakend nagu Capacitor, mida selle loojad kirjeldavad platvormideülese natiivse käituskeskkonnana mobiilirakenduste loomiseks veebikoodiga. Rakenduste poe projekti ehitamine ja hooldamine on sinu töö või teenus, mida pakume eraldi.
Mida väljaanne ei sisalda
Velvet Pool on kohalik brauseriväljaanne. Sellel ei ole võrgumängu ega privaatseid ruume, võrgus tulemustetabelit, pilvekontosid ega reklaami-SDK-d. Kaks inimest saavad mängida ühel seadmel ning isiklikud tulemused sobivatest arvuti mängudest salvestatakse brauserisse. Harjutus ja samal seadmel mängitud mängud tulemust ei salvesta.
Võrgumäng vajab sinu oma serverit ja arendust. See on tõeline projekt, seega planeeri see algusest peale, mitte oota, et mall sellesse kasvab. Kui su kataloog vajab rohkem spordimänge, on need kaks samuti müügil valmis brauseriväljaannetena, mida saab majutada.
Puttide: 3D minigolf 30 augu ja tavalise JavaScriptiga
Golazo: lauajalgpall 50 rahvusmeeskonnaga
Litsents ja hind ühes lõigus
Velvet Pool on tavahinnaga 39 $. Kuni 30. novembrini 2026 kehtib Black Friday soodustus, mis annab kõigile mallidele 15% allahindluse, seega maksab see 33,15 $, ja kahe või enama malli tellimusel tuleb veel 5% kuni 20% soodsamalt. Iga ost on igavesti kehtiv, mitteeksklusiivne litsents ühele lõpptootele, kas sinu või ühe kliendi oma. Selle toote piires võid muuta koodi, graafikat ja heli ning panna sinna oma brändi. Mängijad saavad sellele ligi tasuta või reklaamide kaudu. Malli ega selle koodi eraldi edasi müüa ei tohi. Tugi kestab kuus kuud või 12 kuud, kui ostes lisad laienduse; kohandatud töö, majutus ning SDK- või portaaliühendus pakutakse eraldi.
Loe litsentsi- ja tugitingimusi täielikult
Korduma kippuvad küsimused
Kas bilardimängu lähtekood on loetav või minimeeritud?
Loetav. JavaScript kaustades source/src ja game/src on lihtne ja vormindatud, minimeeritud või pakendatud faile ei ole.
Kas vajan Node.js-i või koostamisetappi?
Ei. Muudad faile kaustas source/ ja kopeerid need kausta game/. Node.js 20 või uuem on vajalik ainult siis, kui tahad käivitada valikulised testid.
Kas saan arvutit lihtsamaks või raskemaks muuta?
Jah. Arvuti löögi valik asub failis src/core/ai.js, eraldi füüsikast, seega saad seda häälestada, muutmata pallide liikumist.
Kas see töötab telefonides?
Jah. Puuteinput on toetatud ja juhtnupud kohanduvad ekraaniga. Nõutav on WebGL2, jõudlus sõltub seadmest, seega testi oma mängijate telefone.
Kas mängijad säilitavad edusammud, kui kolin mängu uuele domeenile?
Ei. Salvestused kuuluvad brauseri päritolule, seega domeeni muutmine alustab mängijaid nullist. Vali lõplik aadress enne starti.
Kas saan lisada võrgumängu?
Mitte ainult selle väljaandega. See vajab sinu oma serverit ja arendust. Saame selle pakkuda kohandatud tööna.
Kellele see bilardikood sobib
See sobib portaalile või saidile, mis tahab kataloogi 8-palli mängu, agentuurile, kes tarnib ühele kliendile brändiga bilardimängu, ja arendajale, kes tahab lugeda, kuidas bilardi füüsika ja reeglid on kirjutatud, ilma 3D-teegita takistamas. See sobib vähem, kui su plaan sõltub võrgumängudest või jagatud tulemustetabelist.
Mängi demot enne ostmist telefonis ja sülearvutis ning ava juhendi failikaart. Kui jaotus füüsika, reeglite ja arvuti vahel vastab sellele, kuidas sa plaanid töötada, on ülejäänu mõne pärastlõuna muudatused.