/tutorials/fundamentals/coding-1/coding-fundamentals.md

สอนพื้นฐานของการเขียนโค้ดด้วย Luau

คำอธิบาย

เนื้อหาของซีรีส์

พื้นฐานการเขียนโค้ด

ภาพรวม

ประสบการณ์

อวาตาร์

ทรัพยากร

Open Cloud

สร้าง

การค้นพบ

การแปลภาษา

การวิเคราะห์

การออกแบบ

การปรับขนาด

สร้างรายได้

การศึกษา

ทุกหลักสูตร

หลักสูตร

วิธีนี้ไม่ได้ทำพร้อมกันและส่งคืน `Operation` ซึ่งแสดงสถานะปัจจุบันของการดำเนินการและมีเส้นทาง Endpoint ที่คุณใช้สำรวจความคิดเห็นได้ เพื่อเช็คการตอบสนองจริงและข้อมูลเมตาที่เกี่ยวข้อง หากต้องการข้อมูลเพิ่มเติม โปรดดู[เอกสาร]({longRunningOperationsLink})เกี่ยวกับการดำเนินการที่ใช้เวลานาน
            
ส่วนต่อไปนี้จะอธิบายการตอบสนองและวัตถุข้อมูลเมตาที่จะได้รับเมื่อดำเนินการเสร็จสิ้น

Endpoint เวอร์ชัน Beta พร้อมสำหรับการใช้งานทั่วไปแล้ว อาจมีการเปลี่ยนแปลงที่ทำให้ใช้งานไม่ได้ แต่ก็เป็นไปได้ยาก

สามารถตั้งค่าฟิลด์นี้ได้เมื่อสร้างทรัพยากร แต่ไม่สามารถแก้ไขได้ด้วยคำขอภายหลัง

ตั้งค่าช่องข้อมูลเหล่านี้ตอนสร้างแหล่งข้อมูลได้ แต่จะส่งคำขอแก้ไขหลังจากนั้นไม่ได้

อาจมีช่องข้อมูลนี้ในคำขอ แต่จะไม่รวมอยู่ในการตอบกลับโดยเด็ดขาด

ต่อคีย์ API: {maxInPeriod} คำขอทุกๆ {periodInSeconds} วินาทีต่อที่อยู่ IP

อาจใช้ช่องข้อมูลนี้การตอบกลับ แต่จะเว้นไว้ในคำขอ

หมายเหตุ: อัตราสูงสุดอาจต่ำกว่านี้ในช่วงที่มีการใช้งานสูง บาง Endpoints มีอัตราสูงสุดเพิ่มเติม [เรียนรู้เพิ่มเติมเกี่ยวกับอัตราสูงสุด]({link})

{limit} คำขอต่อวันสำหรับคีย์ API ทั้งหมดสำหรับผู้ใช้หรือกลุ่ม

{limit} คำขอต่อชั่วโมงสำหรับคีย์ API ทั้งหมดสำหรับผู้ใช้หรือกลุ่ม

{limit} คำขอต่อนาทีสำหรับคีย์ API ทั้งหมดสำหรับผู้ใช้หรือกลุ่ม

{limit} คำขอต่อวินาทีสำหรับคีย์ API ทั้งหมดสำหรับผู้ใช้หรือกลุ่ม

{limit} คำขอต่อนาทีต่อเจ้าของคีย์ API

{limit} คำขอต่อวันต่อผู้ใช้แอป

{limit} คำขอต่อชั่วโมงต่อผู้ใช้แอป

{limit} คำขอต่อนาทีต่อผู้ใช้แอป

{limit} คำขอต่อวินาทีต่อผู้ใช้แอป

{limit} คำขอต่อวินาทีต่อเจ้าของคีย์ API

ขอบเขตจะควบคุมสิทธิ์ที่ข้อมูลประจำตัวของคุณมี ข้อมูลประจำตัวของคุณจะเข้าถึงได้เฉพาะ Endpoints ที่ขอบเขตที่คุณเลือกไว้รองรับเท่านั้น

เป้าหมายนี้ช่วยให้คุณสามารถจำกัดการใช้คีย์ของคุณเข้าถึง{requiredParts}ที่เลือกไว้

เป้าหมายนี้ช่วยให้คุณสามารถจำกัดการใช้คีย์ของคุณเข้าถึง{requiredParts}และ{optionalParts}ที่เลือกไว้

