Studio Fren Instruction Manual!

Welcome to my…
image
!!!

In this Instruction Manual, I’ll review how this plugin works and whatever.
So click the dropdowns for the knowledge of that section!

Yo! As of the plugin marketplace update with the conversion from Robux to Money.
The slightly coolr Studio Fren will eventually be merged into this plugin!
Plus I’m thinking about remaking the whole plugin from scratch anyway.
Keyword: Eventually. I have other plugins to work on!


---Pop-up Fren Creator!---

Welcome to the [Pop-up Fren Creator] where you can turn anything and anyone into a new Fren of yours!

Pop-up Frens are simply Frens that will pop up on your screen and show themselves!
Saying something or making a noise!
These Frens are the main star of the show!


[Fren Name] - Required
Insert the name of your new Fren into this box, Keep in mind:

  • Your new Fren cannot have the same name as another Fren
  • Your Fren must have a name!

[Sprite] - Required
Insert the Image ID/Username of your new Fren and it will automatically take the appearance of the new sprite.

[Pop-up Sound] - Optional
This will be the sound that your Fren will make when it appears!

[Dialogue] - Optional
This is what your Fren will say when it appears!
Try to keep it short if you want, as the text bubble was designed for single-sentence dialogues.
If your Fren has no dialogue then no dialogue bubble will show.

[Size] - Required - On-Screen only
This will be the size of your Fren when it appears on-screen!
If you have your Pop-up Frens set to [Widget Only] then the size will not apply.

[ScaleType] - Required
This is the Enum.ScaleType that your Fren will use when appearing!
So, what’s the difference?

  • Fit
    The image is scaled to fit within the element X or Y dimension (whichever fits first).
    -May cause your sprite to float!

  • Crop
    The image is cropped to fit within the element.
    -May cause some parts of your sprite to be sliced off!

Changing the setting will not update in the previewer, so click [Test Fren] instead!

[Viewing: ???]
Clicking this button will cycle through the inserted Sprites/Sounds/Dialogues that you have assimilated within your Fren.
Hovering over your additions will prompt a delete confirmation, then clicking it will delete that addition.
Hovering over a sound will play a preview of it!

When you cycle through your collection, you may have noticed [Welcome Message] and [Welcome Sound]

[Welcome Message] - Optional
Whatever you type here will be the welcome message that your Fren will say when you first open up Studio!

[Welcome Sound] - Optional
Whatever sound you put here will be played when your Fren appears to welcome you!

You can either have only a welcome message, a welcome sound, or both!
If both inputs are blank then that Fren will be excluded from welcoming you

[Test Fren]
If you believe you are done creating your Fren but are unsure about it.
You may click the [Test Fren] button to see what your Fren will look like popping up!
(Recommended to spam click)

[Finish!! :D]
When you believe you are done creating your perfect Fren,
You may click the [Finish!!] button at the bottom to create and save that Fren!
Now that Fren will appear to welcome/motivate/inspire/insult/say nothing to you!

[Cancel]
If you are not too sure about your created Fren you may click the [Cancel] button.
This will start a timer of 5 seconds, clicking during this timer will 100% cancel the Fren Creation process.
But waiting it out will let you continue creating your Fren.

[Example Result!]


---Animated Fren Creator!---

Welcome to the [Animated Fren Creator!] where you can turn anything into a moving Fren!
Animated Frens are basically a gif that will shmoove on your screen.
These Frens are a bit more restricted and limited but pretty cool if you use them right.
Animated Frens do not have dialogues or sounds, they are just there to shmoove.


[Fren Name] - Required
Insert the name of your new Fren into this box, Keep in mind:

  • Your new Fren cannot have the same name as another Fren
  • Your Fren must have a name!

[Sprite Sheet] - Required
Insert the Image ID of the sprite sheet you have!
Then the preview should automatically change to your sprite sheet!

[Size] - Required - On-Screen only
This will be the size of your Fren when it appears on-screen!
If you have your Animated Frens set to [Widget Only] then the size will not apply.

[Columns] - Required
Insert the number of columns that your sprite sheet has!
In this example, there are 6!
Rows

[Frames] - Required
Insert the number of frames that your sprite sheet has!
In this example, there are 38!
Criminal!

[Frame Delay] - Required
Insert the seconds of how long it will take until the next frame plays!

[Repeat Delay] - Required
Insert the seconds of how long it will take until the gif restarts!

[Test Fren] - Required
If you believe you are done creating your Fren but are unsure about it.
You may click the [Test Fren] button to see what your Fren will look like shmooving!

[Finish!! :3]
When you believe you are done creating your perfect Fren,
You may click the [Finish!!] button at the bottom right to create and save that Fren!
But it will not let you continue if you have not tested your changes first!

[Cancel]
If you are not too sure about your created Fren you may click the [Cancel] button.
This will start a timer of 5 seconds, clicking during this timer will 100% cancel the Fren Creation process.
But waiting it out will let you continue creating your Fren.

