Bookmarkr
Introduction
As someone who has been working in a fairly big codebase for a while now, I’ve found myself searching for a tool that would make accessing specific resources within the codebase quick and easy. Despite coming across some plugins that approached this problem, I couldn’t find one that encompassed ease of use and functionality in a way I was looking for. Thus, I recently began developing this plugin and decided to make it my first open source project on Roblox, hopefully helping some people that find themselves in a similar situation as me.
Features
-
Simplistic interface that adjusts to Studio’s color theme, built with Fusion
-
Folders
-
Create bookmarks of scripts and any other instance
-
Easy navigation thanks to a list-based directory system and breadcrumb navigator
-
Search function with result cycling
-
Bookmarks save automatically and persist throughout sessions
-
Customizable bookmark names (and optionally line numbers for scripts)
-
Import and export your directories as strings, allowing you to share your bookmarks with other developers in your workspace
-
Creating a bookmark while in the script editor automatically uses the currently selected line, no need to edit the bookmark and enter it manually
How to use
Using the plugin is straight forward:
-
To create a folder, click the “Create Folder” button.
-
To create a bookmark, click the “Create Bookmark” button.
-
If you have a script opened in the editor, the bookmark will be a code bookmark, with the line number corresponding to the currently selected line in the editor.
-
You can select instances in the explorer then click “Create Bookmark”. This creates instance bookmarks for all selected instances. (Scripts create code bookmarks without line numbers set)
-
-
Edit bookmarks with the “Edit” button. This allows changing their name (without changing the object path) and line number in case of a code bookmark.
-
To navigate through directories, you can click on specific parent directories in the breadcrumbs navigator or use the “Step Up Directory” button.
-
When searching, a bar will pop up that can be used to scroll through search results, if more than one match is found.
Note
Currently, the plugin keeps track of items via their Instance:GetFullName()
path. Due to this, differentiating between same-name objects under the same parent is not supported. This may be changed in the future, when there’s ever going to be a way of getting persistent unique identifiers for instances. While it would be possible to mark specific instances with an attribute, the goal of this plugin was to not modify existing instances in the workspace or add any new objects.
While I do plan on updating this plugin, I can’t guarantee much activity on it as I am currently busy with other projects. I still appreciate feedback and will try to fix issues if any are found.
Credits / Attributions
Fusion by dphfox
Icons from lucide.dev