Qalisa, Yakha futhi Uhlole i-Portals: Imihlaba engu-471 ye-3D Ekhiqiziwe

Ayini ama-Portals?

Ama-Portals awuhambo lwendiza lwesiphequluli oluzihambelayo oludlula emhlabeni we-3D owenziwe u-471. Ikhamera ilandela indlela enqunywe kusengaphambili, ifinyelele ku-portal, bese ingena ngqo emhlabeni olandelayo osebenzayo ngaphandle kokusikeka noma ukufiphala. Awulawuli indlela yendiza, kodwa ungalawula ijubane layo, indlela evezwa ngayo, umsindo, imifanekiso, nokukhethwa komhlaba.

Le phrojekthi yakhiwe nge-JavaScript kanye ne-three.js. Umhlaba ngamunye ukhiqiza i-geometry nemidwebo yawo esipheqululini, kanti umsindo wawo wenziwa ngesikhathi sokudlala. Imihlaba ayilayishi amamodeli e-3D angaphandle, izithombe zemidwebo, noma amafayela omsindo. Le phrojekthi futhi iyisayithi emile: ayidingi i-akhawunti, iseva yohlelo lokusebenza, noma isevisi yokulandelela.

Indawo yokugcina ikhodi imele ukukhishwa kwe-s8f kusukela ngoNovemba 9, 2026. Lokho kukhishwa kuqukethe cishe imigqa ye-JavaScript eyizigidi ezingu-1.4 kanye nemihlaba engu-471.

Izici ezibalulekile

• Imihlaba engu-471 eyenziwe: Iqoqo lihlanganisa izindawo zasendle, amadolobha, izilwandle, izindawo zangaphakathi, isibhakabhaka, izindawo zabafokazi, izigcawu zangaphambi komlando, izindawo ezikhuthazwe ubuciko, imihlaba yezincwadi, okukhuthazwe amafilimu nomabonakude, izimangaliso zasendulo, namahlaya angaphakathi e-AI.
• Ama-portal angenazikhawu: Umhlaba wamanje nomhlaba ongale kwe-portal kusebenza ngesikhathi esisodwa, okwenza ikhamera iwele ngaphandle kwesikrini soguquko.
• Izimpahla ezenziwa ngezinqubo: I-geometry, imidwebo, nomsindo kukhiqizwa esipheqululini esikhundleni sokulayishwa njengezimpahla zomhlaba ezivamile.
• Indiza ezenzakalelayo: Umhlaba ngamunye unikeza indlela nobude bekhamera. Izindiza eziningi zihlala cishe imizuzwana engu-40 kuya kwengu-50.
• Imifanekiso eguquguqukayo: Imodi ezenzakalelayo ilinganisela izinga lekhwalithi ngokusekelwe ekhadini lemifanekiso bese ilungisa ukulungiswa kokudweba ukuze igcine ukunyakaza kubushelelezi.
• Okuthandwayo kwasendaweni: Imihlaba ebukiwe, izintandokazi, nezilungiselelo kugcinwa endaweni yokugcina yesiphequluli.
• Igalari nohambo: Igalari iveza yonke imihlaba, kanti uhambo olukhethiwe olungu-20 ludlala imihlaba ekhethiwe ngokulandelana okumisiwe.
• Ukushicilelwa kwesayithi emile: Ukwakhiwa kokukhiqiza kwakha amafayela ajwayelekile ku-dist anganikezwa iseva yewebhu emile.

Okudingekayo

Udinga i-Node.js 18 noma eyakamuva kanye ne-Git. Ukuhlola ikhodi yomthombo ngqo akudingi ukufakwa noma isinyathelo sokwakha. Ikhadi lemifanekiso elizinikele liyathandeka, nakuba iphrojekthi ingasebenza ngekhwalithi eyehlisiwe kumafoni nakumakhompyutha aphathekayo amadala.

Qinisekisa inguqulo yakho ye-Node.js:

node --version

Uma umphumela ungaphambi kwenguqulo 18, buyekeza i-Node.js ngaphambi kokuqhubeka.

Qalisa ama-Portals ngqo emthonjeni

1. Klona indawo yokugcina ikhodi

git clone https://github.com/emollick/ai-portals.git
cd ai-portals

2. Qalisa iseva yomthombo yasendaweni

npm start

Vula i-http://localhost:8000 esipheqululini. Lokhu kunikeza isihlahla somthombo njengoba sinjalo, ngaphandle kokudinga ukufakwa kwamaphakheji noma ukuhlanganiswa kuqala.

