pxt arcade

ตัวแก้ไขเกมแบบสบาย ๆ โดยใช้ Microsoft MakeCode

• ลองใช้ https://arcade.makecode.com
• ฟอรัม

repo นี้มีตัวแก้ไขอาร์เคดที่สร้างขึ้นด้วย Microsoft MakeCode (PXT)

การสร้างและแก้ไขแพ็คเกจ

ในบรรณาธิการคุณจะพบไอคอน GitHub ถัดจากไอคอนบันทึก ใช้การรวม GitHub เพื่อสร้างแพ็คเกจไลบรารี คุณไม่จำเป็นต้องติดตั้งเซิร์ฟเวอร์ dev ท้องถิ่น ทุกอย่างสามารถเกิดขึ้นได้ในบรรณาธิการ

การตั้งค่าเซิร์ฟเวอร์ท้องถิ่น

การตั้งค่านี้ให้ตัวแก้ไขเวอร์ชันท้องถิ่นและความสามารถในการโหลดแพ็คเกจจากเครื่องของคุณ นี่คือการตั้งค่าเพื่อพัฒนาแพ็คเกจใหม่

การตั้งค่า

• ติดตั้ง node.js 8+ (คุณอาจต้องรีสตาร์ทหลังจากนั้นดังนั้นตัวแปรสภาพแวดล้อมทั้งหมดของคุณจะถูกนำไปใช้อย่างถูกต้อง)
• โคลน https://github.com/microsoft/pxt-arcade ไปยังโฟลเดอร์ pxt-arcade ตัวอย่างเช่นจาก Git Bash

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

• ไปที่ pxt-arcade แล้ววิ่ง

 cd pxt-arcade
npm install

อย่าลืม git pull และ npm install เป็นระยะเพื่อรับการเปลี่ยนแปลงล่าสุด

 git pull
npm install

การเปิดตัวเซิร์ฟเวอร์

คำสั่งนี้เปิดใช้งานเว็บเซิร์ฟเวอร์ท้องถิ่น โปรดทราบว่าเว็บเซิร์ฟเวอร์นี้มีไว้เพื่อการพัฒนาเท่านั้น ไม่ได้รับการออกแบบหรือรักษาความปลอดภัยให้ทำงานบนเว็บเซิร์ฟเวอร์

 npm run serve

รีเฟรชไฟล์ md community.md

เรียกใช้คำสั่งนี้จากนั้นแก้ไขคำอธิบายปรับปรุงภาพหน้าจอ (หรือบันทึก GIF) หากจำเป็น

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

