L5 Extension

This extension runs L5 projects from VSCode and VSCodium.

Features

Requirements

Install Love2d on your computer.

Extension Settings

This extension contributes the following settings:

• l5.path: Path to your love executable. Windows: default path shown. Linux: use love if in PATH, or full path like /usr/bin/love. macOS: uses open -n -a love automatically if you have approved Love through your security settings.
• l5.maxInstances: Set the max amount of instance you want to be able to spawn at the same time. Defaults to 1
• l5.useConsoleSubsystem: Should Löve be executed with the console subsystem? (Windows only)
• l5.overwrite: Should the launcher overwrite the first process when launching another one? Defaults to true.
• l5.saveAllOnLaunch: Should VS Code save all opened files on Löve launch? Defaults to false.
• l5.autoRestartOnSave: Automatically restart LÖVE when a Lua file is saved. Defaults to false.
• l5.customArgs: Additional command line arguments to pass to LÖVE (space-separated). Defaults to "".

Contributing

There are a couple of docs that might be helpful in contributing to this extension!

• Setting Up Developer Environment → Useful for getting the extension running on your own computer
• How to Publish Extensions → manual creation of .vsix files
• Github Workflows → how the Github Workflows work

Known Issues

MacOS Extra Security Approval

Because Love2d is an open-source game engine that is not installed through the App Store (and has not paid a $99 licensing fee), you will need to do an extra step to approve the application otherwise Love2d will not open.

When running the extension will prompt you to move the application to the trash.

In order to bypass this, you will need to open System Settings → Privacy & Security and scroll to "Open Anyway"

When you press "Open Anyway", it will prompt again if you would like to "Open Anyway".

Then it will prompt for your computer password.

It will then launch Love2d normally. You can close this application and you will be able to run L5 projects!

Release Notes

0.0.1

Beta release to test on non-Mac devices.