Pool game source code: 8-ball HTML5 पैकेज के अंदर
Physics, नियम, CPU और saves अलग-अलग फ़ाइलों में: Velvet Pool के source में क्या है और खरीदार सबसे पहले क्या बदलता है।
Pool game source code तब खरीदने लायक है जब तीन चीज़ें अलग-अलग, पढ़ने योग्य फ़ाइलों में हों: गेंद की physics, 8-ball के नियम और कंप्यूटर प्रतिद्वंद्वी। अगर ये आपस में उलझी हों, तो मेज़ के रंग या CPU की कठिनाई का हर बदलाव debugging का सत्र बन जाता है। Velvet Pool, हमारा 8-ball template, इन्हें अलग रखता है, और यह गाइड उसके पैकेज को फ़ाइल-दर-फ़ाइल समझाती है।
हम देखते हैं कि कोड कैसे व्यवस्थित है, खरीदार आमतौर पर पहले क्या बदलता है, इसे कैसे होस्ट या app में लपेटा जाए, licence क्या अनुमति देता है और edition में क्या शामिल नहीं है। नीचे हर फ़ाइल का नाम game के साथ आने वाली buyer guide से लिया गया है।
संक्षेप में: Velvet Pool WebGL2 पर सादा JavaScript है, बिना 3D library और बिना build step। आप एक फ़ाइल बदलते हैं, उसे game फ़ोल्डर में कॉपी करते हैं और page reload करते हैं।
इस pool game source code में क्या है
Velvet Pool एक तैयार 8-ball game है, कोई engine या starter kit नहीं। डाउनलोड में चार फ़ोल्डर हैं: game/ upload के लिए तैयार build है, source/ वही game developer edition में है जिसमें README, package.json और tests हैं, documentation/ में English और Portuguese में चित्रित guide है, और THIRD-PARTY-LICENSES/ में font licence के पाठ हैं।
Game खुद fouls, ball-in-hand और solids या stripes के साथ 8-ball खेलता है। तीन CPU levels हैं (Easy यानी आसान, Medium यानी मध्यम और Hard यानी कठिन), undo, ball placement और re-rack वाली मुफ़्त practice table, और एक ही device पर दो खिलाड़ियों के मुकाबले। खिलाड़ी cue ball पर follow, draw या side spin लगाते हैं, और स्थानीय achievements पाँच cloth रंग और पाँच cue styles खोलते हैं। Interface 14 भाषाओं में आता है।
- Stack: vanilla JavaScript, ES modules और WebGL2। कोई Three.js या अन्य code library नहीं।
- Code: source/src और game/src में सादा, formatted JavaScript। कुछ भी minified या bundled नहीं है।
- Tests: वैकल्पिक, Node.js 20 या नए के साथ। ये physics, 8-ball नियम, CPU मुकाबले और translation keys जाँचते हैं।
- लिखने के समय का संस्करण: 1.1.0, 22 अक्टूबर 2026 को अपडेट।
Velvet Pool की listing, demo और manual देखें
फ़ाइलें कैसे व्यवस्थित हैं
game/ और source/ का layout एक जैसा है, इसलिए एक फ़ोल्डर का path दूसरे में उसी फ़ाइल की ओर इशारा करता है। Pool game के लिए सबसे ज़रूरी बँटवारा src/core/ (simulation और नियम) और src/game/ (वह सब कुछ जो खिलाड़ी छूता है) के बीच है।
- src/core/physics.js: गेंद का simulation, spin और cushion की प्रतिक्रिया।
- src/core/rules.js: 8-ball नियम और foul के फ़ैसले।
- src/core/ai.js: CPU अपना shot कैसे चुनता है।
- src/game/controls.js: aiming, power और spin का input।
- src/game/progress.js: achievements, cloths, cues और match scoring।
- src/game/i18n.js: 14 भाषाओं के texts, LANGS में सूचीबद्ध।
- src/game/localRecords.js: स्थानीय score history।
- src/game/audio.js: effects और music playback।
- css/style.css और css/fonts.css: theme, responsive layout और font declarations।
- assets/: art, audio और fonts, logo फ़ाइलें assets/logo/ में।
क्योंकि physics, नियम और CPU अलग modules हैं, आप CPU को ज़्यादा नरम बना सकते हैं बिना गेंदों की चाल छुए, या cushions को दोबारा tune किए बिना foul का नियम बदल सकते हैं। खरीदने से पहले किसी भी billiards code में यही बँटवारा सबसे पहले देखें।
खरीदार सबसे पहले क्या बदलता है
ज़्यादातर projects एक ही क्रम में चलते हैं। पहले वह बदलें जो खिलाड़ी देखता है, फिर वह जो वह महसूस करता है, और नियमों को आख़िर के लिए छोड़ें, क्योंकि नियम ही वह जगह है जहाँ bug सबसे आसानी से घुसता है।
- Branding: assets/logo/ की logo फ़ाइलें बदलें और CSS में मेल खाते sizes समायोजित करें। White label की अनुमति है, इसलिए हमारे नाम की जगह आपका या आपके client का नाम लग सकता है।
- मेज़ का रूप: रंग और fonts css/style.css में रहते हैं। Cloth और cue की परिभाषाएँ progress.js में हैं। उनके IDs स्थिर रखें, वरना खिलाड़ी अपने पहले से खुले cosmetics खो देंगे।
- Texts और भाषाएँ: हर string i18n.js में है। जो शब्दावली चाहिए वह संपादित करें; भाषाओं की सूची LANGS में है।
- CPU की कठिनाई: shot चुनने का तर्क ai.js में है। एक बार में एक level tune करें और उसके विरुद्ध पूरा match खेलें।
- Physics: घर्षण (friction), spin और cushion की प्रतिक्रिया physics.js में हैं। यहाँ छोटे बदलाव भी बड़ा असर डालते हैं, इसलिए हर बदलाव के बाद tests चलाएँ।
- नियम: घर के अपने variations rules.js में जाते हैं। Fouls और ball-in-hand को suite के साथ हाथ से भी टेस्ट करें।
सबके लिए काम का तरीका एक ही है: source/ में फ़ाइल संपादित करें, उसे game/ में उसी path पर कॉपी करें, फ़ोल्डर को HTTP पर serve करें और reload करें। Buyer guide सुझाती है कि एक बार में एक सुविधा बदलें और हर बदलाव के बाद menu, एक match, pause, result screen और reload को टेस्ट करें।
होस्ट करना, embed करना या app में लपेटना
Hosting सबसे सरल हिस्सा है। game/ के अंदर की हर चीज़ public_html/velvet-pool/ जैसे फ़ोल्डर में upload करें, subfolders रखें, और पता खोलें। Server पर npm, terminal, PHP, database या account की ज़रूरत नहीं है। HTTPS पर static files देने वाला plan काफ़ी है।
- index.html पर डबल-क्लिक करके न खोलें: browsers file:// पर game modules block करते हैं। स्थानीय टेस्ट के लिए game/ के भीतर python -m http.server 8765 चलाएँ।
- अगर screen खाली रहे, तो जाँचें कि WebGL2 चालू है और फ़ाइल नामों के बड़े-छोटे अक्षर वैसे ही हैं।
- अगर browser कोई module मना करे, तो आपका server .js को गलत MIME type भेज रहा है।
- Portal पर iframe के अंदर fullscreen और autoplay की अनुमति दें।
Game को run time पर जो भी चाहिए, वह game/ के भीतर है, इसलिए कुछ भी CDN या किसी दूसरी site से नहीं आता। हर नए page load पर आपके host तक पहुँच होती है, इसलिए यह installable offline app नहीं है। यह touch screens पर चलता है: खिलाड़ी मेज़ पर निशाना लगाते हैं और power control खींचते हैं।
Native app projects इस package का हिस्सा नहीं हैं। अगर आप game को Google Play या App Store पर चाहते हैं, तो Capacitor जैसा wrapper एक आम रास्ता है, जिसे उसके बनाने वाले web code से mobile apps बनाने का cross-platform native runtime बताते हैं। Store project बनाना और उसे संभालना आपका काम है, या वह सेवा जिसका हम अलग से quote देते हैं।
इस edition में क्या नहीं है
Velvet Pool local browser edition है। इसमें online multiplayer या private rooms नहीं हैं, online ranking नहीं है, cloud accounts नहीं हैं और advertising SDK नहीं है। एक ही device पर दो लोग खेल सकते हैं, और योग्य CPU matches के personal scores browser में सहेजे जाते हैं। Practice और एक ही device के matches score नहीं सहेजते।
Online play के लिए आपका अपना server और development चाहिए। यह एक असली project है, इसलिए शुरू से ही उसका budget रखें, यह उम्मीद न करें कि template खुद उस तक बढ़ जाएगा। अगर आपके catalogue में और sports games चाहिए, तो ये दो भी तैयार browser editions के रूप में बिकते हैं।
Puttide: 30 holes वाला 3D mini golf, वह भी सादे JavaScript में
Golazo: 50 राष्ट्रीय टीमों वाला tabletop football
लाइसेंस और कीमत, एक पैराग्राफ़ में
Velvet Pool की सूची मूल्य $39 है। 30 नवंबर 2026 तक Black Friday promotion हर template पर 15% छूट देता है, इसलिए इसकी कीमत $33.15 है, और दो या अधिक templates के order पर 5% से 20% तक की अतिरिक्त छूट मिलती है। हर खरीद एक end product के लिए स्थायी, गैर-विशेष (non-exclusive) licence है, आपके या एक client के लिए। आप उस product के भीतर code, art और audio बदल सकते हैं और उस पर अपना brand लगा सकते हैं। खिलाड़ी इसे मुफ़्त में या ads के साथ खेल सकते हैं। Template या उसका code अकेले दोबारा बेचना मना है। Checkout पर extension लेने पर 12 महीने, वरना 6 महीने का support शामिल है; custom काम, hosting और SDK या portal integration का अलग से quote दिया जाता है।
पूरी licence और support की शर्तें पढ़ें
अक्सर पूछे जाने वाले प्रश्न
क्या pool game source code पढ़ने योग्य है या minified?
पढ़ने योग्य है। source/src और game/src का JavaScript सादा और formatted है, कोई minified या bundled फ़ाइल नहीं।
क्या मुझे Node.js या build step चाहिए?
नहीं। आप source/ की फ़ाइलें संपादित करके game/ में कॉपी करते हैं। Node.js 20 या नया सिर्फ़ तब चाहिए जब आप वैकल्पिक tests चलाना चाहें।
क्या मैं CPU को आसान या कठिन बना सकता हूँ?
हाँ। CPU का shot चुनने का तर्क src/core/ai.js में है, physics से अलग, इसलिए गेंदों की चाल बदले बिना उसे tune किया जा सकता है।
क्या यह फ़ोन पर चलता है?
हाँ। Touch input समर्थित है और controls स्क्रीन के हिसाब से बदलते हैं। WebGL2 ज़रूरी है, और प्रदर्शन device पर निर्भर करता है, इसलिए अपने खिलाड़ियों के फ़ोन पर टेस्ट करें।
अगर मैं game को नए domain पर ले जाऊँ तो क्या खिलाड़ियों की progress बचेगी?
नहीं। Saves browser origin से जुड़े होते हैं, इसलिए domain बदलने पर खिलाड़ी नए सिरे से शुरू करते हैं। Launch से पहले अंतिम पता चुन लें।
क्या मैं online multiplayer जोड़ सकता हूँ?
अकेले इस edition से नहीं। इसके लिए आपका अपना server और development चाहिए। हम इसे custom काम के रूप में quote कर सकते हैं।
यह pool code किसके लिए ठीक है
यह उस portal या site के लिए ठीक है जो अपने catalogue में 8-ball game चाहता है, उस agency के लिए जो एक client को branded billiards game दे रही है, और उस developer के लिए जो बिना 3D library के बीच में आए यह पढ़ना चाहता है कि pool की physics और नियम कैसे लिखे गए हैं। अगर आपकी योजना online matches या साझा leaderboard पर टिकी है, तो यह कम उपयुक्त है।
खरीदने से पहले फ़ोन और laptop पर demo खेलें, और manual का file map खोलें। अगर physics, नियम और CPU का बँटवारा आपके काम के तरीके से मेल खाता है, तो बाकी कुछ दिनों के बदलाव भर है।