This repository has been archived by the owner. It is now read-only.
[ARCHIVED] Third party IDE support for Roblox Studio.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
plugin Fix #25 Nov 8, 2017
src Fix file names not saving Nov 24, 2017
.gitattributes :neckbeard: Added .gitattributes Aug 12, 2016
.gitignore New partials system for plugin.moon Dec 20, 2016
Cakefile New partials system for plugin.moon Dec 20, 2016
LICENSE
README.md Archive project May 22, 2018

README.md

RbxSync is no longer supported

RbxSync will no longer be receiving updates and is now archived. I recommend you use Rojo instead (with a VSCode extension I wrote for it, just search for Rojo in the extensions tab).

RbxSync is being retired because I believe that Rojo is a better solution to the problem I was trying to solve when I created RbxSync, and I want to give more time to my other projects. Rojo receives more frequent updates and is maintained by a (at the time of this writing) Roblox employee (as a personal project).

If you are switching, you should know that Rojo is not a drop-in replacement for RbxSync. There are some differences, notably:

  • At the time of writing, Rojo only supports filesystem-to-Studio syncing, so you need to create all of your scripts on your computer before syncing them in to Studio. However, in a future version of Rojo, bidirectional syncing will be possible.
  • Rojo is a bit harder to use for non-power users (there is no graphical interface), comparatively, but the VSCode extension makes it a lot easier.
  • Rojo uses different naming schemes to represent scripts on the filesystem:
Instance RbxSync Rojo
LocalScript Script.local.lua Script.client.lua
Script Script.lua Script.server.lua
ModuleScript Script.module.lua Script.lua
Other instances Not Supported SomeName.json
  • Rojo uses a different way to represent nested scripts.
    • RbxSync: The script exists on the top-level, and a folder of the same name indicates what goes inside:
      • Script.module.lua
      • Script/
        • Child script.module.lua
    • Rojo: Only the folder exists on the top level. If a file has the name "init.lua" (or .client.lua/.server/lua) inside that folder, then a script with the name of the folder will be created with the contents of "init.lua", and the other files inside the folder will be created as a child of that Script object:
      • Script/
        • init.lua
        • Child script.lua
  • Rojo uses partition-based syncing, rather than syncing the entire game like RbxSync does. This means that you can create many folders on your computer that can then be mounted in your Roblox game as children of specific objects.
  • Rojo uses desctructive syncing, while RbxSync will ignore any objects it doesn't manage. This means that if something exists inside one of your partition mount points, it will be destroyed if it doesn't line up with what you have on disk.
    • This means that you may have trouble migrating if you have lots of nested instances (Scripts with non-script children). You may need to restructure your project to lift all objects or prefabs out from under any scripts in a partition if this is the case for you.
    • Any CollectionService tags on synced scripts or objects will be removed upon a fresh sync.
  • Rojo will support bidirectional syncing.
  • Rojo will support multiple instances of Studio at once.
  • Rojo will support exporting to and reading from rbxmx files
  • Rojo will support ignoring configured files and instances
  • Rojo will support custom development assets via rbxasset://
  • Rojo will support a whole lot more!

If RbxSync has been useful to you, I'm confident that with a little tweaking to your workflow, Rojo will do a much better job in the long run. So long, RbxSync, it's been nice! 👋

RbxSync - Third party IDE support for Roblox Studio in one click

Patreon

RbxSync is an open source Roblox plugin that easily integrates any third-party code editor or IDE, such as Sublime Text, Notepad++, VS Code, or Atom, into Roblox Studio. This is accomplished via a helper application which runs in the tray and acts as a middle man between your code editor of choice and Roblox Studio.

Tray example Demo Gif

Download

Available in the releases section.

Notice: The executable will most likely cause Windows to alert you with a fullscreen SmartScreen warning because this file is not commonly downloaded. To run anyway, click More info then click Run anyway. If you're wary, you can build the plugin from the source with the instructions below.

Installation

RbxSync is designed with simplicity in mind: just download the executable and run it, and it will automatically install the plugin into Roblox Studio. Just let the application run in the tray while you're developing. (Note: If you have changed the Roblox Studio Plugin directory, you will need to configure this before using RbxSync)

