This guide covers how to install and configure the ULX admin mod on your Garry's Mod server hosted with Legion Hosting, including installation, granting admin permissions, common commands, and managing permission groups.

---

Table of Contents

1. Installing ULX and ULib
2. Granting Yourself Superadmin
3. Common ULX Commands
4. Permission Groups
5. Chat Commands
6. Configuration Files

---

1. Installing ULX and ULib

ULX is the most widely used admin mod for Garry's Mod. It requires two addons installed together:

Addon	Workshop ID	Notes
ULib	557962280	Required library for ULX. Must be installed first.
ULX	557962238	The admin mod itself. Depends on ULib.

Option A — Workshop Collection (Recommended)

Add both Workshop IDs to your server's Workshop collection. If you already have a collection configured via +host_workshop_collection in GPanel, simply add ULib and ULX to that existing collection on Steam. The server will download them automatically on next restart.

Option B — Manual SFTP Upload

1. Download both addons from the Workshop or from the Team Ulysses GitHub.
2. Upload them via SFTP to your server so the folder structure looks like:

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

Each folder must contain the addon's lua/ directory directly inside it.

---

2. Granting Yourself Superadmin

After ULX is installed and the server has restarted, you need to grant yourself the superadmin rank. Open the server console in GPanel and run:

ulx adduser "YourSteamName" superadmin

If your Steam name contains special characters or spaces, use your 64-bit Steam ID instead for accuracy:

ulx adduserid "STEAM_0:1:12345678" superadmin

Once granted, reconnect to the server. You can verify your rank by typing !menu in chat to open the ULX admin GUI.

---

3. Common ULX Commands

ULX commands can be run from the server console in GPanel, the in-game console, or as chat commands (prefix with !). Below are the most commonly used commands.

Player Management

Command	Chat Shortcut	Description
ulx kick "Player" reason	!kick Player reason	Kick a player from the server
ulx ban "Player" minutes reason	!ban Player 60 reason	Ban a player (0 = permanent)
ulx unban STEAMID	!unban STEAMID	Unban a player by Steam ID
ulx slay "Player"	!slay Player	Kill a player instantly
ulx slap "Player" damage	!slap Player 10	Slap a player for specified damage

Communication Controls

Command	Chat Shortcut	Description
ulx gag "Player"	!gag Player	Prevent a player from using voice chat
ulx ungag "Player"	!ungag Player	Restore voice chat for a player
ulx mute "Player"	!mute Player	Prevent a player from using text chat
ulx unmute "Player"	!unmute Player	Restore text chat for a player

Utility Commands

Command	Chat Shortcut	Description
ulx noclip "Player"	!noclip Player	Toggle noclip (fly through walls)
ulx god "Player"	!god Player	Toggle god mode (invincibility)
ulx teleport "Player"	!tp Player	Teleport a player to your crosshair
ulx bring "Player"	!bring Player	Teleport a player to you
ulx goto "Player"	!goto Player	Teleport yourself to a player
ulx return "Player"	!return Player	Return a player to their previous position
ulx cloak "Player"	!cloak Player	Make a player invisible

---

4. Permission Groups

ULX uses a group-based permission system. By default, ULX includes these groups, ordered from most to least privileged:

Group	Inherits From	Typical Use
superadmin	admin	Server owner. Full access to all commands.
admin	operator	Trusted staff. Can ban, kick, manage players.
operator	user	Junior moderators. Limited moderation commands.
user	none	Default group for all players.

Managing Users and Groups

// 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"

Using the GUI

As superadmin, type !menu in chat to open the ULX admin panel. The Groups tab provides a visual interface for creating groups, assigning permissions, and managing users without console commands.

---

5. Chat Commands

ULX supports chat-based command shortcuts for quick in-game administration. All commands use the ! prefix by default. Some useful patterns:

Chat Command	Effect
!menu	Opens the ULX admin GUI
!motd	Displays the Message of the Day
!kick Player reason	Kicks the named player
!ban Player 60 reason	Bans for 60 minutes
!hp Player 100	Sets a player's health
!armor Player 100	Sets a player's armor

---

6. Configuration Files

ULX stores its configuration and data in garrysmod/data/ulib/. Key files to be aware of:

File	Purpose
data/ulib/users.txt	All user-to-group assignments and Steam IDs
data/ulib/groups.txt	Group definitions, inheritance, and permissions
data/ulib/bans.txt	Active ban list with expiry times
data/ulx/config.txt	ULX settings (MOTD, welcome message, logging, etc.)

---

Related Articles

• Garry's Mod Server Setup Guide — Server.cfg, Workshop, gamemodes, DarkRP, FastDL
• Garry's Mod Troubleshooting — Missing textures, Workshop errors, and more
• How to Upload Files via SFTP

---