HTML Chat/Commands

From STNE Wiki

< HTML Chat
Revision as of 15:13, 6 January 2011 by Hcidem (Talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

STNE is a Strategy and Role Play Game. You can play here.

Contents | STNE | Colonies | Buildings | Goods | Items | NPC | Ships | Stellar Cartography | Research | Trade | Combat | Settler | Alliances | Index


Contents

General user commands

HTML Chat includes a number of useful commands which allow STNE players to customize their messages or improve their understanding of it's system status. These commands can be used on any HTML Chat channel on which a player has user access, including the primary game server channel.

Command Description
/reload [session] This command reloads the chat feature. The simple "/reload" command only reloads the connection, which can be helpful when chat begins to "hang". Adding "session" to the command reload the server session, which is useful after a player has changed his Character Name during the current session.
/scroll [on/off] This command temporarily deactivates automatic scrolling in the chat interface for the current channel. If "on/off" is not indicated, the current setting is simply reversed.
/say, /s Posts the text which follows this command, which begins with a slash (/) - This is the default command used when simply writing text in the input box.
/emote, /me Posts text in the "first-person" context.
/ignore-query This allows a player to ignores chat inquiries from a specific player. This must be used in the corresponding query channel (see Starting a new channel for "query").
/unignore-query This removes a player from your ignore list, and permits new queries from the player. This must be used in the corresponding query channel (see Starting a new channel for "query").
/list-roles Lists all assigned user rights on the channel.
/list-joins Lists all players actively subscribed to the channel.
/random, /roll [<maximum number>] This command does not relate directly to the chat feature. It returns a random number from 1-<maximum number> using a random number generator. If no <maximum number> is included, 6 is used.
/create-password [<long>] [upper/lower] This command does not relate directly to the chat feature. It generates random passwords with the indicated length and upper and lower case capability. The same algorithm is used as with "/random". The password is cleared from the server's console, and not buffered.
/calc <calculation> This command does not relate directly to the chat feature. It performs a mathematical computation (e.g. /calc round (3* (5/4+1) - 10) *-1). The following functions are available: abs, acos, asin, atan, ceil, cos, exp, floor, log, max, min, pow, random, round, sin, sqrt, tan
/ping This returns a simple “Pong!” which can be helpful to determine whether your chat feature is still connected to the server.
/help This is the default help command, which returns an URL reference to the German-language command reference page at http://game3.stne.net/Manual.aspx?pg=4&id=175.

The chat feature itself provides a linked command titled "Load older entries" at the beginning of each user's chat log display. This command loads older entries from the chat log while also deactivating automatic scrolling temporarily. Automatic scrolling is reactivated once the user posts a new entry to the channel.


Joining an existing channel

The game server's primary channel loads automatically for users who have not disabled chat in their Preferences screen. New chat "queries" from other players merely require a player's acceptance to begin the session. All other channels need to be actively joined. These commands allow players to join such channels.

Command Description
/join, /j <channel name> Subscribes the player to a specific channel until the player is actively removed from the channel (If the channel does not yet exist, see Starting a new channel.).
/join-group <alliance ID> Subscribes the player to an alliance channel. The player must be actively authorizated to join the channel before this command will work.
/part, /close, /c Removes the player from the current channel, and removes it from the chat interface.


Starting a new channel

Any player can begin a new channel for their own purposes. Naturally, such players must still comply with STNE rules, including the Chat Moderation Rules, while using the channel. These commands open new channels.

Command Description
/query, /q <player> This opens a private, one-to-one channel with another player. The channel remains open until it is manually closed by both parties.
/join, /j <channel name> If a channel does not yet exist, the "/join" command opens the channel, and assigns the user its "Operator" status (see user rights).
/reg-chan This registers a channel on the server. This must be done by a channel Operator.
/unreg-chan <channel name> Removes a channel from the server's registration. The channel is also deleted once this is used. The inclusion of the channel name protects owners from inadvertently deleting a channel. As long as all players have left the channel, it can later be registered anew by another player.

Setting channel characteristics

A characteristic is an attribute, a text entry, or a special value assigned to a particular chat channel. Each characteristic can be accessed using the following commands:

/<characteristic>
The current characteristic value is called up, and written to the channel.
/<characteristic> set <new value>
The characteristic is set to a particular value.
/<characteristic> set
The current characteristic is removed (set to "null" value).
/<characteristic> edit
This command writes "/<characteristic> set <current value>” to the channel for faster processing. The current value can then be edited either partially or in full.


The following characteristics are currently available on all channels:

Name of characteristic Description of purpose Mininum authority level required
chan-name Sets the channel name. Owner
chan-title Sets the color-enabled channel title (FONT, B, I, SMALL are permitted). SuperAdmin
chan-msg Sets the color-enabled channel message (which is displayed each time a connection is established). Operator
chan-desc Sets the color-enabled channel description (which is only displayed when a new user joins the channel, or with an explicit call command). Admin
chan-default-role Sets the default user rights for the channel (which player's receive if they have not been assigned specific rights). "Write"=normal channel, "Read"=moderator channel, "None"=private channel Owner
chan-owner Sets the channel owner with its associated rights. Owner


Setting player's access rights

Channel users can be assigned various access rights to the channel. These rights are determined by setting a player's "role" with the following command: /set-role <role> <player number>

The following roles (rights) are currently available on all channels:

Name of role Alias Description of rights
Owner founder, f The player has all available access rights on the channel.
SuperAdmin sa The player has access rights above "Admin".
Admin a The player has access rights above "Operator".
Operator op The player has access rights above "Write".
Write voice, w, v The player may both read and write channel messages.
Read devoice, r, d The player may only read channel messages.
None ban, b The player has no user rights on the channel.
Default reset User rights are returned to the channel's default level without including them in the list of assigned rights.


Special channel commands

These additional commands are helpful in managing HTML Chat channels.

Command Description
/group-role set <alliance ID> This provides access to the current channel for an alliance.
/group-role del <alliance ID> This removes channel access from an alliance.
/group-role list This lists all alliances with channel access. If the channel is an automatically-generated alliance channel, it's associated alliance will not be listed.
/kick <player> This removes a player from the channel.
/ban <player> This removes a player from the channel and removes it from the player's chat interface.
/unban <player> This removes a player's ban status.
/update-user <player> This is a moderator command which forces the chat server to obtain the newest player from the game server. It is useful to immediately activate a chat ban status. Otherwise, it takes 5-10 minutes until the ban becomes active.



Also See: