josh-perry / acid-rain

LOVE VSCode Game Template

A fully configured VSCode template for LOVE

Features

• 📄 Rich Lua language features with Lua Language Server
• 🔧 Debugging with Local Lua Debugger
• 🏢 Automatic builds with Makelove
• 👨‍💻 Consistent coding styles with Editorconfig
• 🏃‍♂️ Running scripts with NPM Scripts
• 🗂️ Organized with Workspaces
• 🔗 Extensible and configurable for your needs

Prerequisites

• Visual Studio Code
• LÖVE 11.4
• Makelove
• NPM (Optional)

LÖVE and Makelove should be in your PATH environment variable.

Setup

1 - Use this template to create a new repository for your game, then clone that repository locally.

2 - Open the Workspace.code-workspace file with Visual Studio Code. You will be prompted that there are recommended extensions and if you want to install these. Click 'Install'.

3 - Configure the Game/conf.lua and Tools/build/makelove.toml with the settings specific for your game.

4 - Configure the Root/.editorconfig to your liking for code styles.

5 - Change the Root/LICENSE file to a swap out my name for your name, or change it to a license of your liking.

Running

Press F5 to launch the game in 'Debug mode'. In debug mode you can use breakpoints and inspect variables. This does have some performance impact though.
You can switch to 'Release mode' in the 'Run and Debug' tab (Ctrl+Shift+D).
Alternatively, you can run lovec game in the terminal.

Structure

├── /Game
│   ├── /assets         Contains the game's assets
│   ├── /lib            Contains external libraries
│   └── /src            Contains the game's source code
│
├── Tools
│   ├── /build          Contains the makelove.toml
│   └── package.json    Contains all scripts to use with NPM Scripts
│
├── Resources           Contains resources for you game that should not be shipped, like raw audio
│
├── Builds              Contains the builds of your game made with makelove
│
└── Root                Root access to the workspace