ประเภทเป้าหมายนั้นใช้เพื่อจำกัดทรัพยากรที่ข้อมูลประจำตัวของคุณมีสิทธิ์ใช้งานได้ แม้ว่าบัญชีของคุณจะมีสิทธิ์ใช้งานทรัพยากรเพิ่มเติม แต่จะดำเนินการได้เฉพาะทรัพยากรที่เลือกไว้เท่านั้น ทั้งนี้ ในกรณีที่ขอบเขตไม่มีส่วนเป้าหมาย คุณจะดำเนินการกับทรัพยากรที่เกี่ยวข้องทั้งหมดได้

ต้องมีสิทธิ์เข้าถึงคีย์ API ต่อไปนี้เพื่อเรียกใช้ Endpoint นี้ ดูข้อมูล
เพิ่มเติมเกี่ยวกับการสร้างคีย์ที่เหมาะสมได้ที่[จัดการคีย์ API]({apiKeyReferenceDocLink})

Endpoints ต่อไปนี้พร้อมใช้งานที่เส้นทางที่สัมพันธ์กับ URL หลัก

สตริงนี้มีรูปแบบ [FieldMask](/cloud/reference/types#fieldmask)

ค่า JSON จะเป็น `null`, `boolean`, `string`, `number`, `array` หรือ `object` ก็ได้

แอปพลิเคชัน OAuth 2.0 ของคุณต้องมีขอบเขตต่อไปนี้เพื่อใช้ Endpoint นี้ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีลงทะเบียนแอปพลิเคชัน OAuth 2.0 ได้ที่[การลงทะเบียนและการตรวจสอบแอป]({oauth2ReferenceDocLink})

วัตถุต่อไปนี้ใช้บรรยายเพย์โหลดที่ยอมรับหรือส่งคืน ดูข้อมูลเพิ่มเติมว่าจะใช้วัตถุเหล่านี้ตอนไหนที่ Endpoint แต่ละจุด

เนื้อหาคำขอเป็น

สตริงนี้มีรูปแบบ[ประทับเวลา](/cloud/reference/types#timestamp)

ต้องมีขอบเขตต่อไปนี้สำหรับแอปพลิเคชัน OAuth 2.0 ของคุณเพื่อใช้ Endpoint นี้ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีลงทะเบียนแอปพลิเคชัน OAuth 2.0 ได้ที่[การลงทะเบียนและการตรวจสอบแอป]({oauth2ReferenceDocLink})

This allows viewing information about your assets.

This allows uploading and updating assets to Roblox.

This allows granting asset permissions to any subjects (including groups and experiences) and assets your account has access to.

Grants the ability to update badges owned by the user.

This allows viewing information about your commerce items.

This allows making changes to your synced commerce items.

This allows viewing information about your commerce merchant connections.

This allows editing of your commerce merchant connections.

This allows you to view information about your Creator Store products.

This allows you to modify information about your Creator Store products.

Grants access to create data stores on your behalf.

Grants access to read a list of data stores.

Grants access to take a snapshot of your data stores.

Grants access to create entries in your data stores.

Grants access to mark specified entries for deletion.

Grants access to list your data store's entries.

Grants access to read specified entries in your data stores.

Grants access to update the value, attributes, and users of an entry.

Grants access to delete revisions of your data store's entries.

Grants access to list revisions for your data store's entries.

Grants access to read revisions of your data store's entries.

This allows viewing information about your communities.

This allows you to manage community join requests and role updates of lower-ranked community members for your account.

Allows you to view an instance's property data.

Allows you to modify the property data of instances (currently only supports Scripts).

This allows viewing information about your inventory.

Grants access to mange your badges and spend robux.

Grants access to update the authorized user's badges.

Grants access to manage your developer products.

Grants access to read information about the experiences you have notifications on for.

Grants access to turn on or off notifications for experiences on your behalf.

Grants access to manage your communities.

Grants permission to read community information.

Grants access to read and write your localization tables

Grants access to manage team collaboration for all experiences you own.

Grants access to manage your experiences and certain information associated with your experiences (e.g. localization information).

Grants access to read your experiences' localization information.

Grants access to modify your experiences' localization preferences.

Grants access to manage your user account.

Grants access to modify user localization preferences.

Allows you to view the status, logs, and results of Luau execution tasks for the associated place.

Allows you to create new Luau execution tasks for the associated place.

Grants access to asynchronously flush all data structures in the universe.

Grants access to discard read items from the front of the queue.

Grants access to read items at the front of the queue.

Grants access to read your memory store items.

Grants access to create, update, and delete map items.

This grants the ability to publish messages on behalf of users.

This allows sending notifications from your experience to users.

(Deprecated) Grants access to read a list of entries in an ordered data store.

(Deprecated) Grants access to create a new entry in an ordered data store.

Grants access to list entries from an ordered data store.

Grants access to create entries in an ordered data store.

This allows listing secrets associated with your experience.

This allows creating and updating secrets associated with your experience.

This permission allows you to submit an evaluation job and view the job result.

Grants access to read about your subscription products.

Grants the ability to read place information.

Grants the ability to edit place information.

Grants access to publish new versions of experiences to Roblox.

Grants the ability to read experience information.

Grants access to edit the authorized user's experiences.

Allows you to view user restrictions in the experience.

Allows you to edit user restrictions in the experience.

Grants the ability to read the authorized user's premium and verified status.

This allows you to view the authorized user's social accounts.

This enables Single Sign-On functionality.

This grants access to read your profile information.

ฟังก์ชันนี้จะส่งคืนค่าทันทีหากเป็นไปได้ แต่อาจหยุดการทำงานของเธรดที่เรียกใช้จนกว่าจะส่งคืนค่าได้

Roblox ไม่รองรับหรือดูแลรักษา{nameStart}ชื่อ{nameEnd}อีกต่อไป

Roblox ไม่รองรับหรือปรับปรุงการคำนวณนี้อีกต่อไป

สมาชิกรายการนี้ไม่ปรากฏในเบราว์เซอร์วัตถุและไม่ได้มีไว้สำหรับการใช้งานอย่างแพร่หลาย

สามารถเข้าถึงสมาชิกรายการนี้ได้ทางแถบคำสั่งเท่านั้น หากพยายามเข้าถึงจากสคริปต์ จะเกิดข้อผิดพลาด

ฟังก์ชันนี้ไม่สามารถหยุดเธรดภาษา Lua ที่เรียกใช้ไว้ชั่วคราว

หากพยายามเข้าถึงสมาชิกรายการนี้ในสคริปต์ จะเกิดข้อผิดพลาด คุณอาจเข้าถึงสมาชิกรายการนี้ได้จากหน้าต่างคุณสมบัติของ Roblox Studio

สมาชิกรายการนี้ไม่ปรากฏในเบราว์เซอร์วัตถุของ Roblox Studio

คุณไม่สามารถสร้างอินสแตนซ์ของ Class นี้ด้วยคอนสตรัคเตอร์ Instance.new

Roblox ไม่ได้จำลองสมาชิกรายการนี้ข้ามระหว่างเซิร์ฟเวอร์กับไคลเอนต์

โค้ดภาษา Lua เข้าถึงสมาชิกรายการนี้ไม่ได้ คุณอาจเปลี่ยนค่าได้จากหน้าต่างคุณสมบัติใน Roblox Studio

เข้าถึงสมาชิกรายการนี้ได้จากการดำเนินการของ Luau ใน OpenCloud

พฤติกรรมการจำลองวัตถุนี้ขึ้นอยู่กับผู้เล่นที่เป็นเจ้าของ

สามารถเข้าถึงสมาชิกรายการนี้ได้ทางแถบคำสั่งและปลั๊กอิน หากพยายามเข้าถึงจากสคริปต์ จะเกิดข้อผิดพลาด

สมาชิกรายการนี้เป็นแบบอ่านอย่างเดียว หากพยายามเขียน จะเกิดข้อผิดพลาด

คุณสมบัตินี้อ่านได้อย่างเดียวและอ่านได้อย่างปลอดภัยในเธรดที่ไม่ซิงค์ การพยายามเขียนคุณสมบัตินี้อาจทำให้เกิดข้อผิดพลาด

สามารถเข้าถึงสมาชิกรายการนี้ได้ใน CoreScripts เท่านั้น

มีเพียง Roblox CoreScripts เท่านั้นที่สามารถเข้าถึงสมาชิกรายการนี้ได้ ซึ่ง Player จะไม่สามารถใช้ได้

อ่านและเขียนคุณสมบัตินี้ได้อย่างปลอดภัยจากหลายเธรด

Class นี้เป็นซิงเกิลตันระดับบนสุด ดึงอินสแตนซ์ Class นี้ด้วยฟังก์ชัน GetService

อาจมีหลายเธรดที่เขียนไปยังคุณสมบัตินี้ได้ จึงไม่ปลอดภัยที่จะอ่านจากเธรดที่ไม่ได้ซิงค์

ฟังก์ชันนี้จะหยุดเธรดภาษา Lua ที่เรียกใช้ชั่วคราวจนกว่าจะได้ผลลัพธ์ โดยการดำเนินการนี้จะไม่ขัดจังหวะสคริปต์อื่น

สร้างประสบการณ์แรกของคุณ

จัดการและวิเคราะห์ประสบการณ์ทั้งหมดของคุณได้ในที่เดียว

เรียนรู้จากเอกสารและแหล่งข้อมูลสำหรับครีเอเตอร์ทุกคน

เรียนรู้วิธีสร้างประสบการณ์ Roblox ด้วยคู่มือ คู่มือการใช้งาน และตัวอย่างการเขียนโค้ด

สร้างประสบการณ์ของคุณใน Studio ซึ่งเป็น IDE แบบครบวงจร และนำไปใช้กับอุปกรณ์ที่หลากหลาย

Dependable ways to offer value over time to your audience

Since March, most creators who used the New Ads Manager experienced a 44% drop in cost per play and an 89% increase in quality play-through rates.

Find users for your experience with Ads Manager!

A great way to find initial players for your game!

Use the Reactivate Users objective to bring users back

Learn how to create successful ads that drive traffic to your creations

Chart your experience's growth and discover opportunities to improve

Learn how to apply movement to your characters and environments

Learn how to upload or use assets from Store in your creations

Learn how to convert a model into an avatar in less than 5 minutes.

Create Avatar items and publish it to Marketplace

Sorted by highest revenue over the last 7 days

Learn about what you can make and sell on the marketplace

The avatar represents every Roblox user as a customizable character

Manage your permanent and temporary bans from Creator Hub.

See this thread of cool creations being built by the community

Learn basic modeling techniques in blender

Find models, scripts, and plugins made by other creators

Learn how to cage your avatar items from Roblox's own 3D artist

Learn how to configure characters to ensure all avatar features work properly

Learn how to create objects that interact with the world or other users

Make and sell your first basic clothing item on Roblox

Use Studio's collaboration tools to work with your team at the same time

Check out what’s trending on the Creator Marketplace

Check out what's trending on the Creator Store

Participate in community events held by other Creators

Find tutorials written by the Creator community

Learn how to implement a Connection invite reward system

Keep players engaged and monetized with content updates

Captivate your audience with an enjoyable gameplay cycle

Drive engagement and progress with fun, repetitive gameplay

Kick off your creator journey by making your very first place.

Learn how to create a sliding door without writing any code

Alex shares first-hand experience behind creating the hit experience, JailBreak

Blake found a passion in making realistic, quirky carnival games

The Clemens are the family-owned studio behind hits like The Survival Game

Jasmine is the artist behind some of the most popular avatar items on Marketplace

Jessica is the designer behind imaginative environments like in Alo Yoga

Jenni is the UGC creator and artist behind many popular collaborations

Morphist’s unique style combines cutesy and emo aesthetics

The Riotfall creators travel to find inspiration for their immersive environments

Stephen shares their love of programming tools

Sam shares how they got started designing fashion items that they wish existed

All objects that make up a 3D world, such as parts and lighting

Use data stores to save player progress and handle player position.

Learn about the range of debugging tools available in Studio

See your progress towards your next cash out!

Use the developer console to debug your experience when testing

Adding subscriptions to your experience helps build long term relationships with your user base. Enable subscriptions before December 15, 2023, and enjoy 3 months of lower rates.

Look at the top Experiences out to get inspiration

Get started with Studio, Roblox’s creation engine

Add a few lines of code to unlock new dashboards to understand your onboarding and other funnels and track your in-game economy.

Minty teaches Enyu about constructive solid geometry.

Build live, cross-server events and cutscenes on a structured sequence

Learn how to create timed events for your experiences

Create time-based events for increased discoverability across Roblox. Announce your latest update, highlight an activity, or celebrate a milestone with your players!

Learn about how to target the age group right for your Creation through Experienced Guidelines

Gain knowledge and expertise directly from Roblox

Learn how to implement a friend invite reward system

Understand the basics of how to create a game

Learn how you can control how your data is used to train AI. {linkStart}Read More{linkEnd}

Easily create custom textures using our AI tools

Use our all-in-one creation engine to build anything you can imagine

PolarCub shares all the tips tricks to make UGC items

Learn best practices for blocking out your environments.

Leverage Guilded to build a community for your Creation

Join our incredible cast of creators for a Halloween game jam

Use the head part to create facial animations or trigger emotes

Using metrics to understand where you can improve your gameplay

Figure out how to keep them coming back to your game

User input allow users to interact with your experience environment

Guide players through their first time playing your experience

Create clothing that stretchs and fit over any avatar body

At Roblox, we believe you learn best by doing. Choose one of our guides to explore more of what the platform offers.

Get help writing code and answers to your creation questions

The Lighting and SoundService let you control environmental effects

Take a deep dive into lighting your environment and adding terrain.

Learn how to adapt your content to different languages and cultural norms

Object-oriented programming in Luau. When does it make sense?

This walkthrough covers attachments, beams, and some basic scripting concepts that shows you how to set player health to 0 if they touch something

Cultivating an active player base is an instrumental part of developing a successful and enduring game.

Learn how to use the LuauHeap tool to keep an eye on memory usage.

Get started with the performance optimization and troubleshooting tool

Microprofiler provides timing information for the task scheduler

Dive deep into frame colors, flame graphs, and more

Learn how module scripts work and when to use them.

Understand how to use metrics to be more successful

Improve the performance of computationally intensive Luau scripts

View your daily benchmarks, insights, and real-time metrics to take {boldStart}{experienceName}{boldEnd} to the next level.

Learn how to use NPCs (non-player characters) in your experiences

@minty creates an obby live from scratch using suggestions from chat

Our platform provides you with unparalleled opportunities to create. Get started by exploring the Creator Hub, Roblox Studio, and our vibrant Creator community.

Our platform provides you with unparalleled opportunities to create.

Our community of award-winning studios and self-taught creators all started here, just like you. 

A principal environment artist at Roblox covers how and why to use packages

Learn how to deal with the most common performance problems.

Staff stream about gravity, material properties, and constraints

Learn about what happens when a user joins an experience

Plugins add additional features or functionality to your creations

Let's tour PolarCub's UGC Homestore! Also, Temprist shows up.

Finalize your assets, spruce up your terrain, add effects, and oh my.

Learn how to drive traffic and awareness to your creations

Catch up on all the highlights from this year's RDC

Learn how to sell and promote avatar items with insights from the experts.

Learn efficient workflows for making avatar items in Blender.

Madison_Hatter2 shows how to texture and publish a simple avatar item.

Learn about what’s possible with our creation engine

Learn how to implement rewarded video ads in your experiences.

Learn hwo to rig an R15 humanoid character model

Make and sell your first basic rigid accessory on Roblox

Get a preview of some of the new features and capabilities coming soon to Roblox

Studio คือเครื่องมือที่ช่วยคุณในการสร้างประสบการณ์บน Roblox

DucksAreYellow and Rush Bogin talk best practices and gotchas for UGC.

Learn how to use the script editor in Studio to create custom scripts

Andrew shows you where to place your scripts, so they run properly.

Scripting lets you add immersive interactions for your users

Make and sell your first pair of shoes on Roblox.

Learn Studio shortcuts and key commands that make building quicker

What are the pros and cons of the two approaches?

Keep your transitions smooth even when the target value changes.

Learn how to integrate features that allow players to play with friends

Learn how to integrate features that allow players to play with Connections

Create a Sponsored Ad to get your Creation in front of more Creators

When should you consider using an UnreliableRemoteEvent?

An in-depth look at how to debug your code in Roblox Studio.

Studio is an all-in-one tool for building on Roblox. Try making something today!

Learn how to offer players recurring benefits for a monthly fee

Grow your experience with the help of other Creators

Use the terrain editor to generate and alter terrain in Studio

Experiences like {boldStart}{experienceName}{boldEnd} saw an average +8.5% lift in qualified play through rate with personalization.

Learn about all the best methods for telling time in Roblox experiences.

Translations can help your Creation reach tons of different audiences

Tour the new UGC Homestore template with Minty and SCHLEEMPH

Use the new Style Manager to create, manage, and apply UI styles.

Learn about how to build for Roblox's unique audience

What are they and how you can use them to build

Learn all about place versions, packages, and script history.

Watch a quick introduction to creating on Roblox, then jump into Studio

Read the latest announcements from Roblox Staff

Manage and grow your creations all in one convenient place

Workspace holds objects that you want the engine to render in your project

Staff stream covering parts, meshes, terrain, and lighting

Build wild obbies, design epic race tracks and decorate every detail.
Your world is waiting! Let’s create something epic.

Intro to texturing for UGC ft. Madison_Hatter2

Every public experience must have a content maturity label to be playable.