Ukuhlola umthombo kunemikhawulo emibili elindelekile. Igalari yayo ayikwazi ukubona imihlaba esanda kwengezwa noma ikhombise ikhasi lezincazelo ezikhiqiziwe. Ekuvakasheni kokuqala, ikhonsoli yesiphequluli iphinde ibike ifayela elilahlekile le-atlas.json ngoba lelo fayela likhiqizwa kuphela yinqubo yokwakha.

Yakha futhi uhlole ukwakhiwa kokukhiqiza

Faka okuncikile kokwakha, khiqiza iphakheji yokushicilela, bese uqala iseva yokuyihlola:

npm install
npm run build
npm run preview

Isayithi emile elikhiqiziwe libhalwa ku-dist. Vula i-http://localhost:8001 ukuze ulihlole.

Ukwakhiwa kunciphisa imibhalo yephrojekthi nge-esbuild futhi kwakha izinsiza ezisetshenziselwa ukushicilela kuphela, okuhlanganisa:

• Ikhasi elincane lokubuka ngaphambi kokwabelana lomhlaba nomsebenzi ngamunye.
• Ikhasi elilula elibala wonke umhlaba nencazelo yawo.
• Idatha yegalari erekhoda ukuthi yimiphi imihlaba emisha.
• ifayela lokucushwa kokusingatha.

Phinda ukhiqize ukukhishwa kwe-s8f

Ukwakhiwa kwamukela uphawu lokukhishwa. Ngokwemibhalo yendawo yokugcina ikhodi, umyalo olandelayo waphinda wakhiqiza ifayela lokukhishwa kwe-s8f elibukhoma, ifayela nefayela ne-byte nge-byte, ngoNovemba 9, 2026:

npm run build -- --stamp s8f

Sebenzisa ukwakhiwa okujwayelekile ngesikhathi sokuthuthukisa. Sebenzisa uphawu lapho udinga ngokuqondile imethadatha yokukhishwa noma ufuna ukuphinda ukhiqize ukukhishwa okubhalwe phansi.

Izilawuli eziyisisekelo nokusetshenziswa

Ama-Portals aqala ukundiza ngokuzenzakalelayo. Umsindo uqala uvaliwe, ngakho cindezela u-S uma ufuna ukuzwa umsindo owenziwe ngekhompyutha. Izilawuli zekhibhodi yilezi:

• Space: Misa noma qhubeka nendiza.
• Right Arrow: Sheshisa uye ku-portal elandelayo.
• S: Vula noma cisha umsindo.
• G: Vula imodi ye-Gentle ukuze ikhamera izinze futhi umkhathizwe uhlale uqondile.
• H: Gcina umhlaba wamanje njengentandokazi.
• P: Gcina isithombe.
• I: Vula igalari, uhambo, nesixhumi esibonakalayo sokusesha.
• O: Vula izinketho zemifanekiso, ikhamera, isitayela sobuciko, uhambo, umlingani, nesikhathi sosuku.
• F: Ngena noma uphume kumodi yesikrini esigcwele.

Ukuhambisa igundane kuveza ibha yokulawula ezansi kwesikrini. Iqukethe izinkinobho ezihambisana nezilawuli zekhibhodi, kanye nesilayida se-Pace nesilayida se-Earthly to Strange. Kumawindi amancane, izilayida zihanjiselwa kusixhumi esibonakalayo sezinketho.

Ukuhlola kokuqala okuwusizo

1. Qalisa ukubuka kuqala komthombo noma kokukhiqizwa.
2. Cindezela u-S ukuze uvule umsindo.
3. Vumela umhlaba owodwa ophelele udlale ukuze ubone ukuwela kwengosi okujwayelekile.
4. Cindezela u-G uma ukunyakaza kwekhamera kukuphazamisa.
5. Vula igalari ngo-I bese usesha noma uphequlule iqoqo eliphelele.
6. Lungisa i-Earthly to Strange ukuze uthinte ukuthi kukhethwa kangaki imihlaba engajwayelekile.
7. Cindezela u-H lapho uhlangana nomhlaba ofuna ukuwugcina njengentandokazi.

Indlela izingosi ezingenamthungo ezisebenza ngayo

Cishe umzuzwana owodwa ngemva kokuwela, injini ikhetha umhlaba olandelayo. Yakha lowo mhlaba kancane ngamamilisekhondi ambalwa phakathi kwamafreyimu aboniswayo, bese ilungiselela kusengaphambili ama-shader nama-texture awo ngesikhathi ungabonakali.

Indawo oya kuyo ayisona isithombe esimile sokubuka kuqala. Ikhamera yesibili ibonisa umhlaba olandelayo osebenzayo ngaphakathi kokuvuleka kwengosi kufreyimu ngayinye. Ngaphambi nje kokuba ikhamera ifike esangweni, injini yenza indawo oya kuyo ibe umhlaba wamanje bese iqhubeka nendiza. Uma ukulungiselela kungakaqedi, indiza yamanje iyehla ijubane futhi ilinde phambi kwengosi.

Indlela imihlaba ekhethwa ngayo

Umkhethi ubeka phambili imihlaba isivakashi esingakayiboni. Kuyo imihlaba yokuqala eyishumi nambili yokuvakasha, uthanda imihlaba ama-agent ahlola iphrojekthi ayinike amaphuzu aphezulu kakhulu. Umhlaba ngamunye uneqembu lekhwalithi elisuka ku-1 kuye ku-5, futhi la maqembu asiza ukunquma ukuthi yikuphi okuhlangenwe nakho okuvela ekuqaleni.

Umkhethi uphinde afune umehluko. Uvame ukukhetha indawo eya kuyo ehlukile esimweni samanje ngohlobo, ukukhanya, noma izinga lokushisa. Isilungiselelo se-Earthly to Strange silawula ukuthi okufakiwe okungajwayelekile kuvela kaningi kangakanani.

Qonda ukwakheka kwephrojekthi

Amafayela namafolda abaluleke kakhulu yilawa:

• index.html: Ikhasi lohlelo.
• src/main.js: Izilawuli zekhibhodi, izinketho, nebha yokulawula engezansi.
• src/core: Izinhlelo zendiza, izingosi, ukukhethwa kwemihlaba, umsindo, nekhwalithi yezithombe.
• src/kit: Izingxenye ezabiwe zokwakha imihlaba, njengamazulu, amanzi, indawo, izitshalo, izilwane, izakhiwo, nezangaphakathi.
• src/worlds: Imojuli eyodwa ngomhlaba ngamunye, ukubhaliswa kwemihlaba, nehholo lokuvula.
• src/parts: Izingxenye eziyinhloko ezisetshenziswa imihlaba ngayinye.
• src/extras.js: Uhlu lwezinto zokugibela, abangane, nezitayela zobuciko.
• src/rides, src/companions, kanye ne-src/styles: Ukuqaliswa kwalezo zengezo.
• src/ui: Ikhodi yegalari neyokwabelana, kanye ne-ui.css, okuwukuphela kweshidi lesitayela lesayithi.
• vendor/three: Ilabhulali ye-three.js ehlanganisiwe.
• thumbs: Izithombe zezithonjana zegalari.
• design: Umbhalo wemihlaba namathebula okufika kokukhishwa afundwa yi-build.
• tools: Iskripthi se-build neseva yasendaweni.

Indlela imojuli yomhlaba eyakhiwe ngayo

Umhlaba uyifayela elingaphansi kwe-src/worlds. I-default export yawo iyinto equkethe umsebenzi we-build. Umhlaba kufanele futhi ubhaliswe ku-src/worlds/index.js ngesihloko sawo, uhlobo, namazwibela, ngoba umkhethi negalari zifunda lolo hlu.

Umsebenzi we-build ubuyisa izinto ezintathu ezibalulekile:

• Isigcawu se-three.js.
• Indlela yekhamera.
• Ubude bendiza.

Imihlaba eminingi ibeka ingxenye yayo eyinhloko efayeleni elihlukile elingaphansi kwe-src/parts. Izinsiza ezabiwe ku-src/kit zinikeza izingxenye ezingasetshenziswa kabusha, esikhundleni sokuba umhlaba ngamunye wakhe ngokuzimela indawo evamile.

Indlela ephephile yokutadisha noma yokwandisa imihlaba

1. Khetha umhlaba okhona ngaphansi kwe-src/worlds ofana nohlobo lwendawo ofuna ukuyiqonda.
2. Landela ama-import awo uye ku-src/parts naku-src/kit ukuze ubone ukuthi isigcawu sawo sihlanganiswa kanjani.
3. Hlola i-default export yawo nomsebenzi we-build ukuze ufunde ukwakheka kwangempela kwezinto kanye nemithetho yezindlela zekhamera esetshenziswa yirephozithri.
4. Hlola ukubhaliswa okuhambisanayo ku-src/worlds/index.js ukuze ubone imethadatha edingekayo yesihloko, uhlobo, namazwibela.
5. Qalisa i-npm start ukuze uhlole umthombo ngokushesha.
6. Yakha i-production build ukuze uqinisekise izinsiza zegalari nezokwabelana ezikhiqiziwe.

Le rephozithri inkulu ngokungavamile, ngakho ukulungisa umhlaba oseduze kuphephe kakhulu kunokuzama ukuqagela ama-API angabhaliwe noma ukwakha imojuli kusukela ekuqaleni.

Ukuziphatha komsindo nezithombe