[Example Result!]
If everything looks good then Test it first → Make changes if necessary → Finish!!


---Fren Collections!---

When you click this button it will show your [Pop-up Fren Collection!]
With your first Fren to get you started, Placeholdew!


When you’re on this page you can click [Create Fren!!] to make a new Fren!
Or Delete/Edit Frens inside your collection.

Deleting, Editing, and Active Frens

[Deleting a Fren]
How could you?!
When you click the [X] in the top right corner of your Fren.
A prompt will show asking if you are sure of murdering deleting that Fren.

So choose their fate if you didn’t accidentally click the [X] button!

[Editing a Fren]
To edit a Fren just click their little jail cell and the Fren Creator will show up again!
Do your changes and if you are satisfied, click [Finish!!] or [Cancel] if not.

[Activeness]
This is an alternative to deleting Frens!
The little circle in the top left corner of your Fren is the active button!
When a new Fren is added it will automatically be set to [Active]
Animated Frens will not auto-activate

If there are multiple Frens active, the plugin will not choose the previous Fren that has appeared, that way you get to see someone new! Also applies to the welcomer.

Otherwise if clicked again the button will turn red and [Inactive]

  • Pop-up Frens
    -This will exclude that Fren from being chosen for pop-up, so sad.
    -At least one Fren has to be active.

  • Animated Frens
    -Only one Animated Fren can be active at a time!
    -All Frens can be inactive if you want.

Import and Exporting

These funny little buttons allow you to save your Frens into a folder or put Frens into your Collection!

[Exporting]
When you click the [Export] button, it shows your Save Prompt to download your exported Frens somewhere on your computer.
As a backup, it will also create a new folder within ServerStorage named [PackagedPopupFrens] or [PackagedAnimFrens], depending on what collection page you have open.

That folder is a delivery box that the plugin has stuffed your Frens into!
These folders contain all your Fren’s info before being stuffed into a box.
It’s ok! They’re comfortable I think.

[Importing]
When you click the [Import] button, the plugin will search through ServerStorage to find the corresponding folder to the collection page you have opened.

If the plugin successfully found the folder, it will release all the Frens from their boxes and move them into your collection!!
It’s so cool!!


This feature will allow you to back up your Frens as an Rbxm File after you export! Just in case you somehow lose your Frens to data loss or changed computers, since plugin data is saved locally.

Or if you want to share your created Frens, you may send them your Rbxm File to import into their collection, and vice versa!
Just remember to import the file into ServerStorage

OR if you bought the Slightly Cooler Version, you can easily transfer your Frens to that plugin!

[Notes]
Importing can fail if:

  • A Fren in your collection has the same name as another Fren from the exported folder
  • The exported Fren has missing info
  • The plugin cannot find the folder

Exporting will export ALL of your Frens in your currently opened collection, active or not. So, if you’re thinking of sharing your Frens, go through the exported folder/file and delete the folders that you don’t want to share.

If you have the Slightly Cooler Version, it will not export the customizations of the text bubbles.


Want to try it out?? Here are the two files of the pop-up and anim Placeholdew.
PlaceholdewAnimBox.rbxm (565 Bytes)
PlaceholdewBox.rbxm (912 Bytes)


---Configure!---

Welcome to the [Configure Page!] where there are probably too many settings for this kind of plugin. So much that I can’t take a screenshot of this page!
But all of them are easy to understand! I think.

You can cycle through most of the options by clicking or right-clicking.

Pop-up Fren Settings

[Appear and Disappear Style]
The tween style of when your Fren pops up!

Show Tween Styles


Fade is not an actual tween style but here is an example anyway:
Fadeee

[Appear Location]
This will determine where your Fren will pop up from!

Show Locations

[Dialogue Appear Style]
The style of when your Fren’s dialogue bubble appears!

Show Styles

Hey

[Dialogue Effect]
The style of how your Fren’s dialogue text appears!
Instant is already shown and you should know what typing means.

[Dialogue Font]
The font of your Fren’s dialogue text.
The button will automatically change the font when cycling.

[Auto Rotate]
Your Pop-up Frens will rotate based on where they appear!

Rotate Examples

[Fren Appears In]
Determines if your Pop-up Fren will only appear on-screen, widget, or both!

[Fren Stays] - Widget Only
If you are a widget kind of developer this one is for you!
If this option is enabled then your Pop-up Fren will stay on the widget screen until the next Fren’s turn.
If this option is disabled then your Pop-up Fren will show up, do its thing, then go to sleep, leaving you with an empty widget box.


[Pop-up Interval]
Insert your Minimum time and Maximum time of when you want your Fren to pop up!
Both inputs can be the same number if you want.
You will need to restart Studio for this change to update.

[Linger Time]
This is how long you want your Fren to stay on-screen before they go back to sleep.
[Fren Stays Setting] being enabled ignores this input.

[Show and Disappear Speed]
How fast you want your Fren to appear and disappear.


Animated Fren Settings