Files will open with your system default .lua editor.

Note: If you already have Studio open when you run the application for the first time, you will need to restart Studio for the plugin to load.

Features

Persistent Mode / Git Mode

By default, RbxSync will use a temporary folder, but using a persistent directory is also supported. This will cause the plugin to write all scripts to disk (nested with folders that match in-game hierarchy), even ones you don't explicitly open. The plugin will keep the scripts up to date on disk, even through Parent or Name changes. If you delete the script from your game, it will also be deleted on disk. If two objects have the same name and parent, one of them will be appended with (2) at the end of its name. Try to avoid this.

This allows you to create a Git repository for all the scripts in your game super easily.

To enable this feature, create a StringValue in ServerScriptService named PlaceName, and then set the value to the name you'd like the folder to use. The scripts will then be written to C:\Users\<Current User>\Documents\ROBLOX\RbxSync\<Place Name> by default, but this is configurable.

PMode Demo

Mixins (DEPRECATED)

!! Mixins are deprecated as of v1.3.4 and support for this special syntax will be dropped in version 2 (coming 2018). Code created with mixins will continue to work after support is dropped, but they will no longer be parsed into the @(...) syntax.

Mixins allow you to use the syntax @(mixin_name) in your scripts, which will return any values you set in the Mixins module. To use this feature, create a ModuleScript in ReplicatedStorage named Mixins.

The module should return a table with string indexes for your mixin names. The values can be any type, but if they are a function, the function will be executed, given the arguments (mixin_name, script, function_environment).

  • mixin_name: The name of the mixin, e.g. what is @(here).
  • script: The Script object that is using the mixin
  • function_environment: The result of getfenv in the function where the mixin is used

Example Mixins script:

return {
	hello = "Hi there!";
	require_all_children = function(mixin, script, env)
		for _, child in pairs(script:GetChildren()) do
			if child:IsA("ModuleScript") then
				require(child)
			end
		end
	end;
}

Then, anywhere in another script:

@(require_all_children)

print(@(hello))

This actually compiles to:

local __RSMIXINS=require(game:GetService"ReplicatedStorage".Mixins);__RSMIXIN=function(a,b,c)if type(__RSMIXINS[a])=='function'then return __RSMIXINS[a](a,b,c)else return __RSMIXINS[a]end end

__RSMIXIN('require_all_children', script, getfenv())

print(__RSMIXIN('hello', script, getfenv()))

MoonScript Support

If you have MoonScript installed on your computer (have moonc in your PATH), RbxSync can automatically compile your scripts into Lua every time you save them and instantly push them to your game in Studio.

Mixins can be used with the built-in mixin function, e.g. mixin "hello". In MoonScript mode only, there are three special mixin names, which can be used to inject things into the environment:

  • autoload: This mixin is automatically run at the start of every script.
  • client: This mixin is automatically run at the start of every script running on the client.
  • server: This mixin is automatically run at the start of every script running on the server.

To put a script in MoonScript mode, there must be a StringValue named "MoonScript" inside of it. The plugin provides several shortcuts so you don't have to do this manually:

  • If you put .moon at the end of your script name (e.g. KillScript.moon, then press the Open in Editor button, it will remove the .moon from the name after it's created the value.
  • If the script source contains m, moon, or moonscript exactly, when you press the Open in Editor button, it will also put the script in MoonScript mode.
  • Use the hotkey Ctrl+Alt+B with a script selected.

Building it yourself

Building RbxSync is made easy by using CoffeeScript's Cakefiles. The build script will automatically replace the partial strings in plugin.coffee with the data from the partials/ directory.

Prerequisites

  • npm install -g electron-packager
  • npm install -g electron
  • npm install -g coffee-script
  • You must have moonc in your PATH.
  • Go to the ./src directory and run npm install to install the dependencies

Building and running the app for developmental testing

Run cake b && electron src from the directory that the Cakefile is in

Building the entire app into executable

Run cake build:app

TODO

  • Need to make the plugin work with multiple instances of Studio open, but this will probably require quite a bit of refactoring in server.coffee