pxt arcade

Editor Game Casual Menggunakan Microsoft Makecode

• Cobalah https://arcade.makecode.com
• Forum

Repo ini berisi editor arcade yang dibangun dengan Microsoft Makecode (PXT).

Membuat dan mengedit paket

Di editor, Anda akan menemukan ikon GitHub di sebelah ikon Simpan. Gunakan integrasi GitHub untuk membangun paket perpustakaan. Anda tidak perlu menginstal server dev lokal; Semuanya bisa terjadi di editor.

Pengaturan Server Lokal

Pengaturan ini memberi Anda versi lokal editor dan kemampuan untuk memuat paket dari mesin Anda. Ini adalah pengaturan untuk mengembangkan paket baru.

Pengaturan

• Instal Node.js 8+ (Anda mungkin perlu memulai kembali setelah itu sehingga semua variabel lingkungan Anda diterapkan dengan benar)
• Clone https://github.com/microsoft/pxt-arcade ke pxt-arcade folder. Misalnya, dari pesta git

 git clone https://github.com/microsoft/pxt-arcade

• Pergi ke pxt-arcade dan Lari

 cd pxt-arcade
npm install

Jangan lupa untuk secara berkala git pull dan npm install untuk mendapatkan perubahan terbaru.

 git pull
npm install

Meluncurkan server

Perintah ini meluncurkan server web lokal. Perhatikan bahwa server web ini hanya dimaksudkan untuk tujuan pengembangan. Itu tidak dirancang atau diamankan untuk dijalankan di server web.

 npm run serve

Menyegarkan file komunitas.md

Jalankan perintah ini, lalu tambal deskripsi, tingkatkan tangkapan layar (atau rekam GIF) jika perlu.

 pxt ddt featured-game --md docs/community.md

