# Index

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Load Roblox Characters</td><td></td><td></td><td><a href="/lrc/load-roblox-characters-4">LRC</a></td></tr><tr><td>Scriptable Roblox iOS Widgets</td><td></td><td></td><td><a href="/scriptable/collection-of-roblox-ios-widgets">Scriptable Roblox iOS Widgets</a></td></tr></tbody></table>


# Load Roblox Characters 4

Load Roblox Characters 4.x.x – LRC4 – User Manual

Load Roblox Characters 4 (LRC4) is the fourth addition of Load Roblox Characters. Fundamentally, it still is the same, just more capable and smooth!

## Features

* Load characters in R6 or R15
* Auto update characters
* Inspect characters
* Select from a user's saved outfits
* Quickly select characters of you, developers in your team create, your recently loaded characters, your bookmarks, your friends, or search for any user on Roblox.

## Improvements over LRC3

LRC4 is a full revamp and the next major version of [LRC3](/lrc/load-roblox-characters-3), here's some of the main improvements LRC4 brings:

* LRC is now served in a widget, allowing you to resize and dock it however you want and it will adapt to its best ability to fit seamlessly into wherever you need it.
* LRC4 automatically picks the best rig type for each user's character, and will automatically choose the best rig type for user's saved outfits as well.
* LRC4 introduces new options for loading characters, such as making them inspectable via pre-made scripts, hiding their health, or disabling autoscaling. Additionally, if you select an option which overrides any toggle, you'll be made aware.
* You can now bookmark characters for easy access.
* Inserting characters should now position them more easily in view of your camera than before.
* You can now apply default settings, clear all data and cache, or simply the cache of individual users.
* LRC4 is all-in-all more smooth, displaying progress bars and spinners when actions require wait time. Additionally, LRC4 (4.0.2+) introduces a resolver in-case you have a network issue or Roblox experiences issues.
* (4.1.0+) Improved update notice and development installation label (existed since 4.0.0, improved 4.1.0) which appears when the plugin is loaded locally.

***

## How to install LRC4 (Load Roblox Characters 4)

1. To install LRC4, open Roblox Studio and navigate into any place (local file, game, etc.)
2. Navigate to the view tab, open the Toolbox, and in the dropdown selector, select 'Plugins'
3. Search for 'Load Roblox Characters'
4. The first result should be Load Roblox Characters 4, click on it
5. At the bottom of the page, click 'Install'

***

## How to navigate LRC4

### Open the plugin widget

When opening studio for the first time with LRC4 installed, under your plugins tab, you should see a toolbar named 'Wolfite'. Under that toolbar, you should see the button 'Load Character'. Click it to open the LRC4 widget.

Upon opening the plugin for the first time, it may take some time to load. This is because if you don't use LRC4 actively in a studio session, it won't initiate to save resources for your system. However, this makes it so it will take longer to load the first time you open it.

### Use your home page

LRC4 should automatically open to the home page upon loading, no input is required. Once you're there, you can click on yourself, developers in your team create session, your bookmarks or recents, your friends, or you can search for anyone with the search bar at the bottom of Home. You won't see bookmarks or recents if this is your first time with the plugin, but read further to learn how to do that!

### Navigate to the loader

Navigating to the loader is simple. When the plugin is opened, your character should automatically be loaded in the background and ready to be shown in the loader. To open the loader, either click and load another character from the home screen (you can also right-click them too!) or use the bottom nav-bar to open the loader.

### Navigate to settings

To open settings in LRC4, click the cog icon in the bottom nav-bar.

***

## Apply default settings and reset all local data

To apply default settings or reset all local data of the plugin in LRC4, you can

1. Open the plugin
2. Navigate to the settings page
3. Scroll down to the bottom of the settings page
4. Click on 'Apply default settings' or 'reset all data' in the bottom-right corner
5. Follow the prompts to finalise your decision.

<figure><img src="https://3666429385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUCdEPI04ZmVrbWQv7DP%2Fuploads%2FspoKPn9pvdSzvyopDluy%2FLRC4-1345.png?alt=media&amp;token=1090b945-8009-4b0f-8a9d-f2f0feb96077" alt=""><figcaption></figcaption></figure>

***

## How to use the loader

Once you've [navigated to the loader](#navigate-to-the-loader), you'll see two main panels. In the first panel, you'll see the user/character you wish to load. Here you can bookmark their character for easy access in the future.

