이 가이드는 Legion Hosting으로 호스팅되는 Garry's Mod 서버에 ULX 관리자 모드를 설치하고 구성하는 방법을 다루며, 설치, 관리자 권한 부여, 일반 명령어, 권한 그룹 관리를 포함합니다.

---

목차

1. ULX 및 ULib 설치
2. 자신에게 슈퍼관리자 권한 부여
3. 일반 ULX 명령어
4. 권한 그룹
5. 채팅 명령어
6. 구성 파일

---

1. ULX 및 ULib 설치

ULX는 Garry's Mod에서 가장 널리 사용되는 관리자 모드입니다. 함께 설치해야 하는 두 가지 애드온이 필요합니다:

애드온	Workshop ID	참고
ULib	557962280	ULX에 필요한 라이브러리. 먼저 설치해야 합니다.
ULX	557962238	관리자 모드 본체. ULib에 의존합니다.

옵션 A — Workshop 컬렉션 (권장)

두 Workshop ID를 모두 서버의 Workshop 컬렉션에 추가하세요. GPanel에서 +host_workshop_collection을 통해 이미 컬렉션이 구성되어 있다면, Steam의 해당 기존 컬렉션에 ULib와 ULX를 추가하기만 하면 됩니다. 서버는 다음 재시작 시 자동으로 다운로드합니다.

옵션 B — 수동 SFTP 업로드

1. Workshop 또는 Team Ulysses GitHub에서 두 애드온을 다운로드합니다.
2. 폴더 구조가 다음과 같이 보이도록 SFTP를 통해 서버에 업로드합니다:

garrysmod/addons/ulib/
garrysmod/addons/ulx/

각 폴더는 그 안에 직접 애드온의 lua/ 디렉터리를 포함해야 합니다.

---

2. 자신에게 슈퍼관리자 권한 부여

ULX가 설치되고 서버가 재시작된 후, 자신에게 superadmin 등급을 부여해야 합니다. GPanel에서 서버 콘솔을 열고 다음을 실행하세요:

ulx adduser "YourSteamName" superadmin

Steam 이름에 특수 문자나 공백이 포함된 경우, 정확성을 위해 64비트 Steam ID를 대신 사용하세요:

ulx adduserid "STEAM_0:1:12345678" superadmin

권한이 부여되면 서버에 다시 접속하세요. 채팅에서 !menu를 입력하여 ULX 관리자 GUI를 열어 등급을 확인할 수 있습니다.

---

3. 일반 ULX 명령어

ULX 명령어는 GPanel의 서버 콘솔, 게임 내 콘솔, 또는 채팅 명령어(! 접두사 사용)로 실행할 수 있습니다. 아래는 가장 일반적으로 사용되는 명령어입니다.

플레이어 관리

명령어	채팅 단축키	설명
ulx kick "Player" reason	!kick Player reason	서버에서 플레이어를 추방
ulx ban "Player" minutes reason	!ban Player 60 reason	플레이어를 차단 (0 = 영구)
ulx unban STEAMID	!unban STEAMID	Steam ID로 플레이어 차단 해제
ulx slay "Player"	!slay Player	플레이어를 즉시 사망 처리
ulx slap "Player" damage	!slap Player 10	지정된 피해량으로 플레이어를 때림

커뮤니케이션 제어

명령어	채팅 단축키	설명
ulx gag "Player"	!gag Player	플레이어가 음성 채팅을 사용하지 못하게 함
ulx ungag "Player"	!ungag Player	플레이어의 음성 채팅을 복원
ulx mute "Player"	!mute Player	플레이어가 텍스트 채팅을 사용하지 못하게 함
ulx unmute "Player"	!unmute Player	플레이어의 텍스트 채팅을 복원

유틸리티 명령어

명령어	채팅 단축키	설명
ulx noclip "Player"	!noclip Player	노클립 전환 (벽 통과 비행)
ulx god "Player"	!god Player	갓 모드 전환 (무적)
ulx teleport "Player"	!tp Player	플레이어를 조준점으로 순간이동
ulx bring "Player"	!bring Player	플레이어를 자신에게 순간이동
ulx goto "Player"	!goto Player	자신을 플레이어에게 순간이동
ulx return "Player"	!return Player	플레이어를 이전 위치로 되돌림
ulx cloak "Player"	!cloak Player	플레이어를 보이지 않게 함

---

4. 권한 그룹

ULX는 그룹 기반 권한 시스템을 사용합니다. 기본적으로 ULX는 가장 높은 권한부터 가장 낮은 권한 순으로 다음 그룹을 포함합니다:

그룹	상속 대상	일반적인 용도
superadmin	admin	서버 소유자. 모든 명령어에 대한 전체 접근.
admin	operator	신뢰할 수 있는 스태프. 차단, 추방, 플레이어 관리 가능.
operator	user	주니어 운영자. 제한된 관리 명령어.
user	없음	모든 플레이어의 기본 그룹.

사용자 및 그룹 관리

// Add a user to a group
ulx adduser "Player" admin

// Remove a user from their group (reverts to "user")
ulx removeuser "Player"

// Create a custom group that inherits from "operator"
ulx groupallow "moderator" "ulx kick"
ulx addgroup "moderator" "operator"

// Grant a specific command to a group
ulx groupallow "admin" "ulx ban"

// Deny a specific command from a group
ulx groupdeny "operator" "ulx ban"

GUI 사용

슈퍼관리자로서 채팅에 !menu를 입력하여 ULX 관리자 패널을 엽니다. Groups 탭은 콘솔 명령어 없이 그룹을 생성하고, 권한을 할당하며, 사용자를 관리하기 위한 시각적 인터페이스를 제공합니다.

---

5. 채팅 명령어

ULX는 빠른 게임 내 관리를 위한 채팅 기반 명령어 단축키를 지원합니다. 모든 명령어는 기본적으로 ! 접두사를 사용합니다. 유용한 패턴 몇 가지:

채팅 명령어	효과
!menu	ULX 관리자 GUI를 엽니다
!motd	오늘의 메시지를 표시합니다
!kick Player reason	지정된 플레이어를 추방합니다
!ban Player 60 reason	60분 동안 차단합니다
!hp Player 100	플레이어의 체력을 설정합니다
!armor Player 100	플레이어의 방어구를 설정합니다

---

6. 구성 파일

ULX는 구성 및 데이터를 garrysmod/data/ulib/에 저장합니다. 알아두어야 할 주요 파일:

파일	용도
data/ulib/users.txt	모든 사용자-그룹 할당 및 Steam ID
data/ulib/groups.txt	그룹 정의, 상속 및 권한
data/ulib/bans.txt	만료 시간이 포함된 활성 차단 목록
data/ulx/config.txt	ULX 설정 (MOTD, 환영 메시지, 로깅 등)

---

관련 문서

• Garry's Mod 서버 설정 가이드 — Server.cfg, Workshop, 게임모드, DarkRP, FastDL
• Garry's Mod 문제 해결 — 누락된 텍스처, Workshop 오류 등
• SFTP를 통해 파일 업로드하는 방법

---