Command syntax

One of Shine's design goals is to be easy to use. Thus I've created an easy to use targeting system that lets you fine tune exactly who you want to target. This command syntax applies to both console commands and chat commands in the same way.

Player names are always completed, you do not need to type the full name. However, Shine checks game IDs first, then NS2/Steam IDs and finally checks the name. Remember to be careful with names that only contain numbers, use their game ID instead of their name to target them otherwise you may end up targeting someone else instead.

Note

Not all commands support multiple player targets. See the plugin pages for whether a command takes a single player or multiple players as arguments.

Targeting yourself

If you have a strange name or part (or all) of it is shared with another player, it can often be annoying to try and apply a command to yourself. Shine allows you to target yourself with ^.

For example,

sh_forcerandom ^

would put you on a random team.

Teams

For commands that require you to specify a team, just use 'alien' or 'marine' or any variation of them (as long as it's a single word). Shine will sort out the team number stuff for you so you don't have to know that Aliens are team 2 and Marines are team 1.

For example,

sh_setteam bob alien

would move bob over to the alien team.

Selecting multiple players

For some commands, you can pass multiple players to the command and Shine will apply the action to all of them at once. For instance, if you type comma separated names or Steam IDs, Shine will attempt to find each player you give and for any it finds, will apply the command.

For example,

sh_rr bob,joe,123456,^

would move bob, joe, the player with Steam ID 123456 and yourself to the ready room.

Selecting entire teams

It doesn't stop at multiple player names though. Shine lets you target an entire team at once with @alien or @marine. You can also select all ready room players with @readyroom and all spectators with @spectate.

For example,

sh_forcerandom @readyroom

will force everyone in the ready room to a random team.

Selecting entire user groups

You can select everyone in a certain user group with %groupname. To select all those who aren't in a set user group, use %guest.

For example,

sh_forcerandom %guest

will force every user without a set user group onto a random team.

Selecting multiple teams

You can even select multiple teams. As with selecting multiple individuals, just separate the values with commas.

For example,

sh_forcerandom @readyroom,@spectate

will force everyone in the ready room and everyone in spectate onto a random team.

Selecting everyone

Finally, if you really want to, you can select the entire server population at once. This is done with *.

For example,

sh_forcerandom *

will force everyone on the server into a random team.

Negating a target

If you wish to select all players except a given player/group, or you wish to trim a target group down, you can add '!' before your target directive. This will remove the given target from the target list. For example,

sh_forcerandom !^

will force everyone except you onto a random team. You could also do something like:

sh_rr @alien,!^

which would force the entire alien team except yourself into the ready room.