Ukuhlanganiswa komsindo

Umhlaba ngamunye uthola i-chord ehamba kancane nezinsimbi eziningana. Eminingi iphinde isebenzise umsindo ongemuva othulile, njengomoya, amanzi, umsindo wegumbi, noma ukuduma okungaguquki komkhathi. Umhlaba ungangeza izingqimba ezifika kwezintathu ezikhethwe emiphumeleni engu-19 etholakalayo, okuhlanganisa imvula, amagagasi, izinyoni, nezinsimbi ezikude. Injini yomsindo yesiphequluli ihlanganisa le misindo esikhundleni sokulayisha amafayela omsindo.

Ikhwalithi yezithombe ezenzakalelayo

Uma izithombe zisethelwe ku-Auto, i-Portals ilinganisela izinga lekhwalithi elifanele ekhadini lezithombe. Bese inyusa noma yehlisa ukulungiswa kokudweba ukuze isize ukugcina indiza ihamba kahle. Kukhompyutha ephathekayo noma ocingweni oludala, gcina i-Auto ivuliwe ngaphambi kokuzama izilungiselelo ezidinga amandla amaningi.

Amathiphu athuthukile

Sebenzisa imodi ye-Gentle ukuze kube lula ukufinyelela

Cindezela G ukuze ugcine ikhamera izinzile futhi umkhathizwe ulingana. Lesi yisethingi yokuqala okufanele uyizame uma indiza evamile ikubangela ukungakhululeki.

Hlola kokubili izinguqulo zomthombo nezakhiwe

Sebenzisa iseva yomthombo ukuze wenze izinguquko ngokushesha, kodwa hlala uhlola isakhiwo se-dist ngaphambi kokusisebenzisa. Enye idatha yegalari, amakhasi ezincazelo, ukubuka kuqala kokwabelana, nezilungiselelo zokusingatha kutholakala kuphela ngemva kokwakha.

Hlola ukulungela kwephothali, hhayi ukubukeka kwesigcawu kuphela

Umhlaba kufanele ulungele ngaphambi kokuwela. Lapho ushintsha ikhodi yomhlaba, bheka indlela eya kwiphothali yawo kanye nesigcawu lapho uya khona. Ukwakheka okunzima noma ukulungiswa kwama-shader kungabangela indiza yehlise ijubane ngesikhathi ilindile.

Sebenzisa uhambo ngokulandelana okuphindaphindekayo

I-Portals inohambo olungu-20 oludlala imihlaba ngokulandelana okumisiwe. Izibonelo zifaka Iconsi Elilodwa Lamanzi, olusuka etsheni leqhwa luye olwandle olujulile, kanye ne-Ukuhlehla Kancane, eqala ngaphakathi kweseli eliphilayo. Ukulandelana okumisiwe kuyasiza uma ufuna ulwazi oluqondiswe kakhulu kunalokho okunikezwa isikhethi esivamile.

Hlonipha imingcele yesitoreji nobumfihlo

Uhlelo alunayo i-backend futhi aluthumeli idatha ye-akhawunti, yokulandelela, yezintandokazi, noma yezilungiselelo kuseva. Lapho ulungisa izinkinga zezintandokazi noma zokuziphatha kwemihlaba eboniwe, khumbula ukuthi la magugu agcinwa yisiphequluli.

Buyekeza amalayisensi ngaphambi kokushicilela izinguquko

Indawo yekhodi isatshalaliswa ngaphansi kwe-CC BY-NC-SA 4.0, evumela ukwabelana nokushintshwa okungekona okokuhweba ngokunikeza ukuqashelwa nangokusebenzisa ilayisensi efanayo. I-three.js neminye imisebenzi emifushane isebenzisa imigomo ehlukile. Funda i-LICENSE kanye ne-THIRD-PARTY-NOTICES.txt ngaphambi kokusabalalisa kabusha isakhiwo esilungisiwe, ikakhulukazi ngoba i-README ichaza nemvelaphi eyengeziwe yama-shader nemisebenzi ewusizo.

Isiphetho

I-Portals ihlanganisa izigcawu ze-three.js ezikhiqizwa ngezinqubo, umsindo owenziwe ngokuhlanganisa, izithombe ezizivumelanisa nezimo, ukwakheka kwemihlaba ngemuva, nokunikezwa kwemihlaba emibili ukuze idale uhambo oluqhubekayo lwesiphequluli. Ungahlola umthombo ngokushesha nge-npm start, ukhiqize isayithi eliphelele elilungele ukusatshalaliswa nge-npm run build, futhi usebenzise ukuhlelwa kwephrojekthi namamojuli emihlaba akhona njengeziqondiso lapho ufunda noma welula ukwakheka kwayo.