This library provides generic functions for table/array manipulation,
providing all its functions inside the global `Library.table` variable. Most
functions in the `Library.table` library assume that the table represents an
array or a list. For these functions, the "length" of a table means the result
of the length operator.


Sets the value for all keys within the given table to `nil`. This causes
the `#` operator to return `0` for the given table. The allocated capacity
of the table's array portion is maintained, which allows for efficient
re-use of the space.

```lua
local grades = {95, 82, 71, 92, 100, 60}
print(grades[4], #grades) --> 92, 6
table.clear(grades)
print(grades[4], #grades) --> nil, 0
-- If grades is filled again with the same number of entries,
-- no potentially expensive array resizing will occur
-- because the capacity was maintained by table.clear.
```

This function does not delete/destroy the table provided to it. This
function is meant to be used specifically for tables that are to be
re-used.


table.clear

table

Sets all keys in the given table to `nil`.


Returns an unfrozen shallow copy of the provided table.


table.clone

Returns a shallow copy of the provided table.


Given an array where all elements are strings or numbers, returns the
string `t[i] ... sep ... t[i+1] ... sep ... t[j]`. The default value for
sep is an empty string, the default for `i` is 1, and the default for `j`
is #t. If i is greater than `j`, returns the empty string.


table.concat

The table that will be converted into a string.


The string that will be concatenated between each entry in the table.


The starting index of the table concatenation.


The ending index of the table concatenation.


Returns the given range of table elements as a string where each element
is separated by the given separator.


Creates a table with the array portion allocated to the given `number` of
elements, optionally filled with the given `value`.

```lua
local t = table.create(3, "Roblox")
print(table.concat(t)) --> RobloxRobloxRoblox
```

If you are inserting into large array-like tables and are certain of a
reasonable upper limit to the number of elements, it's recommended to use
this function to initialize the table. This ensures the table's array
portion of its memory is sufficiently sized, as resizing it can be
expensive. For small quantities this is typically not noticeable.


table.create

count

value

Returns a new table populated with many instances of the specified value.


Within the given array-like table `haystack`, find the first occurrence of
value `needle`, starting from index `init` or the beginning if not
provided. If the value is not found, `nil` is returned.

