There are 2 ways to download the module into your game
📄️ Generating sprite sheets
Roblox doesn't allow users to upload GIF files, so to work around that, you need to convert your GIFs into sprite sheets. You can use https://gabys.xyz/giftosprite to do that.
📄️ Basic usage
The most basic way to use the player is to call the .new() method with a table of parameters:
📄️ Playing the same GIF on multiple screens
You can replace the Screen property with Screens, which is a table of UI elements / textures, to show the same GIF on multiple screens.
📄️ Using multiple sprite sheets
Sometimes your GIF has a lot of frames and you need to split it into multiple sprite sheets to keep good quality. You can replace all of the properties (except Screen) with a SpriteSheets property which is a table containing multiple sprite sheets.
📄️ Stopping all GIFs in an Instance
You can use the .DestroyAllGifsIn() function to destroy all gifs in the specified instance.
You can optionally add an ID to each GIF to be able to get it later in another script.
You can use the Effect property to tell the module how to show / hide GIFs. Currently only a Fade effect is available.
The example game below is my testing place for the module. You can edit it by pressing the 3 dots and clicking Edit.