Skip to content

v1.4.0

Choose a tag to compare

@github-actions github-actions released this 31 Jul 16:32
· 1429 commits to main since this release

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.json file, 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.json file now uses project instead of template to define the base tree.
  • Configuration: The verbatim boolean replaces the old keepRouteNames setting.
  • CLI: The -t flag now activates tags. It no longer sets the template.
  • CLI: The -p or --project flag overrides the project file. This replaces the old -t template 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 .json and .yml.
  • Argon Support: Rogen now fully supports Argon.

Additions

  • New Config Options: Use unwrap to remove global wrapper folders, and use globIgnorePaths to ignore exact file patterns. Use casing to 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 .unwrap into 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 watch and init directly as commands. The old -w, --watch, -i, and --init flags still work.
  • Version Check: View the installed version using the new -v or --version flag.

Package Manager Support

  • You can now install Rogen with npm using npm i @ldgerrits/rogen