คำสั่งนี้ต้องการ imageMagick (https://imagemagick.org/index.php) ที่จะติดตั้งและพร้อมใช้งานที่บรรทัดคำสั่งเป็น "Magick"

การอัปเดตเวอร์ชัน PXT-arcade-SIM

เมื่อเปลี่ยนเวอร์ชันของ PXT-arcade-SIM ที่อ้างอิงโดย PXT-Arcade คุณต้องเปลี่ยนเวอร์ชันในสามแห่ง:

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

ในไฟล์ YML สองไฟล์คุณจะพบเวอร์ชันในฟิลด์ ref ภายใต้ขั้นตอนที่ตรวจสอบ PXT-Arcade-SIM

อัปเดตเพลย์ลิสต์ใน Markdown

รับคีย์ Google API และเก็บไว้ในตัวแปรสภาพแวดล้อม GOOGLE_API_KEY (เปิดข้อมูลจากแอพ)

 pxt downloadplaylists

วิธีสร้างชุดสไปรต์

แพ็คของรูปภาพสามารถเพิ่มลงในตัวแก้ไขโดยใช้แพ็คเกจ PXT เพื่อสร้างแพ็คเกจภาพ

1. สร้างแพ็คเกจ (ดูขั้นตอนด้านบน)
2. เตรียมสไปรต์ของคุณใน Spritesheet: สไปรต์ทั้งหมดในแผ่นจะต้องมีขนาดเท่ากันและจัดเรียงในกริดโดยไม่มีช่องว่าง Spritesheets ต้องเป็นไฟล์ PNG ตัวอย่าง Spritesheet ตั้งอยู่ที่นี่
3. ภายในไดเรกทอรีแพ็คเกจสร้างไดเรกทอรีย่อยที่จะวางสินทรัพย์และคัดลอก Spritesheet ที่มีรูปภาพของคุณลงไป
4. สร้างไฟล์ชื่อ meta.json ในไดเรกทอรีที่คุณสร้างขึ้น ตัวอย่าง meta.json สามารถพบได้ที่นี่และเอกสารเกี่ยวกับตัวเลือกทั้งหมดสามารถพบได้ที่นี่
5. สร้างไฟล์ .json อื่นที่มีชื่อเบสเดียวกับ Spritesheet
6. ภายในไฟล์นั้นเพิ่มคุณสมบัติเดียวที่เรียกว่า frames ซึ่งแมปกับอาร์เรย์ของชื่อสำหรับสไปรต์ ดัชนีเริ่มต้นที่ด้านบนซ้ายของแผ่นและไปจากซ้ายไปขวา สำหรับไฟล์ตัวอย่างดูที่นี่
7. จากรูทของแพ็คเกจของคุณเรียกใช้คำสั่ง pxt buildsprites SUBDIR ที่ SUBDIR เป็นชื่อของไดเรกทอรีที่มีสินทรัพย์
8. สองไฟล์จะถูกสร้างขึ้นในรูทแพ็คเกจหนึ่งไฟล์ที่มีส่วนขยาย .ts และอีกไฟล์หนึ่งพร้อมส่วนขยาย .jres เพิ่มทั้งสองไปยัง pxt.json ของแพ็คเกจ
9. เสร็จแล้ว! ภาพจะปรากฏในหมวดหมู่รูปภาพเมื่อมีการเพิ่มแพ็คเกจลงในโครงการ

การตั้งค่า dev ท้องถิ่น

คำแนะนำเหล่านี้ช่วยให้คุณทดสอบการเปลี่ยนแปลงกับ PXT-Core และ PXT-common-packages พวกเขามีส่วนร่วมมากขึ้นในขณะที่คุณต้องการโคลนและเชื่อมโยง 3 repos

• ติดตั้ง node.js 8+ (คุณอาจต้องรีสตาร์ทหลังจากนั้นดังนั้นตัวแปรสภาพแวดล้อมทั้งหมดของคุณจะถูกนำไปใช้อย่างถูกต้อง)
• (ไม่บังคับ) ติดตั้งรหัส Visual Studio

การตั้งค่าอัตโนมัติ

• ดาวน์โหลด setup.cmd ไปยังเครื่องในพื้นที่ของคุณและวางไว้ในโฟลเดอร์ที่คุณต้องการทำงานพัฒนาของคุณ
• เรียกใช้คำสั่งต่อไปนี้

setup.cmd /firsttime

การโทรนี้ควรทำตามขั้นตอนที่ระบุไว้ในการตั้งค่าด้วยตนเองโดยอัตโนมัติและจะโคลนและเชื่อมโยงทั้งสาม repos

การตั้งค่าด้วยตนเอง

• ติดตั้งเครื่องมือบรรทัดคำสั่ง pxt

 [sudo] npm install -g pxt

ในโฟลเดอร์ทั่วไป

• Clone https://github.com/microsoft/pxt ไปยังโฟลเดอร์ pxt
• โคลน https://github.com/microsoft/pxt-common-packages ไปยังโฟลเดอร์ pxt-common-packages
• Clone https://github.com/microsoft/pxt-arcade ไปยังโฟลเดอร์ pxt-arcade
• ไปที่ pxt และเรียกใช้

 npm install
npm run build

• ไปที่ pxt-common-packages และเรียกใช้

 npm install
npm link ../pxt

• ไปที่ pxt-arcade แล้ววิ่ง

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

เพื่อเรียกใช้เซิร์ฟเวอร์ท้องถิ่น

จากโฟลเดอร์ Root GitHub

 cd pxt-arcade
pxt serve --rebundle

คำแนะนำเพิ่มเติมที่ https://github.com/microsoft/pxt#running-a-target-from-localhost

เพื่อดูการเปลี่ยนแปลง

ในการสร้างใหม่โดยอัตโนมัติเมื่อทำการเปลี่ยนแปลงเราจำเป็นต้องมีอึก

ติดตั้ง Gulp:

 npm install -g gulp

และในเทอร์มินัลแยกจาก pxt serve และใน PXT/ โฟลเดอร์ให้เรียกใช้:

 gulp watch

ใช้ setup.cmd

แทนที่จะต้องไปที่ repo แต่ละครั้งให้ดึงและเชื่อมโยงแต่ละรายการเป็นรายบุคคลตอนนี้คุณสามารถใช้ไฟล์ setup.cmd การใช้งานมีการระบุดังนี้ด้วยตัวเลือกเหล่านี้:
/firsttime ตั้งค่าสภาพแวดล้อมนักพัฒนา-Will Clone 3 repos (PXT, PXT-arcade และ PXT-common-packages) จากนั้นเรียกใช้ตัวเลือก Run /Link
/pull ดึง Git บน 3 repos (pxt, pxt-arcade และ pxt-common-packages)
/link เรียกใช้ NPM ติดตั้งและเชื่อมโยง 3 repos
/run รันเซิร์ฟเวอร์ท้องถิ่นและนาฬิกาสำหรับการเปลี่ยนแปลงโดยใช้ Gulp

การดูเอกสาร

เอกสารจะแสดงผลที่เซิร์ฟเวอร์และสามารถดูได้เมื่อเบราว์เซอร์ได้รับ มีการใช้สไตล์พิเศษและการจัดรูปแบบขยายซึ่งป้องกันไม่ให้การแสดงผลอย่างถูกต้องเป็น markdown ทั่วไป ในขณะที่คุณสามารถเรียกดูพวกเขาที่นี่ใน repo พวกเขาไม่ได้หมายถึงการแสดงผลอย่างถูกต้องเป็นเอกสาร GitHub

การบริจาค

โครงการนี้ได้นำรหัสการดำเนินงานของ Microsoft โอเพ่นซอร์สมาใช้ สำหรับข้อมูลเพิ่มเติมโปรดดูจรรยาบรรณคำถามที่พบบ่อยหรือติดต่อ [email protected] พร้อมคำถามหรือความคิดเห็นเพิ่มเติมใด ๆ

เครื่องหมายการค้า

Microsoft, โลโก้ Microsoft, MakeCode และ MakeCode Arcade เป็นเครื่องหมายการค้าจดทะเบียนของ Microsoft Corporation พวกเขาสามารถใช้เพื่อวัตถุประสงค์ที่อธิบายไว้ในและตามแนวทางเครื่องหมายการค้าและแบรนด์ของ Microsoft ที่เผยแพร่ได้ที่ https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general.aspx หากการใช้งานไม่ครอบคลุมในแนวทางที่เผยแพร่ของ Microsoft หรือคุณไม่แน่ใจโปรดปรึกษาที่ปรึกษากฎหมายหรือทีม MakeCode ของคุณ ([email protected])