Logitech G HUB에서 .lua 스크립트를 안정적으로 가져오고, 실행하고, 버튼에 할당하는 전 과정을 한 번에 정리한 가이드입니다.
Logitech 마우스에서 .lua 스크립트를 사용하면, 단순한 버튼 매핑을 넘어 훨씬 더 많은 동작을 자동화할 수 있습니다.
예를 들어 Rust, CS 2, PUBG 같은 게임에서 반동 제어(리코일 제어)와 같은 반복 작업을 매크로로 묶어
보다 일관된 입력을 만들 수 있습니다. “Logitech G HUB 매크로”는 준비된 스크립트를 구매해 바로 적용할 수도 있고,
직접 스크립트를 작성해 원하는 로직으로 커스터마이징할 수도 있습니다.
아래 내용은 Logitech G HUB에서 매크로를 설치(Import)하고 설정한 뒤 정상 동작을 확인하는 방법을
단계별로 설명합니다. 중간에 막히는 부분이 생기면 “문제 해결(게임에서 작동 안 함 / 로딩 루프)” 섹션을 먼저 확인해 주세요.
1. Logitech G HUB 다운로드 및 설치
공식 사이트에서 G HUB를 다운로드합니다:Logitech G HUB 다운로드.
처음 설치하는 경우라면 최신 안정 버전으로 시작하는 것이 일반적입니다.
다만 특정 PC 환경에서 충돌, 무한 로딩, 스크립트 인식 실패 등이 발생할 수 있으므로,
문제가 생기면 검증된 구버전으로 테스트하는 것도 좋은 접근입니다.
예: 2021.10.8013 –
G HUB (2021.10.8013) 다운로드.
관리자 권한으로 설치 및 실행합니다.
일부 게임은 보안 정책 때문에 일반 권한 상태에서는 스크립트 입력을 제한하거나, G HUB의 스크립트 이벤트를 정상 전달하지 못하게 만들 수 있습니다.
“바탕화면에서는 작동하는데 게임에서는 안 되는” 대표적인 케이스가 여기에 해당합니다.
설치 후에도 가능하면 G HUB를 관리자 권한으로 실행해 주세요.
온보드 메모리(On-board memory) 모드를 비활성화합니다.
최신 G HUB에서는 메인 화면에서 마우스 이미지 오른쪽에 토글로 표시되는 경우가 많습니다.
온보드 메모리가 켜져 있으면, 스크립트 기반 동작이 예상과 다르게 제한되거나 프로필 전환이 꼬일 수 있습니다.
2. Logitech 마우스에 매크로 세팅하기: 기본 프로필 준비
.lua 스크립트를 준비합니다.
직접 만들거나, TopMacro에서 준비된 스크립트를 구매해 사용할 수 있습니다.
파일은 찾기 쉬운 위치(예: 바탕화면 또는 전용 폴더)에 저장해 두면 Import 과정에서 실수가 줄어듭니다.
특히 Rust / PUBG / CS2처럼 여러 게임 스크립트를 동시에 관리하려면, 스크립트 폴더를 따로 만들어 정리하는 것을 권장합니다.
G HUB에서 “Desktop(바탕화면)” 프로필을 기본(Primary)으로 고정합니다.
G HUB 실행
“Games & Applications(게임 및 애플리케이션)” 또는 “Manage Profiles(프로필 관리)”로 이동
“Desktop” 프로필을 찾아 영구(고정) / 기본(Primary)으로 설정
게임별 프로필을 자동으로 만들면, 스크립트가 특정 게임 프로필에서만 동작하거나 반대로 충돌이 생길 수 있습니다.
스크립트 테스트 및 안정적 사용 목적이라면 Desktop 프로필을 기준으로 잡는 것이 가장 단순하고 확실합니다.
3. Lua 스크립트 생성 및 Import(가져오기)
“Desktop” 프로필이 활성화되어 있는지 확인합니다.
가장 흔한 실수는 “지금 어떤 프로필에서 편집하고 있는지”를 놓치는 것입니다.
프로필이 달라지면 버튼 할당과 스크립트 적용 상태도 달라질 수 있으니, 먼저 Desktop 상태인지 확인해 주세요.
새 스크립트를 생성합니다.
“Create New LUA Script(새 LUA 스크립트 만들기)” 또는 유사 버튼을 클릭
스크립트 창에서 “Script” → “Import(가져오기)”를 선택
준비해둔 .lua 파일을 선택
여러 게임(예: Rust, CS2, PUBG) 스크립트를 운영한다면, 스크립트를 여러 개 만들어 각각 Import해 두는 방식이 관리가 쉽습니다.
또는 Premium 통합 스크립트를 사용해 “핫키로 무기/프로필을 전환”하는 구조로 운영할 수도 있습니다.
저장 후 실행(Save and Run)합니다.
Import만 해서는 “로드는 되었지만 실행은 안 된 상태”로 남아 있을 수 있습니다.
스크립트 메뉴에서 Save and Run(저장 및 실행)을 눌러 활성화해 주세요.
이 단계가 빠지면 버튼을 눌러도 아무 반응이 없는 경우가 매우 많습니다.
4. 매크로 동작 확인(테스트)
버튼을 할당합니다.
일반적으로 스크립트는 사이드 버튼(G5 등)에 매핑되어 있는 경우가 많습니다.
원하는 키로 바꾸고 싶다면, 스크립트 내부에서 트리거 버튼을 변경하거나,
G HUB에서 해당 버튼에 기능을 할당하는 방식으로 조정할 수 있습니다.
Desktop 프로필에서 먼저 테스트합니다.
바탕화면 환경에서 버튼을 누르거나 누르고 있는 동안 커서 이동(또는 입력 패턴)이 스크립트대로 동작하는지 확인합니다.
예를 들어 반동 제어 스크립트라면 “아래 방향으로 일정 패턴 이동”이 정상적으로 나타나는지 확인하는 식입니다.
Desktop에서 제대로 동작하면, 대부분의 경우 설정 자체는 올바르게 완료된 상태입니다.
팁: “게임에서만 안 된다”면 스크립트 문제가 아니라 권한(관리자), 프로필(Desktop 고정), 온보드 메모리 같은 환경 설정 이슈일 가능성이 더 높습니다.
5. 여러 개의 매크로를 동시에 추가하는 방법
여러 스크립트를 같이 쓰고 싶다면 다음 방식으로 운영하는 것이 안정적입니다.
위 과정을 반복하여 새 스크립트를 만들고 각 .lua 파일을 Import합니다.
각 스크립트마다 Save and Run을 눌러 실행 상태로 둡니다.
스크립트가 많아질수록 파일/이름 규칙이 중요해지므로, “게임명_버전_설명.lua” 같은 규칙으로 정리하면 관리가 편합니다.
또한 TopMacro에는 여러 무기의 패턴을 한 파일에 통합한 Premium 스크립트도 있습니다.
이 방식은 키보드/마우스 핫키로 무기나 모드를 전환할 수 있어, 스크립트를 여러 개로 쪼개지 않고도 효율적으로 운용할 수 있습니다.
6. G HUB에서 직접 매크로(스크립트) 만들기
직접 스크립트를 만들고 싶다면, 최소한의 프로그래밍 감각이 있으면 훨씬 수월합니다.
다행히 G HUB에는 기본적인 Lua Scripting 인터페이스가 포함되어 있어, 간단한 반복/조건/이벤트 처리부터 차근차근 실험해볼 수 있습니다.
처음에는 작은 기능(예: 단순한 딜레이/반복 클릭/키 조합)부터 시작해서 안정성이 확인되면 점차 복잡한 로직으로 확장하는 것을 권장합니다.
실전 팁: “완벽한 스크립트를 한 번에 만들기”보다, 짧은 단위로 테스트하면서 단계적으로 확장하는 방식이 오류를 줄이고 유지보수도 쉬워집니다.
7. 게임에서 매크로가 작동하지 않을 때
Desktop 프로필이 “영구(고정) / 기본(Primary)”으로 설정되어 있는지 다시 확인합니다.
G HUB를 완전히 종료한 뒤, 관리자 권한으로 다시 실행합니다.
온보드 메모리 모드가 켜져 있으면 끄고 PC를 재부팅합니다.
게임도 가능하면 관리자 권한으로 실행해 테스트해 봅니다(환경에 따라 효과가 있습니다).
그래도 안 되면 G HUB를 재설치하거나, 안정적인 구버전으로 내려서 테스트합니다.
흔한 원인 정리: (1) 권한 문제 (2) 프로필 충돌 (3) 온보드 메모리 (4) G HUB 버전 이슈.
위 4가지를 순서대로 점검하면 대부분 해결됩니다.
8. G HUB가 실행되지 않거나 무한 로딩(Loading loop)일 때
가장 실전적으로 효과가 좋은 방법은 완전 삭제 후 구버전 설치입니다.
예: 2021.10.8013 설치 후,
실행 과정에서 업데이트 팝업이 뜨면 업데이트를 진행해 최신 구성 요소를 다시 받게 하는 방식입니다.
이 방법은 “아예 켜지지 않음 / 로딩만 계속됨” 문제를 해결하는 데 도움이 되는 경우가 많습니다.
9. 마무리
Logitech 마우스에서 매크로를 세팅하는 과정은 핵심만 잡으면 생각보다 단순합니다.
중요한 것은 “Import만 하고 끝내지 말 것”, “Desktop 프로필을 고정할 것”, “관리자 권한을 사용할 것”입니다.
G HUB 설치 후 관리자 권한 실행
Desktop 프로필을 기본(Primary)으로 고정
새 Lua 스크립트 생성 → Import
Save and Run으로 실행 상태 활성화
버튼 할당 후 Desktop에서 먼저 테스트
설정이 잘 끝나면, 작업도 게임도 더 편해집니다. 안정적으로 세팅해서 깔끔하게 사용해 보세요.
.webp)
.webp)
.webp)
.webp)
.webp)
.webp)
.webp)
.webp)