Perintah ini membutuhkan Imagemagick (https://imagemagick.org/index.php) untuk diinstal dan tersedia di baris perintah sebagai "magick".

Memperbarui versi PXT-Arcade-SIM

Saat mengubah versi PXT-Arcade-SIM yang dirujuk oleh PXT-Arcade, Anda perlu mengubah versi di tiga tempat:

1. package.json
2. .github/workflows/pxt-buildmain.yml
3. .github/workflows/pxt-buildpush.yml

Dalam dua file YML, Anda akan menemukan versi di bidang ref di bawah langkah yang memeriksa PXT-Arcade-SIM.

Perbarui daftar putar di Markdown

Dapatkan kunci Google API dan simpan di variabel lingkungan GOOGLE_API_KEY (nyalakan data dari aplikasi).

 pxt downloadplaylists

Cara membuat paket sprite

Paket gambar dapat ditambahkan ke editor menggunakan paket PXT. Untuk membuat paket gambar.

1. Buat paket (lihat langkah -langkah di atas)
2. Siapkan sprite Anda di spritesheet: semua sprite dalam lembar harus berukuran sama dan diatur dalam kisi tanpa celah. Spritesheets harus file PNG. Contoh spritesheet terletak di sini
3. Di dalam direktori paket, buat subdirektori di mana aset akan ditempatkan dan salin spritesheet yang berisi gambar Anda ke dalamnya.
4. Buat file bernama meta.json di direktori yang Anda buat. Contoh meta.json dapat ditemukan di sini dan dokumentasi tentang semua opsi dapat ditemukan di sini
5. Buat file .json lain dengan nama dasar yang sama dengan spritesheet.
6. Di dalam file itu, tambahkan satu properti yang disebut frames yang memetakan ke berbagai nama untuk sprite. Indeks mulai di kiri atas lembar dan melanjutkan ke kiri ke kanan. Untuk file sampel lihat di sini
7. Dari akar paket Anda, jalankan perintah pxt buildsprites SUBDIR di mana SUBDIR adalah nama direktori yang berisi aset.
8. Dua file akan dihasilkan dalam root paket, satu dengan extenstion .ts dan satu dengan ekstensi .jres . Tambahkan keduanya ke pxt.json paket
9. Anda selesai! Gambar akan muncul dalam kategori gambar saat paket ditambahkan ke proyek

Pengaturan dev lokal

Instruksi ini memungkinkan Anda untuk menguji perubahan pada paket PXT-Core dan PXT-Common. Mereka lebih terlibat karena Anda perlu mengkloning dan menautkan 3 repo.

• Instal Node.js 8+ (Anda mungkin perlu memulai kembali setelah itu sehingga semua variabel lingkungan Anda diterapkan dengan benar)
• (Opsional) Instal kode studio visual

Pengaturan Otomatis

• Unduh setup.cmd ke mesin lokal Anda dan letakkan di folder Anda ingin melakukan pekerjaan pengembangan Anda
• Jalankan perintah berikut

setup.cmd /firsttime

Panggilan ini harus secara otomatis melakukan langkah -langkah yang diuraikan dalam pengaturan manual dan akan mengkloning dan menautkan ketiga repo.

Pengaturan manual

• Instal alat baris perintah PXT

 [sudo] npm install -g pxt

Di folder umum,

• Klon https://github.com/microsoft/pxt ke folder pxt
• Klon https://github.com/microsoft/pxt-common-packages ke folder pxt-common-packages
• Clone https://github.com/microsoft/pxt-arcade ke pxt-arcade folder
• Pergi ke pxt dan jalankan

 npm install
npm run build

• Pergi ke pxt-common-packages dan jalankan

 npm install
npm link ../pxt

• Pergi ke pxt-arcade dan Lari

 npm install
npm link ../pxt
npm link ../pxt-common-packages

untuk menjalankan server lokal

Dari folder root github,

 cd pxt-arcade
pxt serve --rebundle

Lebih banyak instruksi di https://github.com/microsoft/pxt#running-a-target-from-localhost

untuk mengawasi perubahan

Untuk membangun kembali secara otomatis ketika perubahan dilakukan, kita perlu menelan.

Instal Gulp:

 npm install -g gulp

dan di terminal terpisah dari pxt serve dan di pxt/ folder, jalankan:

 gulp watch

Menggunakan setup.cmd

Alih -alih harus pergi ke setiap repo, tarik dan tautkan masing -masing secara individual, Anda sekarang dapat menggunakan file setup.cmd . Penggunaan diuraikan sebagai berikut dengan opsi ini:
/firsttime mengatur lingkungan pengembang-akan mengkloning 3 repo (pxt, pxt-arcade, dan pxt-common-package) dan kemudian menjalankan /link opsi
/pull lakukan git tarik pada 3 repo (pxt, pxt-arcade, dan pxt-common-package)
/link menjalankan instal NPM dan menautkan 3 repo
/run menjalankan server lokal dan jam tangan untuk perubahan menggunakan tegukan

Melihat dokumen

Dokumen diterjemahkan di server dan dapat dilihat ketika diterima oleh browser. Gaya khusus dan pemformatan yang diperluas digunakan yang mencegah mereka dari rendering dengan benar sebagai penurunan harga umum. Meskipun Anda dapat menelusuri mereka di sini di repo, mereka tidak dimaksudkan untuk diterjemahkan dengan benar sebagai dokumen GitHub.

Berkontribusi

Proyek ini telah mengadopsi kode perilaku open source Microsoft. Untuk informasi lebih lanjut, lihat FAQ Kode Perilaku atau hubungi [email protected] dengan pertanyaan atau komentar tambahan.

Merek dagang

Microsoft, Logo Microsoft, MakeCode, dan MakeCode Arcade adalah merek dagang terdaftar dari Microsoft Corporation. Mereka hanya dapat digunakan untuk tujuan yang dijelaskan dalam dan sesuai dengan merek dagang Microsoft dan pedoman merek yang diterbitkan di https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general.aspx. Jika penggunaannya tidak tercakup dalam pedoman Microsoft yang diterbitkan atau Anda tidak yakin, silakan berkonsultasi dengan penasihat hukum Anda atau tim Makecode ([email protected]).