Repository navigation
v1.4.0
Introducing a new documentation website, major stability fixes for Rojo, and a powerful tag system. If you use an old configuration, Rogen will warn you exactly what to change.
Breaking Changes
- Configuration: Configured paths now resolve relative to the
.rogen.jsonfile, not your current terminal folder. You can now run Rogen from any directory, which makes managing multi-place projects much easier. (Paths passed via CLI flags still use your terminal folder.) - Configuration: The
.rogen.jsonfile now usesprojectinstead oftemplateto define the base tree. - Configuration: The
verbatimboolean replaces the oldkeepRouteNamessetting. - CLI: The
-tflag now activates tags. It no longer sets the template. - CLI: The
-por--projectflag overrides the project file. This replaces the old-ttemplate flag.
Major Upgrades
- Rojo Stability: Improved the generated Rojo structure. This fix significantly reduces Rojo crashes when deleting files or folders.
- Tag System: Rogen now supports build-time dependency injection. You can filter test files and mock data from production builds. Define tags in your config, then apply them to files or folders. Rogen removes files with inactive tags from the build entirely.
- Data Files: Rogen now properly handles data files like
.jsonand.yml. - Argon Support: Rogen now fully supports Argon.
Additions
- New Config Options: Use
unwrapto remove global wrapper folders, and useglobIgnorePathsto ignore exact file patterns. Usecasingto set folder formatting to"camelCase"or"PascalCase"(contributed by @bo-rges) - Invisible Folders: Wrap a folder name in parentheses, like
(inventory). Rogen keeps the files together on your machine but removes the folder from Roblox Studio. - File Hoisting: Add a
^symbol to the start of a file name to place it exactly at the root of a service. - New Marker Files: Drop
.structure,.sync,.verbatim, or.unwrapinto a folder to change how Rogen reads its contents. - New Routing Delimiter: Use the plus symbol (
+) as a routing delimiter in file names, alongside dots, hyphens, and underscores. - Logging & Collision Warnings: Rogen logs events more clearly and warns you when file paths collide.
- Exact Keyword Names: If a file name matches a routing keyword exactly, Rogen treats it as the name, not as a routing affix.
- CLI Commands: You can run
watchandinitdirectly as commands. The old-w,--watch,-i, and--initflags still work. - Version Check: View the installed version using the new
-vor--versionflag.
Package Manager Support
- You can now install Rogen with npm using
npm i @ldgerrits/rogen