Furaffinity-Custom-Settings

Library to create Custom settings on Furaffinitiy

Questo script non dovrebbe essere installato direttamente. È una libreria per altri script da includere con la chiave // @require https://update.greatest.deepsurf.us/scripts/475041/1617223/Furaffinity-Custom-Settings.js

Fai una domanda, pubblica una recensione, oppure segnala lo script.

Autore: Midori Tsume
Versione: 4.3.0
Creato il: 11/09/2023
Aggiornato il: 01/07/2025
Dimensione: 60,6 KB
Licenza: MIT

Furaffinity Custom Settings

Helper Script to create Custom settings on Furaffinitiy. Also see docs on Furaffinity-Custom-Settings

How to use

@require this script

Create Settings Object:

const customSettings = new FACustomSettings(); // Multiple Settings Pages can be created
customSettings.provider = "Midori's Script Settings"; // Change Navigation Settings Name
customSettings.headerName = "My Script Settings"; // Change the Settings Header Name

See Settings for more info

Create a new Setting:

const setting = CustomSettings.newSetting(SettingType, "Setting Name");
setting.description = "Setting Description";
setting.defaultValue = DefaultValue;
setting.inInput = (target) => { doSomething(); }; // For Action Settings when clicked otherwise every time the Setting is changed
setting.addEventListener("input", (target) => { doSomthing(); }); // Alternative to onInput
setting.verifyRegex = /Regex/; // For Text Settings only

See Settings for more info

Trigger when settings should be loaded:

CustomSettings.loadSettingsMenu(); //loads Navigation Menu & Settings if on Settings Page

Feature Roadmap

Feature	Status
Create new Settings and easily access Settings change ⠀⠀⠀⠀	✅ Completed
Have different Setting Types	✅ Completed
⠀⠀⠀⠀Number (TextField that only allows Numbers)	✅ Completed
⠀⠀⠀⠀Boolean (Checkbox with a description)	✅ Completed
⠀⠀⠀⠀Action (Button with a description)	✅ Completed
⠀⠀⠀⠀Text (TextField that allow any Characters)	✅ Completed
⠀⠀⠀⠀Option (Combobox that allows multiple options)	✅ Completed
Change Settings Page Name and Header Name	✅ Completed
Have multiple different Setting Pages	✅ Completed
Import and Export Settings	✅ Completed

Documentation

Setting

The Setting class contains following Properties:

id - Can only be set once. Defines the Setting elements html id. Is set to setting Name, if not set manually.
name - Name of the Setting.
description - Description of the Setting.
type - Type of the Setting. (See SettingType for more info)
defaultValue - Default value for the Setting. (Is ignored on SettingTypes.Action)
action - Action that is executed when the Setting changes. (See Action for more info)
value - Current value of the Setting.
min - Minimum value for SettingType.Number
max - Maximum value for SettingType.Number
step - Step value for SettingType.Number
verifyRegex - Regex for validation of input for SettingType.Text

SettingType

SettingType can have the following values:

SettingType.Number - A TextField that only accepts Numbers. (Enables min, max, step)
SettingType.Text - A TextField that allows any Character. (Enables verifyRegex)
SettingType.Boolean - A Checkbox with a description.
SettingType.Action - A Button with a certain Action. (Value returns the name)
SettingType.Option - A Combobox with multiple Options

Input

The onInput Property defines a Function that is executed when the Setting changed. It receives the Settings Element as a Parameter. It can also be used with addEventListener. Example:

customSetting.onInput = (target) => {
  console.log(target.value); // Target is the HTML Element of the Setting
};

customSetting.addEventListener("input", (target) => {
  console.log(target.value);
});

Here every time the Checkbox is clicked the program prints out wether it is checked or not.