Class TJSGameSettings<ExtraProps>
Type Parameters
- ExtraProps extends Record<string, any> = {}
Hierarchy
- TJSGameSettings (View Summary)
Index
Constructors
Accessors
Methods
Constructors
constructor
- new TJSGameSettings<ExtraProps extends Record<string, any> = {}>(
namespace: string,
options?: Ctor,
): TJSGameSettings<ExtraProps>Creates the TJSGameSettings instance.
Type Parameters
- ExtraProps extends Record<string, any> = {}
Parameters
- namespace: string
The namespace for all settings.
Optionaloptions: CtorTJSGameSetting options.
Returns TJSGameSettings<ExtraProps>
Methods
data
Returns an iterable for the game setting data; TJSGameSettings.Data.GameSetting.
Parameters
Optionalregex: RegExpOptional regular expression to filter by game setting keys.
Returns IterableIterator<TJSGameSettings.Data.GameSetting<ExtraProps>>
Iterable iterator of
TJSGameSettings.Data.GameSetting.
entries
Returns an iterable for the game setting keys and stores.
Type Parameters
- T
Store data type.
Parameters
Optionalregex: RegExpOptional regular expression to filter by game setting keys.
Returns IterableIterator<[string, MinimalWritable<T>]>
Iterable iterator of keys and stores.
- T
getReadableStore
getStore
Returns a writable Game Settings store for the associated key.
Type Parameters
- T
Parameters
- key: string
Game setting key.
Returns MinimalWritable<T>
The associated store for the given game setting key.
getWritableStore
Returns a writable Game Settings store for the associated key.
Type Parameters
- T
Parameters
- key: string
Game setting key.
Returns MinimalWritable<T>
The associated store for the given game setting key.
keys
Returns an iterable for the game setting keys from existing stores.
Parameters
Optionalregex: RegExpOptional regular expression to filter by game setting keys.
Returns IterableIterator<string>
Iterable iterator of game setting keys.
register
Registers a setting with TJSGameSettings and Foundry core.
Parameters
- setting: TJSGameSettings.Options.GameSetting<ExtraProps>
A GameSetting instance to set to Foundry game settings.
OptionalcoreConfig: booleanWhen false this overrides the
setting.options.configparameter when registering the setting with Foundry. This allows the settings to be displayed in the app itself, but removed from the standard Foundry configuration location.
Returns void
- setting: TJSGameSettings.Options.GameSetting<ExtraProps>
registerAll
- registerAll(
settings: Iterable<TJSGameSettings.Options.GameSetting<ExtraProps>>,
coreConfig?: boolean,
): voidRegisters multiple settings.
Parameters
- settings: Iterable<TJSGameSettings.Options.GameSetting<ExtraProps>>
An iterable list of game setting configurations to register.
OptionalcoreConfig: booleanWhen false this overrides the
setting.options.configparameter when registering the setting with Foundry. This allows the settings to be displayed in the app itself, but removed from the standard Foundry configuration location.
Returns void
An object containing all TJSGameSetting store subscriber handlers for each setting
keyadded. - settings: Iterable<TJSGameSettings.Options.GameSetting<ExtraProps>>
stores
Returns an iterable for the game setting stores.
Type Parameters
- T
Parameters
Optionalregex: RegExpOptional regular expression to filter by game setting keys.
Returns IterableIterator<MinimalWritable<T>>
Iterable iterator of stores.
Registers game settings and creates a backing Svelte store for each setting. The Svelte store will update the Foundry game settings and vice versa when changes occur to the Foundry game settings the updated data is set to the store.
Note: It is possible to add multiple
onChangecallbacks on registration.Type Param
ExtraProps- Defines additional properties for game setting options / data that child implementations may define.