In the second panel, you'll see the loading options for the character. At the top, you can select the rig type or choose another outfit the user has saved. LRC4 should automatically select the correct rig type for each user's character and all their saved outfits. Additionally, you'll see all the following configuration toggles under here:

* Auto Update
* Inspectable
* Pushable
* Show Nametag
* Hide Health
* Disable Auto Scaling

<figure><img src="https://3666429385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUCdEPI04ZmVrbWQv7DP%2Fuploads%2FwFKebgU4VqauvyWW9DQM%2FLRC4-2148.png?alt=media&amp;token=ee824be5-f850-4bba-aed3-29eb83b73e46" alt=""><figcaption></figcaption></figure>

***

## Troubleshooting Guide

If you're having issues with LRC4, here's some things you can try:

1. First, refer to the troubleshooting guide below
2. If none of these solutions help, try reaching out to the developer by creating a ticket on Discord. This should be your last-resort of an option. You can find the Discord server on the [LRC4 Roblox Creator Hub listing page](https://create.roblox.com/store/asset/8867876284/Load-Roblox-Characters-4) as a 13+ user.

### Error: Could not connect to Roblox, check your connection and try again

<figure><img src="https://3666429385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUCdEPI04ZmVrbWQv7DP%2Fuploads%2FjdfyXmVz5mI2qWztdiqp%2FLRC4-Connection-Error.png?alt=media&amp;token=66daaac3-eca8-4088-867f-056dddbbdfd1" alt=""><figcaption><p>LRC4 Network Error Resolver page: "Could not connect to Roblox, check your connection and try again."</p></figcaption></figure>

If you're receiving a network error when trying to open the plugin, here's what you can try:

* Ensure your network connection and ensure that you can load Roblox.com
* Ensure that Roblox isn't experiencing any issues at [status.roblox.com](https://status.roblox.com) as these may affect the plugin loading
* Try restarting studio or re-installing the plugin

### Error: Oxalyl Proxy responded with 401 Unauthorizated error.

If you receive a 401 error regarding the Oxalyl Proxy, please ensure that your plugin installation is up-to-date even if it doesn't directly display 'Update available' in the plugin. If this issue still persists, you may need to [create a ticket](#troubleshooting-guide).

### Error: You are sending requests too fast. Please wait and try again later.

If you receive this error, please try waiting before sending any more requests. You can avoid doing this by not viewing or selecting any saved outfits. If the issue persists, you may need to restart Roblox Studio.

### Error: TestService error usi requests flag is enabled

This is an internal error used for testing network errors when querying UserService endpoints. If you have an attribute titled `lrc4__error_usi_requests` attributed to TestService, all wrapped requests to UserService information will error.

### Home: Some elements have failed to load

This may appear after resolving a network error. This error cannot be resolved without restarting Roblox Studio.

## Clear cache from a user or remove a character from your recently loaded

To remove a user/character from your recently loaded, navigate to the home page, identify the user, hover over their card, and right-click it, then select `Remove from Recent`. To remove associated cache, do the same, except navigate to `Advanced...` then `Clear associated cache...`. This should remove the associated cache saved such as user information and outfit information. If you do this too often you may reach rate-limits.

***

## Resources

* [LRC4 - Roblox Creator Hub listing](https://create.roblox.com/store/asset/8867876284/Load-Roblox-Characters-4)
* [LRC3 - Load Roblox Characters 3](/lrc/load-roblox-characters-3)


# Load Roblox Characters 3

Load Roblox Characters 3.x.x – LRC3 – User Manual

> **WARNING**
>
> The LRC3 plugin is [archived here](https://create.roblox.com/store/asset/74094428811433/LRC3-ARCHIVE) and should be used for edge-cases only and is incredibly unstable. It may be removed in the future.

Load Roblox Characters 3 (LRC3) is the third addition of Load Roblox Characters, releasing on the 23rd of June, 2023 as `3.0a`. It should not be used and is an archived and unstable state. Features like loading user outfits are permanently disabled. [Please upgrade to LRC4 to restore this functionality, as well as receive a wide array of updates and continued support](/lrc/load-roblox-characters-4).


# LRC Changelog

Load Roblox Characters Changelog

All dates on this page are in `dd/mm/yy`.

## 4.4.4 (05/07/25)

<details>

<summary><a href="https://github.com/wlft/load-roblox-characters/releases/tag/v4.4.4">4.4.4 (05/07/25)</a></summary>

### Improvements

* Add 'Learn More' text to the Update Available notification for clarification
* Add new changes banner and changelog screen for the most recent version

### Fixes

* 3D Preview no longer shows when app is in 'mini' mode after a new character is selected
* Fixed spinner displaying when 3D Preview is toggled after loading is finished

</details>

## 4.4.3 (04/05/25)

<details>

<summary><a href="https://github.com/wlft/load-roblox-characters/releases/tag/v4.4.3">4.4.3 (04/05/25)</a></summary>

### Improvements

* Added images to some `cclick` prompts to better help detail what needs to be done. Does not support NextGen Studio
* When the Use 3D Preview setting is disabled, logic for 3D Preview won't execute unless it is explicitly toggled in the loader
  * Please disable Use 3D Preview if you are experiencing crashes

### Fixes

* Fixed 3D Preview not rotating on newer Roblox Studio versions
* Improved 3D Preview rotating performance as well as when loading R15 rigs

</details>

## 4.4.2 (28/03/25)

<details>

<summary><a href="https://github.com/wlft/load-roblox-characters/releases/tag/v4.4.2">4.4.2 (28/03/25)</a></summary>

### Improvements

* Added `cclick` prompt ability, adding 'Learn More' to common errors such as accidentally denying access to the proxy or script injection, and also info on how to update the plugin
* Added extra update prompts, locking the plugin if its behind a major version until it's updated, displaying a banner on start-up if the installation is behind 3 minor versions

### Fixes

* The plugin widget's inputs are now unfrozen if an error occurs during a prompt

</details>

## 4.4.1-hotfix.1 (10/02/25)

<details>

<summary><a href="https://github.com/wlft/load-roblox-characters/releases/tag/v4.4.1-hotfix.1">4.4.1-hotfix.1 (10/02/25)</a></summary>

### Fixes

* Fixed context actions not working as per result of an unannounced behaviour change

</details>

## 4.4.1 (10/02/25)

<details>

<summary><a href="https://github.com/wlft/load-roblox-characters/releases/tag/v4.4.1">4.4.1 (10/02/25)</a></summary>

### Improvements

* Viewport model is less likely to be revealed in the workspace before fully loading
* Added additional expand button for viewport util actions to be shown when the viewport is too small to fit all its actions
* Added icons to each expand context action menu that obey studio's theme (does not update if the theme has been changed after the menu is first used)
* Moved refresh/sync to the left side of the viewport
* Added loader option **Remove Packages**: Defaults each limb to 0; the default rig *(not available with magic insert)*
* Added loader option **Ignore Body Scale**: Resets the character's body scales to the default *(not available with magic insert)*
* Improved quality of certain icons

### Fixes

* Rotated Oxalyl auth key in all places
* Fixed light theme conflicts
* Theming now properly applies to ViewportFrames and ImageButtons
* 'Recently Loaded' setting is now correctly included in the settings export feature

</details>

## 4.4.0 (07/02/25)

<details>

<summary><a href="https://github.com/wlft/load-roblox-characters/releases/tag/v4.4.0">4.4.0 (07/02/25)</a></summary>

### Improvements

* Added settings to toggle recently loaded characters
* Added ability to export/import plugin settings/local data
* Switched to a dedicated plugin toolbar; switched from `Wolfite` toolbar to `Load Roblox Characters` toolbar
* Rotated Oxalyl auth token
* Added additional expand button for the loader's top\_buttons to be displayed when the widget is too small to fit the other actions, affects: Outfits, Animations, Inspect
* Added ability to refresh/sync a character's appearance. Available for imported models if the user ID is available
* LRC now checks for new updates after 50 minutes when/if opened

### Fixes

* Improved plugin stability, especially in development environments and with certain plugins installed

</details>

## 4.3.0-hotfix.2 (05/11/24)

<details>

<summary><a href="https://github.com/wlft/load-roblox-characters/releases/tag/v4.3.0-hotfix.2">4.3.0-hotfix.2 (05/11/24)</a></summary>

### Fixes

* Fixed error where dont\_show\_again setting was assumed to be type table when it was nil and being written to
* Pcalled entire prompt component to prevent future errors

</details>

## 4.3.0-hotfix.1 (04/11/24)

<details>

<summary><a href="https://github.com/wlft/load-roblox-characters/releases/tag/v4.3.0-hotfix.1">4.3.0-hotfix.1 (04/11/24)</a></summary>

### Fixes

* Pcalled bridge initialisation due to numerous failures in dev installations

</details>

## 4.3.0 (29/10/24)

<details>

<summary><a href="https://github.com/wlft/load-roblox-characters/releases/tag/v4.3.0">4.3.0 (29/10/24)</a></summary>

### Improvements

* Friends are now sorted A-Z when Thread Async Functions (`id:mtd`) setting is enabled
* Added ability to insert character with `CreateHumanoidModelFromDescription`
* Friends' usernames are now stored and do not require being requested for tooltips
* Increased Home initialisation priority (Home should now load/begin loading sooner)
* Added **Import Character** *(BETA)* feature to import characters from a local .rbxm file and view/insert them in the loader
* Added **Locked** setting to the loader which will lock/unlock every Part (R6) and MeshPart (R15) underneath a rig
* LRC toolbar button now reflects the state of the widget accordingly

### Fixes

* Now displays 150 outfits under user saved outfits rather than the 50 previously allowed
* No longer warns the output if the current version of the plugin isn't below the distributed version
* Local development installations now delete the `Wolfite` toolbar to prevent unexpected errors

</details>

## 4.2.3-hotfix.1 (27/10/24)

<details>

<summary><a href="https://github.com/wlft/load-roblox-characters/releases/tag/v4.2.3-hotfix.1">4.2.3-hotfix.1 (27/10/24)</a></summary>

### Fixes

* Replaced reference to `'Motor6D'` with `string.reverse('D6rotoM')` to prevent false-positive shadow ban

</details>

## 4.2.3 (26/10/24)

<details>

<summary><a href="https://github.com/wlft/load-roblox-characters/releases/tag/v4.2.3">4.2.3 (26/10/24)</a></summary>

### Improvements

* None

### Fixes

* Disabled `Archivable` property on viewport rig and deleted Motor6D descendants to prevent it affecting undo/redo

### Notes

* Includes support for opening local characters. This can be tested via inputting `/i/ud` into the search bar

</details>

## 4.2.2 (25/10/24)

<details>

<summary><a href="https://github.com/wlft/load-roblox-characters/releases/tag/v4.2.2">4.2.2 (25/10/24)</a></summary>

#### Improvements

* Added ability to adjust FOV/zoom in 3D Preview via the scroll wheel
* Usernames are now only requested when necessary instead of being preloaded unnecessarily. This will prevent rate limits when reloading the plugin too many times
* Revamped the prompt modal to adapt to small widget sizes

#### Fixed

* Fixed values in body colors RAW not being cleared and resulting in duplicates

</details>

## 4.2.1 (24/10/24)

<details>

<summary><a href="https://github.com/wlft/load-roblox-characters/releases/tag/v4.2.1">4.2.1 (24/10/24)</a></summary>

(fka. 4.2.0)

#### Improvements

* Added setting: **Thread Async Functions** (fka. Use Multithreading; `mtd`); Creates new threads in areas that use asynchronous functions such as loading friends' user thumbnails on Home, allowing for near-instant loading of Home/Friends.
* Added setting: **Use 3D Preview** (aka. Use Viewport by Default; `vbd`); Loads character previews using 3D Preview (added this version) when enabled, and defaults to `contain_view.viewport_padding.fallback` (a static image) when disabled.
* Added **3D Preview** (fka. Viewport Model) that loads a 3D character model in `contain_view.viewport_padding.viewport.wm`, and updates it when the rig type or outfit is switched/selected. Also includes a toggle to switch between static (fallback) and 3D and a toggle to disable rotation. Includes warning when rig type has been changed and is different from the origin avatar.
* Added **Export** feature to export characters as `.rbxm`, requires the character to already exist in the workspace before being available, fallbacks to forbidden cursor and banner warning when clicked if no existing rig is found.
* Added **Animations** feature with ability to select equipped emotes, paste and use an existing animation ID (verifies asset ID and asset type to reduce errors, some cases only display warnings), or an existing emote which is automatically converted to an animation ID. Only available for R15 rigs, looping forcefully enabled, option for Highest Priority (`Enum.# AnimationPriority.Action4`) available.
* Added ability to **Inspect** a user's character/outfit, including their equipped assets and emotes, raw scales data, raw body colors data, raw body color3s data.

#### Fixes

* Fixed: Settings not displaying correct states.

#### Known Bugs/Issues

* Resolution on R15 rigs may be awfully low unexpectedly. No reason or solution is known.

</details>

## 4.1.1 (20/10/24)

<details>

<summary>4.1.1 (20/10/24)</summary>

**Fixes**

* Fixed loader main content visibility not being reset properly, making the main loader ui invisible permanently if another user is opened while the loader's outfit selector is active

**Improvements**

* Added 'Combine Identical Names' setting (ID: cin) to combine user's display names and usernames together if they are identical

</details>

## 4.1.0-hotfix.1 (11/10/24)

<details>

<summary>4.1.0-hotfix.1 (11/10/24)</summary>

**Fixes**

* Hid Twitter social reference before getting policy information

</details>

## 4.1.0 (11/10/24)

<details>

<summary>4.1.0 (11/10/24)</summary>

**Improvements**

* Added Resolver to help resolve network issues
* Improved 'Developer Installation' label which replaces the 'Update Available' label to display when the plugin is installed locally
* Improved text scaling on most pages and added mini view scale
* Improved tooltip sizing
* Spinners will now pause when they are not actively visible to save resources
* Removed unnecessary objects from `lrc4.r.ui.app`, total rbxmx file size is currently `~2,043 KB`.
* Added update notice to the settings page detailing the current version and the distributed version
* Added check for an attribute named `lrc4__error_usi_requests` (on TestService and set to true) which will cause the wrapper to error requests when found

**Fixes**

* Fixed network issues at loading Home not being caught properly
* Fixed context-action menu displaying `Open in Outfit Editor...` instead of `Open in Outfit Loader...`

</details>

## 4.0.1 (08/10/24)

<details>

<summary>4.0.1 (08/10/24)</summary>

**Improvements**

* Updated @nooneisback's SpriteClip model to SpriteClip2

</details>

***

{% hint style="warning" %}
The entries below are historic and may be inaccurate/incomplete
{% endhint %}

## 4.0.0 (27/08/24)

<details>

<summary>4.0.0 (27/08/24)</summary>

**Improvements**

* Revamped LRC; update to LRC4 from LRC3; bumped major version from 3 to 4
* Switched versioning to SemVer
* Redesigned UI:
  * Better scaling support
  * More actionable (easier to click) buttons
  * Retain support for both studio themes (light/dark)
  * Clearer loading states
* The plugin is now being served from a widget, allowing it to be resized freely
* The plugin is now not loaded until first used in a studio session
* LRC now uses Google Material 3 Icons, as opposed to FlatIcon
* Removed Donate game link
* Switched from Hydrogen Proxy (<https://hydrogen.wolfite.dev/>) to Oxalyl Proxy (<https://oxalyl.apis.wolf1te.com/>)
  * Hydrogen Proxy is now sunset
* Added loader option to hide a character's health
* Added loader option to disable auto scaling of a character's Humanoid
* Added `inspectable` loader option, allowing an inserted character to be inspected by a player
* Loader now automatically detects and pre-selects the correct rig type for a character, including for outfits
* Added tooltip to loader options that require script injection permissions
* Added bookmarks: Ability to bookmark players and save them for later
* Added recently loaded: Displays (30 of) your most recently inserted characters, for quick and easy access
* Switched friends to a grid layout, now displaying all of them at once
* Remade the AutoApply/AutoUpdate script to be more efficient and accurate.
* Changed `Display Names+` setting to `Prioritise Display Names`, works identically
* Added setting: **Compact Title:** Compact the widget title to "LRC4" as opposed to "Load Roblox Characters 4"
* Added setting: **Include Metadata:** Include metadata on loaded characters
* Added setting: **Insert at camera:** Position characters near camera when inserting
* Added setting: **Simplified Names:** Name inserted character models by their username only
* Added ability to apply/restore default settings and reset all plugin data
* Added ability to clear associated plugin data and cache of a user, allowing you to refresh their outfits without relaunching studio
* Improved plugin adaptability with less empty scroll spaces
* Added prompts to 'Leave a review on the Creator Store' and to reach out to @Wolfite\_ on Twitter for support
* The time a character was last loaded is now saved and displayed when possible
* Loader now displays both a user's username and display name and a verified badge if applicable
* 'Development Installation' label now displayed in place of 'Update Available' if the live installed plugin version is above the currently distributed version
* Proper caching of user information and associated data

**Fixes**

* All friends are now displayed on the home page
* The plugin does not brick itself when the widget is closed imperfectly
* Inserting characters is more reliable, with a less chance to misalign character accessories

*(... other misc. undocumented changes)*

</details>

***

## v3.0d (08/12/23)

<details>

<summary>v3.0d (08/12/23)</summary>

**Fixes**

* Fixed user outfits displaying non user-saved creations and outfits/creations that cannot be edited by the user (i.e., dynamic heads) and ensured the correct outfit type was queried - Avatar

</details>

## v3.0c (22/10/23)

<details>

<summary>v3.0c (22/10/23)</summary>

**Improvements**

* Changed web proxy (LegoProxy, served from legoproxy.fundlebox.fun -> Hydrogen Proxy, served from hydrogen.wolfite.dev)

</details>

## v3.0b (12/10/23)

<details>

<summary>v3.0b (12/10/23)</summary>

**Improvements**

* Changed web proxy (RoProxy -> LegoProxy, served from legoproxy.fundlebox.fun) and added caching

</details>

## v3.0a (23/06/23)

<details>

<summary>v3.0a (23/06/23)</summary>

Recorded as a 'revamp', starting on the 3rd of June, 2023

**Improvements**

* Revamped UI
* Changed plugin toolbar icon
* Changed 'PINNED' header to 'Recommended', displaying the current studio user and users in their team create session
* Added 'Friends' to the home page for quick and easy access
* Added settings
  * **Display Names+**: Prioritise display names in the loader and as name tags. Does not work with searching.
* Added a donation game link to the settings page, as well as the current version, credits to FlatIcon, and a mention of AlreadyPro:
  * "This plugin probably wouldn't exist without AlreadyPro, massive shoutout to him!"
* Added **Pushable** loader option, determining whether or not a character can be pushed by a player in-game (determining the Anchored property of its HumanoidRootPart)
* Added **Show Nametag** loader option
* Plugin now supports the Verified badge globally
* Spinning loader replaced with white 'Loading...' text

</details>

***

## v2.3a (22/01/23)

<details>

<summary>v2.3a (22/01/23)</summary>

**Improvements**

* Replaced update/version checking via requiring a module with reading the version from the description, preventing the plugin from being hidden in the Creator Store plugin search for being 'risky'
  * Response to Roblox **Creator Marketplace: Improving Model Safety**: <https://devforum.roblox.com/t/creator-marketplace-improving-model-safety/1795854>

</details>

## v2.2a (04/11/22)

<details>

<summary>v2.2a (04/11/22)</summary>

**Improvements**

* Adds 'PINNED' header to the current studio user's shortcut, which now opens the loader directly when clicked instead of automatically inputting it into the search bar
* Adds loader to the outfits page before it is ready
* Adds support for studio light theme
* Adds ability to instantly search without further input by putting <kbd>#inst:@</kbd> before your query

**Fixes**

* The position of an inserted character no longer falsely assumes that a rig is R15, and subsequently does not error when trying to insert an R6 character

</details>

## v2.1b (31/08/22)

<details>

<summary>v2.1b (31/08/22)</summary>

**Improvements**

* Locks inserted character's HumanoidRootPart on insert

</details>

## v2.1a (31/08/22)

<details>

<summary>v2.1a (31/08/22)</summary>

**Improvements**

* Revamped UI
* Adds functionality to search a user by their @ or ID
* Displays the current studio user's @username and display name as a shortcut which puts their name in the search bar when clicked
* Adds functionality to complete a search with the enter key, as opposed to clicking the search icon
* Adds ability to load a user's saved outfits
* Adds update required functionality by requiring a module script

**Removed**

* Removed Roblox Premium membership status icon

***No crashes recorded.***

</details>

***

## v1.0a-hotfix.1 (29/02/22)

<details>

<summary>v1.0a-hotfix.1 (29/02/22)</summary>

**Improvements**

* Added undo/redo functionality; added invocations of ChangeHistoryService:SetWaypoint() to its appropriate locations

***Unstable: crashes consistently.***

</details>

## v1.0a (29/02/22)

<details>

<summary>v1.0a (29/02/22)</summary>

**Features**

* Installation screen:
  * "Thanks for installing!"
  * "Press any key or click here to advance."
* Search a user by their @username
* Insert their selected outfit
* Option to toggle 'Always Update'
* Displays Roblox Premium icon (queried via RoProxy) next to the user's username if they are a Premium subscriber
* Displays the user's UserId in a TextBox, which can be copied

***Unstable: crashes consistently.***

</details>


# Collection of Roblox iOS Widgets

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h2>Universe Stats</h2></td><td>View the visits, CCU, favourites, current thumbnail and title of the start place for any universe.</td><td><a href="https://github.com/wlft/scriptable/blob/main/widgets/R/Roblox/universe_stats/uvstatsv1.js">https://github.com/wlft/scriptable/blob/main/widgets/R/Roblox/universe_stats/uvstatsv1.js</a></td><td></td><td><a href="https://github.com/wlft/scriptable/blob/main/widgets/R/Roblox/universe_stats/uvstatsv1.js">https://github.com/wlft/scriptable/blob/main/widgets/R/Roblox/universe_stats/uvstatsv1.js</a></td></tr><tr><td><h2>DevForum First Announcement</h2></td><td>View the first topic in the updates/announcements category on the DevForum.</td><td><a href="https://github.com/wlft/scriptable/blob/main/widgets/R/Roblox/devforum_first_announcement/announcements_only.js">https://github.com/wlft/scriptable/blob/main/widgets/R/Roblox/devforum_first_announcement/announcements_only.js</a></td><td></td><td><a href="https://github.com/wlft/scriptable/blob/main/widgets/R/Roblox/devforum_first_announcement/announcements_only.js">https://github.com/wlft/scriptable/blob/main/widgets/R/Roblox/devforum_first_announcement/announcements_only.js</a></td></tr><tr><td><h2>Total CCU Inline</h2></td><td>View the total CCU of up to 100 universes on your lock screen.</td><td><a href="https://github.com/wlft/scriptable/blob/main/widgets/R/Roblox/total_ccu/total_ccu_inline.js">https://github.com/wlft/scriptable/blob/main/widgets/R/Roblox/total_ccu/total_ccu_inline.js</a></td><td></td><td></td></tr><tr><td><h2>Universe Stats V2</h2></td><td>View the visits, CCU, favourites, current thumbnail and title of the start place with the highest CCU out of (up to) 100 universes</td><td><a href="https://github.com/wlft/scriptable/blob/main/widgets/R/Roblox/universe_stats/uvstatsv2.js">https://github.com/wlft/scriptable/blob/main/widgets/R/Roblox/universe_stats/uvstatsv2.js</a></td><td></td><td></td></tr><tr><td><h2>DevForum First Announcement V2 (all)</h2></td><td>View the first topic in the updates category on the DevForum.</td><td><a href="https://github.com/wlft/scriptable/blob/main/widgets/R/Roblox/devforum_first_announcement/all.js">https://github.com/wlft/scriptable/blob/main/widgets/R/Roblox/devforum_first_announcement/all.js</a></td><td></td><td></td></tr><tr><td><h2>View All</h2></td><td>View all available scriptable widget scripts.</td><td><a href="https://github.com/wlft/scriptable/blob/main/widgets/R/Roblox">https://github.com/wlft/scriptable/blob/main/widgets/R/Roblox</a></td><td></td><td></td></tr></tbody></table>


# Roblox iOS Widget Installation Guide

A quick and easy guide to install widgets via Scriptable from the wlft-roblox-ios-widgets repository.

1. Download [Scriptable from the App Store](https://apps.apple.com/us/app/scriptable/id1405459188?uo=4) on your iOS device.
2. Visit the [wlft/scriptable](https://github.com/wlft/scriptable) on GitHub.
3. Find the script you wish to install. For demonstration purposes, this tutorial will use the [universe\_stats.js](https://github.com/wlft/scriptable/blob/main/widgets/R/Roblox/universe_stats/uvstatsv1.js) script.
4. Click 'raw' and copy and paste the entire script to your clipboard.
5. Open the Scriptable app and tap the plus icon (+) at the top right of the app.
6. Paste the code into editor.
7. Depending on your selected script, there may be options that require you to edit the script. For example, universe\_stats.js has a variable called `universe` which will dictate which universe the widget will target. You can edit this ID in the script to change the behaviour of the widget.
8. To add the widget to your homescreen, close the app and navigate to the page on your homescreen that you want your widget on.
9. Hold down your screen until you see the 'Edit' option.
10. Tap 'Add Widget'.
11. Find or search for 'Scriptable'.
12. Add the ideal size of your widget. This depends on which script you're installing.
13. Once you've picked the correct size, tap 'Add Widget'.
14. While still editing your homescreen, tap the empty widget.
15. Under 'Script', tap 'Choose' and select the script that you just added.