Love2D Quick Install and Setup Guide (2025 Tested)

🎮 Love2D 설치 개요 및 준비 단계

Love2D는 가볍고 설치가 간편한 게임 프레임워크로, 공식 웹사이트(love2d.org)에서 운영체제에 맞는 버전을 다운로드하면 됩니다. macOS 사용자는 제공된 애플리케이션 파일을 내려받아 설치하면 되며, Windows 사용자는 설치 프로그램(Installer) 버전을 사용하는 것이 권장됩니다. 특히 Windows 환경에서는 설치 과정 중 표시되는 설치 경로(Destination Folder)를 반드시 확인해야 하며, 이후 설정 단계에서 해당 경로를 다시 사용하게 됩니다. 설치가 완료되면 macOS에서는 Dock에 애플리케이션을 추가하고, Windows에서는 설치 경로에 있는 love.exe 파일의 바로가기를 생성해 바탕화면에 두는 것이 효율적입니다. 프로그램 실행 시 간단한 애니메이션 창이 나타나면 정상적으로 설치가 완료된 상태입니다.

🛠️ 개발 환경 구성: Visual Studio Code 설치

Love2D로 게임을 개발하려면 코드 작성을 위한 텍스트 편집기가 필요합니다. 다양한 편집기를 사용할 수 있으나, 무료이면서 확장성이 뛰어난 Visual Studio Code(VS Code)가 권장됩니다. 공식 웹사이트(code.visualstudio.com)에서 운영체제에 맞는 버전을 다운로드하여 설치한 뒤 실행하면 프로젝트 파일을 생성하고 관리할 수 있는 개발 환경이 준비됩니다. VS Code는 파일 탐색, 코드 편집, 확장 기능 설치 등 개발 전반을 지원하는 통합 개발 도구입니다.

📁 Love2D 프로젝트 구조 생성

Love2D 프로젝트 구조는 매우 단순합니다. 먼저 컴퓨터의 원하는 위치에 새 폴더를 생성하고, 예시처럼 ‘my game’과 같이 이름을 지정합니다. 이후 VS Code에서 해당 폴더를 ‘Open Folder’ 기능으로 열어 작업 공간으로 설정합니다. 프로젝트의 핵심은 반드시 main.lua라는 이름의 파일을 생성하는 것입니다. 이 파일은 Love2D가 기본적으로 실행하는 진입점 파일이며, 이름이 정확히 main.lua여야 합니다. 기본적으로 프로젝트 폴더 안에 main.lua 파일 하나만 있어도 실행이 가능하며, 이후 개발 과정에서 필요한 추가 파일을 점진적으로 확장해 나가는 구조입니다.

▶️ 프로젝트 실행 방법: 드래그 앤 드롭 방식

프로젝트를 실행하는 가장 기본적인 방법은 생성한 프로젝트 폴더를 Love 실행 파일(또는 바로가기 아이콘) 위로 드래그 앤 드롭하는 것입니다. 실행이 성공하면 Love 창이 열리며, main.lua 파일이 비어 있을 경우 검은 화면이 표시됩니다. 이는 오류가 아닌 정상 동작 상태이며, 코드가 추가되면 해당 내용이 화면에 반영됩니다. 프로젝트 폴더는 바탕화면뿐 아니라 컴퓨터 내 어느 위치에 있어도 동일한 방식으로 실행할 수 있습니다.

⚙️ VS Code 확장 기능을 통한 빠른 실행 설정

보다 효율적인 개발을 위해 VS Code에서 ‘Love2D Support’ 확장 기능을 설치하는 것이 권장됩니다. 확장 탭에서 해당 플러그인을 검색해 설치한 뒤, 설정에서 Love2D 실행 파일의 정확한 경로를 지정해야 합니다. Windows의 경우 일반적으로 C:\Program Files\LOVE\love.exe 경로가 사용되며, macOS에서는 응용 프로그램 폴더 내 Love 앱 경로를 지정합니다. 이 경로는 설치 시 확인했던 위치와 동일해야 합니다. 설정이 완료되면 main.lua 파일을 연 상태에서 Windows는 Alt + L, macOS는 Command + L 단축키로 즉시 프로젝트를 실행할 수 있습니다. 이는 드래그 앤 드롭 방식과 동일한 실행 결과를 제공하지만 훨씬 빠르고 반복 작업에 적합합니다.

🚀 개발 시작 준비 완료

이상의 과정을 마치면 Love2D 개발 환경이 완전히 준비된 상태입니다. 이제 main.lua 파일에 코드를 작성하며 게임 로직을 구현할 수 있으며, 필요에 따라 추가 Lua 파일이나 리소스 파일을 프로젝트 폴더에 확장해 나가면 됩니다. 기본 구조가 단순하기 때문에 초보자도 빠르게 게임 개발을 시작할 수 있는 환경이 갖추어집니다.