2 min read

Source: Roblox Creator Hub · CC BY 4.0 · View source · Code samples: MIT Imported 2026-10-03. Formatting adapted for this site.

ThreadPoolConfig

Controls the thread pooling scheme used by TaskScheduler. The selected value determines how many worker threads the task scheduler allocates for background work. TaskScheduler.ThreadPoolConfig defaults to Auto.

The PerCore variants scale the thread count with the number of physical CPU cores reported by the operating system. The Threads variants use an absolute count regardless of hardware. Auto lets the scheduler choose internally.

Items

NameValueDescription
Auto0Let task scheduler make a decision internally.
Threads11Utilize 1 worker thread, ignore the physical CPU core count.
Threads22Utilize 2 worker threads, ignore the physical CPU core count.
Threads33Utilize 3 worker threads, ignore the physical CPU core count.
Threads44Utilize 4 worker threads, ignore the physical CPU core count.
Threads88Utilize 8 worker threads, ignore the physical CPU core count.
Threads1616Utilize 16 worker threads, ignore the physical CPU core count.
PerCore1101Utilize 1 worker thread per available physical CPU core.
PerCore2102Utilize 2 worker threads per available physical CPU core.
PerCore3103Utilize 3 worker threads per available physical CPU core.
PerCore4104Utilize 4 worker threads per available physical CPU core.

Auto

Let task scheduler make a decision internally.

FieldValue
value0

Threads1

Utilize 1 worker thread, ignore the physical CPU core count.

FieldValue
value1

Threads2

Utilize 2 worker threads, ignore the physical CPU core count.

FieldValue
value2

Threads3

Utilize 3 worker threads, ignore the physical CPU core count.

FieldValue
value3

Threads4

Utilize 4 worker threads, ignore the physical CPU core count.

FieldValue
value4

Threads8

Utilize 8 worker threads, ignore the physical CPU core count.

FieldValue
value8

Threads16

Utilize 16 worker threads, ignore the physical CPU core count.

FieldValue
value16

PerCore1

Utilize 1 worker thread per available physical CPU core.

FieldValue
value101

PerCore2

Utilize 2 worker threads per available physical CPU core.

FieldValue
value102

PerCore3

Utilize 3 worker threads per available physical CPU core.

FieldValue
value103

PerCore4

Utilize 4 worker threads per available physical CPU core.

FieldValue
value104