A [linear search](https://en.wikipedia.org/wiki/Linear_search) algorithm
is performed.

```lua
local t = {"a", "b", "c", "d", "e"}
print(table.find(t, "d")) --> 4
print(table.find(t, "z")) --> nil, because z is not in the table
print(table.find(t, "b", 3)) --> nil, because b appears before index 3
```


table.find

haystack

needle

init

Returns the index of the first occurrence of `needle` within `haystack`
starting from `init`.


Iterates over the provided table, passing the key and value of each
iteration over to the provided function. This function has been deprecated
and is not recommended for use in new code; use a `for` loop instead.


table.foreach

The function that will be used for the iteration. This function will
receive 2 arguments for each iteration, where the 1st argument is the
key, and the 2nd argument is the value.


Iterates over the provided table, passing the key and value of each
iteration over to the provided function.


This is similar to `Library.table.foreach()` except that index-value pairs
are passed, not key-value pairs. This function has been deprecated and is
not recommended for use in new code; use a `for` loop instead.


table.foreachi

The function that will be used for the iteration. This function will
receive 2 arguments for each iteration, where the 1st argument is the
index, and the 2nd argument is the value.


Similar to `Library.table.foreach()` except index-value pairs are passed
instead of key-value pairs.


This function makes the given table read-only, effectively "freezing" it
in its current state. Attempting to modify a frozen table throws an error.

This freezing effect is shallow, which means that you can write to a table
within a frozen table. To deep freeze a table, call this function
recursively on all of the descending tables.


table.freeze

Returns the number of elements in the table passed. This function has been
deprecated and is not recommended for use in new code; use `#t` instead.


table.getn

Returns the number of elements in the table passed.


Inserts the provided value to the target position of the array.


table.insert

The position at which the value will be inserted.


The value that will be appended to the table.


Appends the provided value to the end of the array.


This function returns `true` if the given table is frozen and `false` if
it isn't frozen. You can freeze tables using `Library.table.freeze()`.


table.isfrozen

Whether the table is frozen from `Library.table.freeze()`.


Returns `true` if the given table is frozen and `false` if it isn't
frozen.


Returns the maximum numeric key of the provided table, or zero if the
table has no numeric keys. Gaps in the table are ignored.


table.maxn

Returns the maximum numeric key of the provided table, or zero if the
table has no numeric keys.


Copies elements in table `src` from `src[a]` up to `src[b]` into table
`dst` starting at index `t`. Equivalent to the assignment statement
`dst[t], ..., dst[t + (b - a)] = src[a], ..., src[b]`.

The default for `dst` is `src`. The destination range may overlap with the
source range.

Returns `dst` for convenience.


table.move

Copies the specified range of elements from one table to another.


Returns a new table with all arguments stored into keys 1, 2, etc. and
with a field "n" with the total number of arguments. Note that the
resulting table may not be a sequence.

```lua
local t = table.pack(1, 2, 3)
print(table.concat(t, ", ")) --> 1, 2, 3
```


table.pack

values...

Returns a new table containing the provided values.


Removes from array t the element at position pos, returning the value of
the removed element. When pos is an integer between `1` and `#t`, it
shifts down the elements `t[pos+1], t[pos+2], ..., t[#t]` and erases
element `t[#t]`. If the pos parameter is not provided, pos defaults to the
length of the table removing the last element.


table.remove

The table that is having an element removed.


Removes the specified element from the array, shifting later elements down
to fill in the empty space if possible.


Sorts elements of array t in a given order, from `t[1]` to `t[#t]`. If
`comp` is given, then it must be a function that receives two elements and
returns true when the first element must come before the second in the
final order.

The error `invalid order function for sorting` is thrown if both
`comp(a, b)` and `comp(b, a)` return `true`.

If `comp` is not given, then the standard Luau operator `<` is used
instead.


table.sort

comp

An optional comparison function to be used when comparing elements in
the table. This function receives two elements, and should return true
if the first element should be sorted before the second in the final
order.


Sorts table elements using the provided comparison function or the `<`
operator.


Returns the elements from the given list. By default, `i` is 1 and `j` is
the length of `list`.

Note that this same functionality is also provided by the global
`Global.LuaGlobals.unpack()` function.


table.unpack

list

The index of the first element to unpack.


The index of the last element to unpack.


Returns all elements from the given list as a tuple.


Luau

Array

An object that runs connected functions upon a specific occurrence.

Data Type

RBXScriptSignal

Tuple

Variant

Data type having a value of either true or false.

boolean

Functions are blocks of code that can execute multiple times on command.

function

A double-precision floating-point number.

number

A sequence of characters, such as letters, numbers, and symbols.

string

Data type which can store multiple values of any non-nil type, including booleans, numbers, strings, functions, and other tables.

Overview

Experiences

Avatar

Assets

Open Cloud

Create

Discovery

Localization

Analytics

Design

Scale

Affiliates

Monetize

This method is asynchronous and returns an `Operation`, which represents the current state of the operation. It contains an endpoint path that you can poll to obtain the real response and applicable metadata. See the [documentation]({longRunningOperationsLink}) on long-running operations for more information.
            
The following sections describe the response and metadata objects that are provided when an operation completes.

Beta endpoints are ready for public use. Breaking changes are possible but rare.

This field may be set when creating a resource, but may not be modified by subsequent requests.

These fields may be set when creating a resource, but may not be modified by subsequent requests.

This field may be provided in requests, but will never be included in responses.

Per API Key: {maxInPeriod} requests every {periodInSeconds} seconds per IP Address

This field may be set on responses, but will be ignored in requests.

Note: Rate limits can be lower during high-traffic periods. Certain endpoints have additional rate limits. [Learn more about rate limits]({link}).

{limit} requests per day across all API keys for a user or group

{limit} requests per hour across all API keys for a user or group

{limit} requests per minute across all API keys for a user or group

{limit} requests per second across all API keys for a user or group

{limit} requests per minute per API key owner

{limit} request(s) per second per API key owner

The following API key permissions are required to call this endpoint. For more
information on generating proper keys, see [Manage API keys]({apiKeyReferenceDocLink}).

The following endpoints are available at paths relative to the base URL.

This string is formatted as a [FieldMask](/cloud/reference/types#fieldmask).

A JSON value can be `null`, `boolean`, `string`, `number`, `array`, or `object`.

The following scopes are required for your OAuth 2.0 application to use this endpoint. For more information on how to register an OAuth 2.0 application, see [App registration and review]({oauth2ReferenceDocLink}).

The following objects describe payloads that are accepted or returned. See each individual endpoint for more information on when these objects are used.

This string is formatted as a [Timestamp](/cloud/reference/types#timestamp).

The following scopes are required for your OAuth 2.0 application to use this endpoint. For more information on how to register an OAuth 2.0 application, see [App Registration and Review]({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 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.

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.

This allows viewing information about your inventory.

Grants access to mange your badges and spend robux.

Grants access to manage your developer products.

Grants access to read information about the experiences you follow.

Grants access to follow and unfollow 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.

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

This allows sending notifications from your experience to users.

This allows listing secrets associated with your experience.

This allows creating and updating secrets associated with your experience.

Grants access to read about your subscription products.

Grants the ability to read place information.

Grants the ability to edit place information.

This operation grants access to publish new versions of experiences to Roblox.

Grants the ability to read experience information.

Grants the ability to edit experience information.

Allows you to view user restrictions in the experience.

Allows you to edit user restrictions in the experience.

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

This allows you to view a user's social accounts.

This enables Single Sign-On functionality.

This grants access to read your profile information.

Default Value: {defaultValueStart}{defaultValueEnd}

An array is an ordered list of values. Arrays are useful for storing collections of data.

A set of key-value pairs, where the keys can be any number, string, or object.

This function returns immediately if possible, but can yield the thread that called it until it can return a value.

{nameStart}name{nameEnd} is no longer supported or maintained by Roblox.

This math operation is no longer supported or maintained by Roblox.

This member doesn’t appear in the object browser and is not intended for widespread use.

This member is only accessible only through the command bar. Attempting to access this member from scripts causes an error.

This function can’t pause the Lua thread that called it.

Attempting to access this member in scripts causes an error. You might be able to access this member from Roblox Studio's property window.

This member doesn’t appear in Roblox Studio’s Object Browser.

You can’t create an instance of this class with the Instance.new constructor.

Roblox does not replicate this member across its server-client boundary.

Lua code can’t access this member. You might be able to change its value from the property window in Roblox Studio.

This member is accessible from OpenCloud Luau execution tasks.

This object’s replication behavior is dependent on the player who owns it.

This member is accessible through the command bar and plugins. Attempting to access this member from scripts causes an error.

This member is read only. Attempting to write to this member causes an error.

This property is read-only and is safe to read in unsynchronized threads. Attempting to write to it causes an error.

This member is accessible only in CoreScripts.

Only Roblox CoreScripts can access this member, and it isn’t usable by Players.

You can read and write to this property safely from multiple threads.

This class is a top-level singleton. Retrieve an instance of this class with the GetService function.

Multiple threads can potentially write to this property, so it’s unsafe to read from unsynchronized threads.

This function pauses the Lua thread that called it until it returns a result. This doesn’t interrupt other scripts.

Manage and analyze all your experiences in one convenient place.

Learn with documentation and resources for all creators.

Learn how to create Roblox experiences with guides, tutorials, and code samples.

Build your experiences in Studio, our all-in-one IDE, and deploy to a wide variety of devices.

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.

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

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

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

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.

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.

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 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 is the tool that lets you create experiences on Roblox

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

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

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

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

table

Summary

Functions

Functions

clear

Parameters

Returns

clone

Parameters

Returns

concat

Parameters

Returns

create

Parameters

Returns

find

Parameters

Returns

freeze

Parameters

Returns

insert

Parameters

Returns

insert

Parameters

Returns

isfrozen

Parameters

Returns

maxn

Parameters

Returns

move

Parameters

Returns

pack

Parameters

Returns

remove

Parameters

Returns

sort

Parameters

Returns

unpack

Parameters

Returns