Skip to content

SheetSync is a professional Roblox Studio plugin that allows importing structured data from Google Sheets directly into the Studio.

License

Notifications You must be signed in to change notification settings

foxjetstudios/sheetsync-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 

Repository files navigation

SheetSync 📊

By Fox Jet Studios

Sync data from Google Sheets directly into Roblox Studio in seconds. SheetSync turns spreadsheets into ModuleScripts, Luau tables, or structured folders, powered by a fast and reliable import pipeline.

Perfect for configs, balancing values, item data, NPC stats, leaderboards, and live iteration without touching code every time.


Features ✨

  • ✅ Import data straight from Google Sheets

  • ✅ Automatic CSV parsing with smart type detection

  • ✅ Generate:

    • ModuleScripts
    • Luau tables
    • Folders with Value objects
  • ✅ Choose output destination (ServerStorage, ReplicatedStorage, Workspace)

  • ✅ Live data preview before importing

  • ✅ Clean, modern, and intuitive UI

  • ✅ Built-in logging with success, warning, and error states

  • ✅ Safe name sanitization for Roblox instances


Installation 🛠️

  1. Download the plugin .rbxm or .rbxmx file
  2. Open Roblox Studio
  3. Go to Explorer → Plugin → Save as local plugin
  4. Load the plugin in your game

Or install it directly from the Roblox Creator Store (recommended so you get auto-updates). Screenshot


Usage 🚀

  1. Open SheetSync from the Plugins tab

  2. Paste your Google Sheets URL

  3. Make sure the sheet is public:

    • Share → Anyone with the link → Viewer
  4. Choose:

    • Output Type (ModuleScript, Folder + Values, Luau Table)
    • Destination
    • Output Name
  5. Click Import

  6. Your data is instantly generated in the selected location

Use Preview to inspect parsed data before importing.


Output Types Explained 🧠

📦 ModuleScript

Creates a ModuleScript returning a Luau table:

local data = {
	{
		["Name"] = "Sword",
		["Damage"] = 25,
		["Rare"] = true
	}
}

return data

📁 Folder + Values

Creates a folder where:

  • Each row becomes a folder
  • Each column becomes a StringValue, NumberValue, or BoolValue

Great for designers who prefer visual data.

📜 Luau Table

Creates a Script that returns a raw Luau table, ideal for quick requires or legacy setups.


How It Works ⚡

SheetSync uses a multi-step import pipeline:

  • Converts a Google Sheets URL into a CSV export
  • Fetches data using Roblox HTTP services
  • Parses headers and rows safely
  • Detects value types automatically
  • Generates Roblox instances or Luau source code
  • Logs every step in real time

No external dependencies. No runtime overhead.

Demonstration video:

Demonstration.mp4

Requirements ⚠️

  • You must allow the plugin to use HTTP Service and script injection
  • Google Sheet must be publicly accessible with the permissions below:
Screenshot

License 📜

Code is released under the MIT License Free to use, modify, and distribute. See the LICENSE file for full details.


Support & Feedback 💌

About

SheetSync is a professional Roblox Studio plugin that allows importing structured data from Google Sheets directly into the Studio.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages