Title: ULX v3.60 -- Advanced Admin Mod -- Official GM13 Release

[h2]ULX -- Advanced Admin Mod[/h2]
[b][highlight][url=http://ulyssesmod.net/]Current version: 3.60[/url][/highlight][/b]
[b]DOWNLOAD: [url]http://ulyssesmod.net/[/url][/b]
 * Be sure you download ULib as well, as ULX [i]depends[/i] on it.

[b]Brought to you by:[/b]
Megiddo
Stickly Man!
JamminR

Join the [url=http://steamcommunity.com/groups/ULX]ULX steam community[/url]!

[url=https://www.paypal.com/cgi-bin/webscr?cmd=_xclick&business=Megiddo%40Christian%2enet&item_name=Donation&no_shipping=1&cn=Notes&tax=0&currency_code=USD&lc=US&bn=PP%2dDonationsBF&charset=UTF%2d8][img]http://www.paypal.com/en_US/i/btn/x-click-but04.gif[/img][/url]
(We'll love you forever if you donate! We need to eat too :))



[u][b]What is ULX?[/b][/u]
ULX is a powerful admin mod that is not only the oldest and most mature admin mod, it’s [i][u]the[/u][/i] oldest and most mature Gmod-specific lua release still in use. The first version of ULX was released [i]days[/i] 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!



[u][b]What's new in v3.60?[/b][/u]
Most of the work in this version went into getting ULX, XGUI, and ULib working for Garry's Mod 13. However, there still is quite a bit that we managed to sneak in there! Check out the full ULX and ULib changelog on [url=http://forums.ulyssesmod.net/index.php/topic,6005.0.html]our news post here[/url]. Here's a small snippet of a few of the main changes:
[quote]
ULib v2.50:
 * [ADD] Shows reasons to kicked person upon kick or ban (Thanks FPtje!).
 * [ADD] Operator to target only a specific group, ignoring inheritance ('#').
 * [ADD] Operator to target a specific id ('$').

ULX v3.60:
 * [ADD] "ulx jailtp" - A combination of tp <player> and jail <player> (Thanks HellFox).
 * [ADD] "ulx resettodefaults" - Resets ULX and ULib config to defaults.
 * [ADD] XGUI: Added ability to edit lower-level restrictions from a higher-level group.
 * [CHANGE] ULX ban now supports restricting of time/string formats.
 * [CHANGE] !teleport chat command is now also aliased as !tp.
 * [CHANGE] XGUI: Utilizes ULib's more robust ID Targeting system.
[/quote]



[u][b]Our Legacy: 8 Years of Team Ulysses![/b][/u]
Just about a month after [url=http://garrysmod.com/post/38726203586/were-8-today]Garry's Mod celebrated it's 8th birthday[/url], we at Team Ulysses celebrated 8 years since our (or rather, Megiddo's) first release. Megiddo has compiled a brief history of major events, [url=http://forums.ulyssesmod.net/index.php/topic,6005.0.html]which can also be seen on our latest news post[/url].
[quote]
 * December 24th, 2004 -- First ever Garry's Mod release.
 * January 23rd, 2005 -- "AI Mod" released by Megiddo for Garry's Mod version 5. This mod let you spawn NPCs with weapons in team configurations. It was driven entirely through echoes to the screen and number bindings.
 * January 31, 2005 -- v2 of "AI Mod" for Garry's Mod version 6, allowing for increasingly complex orders to the AI
 * February 25, 2005 -- v3 of "AI Mod", which was now called UGM (Ultimate Garry's mod Minimod). UGM tried to be a "all-in-one" pack to make Garry's Mod a much more enjoyable playing experience.
 * April 28, 2005 (date approximate) -- v4 of UGM. Became extremely complex at this point and so large with bundled models that it was difficult for us to find anyone willing to host it due to the high demand. Keep in mind that all of this was done using source commands and entity I/O, since Lua scripting was not implemented yet.
 * October 28, 2005 -- Garry's Mod v9 released. This was the first version that supported Lua scripting.
 * October 31, 2005 -- First ULX release (v0.5) for Garry's Mod version 9. Since we released so quickly after GM9, it was relatively bare bones. We drew heavily from AMXX for inspiration. The 'X' in ULysses X is a hat-tip to AMXX.
 * December 20, 2005 -- v1.0 of ULX released. Introduced reserved slots, admin action logging, forced downloads, targeting keywords, and others. Do these sound familiar? We know what our users want and stick with it.  :)
 * July 23, 2006 -- v2.0 of ULX released. This was the last major revision released for Garry's Mod v9.
 * November 29, 2006 -- Garry's Mod 10 released, the first for-pay version of Garry's Mod. Garry approached Lua addons in a completely different way, so all addons had to be recreated from the ground up.
 * January 1, 2007 -- v3.0 of ULX released for Garry's Mod 10.
 * May 13, 2011 -- First version of XGUI created by Stickly Man released with ULX v3.50.
 * <From 2011 till now> -- Most of our changes are simply keeping up with whatever Garry breaks in updates.  ;)
[/quote]


[h2]ULX Features:[/h2]
[u][b]Screenshots:[/b][/u]
<coming soon>



[u][b]Videos:[/b][/u]
<coming soon>



[u][b]Full Command List:[/b][/u]
[code]
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: 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 oftheir 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: 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 fireworks - Fire! In pretty displays! (say: !fireworks)
	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 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: 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)


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: Teleport
	o ulx bring <player> - Brings target to you. (say: !bring)
	o ulx goto <player> - Goto target. (say: !goto)
	o ulx send <player> <player> - Goto target. (say: !send)
	o ulx teleport [<player, defaults to self>] - Teleports target. (say: !tp)


Category: User Management
	o ulx addgroup <group> [<inherits from>] - Create a new group withoptional inheritance.
	o ulx adduser <player> <group> - Add a user to specified group.
	o ulx adduserid <SteamID, IP, or UniqueID> <group> - Add a user byID 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: Voting
	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)


-End of help
ULX version: 3.60
[/code]



[u][b]Features in ULX[/b][/u]
 * [i]Immense[/i] 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, 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”.
 * [b]Autocomplete[/b]. 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. You can also offer downloads to your model packs from here. See below for a picture of the default MOTD. You can also turn this off.
 * 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 adverts 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.
 * ULX supports gatekeeper and will use it if available.



[u][b]XGUI features:[/b][/u]
 * 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, 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.



[u][b]Our Community:[/b][/u]
 * The [url=forums.ulyssesmod.net]ulyssesmod.net forums[/url] currently have about 25,000 posts by 4000 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 [url=http://forums.ulyssesmod.net/index.php/board,30.0.html]read the FAQ[/url] for answers first!)
 * You can find a number of third-party plugins in our [url=http://forums.ulyssesmod.net/index.php/board,15.0.html]Releases Board[/url], 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 [url=https://github.com/Nayruden/Ulysses/issues]report to us[/url] 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.



[u][b]Some of our other works you'll want to know about (they work great with ULX!):[/b][/u]
 * [url=http://forums.ulyssesmod.net/index.php/topic,3363.0.html]UPS[/url] - Ulysses Prop Share. An extremely lightweight yet flexible prop protector.
 * [url=http://forums.ulyssesmod.net/index.php/topic,1080.0.html]UClip[/url] - A noclip alternative. Players can't noclip through the world or through other peoples' props.
 * [url=http://forums.ulyssesmod.net/index.php/topic,3039.0.html]UTime[/url] - Keep track of how long your players have been connected this session and total.
 * [url=http://forums.ulyssesmod.net/index.php/topic,922.0.html]Uppl[/url] - Restrict props on a per-model basis.
 * [url=http://forums.ulyssesmod.net/index.php/topic,921.0.html]UBan[/url] (requires ULX) - Ban players across multiple servers using a centralized database.
 * [url=http://forums.ulyssesmod.net/index.php/topic,3650.120.html]sui_scoreboard[/url] - Not technically one of our works, but this is one you just have to try out! Completely re-done scoreboard that just looks amazing.



[u][b]Help me! It's not working![/b][/u]
[i]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.[/i]
[i]You need to follow the directions for your problem [b]in order[/b]. Do not skip a step or you'll probably be ignored.[/i]


[b]ULX isn't running, it says ulx is an unknown command.[/b]
 * 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 [i]server[/i]. 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 [i]and only if[/i] your problem was due to something on our end, please report the bug to us [url=https://github.com/Nayruden/Ulysses/issues]here[/url]


[b]I'm having trouble adding myself or another as an admin.[/b]
 * The syntax for "ulx adduser" can be seen by typing "ulx adduser" and nothing else into the console, or you can read [url=http://forums.ulyssesmod.net/index.php/topic,732.0.html]here[/url]
 * If you still have questions read [url=http://forums.ulyssesmod.net/index.php/topic,383.0.html]this[/url]. 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.


[b]How do I unban someone?[/b]
Read [url=http://forums.ulyssesmod.net/index.php/topic,732.0.html]this[/url].


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