ULX v3.61 -- Advanced Admin Mod

ULX – Advanced Admin Mod

[Current version: 3.62](http://ulyssesmod.net/)

DOWNLOAD: http://ulyssesmod.net/downloads.php

  • Be sure you download ULib as well, as ULX depends on it.

Brought to you by:
Stickly Man!
Mr. President

Join the ULX steam community!

[http://www.paypal.com/en_US/i/btn/x-click-but04.gif](https://www.paypal.com/cgi-bin/webscr?cmd=_xclick&business=smith.brett.41%40g mail%2ecom&item_name=Donation&no_shipping=1&cn=Not es&tax=0¤cy_code=USD&lc=US&bn=PP%2dDonationsBF&cha rset=UTF%2d8)
(We’ll love you forever if you donate! We need to eat too :))

What is ULX?
ULX is a powerful admin mod that is not only the oldest and most mature admin mod, it’s the oldest and most mature Gmod-specific lua release still in use. The first version of ULX was released days after GM9, and development on it has continued since then. Check the features list below for more details. As of version 3.50, ULX now includes XGUI, which is a GUI created by Stickly Man! which is designed to provide an intuitive yet powerful experience for users who can run ULX commands, change ULX configs, manage bans, and much more!

What’s new in v3.62?
Along with lots of bugfixes and ideas from our community, We’ve added a couple new commands: “ulx return” will return a target to their previous position after a teleport, and “ulx stopvote” will stop a vote that’s currently in process. Additionally, if you try to run a command with a partial name of a player that matches multiple users, a list of those users will be presented to you to help you find your target.

XGUI’s ban menu got an overhaul- ban information is now shown in pages, and we’ve added better search, filtering, AND sorting options! The ban information is longer downloaded to each admin on join- instead, the ban data is only requested when needed to avoid lag spikes.

Check out the full changelog here!


Commands Tab:

Groups Tab:

Maps Tab:

Settings Tab:

Bans Tab:

Full Command List:

ULX Help:
If a command can take multiple targets, it will usually let you use the keywords '*' for target
all, '^' to target yourself, '@' for target your picker, '$<userid>' to target by ID (steamid,
uniqueid, userid, ip), '#<group>' to target users in a specific group, and '%<group>' to target
users with access to the group (inheritance counts). IE, ulx slap #user slaps all players who are
in the default guest access group. Any of these keywords can be preceded by '!' to negate it.
EG, ulx slap !^ slaps everyone but you.
You can also separate multiple targets by commas. IE, ulx slap bob,jeff,henry.
All commands must be preceded by "ulx ", ie "ulx slap"

Command Help:

Category: Fun
        o ulx armor <players> <armor: 0<=x<=255> - Sets the armor for target(s). (say: !armor)
        o ulx blind <players> [<amount: 0<=x<=255, default 255>] - Blinds target(s). (say: !blind) (opposite: ulx unblind)
        o ulx cloak [<players, defaults to self>] [<amount: 0<=x<=255, default 255>] - Cloaks target(s). (say: !cloak) (opposite: ulx uncloak)
        o ulx freeze <players> - Freezes target(s). (say: !freeze) (opposite: ulx unfreeze)
        o ulx god [<players, defaults to self>] - Grants god mode to target(s). (say: !god) (opposite: ulx ungod)
        o ulx hp <players> <hp: 1<=x<=2147483647> - Sets the hp for target(s). (say: !hp)
        o ulx ignite <players> [<seconds: 1<=x<=300, default 300>] - Ignites target(s). (say: !ignite) (opposite: ulx unignite)
        o ulx jail <players> [<seconds, 0 is forever: 0<=x, default 0>] - Jails target(s). (say: !jail) (opposite: ulx unjail)
        o ulx jailtp <player> [<seconds, 0 is forever: 0<=x, default 0>] - Teleports, then jails target(s). (say: !jailtp)
        o ulx maul <players> - Maul target(s). (say: !maul)
        o ulx playsound <sound> - Plays a sound (relative to sound dir).
        o ulx ragdoll <players> - ragdolls target(s). (say: !ragdoll) (opposite: ulx unragdoll)
        o ulx slap <players> [<damage: 0<=x, default 0>] - Slaps target(s) with given damage. (say: !slap)
        o ulx slay <players> - Slays target(s). (say: !slay)
        o ulx sslay <players> - Silently slays target(s). (say: !sslay)
        o ulx strip <players> - Strip weapons from target(s). (say: !strip)
        o ulx unigniteall - Extinguishes all players and all entities. (say: !unigniteall)
        o ulx whip <players> [<times: 2<=x<=100, default 10>] [<damage: 0<=x, default 0>] - Slaps target(s) x times with given damage each time. (say: !whip)

Category: Rcon
        o ulx cexec <players> {command} - Run a command on console of target(s). (say: !cexec)
        o ulx ent <classname> [{<flag>:<value>}] - Spawn an ent, separate flag and value with ':'.
        o ulx exec <file> - Execute a file from the cfg directory on the server.
        o ulx luarun {command} - Executes lua in server console. (Use '=' for output)
        o ulx rcon {command} - Execute command on server console. (say: !rcon)

Category: User Management
        o ulx addgroup <group> [<inherits from>] - Create a new group with optional inheritance.
        o ulx adduser <player> <group> - Add a user to specified group.
        o ulx adduserid <SteamID, IP, or UniqueID> <group> - Add a user by ID to specified group.
        o ulx groupallow <group> <command> [<access tag>] - Add to a group's access.
        o ulx groupdeny <group> <command> - Remove from a group's access.
        o ulx removegroup <group> - Removes a group. USE WITH CAUTION.
        o ulx removeuser <player> - Permanently removes a user's access.
        o ulx removeuserid <SteamID, IP, or UniqueID> - Permanently removes a user's access by ID.
        o ulx renamegroup <current group> <new group> - Renames a group.
        o ulx setgroupcantarget <group> [<target string>] - Sets what a group is allowed to target
        o ulx userallow <player> <command> [<access tag>] - Add to a user's access.
        o ulx userallowid <SteamID, IP, or UniqueID> <command> [<access tag>] - Add to a user's access.
        o ulx userdeny <player> <command> [<remove explicit allow or deny instead of outright denying: 0/1>] - Remove from a user's access.
        o ulx userdenyid <SteamID, IP, or UniqueID> <command> [<remove explicit allow or deny instead of outright denying: 0/1>] - Remove from a user's access.
        o ulx usermanagementhelp - See the user management help.

Category: Utility
        o ulx ban <player> [<minutes, 0 for perma: 0<=x, default 0>] [{reason}] - Bans target. (say: !ban)
        o ulx banid <steamid> [<minutes, 0 for perma: 0<=x, default 0>] [{reason}] - Bans steamid.
        o ulx debuginfo - Dump some debug information.
        o ulx help - Shows this help.
        o ulx kick <player> [{reason}] - Kicks target. (say: !kick)
        o ulx map <map> [<gamemode>] - Changes map and gamemode. (say: !map)
        o ulx noclip [<players, defaults to self>] - Toggles noclip on target(s). (say: !noclip)
        o ulx resettodefaults [<string>] - Resets ALL ULX and ULib configuration!
        o ulx spectate <player> - Spectate target. (say: !spectate)
        o ulx unban <steamid> - Unbans steamid.
        o ulx who - See information about currently online users.

Category: Chat
        o ulx asay {message} - Send a message to currently connected admins. (say: @)
        o ulx csay {message} - Send a message to everyone in the middle of their screen. (say: @@@)
        o ulx gag <players> - Gag target(s), disables microphone. (say: !gag) (opposite: ulx ungag)
        o ulx gimp <players> - Gimps target(s) so they are unable to chat normally. (say: !gimp) (opposite: ulx ungimp)
        o ulx mute <players> - Mutes target(s) so they are unable to chat. (say: !mute) (opposite: ulx unmute)
        o ulx psay <player> {message} - Send a private message to target. (say: !p)
        o ulx thetime - Shows you the server time. (say: !thetime)
        o ulx tsay {message} - Send a message to everyone in the chat box. (say: @@)

Category: Voting
        o ulx stopvote - Stops a vote in progress. (say: !stopvote)
        o ulx veto - Veto a successful votemap. (say: !veto)
        o ulx vote <title> {options} - Starts a public vote. (say: !vote)
        o ulx voteban <player> [<minutes: 0<=x, default 1440>] [{reason}] - Starts a public ban vote against target. (say: !voteban)
        o ulx votekick <player> [{reason}] - Starts a public kick vote against target. (say: !votekick)
        o ulx votemap [{map}] - Vote for a map, no args lists available maps. (say: !votemap)
        o ulx votemap2 {map} - Starts a public map vote. (say: !votemap2)

Category: Teleport
        o ulx bring <player> - Brings target to you. (say: !bring)
        o ulx goto <player> - Goto target. (say: !goto)
        o ulx return [<player, defaults to self>] - Returns target to last position before a teleport. (say: !return)
        o ulx send <player> <player> - Goto target. (say: !send)
        o ulx teleport [<player, defaults to self>] - Teleports target. (say: !tp)

Category: Menus
        o ulx motd - Show the message of the day. (say: !motd)
        o xgui <show, hide, toggle> - Opens and/or closes XGUI. (say: !xgui, !menu) (alias: ulx menu)
        o xgui fban <player> - Opens the add ban window, freezes the specified player, and fills out the Name/SteamID automatically. (say: !fban)
        o xgui xban <player> - Opens the add ban window and fills out Name/SteamID automatically if a player was specified. (say: !xban)

-End of help
ULX version: 3.62

Features in ULX

  • Immense command list.
  • Designed to work well with all ranges of servers. Whether you’re a casual weekend server or a 64-player server, ULX will find a home in your admins’ hearts.
  • A unique and full-featured player targeting system. You can always target yourself by using the ‘^’ keyword, IE “ulx slap ^” to slap yourself. You can target the player you’re looking at using the ‘@’ keyword, you can target a group using the ‘%<group_name>’ keyword, you can target a group ignoring inhertience by using the ‘#<group_name>’ keyword, you can target by player ID, SteamID, or UniqueID by using the ‘$<ID>’ keyword, and you can negate a target using ‘!’. If I wanted to slap everyone that wasn’t an admin as well as Bob I’d use “ulx slap !%admin,Bob”.
  • Autocomplete. This is one you’ll have to try yourself to fully realize its potential. If you type "ulx " at a client’s console, you’ll get a list of commands you have access to which narrow down as you type in more characters. After that, it will help you find a target for your command, or show you the full syntax. It can also show valid parameters for each argument, i.e. for "ulx map ", it will list the current maps available on your server. It can’t get any easier!
  • Designed to be easy to use from a dedicated console. Nearly every setting can be changed at console.
  • No hard coded groups or accesses. You decide how you want your group and accesses setup.
  • Plays nice with other mods and gamemodes. Unless another mod changes the default Gmod library, ULX should have no conflicts as it does not actively change gameplay.
  • Supplements gmod’s default admin library and reads in admins from Garry’s default admin file. This means that scripts will pick up ULX admins without specifically being designed to do so (thanks to ULib!). It should be noted that it does this in such a way that it won’t break other mods.
  • HTML Message of the Day. This pops up in a window when players join. This is completely configurable, and you can pass the current map and the connecting player’s STEAMID to a URL. You can also offer downloads to your model packs from here, or disable it completely.
  • Welcome message. In the event you don’t want to use the MOTD, you can greet players from this.
  • A fully featured, completely configurable logging system. Logs player chats, joins, parts, deaths/kills, spawns, admins actions (in colors!), etc. As an extension to the spawn logging, you can also echo player spawns to connected admins so they can catch spammers.
  • Admin actions are echoed to the players on the server. The revised system now uses different colors to highlight various parts of each message. You have three options: Off, anonymous, and full. Full looks like “Foo slapped Bob with 0 damage”, while anonymous looks like “(Someone) slapped Bob with 0 damage”.
  • Everything that’s logged to a file is also echoed to the server console in the event you like to watch what’s going on from there.
  • Reserved slots.
  • Forced downloads. You can push extra resources like models and sounds to the player via ULX.
  • Adverts- You can configure them to show either in the center of the screen or in the player chat area. With XGUI, you can configure these adverts in-game, and the changes take effect immediately.
  • Admins can physgun other players.
  • UTeam is now included with ULX! UTeam sets users’ team based on their usergroup and sets colors and player modifiers for teams. This works great with sui_scoreboard so can see team colors. UTeam is disabled by default, and is only available for sandbox.
  • ULX supports gatekeeper and will use it if available.

XGUI features:

  • Configure just about every aspect of ULX on the fly, without needing a map change.
  • XGUI stays constantly updated-- if another admin changes any setting, it will show up in real-time right before your eyes! Think Google Wave for administration.
  • Allows all users to view and execute only ULX commands that they have access to. Obeys all command argument restrictions, too.
  • You can add and remove groups, move players from group to groups (even players that are offline), add/remove accesses from groups, and change per-command per-argument restrictions for groups.
  • Manage UTeam settings: Add/Remove teams, assign groups to a team, change team modifiers such as hp, runspeed, color, etc.
  • View available server maps, and create map votes. Non-admins can use this menu to execute votemaps on allowed maps. You can even see a preview of the map, if available.
  • Supports modular per-gamemode menus-- For sandbox, you can set prop limits and change basic server settings like noclip and godmode.
  • Configure ULX settings such as adverts, gimps, vote-based settings, command echo settings, kick/ban default reasons, log settings, reserved slots, and more.
  • Advanced ban menu that allows you to easily add bans, remove bans, view loads of details on each ban, search for bans, edit bans unban date, name, reason, etc., view bans that were added via the source engine, all while supporting extremely large banlists.
  • Includes !fban <player> chat command (or “xgui fban <player>” in console) which immediately freezes the targeted player while you enter a ban reason and ban length.
  • Includes an “infobar” which gives you quick access to view ULX, ULib, and XGUI version info, along with a clock to show your local time.

Our Community:
The ulyssesmod.net forums currently have about 38,000 posts by 9000 users, and is visited daily by our team members and fellow community peers and developers who are more than willing to lend a hand in helping you (so long as you ask nicely and read the FAQ for answers first!)

  • You can find a number of third-party plugins in our Releases Board, or we have an area to post suggestions in case you can’t find what you’re looking for!
  • Our developers focus on making ULX as dependable and as bug-free as humanly possible. Any bug you find and report to us that is confirmed to be a fault of ULX is fixed in the next version of ULX, and even put to testing in SVN sooner than the next release.

Some of our other works you’ll want to know about (they work great with ULX!):

  • UPS - Ulysses Prop Share. An extremely lightweight yet flexible prop protector.
  • UClip - A noclip alternative. Players can’t noclip through the world or through other peoples’ props.
  • UTime - Keep track of how long your players have been connected this session and total.
  • Uppl - Restrict props on a per-model basis.
  • UBan (requires ULX) - Ban players across multiple servers using a centralized database.
  • sui_scoreboard - Not technically one of our works, but this is one you just have to try out! Completely re-done scoreboard that just looks amazing.

Help me! It’s not working!
If you don’t have access to your server console, we can’t help you! Please make a test install on a server you can access first.
You need to follow the directions for your problem in order. Do not skip a step or you’ll probably be ignored.

ULX isn’t running, it says ulx is an unknown command.

  • Have you restarted the server? Garrysmod requires a full server restart (not just a map change!) in order to detect new addons.
  • Make sure you properly installed both ULib and ULX on your server. It doesn’t do any good if you install them on your client, and ULX won’t run without ULib.
  • You should have a directory structure of garrysmod/addons/ulx/info.txt and garrysmod/addons/ulib/info.txt.
  • Check server console on map start. Do you see the ULX and ULib loading blocks? If not you installed it improperly.
  • Are there errors in the ULX and ULib loading block? Post them on the thread and we’ll try to help you further!
  • If and only if your problem was due to something on our end, please report the bug to us here

I’m having trouble adding myself or another as an admin.

  • The syntax for “ulx adduser” can be seen by typing “ulx adduser” and nothing else into the console, or you can read here
  • If you still have questions read this. This thread asks for information, so don’t reply without the information saying you read it and you’re still having problems, we will ignore you.

How do I unban someone?
Read this.

How can I uninstall ULib/ULX?
Simply remove the folders from addons.

Yay, new version! :wink:

Good job guys!

Gonna DL it right now :smiley:

This broke my server, I don’t recommend using until they fix.

Not sure what the error is, but there is a problem with the ulib 2.51

Reason I know:

  • I downgraded to 3.60 and it worked perfectly.
  • Went back to 3.61 and everything broke.

Works fine on my server, running TTT v37

It was working fine earlier, then it broke on me.

“It broke” helps no one, find the error and report it.

There seems to be a bug sometimes with the xgui when moving people’s group from the “Group” tab. Sometimes you move them and it says they got moved but their name still appears on group they were in before. Usually a restart/map change fixes the problem.

Yeah, I am aware of this bug, I just haven’t quite had the time to track it down yet. I’ve been having trouble replicating it, as well. Does it occur only when you try to change the group of online people?

I tried many admin mods, but this one is the best!
Keep up the good work.

Seems to be happening in both online and offline players.

[editline]4th September 2013[/editline]

I also got several errors in the console log.

One of them is:

[ERROR] addons/ulx/lua/ulx/modules/sh/fun.lua:1015: attempt to call field 'concommand' (a nil value)
  1. unknown - addons/ulx/lua/ulx/modules/sh/fun.lua:1015
   2. include - [C]:-1
    3. unknown - addons/ulx/lua/ulx/init.lua:33
     4. include - [C]:-1
      5. unknown - addons/ulx/lua/ulib/modules/ulx_init.lua:2
       6. include - [C]:-1
        7. unknown - addons/ulib/lua/ulib/init.lua:68
         8. include - [C]:-1
          9. unknown - addons/ulib/lua/autorun/ulib_init.lua:3

Another is:

[AddCSLuaFile] Couldn't find 'effects/ulx_firework/init.lua' (<nowhere>)
L 09/04/2013 - 17:34:44: Lua Error: [AddCSLuaFile] Couldn't find 'effects/ulx_fireworkstem/init.lua' (<nowhere>)

There is no line 1015 in fun.lua, so you’re not using the right files. Recommend full delete and reinstall. The second error is known and won’t cause any issues.

While usingin the lastest GITHUB version, I’m having this occurence on the latests TTT version. It breaks the hud, nil error on sb_main:245

Also when the server starts up heres the server errors: http://pastebin.com/e9Q3gngE
This started to occur this morning, I’ve had no issue the last 2 days. Lucky for me I have a back up of an old ULX i was using, and it seems to be fine again, would be glad to see you guys look into it :slight_smile:

Oops, that second error is our fault. Thanks for reporting it! It’s fixed on GitHub now.

The first error likely doesn’t have anything to do with ULX or ULib.

Thanks Megiddo, the new update fixed both the errors :smiley:

Most versatile administrative mod I’ve used on gmod.

Updated first post for our latest release of version 3.62!

See more details here: