3 min read Intermediate 15.4k

Install ULX and ULib on a Garry's Mod server

Published on May 18, 2026 at 03:59 PM

ULX is the most widely used GMod admin system: admin management, moderation commands, integration with virtually every gamemode. Full install on your VeryCloud Wisp server.

Introduction

ULX (Ulysses ULX) with its ULib dependency is the de facto standard for GMod administration for 15+ years. Used on the majority of DarkRP, TTT, Sandbox servers. Not the most modern but the most universal. This guide sets it up in 10 minutes.

Prerequisites

A Garry's Mod server at VeryCloud
Access to Files in Wisp
Your SteamID64

Step 1: Download ULib and ULX

Both required.

ULib: https://github.com/TeamUlysses/ulib/archive/master.zip
ULX: https://github.com/TeamUlysses/ulx/archive/master.zip

Extract both ZIPs locally.

Step 2: Upload to the server

In Wisp → Files → /garrysmod/addons/:

Create two folders: ulib and ulx
Upload the contents of ulib-master/ into ulib/
Upload the contents of ulx-master/ into ulx/

Expected structure:

/garrysmod/addons/ulib/
  ├── lua/
  ├── data/
  └── ulib_addon_info.txt

/garrysmod/addons/ulx/
  ├── lua/
  ├── data/
  └── ulx_addon_info.txt

Step 3: Restart

From Wisp console. In the boot logs:

[ULib] Loaded
[ULX] Loaded

Step 4: Promote yourself to superadmin

In-game or from the server console:

ulx adduser <your_name> superadmin

Or for offline by SteamID:

ulx adduserid STEAM_0:1:XXXXX superadmin

Step 5: Test commands

In-game, type !menu or !xgui. The XGUI admin window opens — it's the ULX graphical interface.

You can ban, kick, slay, gag, give weapons, teleport, manage groups and permissions.

Step 6: Create custom groups

ulx groupadd <group_name> <inherited_powers>
# Example
ulx groupadd vip user
ulx groupadd moderator user

The trailing user indicates inheritance from the base user group.

Step 7: Per-command permissions

ulx groupallow moderator ulx kick
ulx groupallow moderator ulx slay
ulx groupallow moderator ulx mute
ulx groupallow vip ulx noclip

Full ULX command list: ulx help or !help in-game.

Step 8: Add players to a group

ulx adduser <player_name> <group>

Player must be connected. For offline:

ulx adduserid STEAM_0:1:XXXXX <group>

Step 9: Save config

Auto-saved to:

/garrysmod/data/ulib/users.txt
/garrysmod/data/ulib/groups.txt

To migrate, copy these two files to the new server.

Step 10: Gamemode integration

ULX auto-hooks into most gamemodes. DarkRP recognizes ULX roles (admin, superadmin) for permissions. For custom logic, see the gamemode's darkrp_modules/jobs/jobs.lua with customCheck mapped on ULX.

Troubleshooting

"You don't have access to this command" — ulx whoami tells your current group. ulx groupallow <group> <command> to grant. ULX doesn't load at boot — verify folders are /addons/ulib/ and /addons/ulx/ (not -master). Conflict with another admin mod — uninstall SAM, Maul, Evolve. Never mix two admin mods.

Useful commands

ulx help
ulx adduser <name> <group>
ulx removeuser <name>
ulx groupadd <name> <inherit>
ulx groupallow <group> <cmd>
ulx kick <name> <reason>
ulx ban <name> <minutes> <reason>
ulx slay <name>
ulx noclip <name>
!menu

Conclusion

ULX + ULib = 15-year standard, works everywhere, documented. Not the sexiest but the most reliable. For more modern alternatives, look at SAM (Sourcebans-like) or Maul, but for 90% of servers ULX is more than enough.

Going further: ULX RP integration (DarkRP roles), persistent bans with MySQL via ULib MySQL extension, Discord ban dashboard.