[Idle Location]
The location where you want your Animated Fren to stay in.

Show Locations

[Fren Appears In]
Determines if your Animated Fren will only idle on-screen or widget.


Other Settings

[Show In Play Test]
If this is on, then your Pop-up Frens and Animated Fren will still be visible in playtest/run mode.

If it is disabled then they won’t be visible.
If you have a widget enabled and this is off, Frens will just not appear in the box.

[Avatar Uses]
This is for anyone that will be typing in usernames for their Fren sprites.
Here are the differences:
image
I don’t know who this person is


---Stats!---

Welcome to the [Stats Page!] where I just added this page for fun!
The stats are pretty self-explanatory, but feel free to take a look at your stats every once in a while.

Here are mine :3


---⭐ The Slightly Coolr Studio Fren ⭐---

Hey! If you had or will have the plugin for a while and want a tiny bit of customization, there is a paid version of this plugin! (paid plugin jumpscare)


This paid version just gives slightly more customization to some aspects of the normal one. So what is there to slightly give to you?

[Colorable text bubbles and different styles of them]

Maybe more later?

[Rich text on your dialogue texts]
image

[Customizable widget background]
image


Lastly, future updates will only be applied to this version.

See, just some slight additions if you want to give your Frens a bit more personality.
Still, the normal version functions the same way.

If you want it, the plugin costs the minimum plugin price of 100 :robux_light:
Clicking the ImageButton below will take you to the slightly cooler plugin.
image

Your Frens in the normal version will not automatically move to the Cooler Version.
But you can transfer your Frens using the Import/Export Feature
Thank you if you buy it :3


---How To Get The Image ID---

If you don’t know how to get the image ID to transform your Fren then this guide will show you! It’s really easy to do in Studio!

  1. Go to your [Toolbox] and find your desired image either in:
  • Marketplace → Images

  • Inventory → My Images

  1. Right Click → Copy Asset ID

  2. Paste your Image ID into your Image ID box!

  3. Continue your Pop-up Fren creation as per usual

What if you have an image but it’s on the website instead of Studio?

  1. Create a Decal Instance in Studio
    Workspace → Right Click → Insert Object → Decal

  2. On the website, highlight just the numbers of the URL for the Decal

  3. In the Decal Instance you have created, paste the numbers into [Texture]
    This will automatically change the Decal ID to the Image ID

  4. Copy just the numbers from [Texture]

  5. Paste your Image ID into your Image ID box!

  6. Continue your Pop-up Fren creation as per usual


---How To Make A Sprite Sheet---

Want to make an Animated Fren hm? But don’t how to make a sprite sheet??
Don’t worry this is easy to do!

  1. Download a gif from somewhere and save it

  2. Go to this website!

  3. Upload your Gif and wait till a sprite sheet is created

  4. Save the sprite sheet image

  5. Upload the sprite sheet as a Decal on Roblox and wait until it processes

  6. Copy its Images ID (refer to the dropdown above)

  7. Paste the Image ID into your sprite sheet input!

  8. Continue your Animated Fren creation as normal


Tips:

  • The website tells you the columns of the sprite sheet.

  • On the same page and if you still have your gif uploaded go to the [Frames]
    box. It will also tell you how many frames your gif has, no need to count!

  • The more frames your gif has then the lower quality your Animated Fren will become. Since Roblox likes to compress images.


---Things To Know---

[Overall Plugin]

  • It is recommended to have the [Output] open with this plugin, some warnings will be told, notably in the Fren Creators.
    Like telling you about invalid names and IDs.
    Examples:
    image

  • There is no limit on how many Frens you can have.

  • Closing the plugin window while creating a Fren will cancel the creation process.
    Be careful!

  • I know there is an annoying line when using the Animated Fren, it is just how the thing works. Either try to ignore it or use the widget.

  • The dialogue pop-up sound plays when the dialogue bubble appears.
    So, if you’re creative enough, you might be able to sync your sounds to the dialogue!

  • Animated Fren will still run in the background even when [Show In Play Test] is disabled. But I don’t think it will impact performance that much.
    It depends on your [Frame Delay] and [Repeat Delay] or you can disable the Animated Fren.

  • Animated Fren will refresh when going to the [Animated Fren Collection]
    So, when you switch your Animated Fren position or widget <-> on-screen.
    It is recommended to go to that page real quick to apply your settings.


[Credits]

  • Huge inspiration from Snakeworl’s Anime Girl Messages Plugin, and the main motivator is the people in the plugin’s comments wanting it to be customizable.
    Me included
    Also, everyone needs a Fren!

  • Spritesheet player system is from here
    I have just altered it a little bit for this plugin.


[Required To Know]

  • Cats do not exist

---Suggestions And Bugs---
  • If you encounter any bugs or glitches let me know! Some in the plugin are visual but I’m worried about the plugin exploding kind!

  • If you got any suggestions message me in Roblox or on here!
    Keep in mind that any future suggestions being promoted to an update will only apply to the Cooler Version!!

1 Like