; This file must be in UTF-8 charset. ; ; Fill free to add additional topics. ; Thanks to UTF-8 encoding you can add texts in any language. ; Period in topic text means empty line. ; [General] Help = /help - Show help topic. List = /list - Show player list. Dots = /dots - Show list of templates for /restart command. Frags = /frags - Show info about players' kills and deathes. Cargo = /cargo - Scan cargo bay of another player. Givecash = /givecash - transfer money across Sirius. Restart = /restart - Set character start conditions by template. Setrobot = /setrobot - Fun stuff. Make Trent look like robot. Setmonkey = /setmonkey - Fun stuff. Give monkey head to Trent. Settrent = /settrent - Fun stuff. Make Trent look like usual. Credits = /credits - Show info about FLShell authors. Setadmin = /setadmin - Grant/Revoke administrative rights to player. Kick = /kick - Kick player from the server. Ban = /ban - Ban player. Unban = /unban - Unban banned player. Jump = /jump - Bring user to another location in Sirius. Land = /land - Instant land on any base or planet. Getcash = /getcash - Add some amount to your cash. Fine = /fine - Fine player for violation. [Help] /help ----------------------------------------------------- Display help topic or command list if is omitted. [List] /list [pageNo] ----------------------------------------------------- Show players list along with their slot number, factions and ships. . Slot number can be used instead of player name in other FLShell commands. E.g. ##1 means player in slot number 1. [Dots] /dots ----------------------------------------------------- Show list of templates for /restart command [Frags] /frags [pageNo] ----------------------------------------------------- Show info about players' kills and deathes. [Cargo] /cargo ----------------------------------------------------- Scan cargo of another player if he is in freighter. [Givecash] /givecash ----------------------------------------------------- Instant transfer money to another player. Commission is 30%. Also you can transfer money to your offline character within same account. [Restart] /restart ----------------------------------------------------- Restart player with new start condition (faction, ship, location etc) using template. . List of templates can be shown by /dots command. . Example: /restart corsair [Setrobot] /setrobot ----------------------------------------------------- Fun stuff. Make Trent look like robot. To see effect run command in space then dock and enter to the bar [Setmonkey] /setmonkey ----------------------------------------------------- Fun stuff. Give monkey head to Trent. To see effect run command in space then dock and enter to the bar [Settrent] /settrent ----------------------------------------------------- Fun stuff. Make Trent look like usual. Revert changes made by /setrobot and /setmonkey commands. To see effect run command in space then dock and enter to the bar [Credits] /credits ----------------------------------------------------- Show info about FLShell authors. ; ; Admin commands ; -------------- ; NOTE: Help for admin commands will be shown only to admin players. ; [Setadmin] /setadmin [revoke] ----------------------------------------------------- Grant administrative rights to player. Administrative rights will be revoked if optional keyword "revoke" is specified. [Kick] /kick ----------------------------------------------------- Kick player from the server. [Ban] /ban ----------------------------------------------------- Ban player. Works also for offline players. [Unban] /unban ----------------------------------------------------- Unban banned player. [Fine] /fine ----------------------------------------------------- Fine player for . A message will be shown to player [Land] /land ----------------------------------------------------- Instant land on a base. Use with care (see FLShell.ini for details) Example: /land li01_01_base - land to Manhetten [Getcash] /getcash ----------------------------------------------------- Add to your cash. Amount can be negative to deduct from the cash. [Jump] /jump [player_name] ----------------------------------------------------- Bring user to another location in Sirius Locations are specified in [JumpLocations] section of FLShell.ini file. Optionally you can jump another player. F L H O O K ============= version: 1.5.5 ================================================================================ == INSTALLATION ================================================================ ================================================================================ FLHOOK ONLY WORKS WITH FLSERVER 1.1. USING IT WITH 1.0 WILL CRASH FLSERVER!!! copy the files from "bin" to your freelancer/exe directory and edit the FLHook.ini in order to suite your needs. there are 3 different ways to start flhook: 1) open dacomsrv.ini in "...\freelancer\exe" and append FLHook.dll to the [Libraries] section. flserver will load flhook whenever you start it. 2) execute FLHookStart.exe while flserver.exe is already running. this will inject FLHook into the running process. 3) execute FLHookStart.exe with "execute ..." as command line. this will start flserver.exe along with FLHook. the rest of the command line will be passed on to the server. FLHook console will be shown as soon as the loading-process has finished (note: the old patch is not needed anymore, use 1) instead) ================================================================================ == CONFIG ====================================================================== ================================================================================ take a look at the comments in FLHook.ini ================================================================================ == ADMIN-COMMANDS ============================================================== ================================================================================ commands can be executed by administrators in several ways: - using the FLHook console(-> access to all commands) - ingame by typing .command in the chat(e.g. .getcash Player1) this will only work when you own the appropriate rights which may be set via the setadmin command. FLHook will store the rights of each player in his account-directory in flhookadmin.ini. - via a socket connection in raw text mode(e.g. with putty) connect to the port given in the FLHook.ini and enter "PASS password". after having successfuly logged in you may enter all of the commands you want(as long as you have the neccessary rights). you may have several socket connections at the same time. exiting the connection may be done by entering "quit" or simply by closing it. - CASH - all cash functions work no matter if the player is currently logged in or not getcash shows current account balance of setcash sets current account balance of to setcashsec sets current account balance of to , only works when his old account balance is addcash adds to the current account balance of addcashsec adds to the current account balance of , only works when his old account balance is - KICK/BAN - kick disconnects . the user will be displayed , if it is specified. ban bans 's account stays connected if he's currently on the server unban unbans 's account kickban kicks and bans (2 in 1, same as kick , ban ) - MSG - msg private message to (shown as "Console: ") msgs send to all players in (shown as "Console: ") must be the either the system-id or the shortname (like Li01) msgu message to the whole universe (shown as "Console: ") fmsg private message to (see XMLTEXT section for further details) fmsgs send to all players in (see XMLTEXT section for further details) fmsgu message to the whole universe (see XMLTEXT section for further details) - BEAM/KILL - beam force to land on (player must be in space) must be either the shortname(like Li01_01_Base for manhatten) or a shortcut defined in the FLHook.ini note: see the issues section below kill kills - REPUTATION - resetrep sets 's reputations to the one specified in "mpnewcharacter.fl" setrep set 's reputation for to . sohuld be between -1 and 1. example: "setrep playerxy li_n_grp 0.7" -> set playerxy's reputation for liberty navy to 0.7 - CARGO - cargo commands only work when the targeted player is ingame enumcargo lists 's cargo, first reply will be the remaining hold size addcargo adds numbers of (shortname like co_gun01_mark02,commodity_silver,etc OR hash) to 's cargo if is set to 1, the cargo is declared as mission cargo note: see issues removecargo removes numbers of (this must be the value from enumcargo's "id=" reply) from - CHARACTERS - rename rename to (player will be kicked if he's logged in 's account) deletechar delete (player will be kicked if he's logged in 's account) readcharfile reads 's userfile(xxx.fl) and prints it(each line will be preceded by "l ") writecharfile writes into 's userfile(xxx.fl). existing charfile will be overwritten. you should be careful with this one because a corrupted charfile may lead to server crashes and flhook does not do any syntax checks on . NOTE: YOU MUST REPLACE LINE-WRAPS WITH \n(TEXT) example: writecharfile playerxy [Player]\ndescription = 00300034002f0031003\n\n ... etc. - SETTINGS - setadmin set as ingame-admin with (affects all characters on the account) (see RIGHTS section below) getadmin show 's rights deladmin revoke 's ingame-admin-status rehash reload the flhook.ini in order to activate changed settings, this works for everything except the socket-settings unload unload flhook(flserver will keep on running flawlessly) this is very useful since it allows you to install a new flhook version on-the-fly. simply unload, replace the files and execute FLHookStart.exe the command will kick players with an active moneyfixlist(don't bother). - OTHER - getgroupmembers returns all players which are in a group with getbasestatus returns the hull status of a base. when the base hasn't been created in space yet it returns 0. getclientid gets 's client id getplayerinfo get 's info xgetplayerinfo same as getplayerinfo, except that result is shown in a more readable format getplayers get player info for all players on the server (players in charselect menu will not be shown) xgetplayers same as getplayers, except that result is shown in a more readable format getplayerids shows all players on the server with their client-id in a short format(useful when ingame) getaccountdirname get account-dirname of getcharfilename get char-filename of savechar save 's current info to disk isloggedin check if is logged in on the server isonserver check if is connected(this includes idleness in charselect menu) to the server NOTE: isonserver will also return true, when another char on the same account is logged in! serverinfo shows server load, whether npc spawn is currently enabled or disabled(see ini) and uptime. the format for the uptime is: days:hours:minutes:seconds moneyfixlist show players with active money-fix help get a list of all commands - MISC INFOS - you can use client-ids instead of by appending $ to the cmd. examples: getcash$ 12 kickban$ 1 etc. you can also use "shortcuts" instead of the whole character-name for a currently logged in player by appending & to the cmd. FLHook traverses all logged in players and checks if their character-name contains (case insensitive) and if so, the command will operate on this player. an error will be shown if the searchstring given in is ambiguous. examples (let's assume there are 2 players logged in: "superhax0r" and "..::[]SUPERNERD[]::.."): "kick& nerd" kicks "..::[]SUPERNERD[]::.." because his nick contains "nerd" "getcash& super" fails because there are multiple character names containing "super" all commands return "OK" when successful or "ERR " when error occured ================================================================================ == RIGHTS ====================================================================== ================================================================================ rights may be seperated by a comma (e.g. setadmin playerxy cash,kickban,msg) superadmin -> everything cash -> cash commands kickban -> kick/ban commands beam -> beam/kill/resetrep/setrep command msg -> msg commands savechar -> savechar command cargo -> cargo commands chars -> rename/deletechar/readcharfile/writecharfile eventmode -> eventmode (only when connected via socket) all other commands except setadmin/getadmin/deladmin may be executed by all admins ================================================================================ == XMLTEXT ===================================================================== ================================================================================ the fmsg* commands allow you to format text in several ways(like in the exe\misctext.dll) text is enclosed in tags while the format can be changed with nodes-names must be written in capital chars! be sure to replace the following characters within a text-node: < -> < > -> > & -> & - NODE SYNTAX - the data field of a TRA node consists of an RGB value along with format specifications: BB is the blue value GG is the green value RR is the red value FF is the format value (all in hexadecimal representation) format flags are: bin hex dec effect 00000001 1 1 bold 00000010 2 2 italic 00000100 4 4 underline 00001000 8 8 big 00010000 10 16 big&wide 00100000 20 32 very big 01000000 40 64 smoothest? 10000000 80 128 smoother? 10010000 90 144 small simply add the flags to combine them (e.g. 7 = bold/italic/underline) examples: fmsgu A player has died: Player this is similar to the standard die-msg(which is shown in bold) fmsgu Hello World this will show "Hello World" ("Hello" will be blue/bold/italic and "World" green/big) ================================================================================ == EVENTMODE =================================================================== ================================================================================ socket connections may be set to eventmode by entering "eventmode". from then on you will receive several event-notifications listed below. once activated, eventmode runs until you close the connection. - NOTIFICATIONS - chat from= id= type= [to= idto=] text= : charname sending the message : client-id of sender : either universe,system or player /: only sent when type=player : guess ... kill victim= type= [by=] : charname of the victim : selfkill,player,npc,suicide : charname of the killer login char= accountdirname= id= ip= occurs when player selects a character in the character-select menu launch char= id= base= system= occurs when player undocks from a base/planet baseenter char= id= base= system= occurs when player enters base baseexit char= id= base= system= occurs when player exits base(includes disconnect/f1) jumpin char= id= system= occurs when player jumps in a system switchout char= id= system= occurs when player switches out a system spawn char= id= system= occurs when player selects a character and launches in space connect id= ip= occurs when player connects to the server disconnect char= id= occurs when player disonnects from the server ================================================================================ == USER-COMMANDS =============================================================== ================================================================================ user commands may be entered ingame by every player in chat and can be enabled or disabled in the ini. enter them ingame to get a description. /set diemsg xxx while xxx must be one of the following values: - all = all deaths will be displayed - system = only display deaths occuring in the system you are currently in - self = only display deaths the player is involved in(either as victim or killer) - none = don't show any death-messages settings keep saved in flhookuser.ini and affect all characters on the account /set diemsgsize - change the size of the diemsgs /set chatfont