Interim Blinkenlights Live Coordination Server Protocol, version 1
Uses port 20223
Client connects to server. All commands, unless prefixed with a **, are in client then server order.
S: ! S=LCSd1 P=LCSP-1-FULL - can also be ! S=LCSd1 P=LCSP-1-FULL
S: ! MOTD Welcome to Blinkenlights Live Coordinations Server. This server is only to be used by parties authorized by the owner. If you are not authorized to connect, please disconnect now.
C: AUTHCHK <password>
S: AUTHACC / AUTHDENY depending on password match
-- end authentication phase --
C: BOTMAST
C: BOTLIST ITTY BITTY BABY (sending configuration)
S: BOTLIST I DON'T BELIEVE IT (okay, go ahead)
C: BOTUSR <name>
C: BOTLIST HABEEB IT (finished)
S: BOTLIST TWINKIE HOUSE (okay)
S: LCSCONF CHARGIN (IMA SENDIN MY CONFIGURATION)
C: CONFRECV LAZER (k)
S: LCSCONF BEGIN
S: LCSCOPT SADMIN <server administrator>
S: LCSCOPT SINAM <server name>
S: LCSCOPT SIRCH <#channel>
S: LCSCOPT SIRCN <bot nickname for IRC>
C: CONFRECV OK
S: LCSLINK FIN
C: LCSLINK FIN
-- end linking procedure --
Every three minutes, the server will poll the client by sending:
LCSLNK AYT
If the client does not respond within sixty seconds, the LCS server will automatically remove it.
It is recommended that, if you are able to, you run the mIRC LCS rather than the RB LCS.
Server to Client commands
LCSMESG <message>
Allows a communications message to be pushed to all current clients.
LCSPULL (BLIST/BSTAT/CACT/CLOC)
Sends a pull request to one or all clients for the following:
- Bot list refresh (and/or manual list retrieval)
- Bot statistics (number connected, socket status, etc.)
- Current action (dreamflood, idling, spinning, etc.)
- Current location (vinca, AI, public/private dream, etc.)
LCSPUSH (BLIST/BSTAT) (Not supported in RB LCS)
Pushes the following data to the client - only useful with DTS/bot transferring
- Additional bots
- Bot statistics for remote bots
LCSLOCK (RINPT, RALLF, RCOMM, RMOVE)
Orders a client or all to disable the following, usually to have a group raid:
- Remote input (FDL dream text boxes, spam text set, etc.)
- All remote functions (excluding disconnection from LCS, and bot disconnection)
- Communications functions (Mass whispering, messaging, inbound whispers)
- Movement functions (1/3/7/9, facing, dream switches)
- Disables FDL dream boxes
LCSUNLK (RINPT, RALLF, RCOMM, RMOVE)
Allows a client to unlock itself after finishing and/or in the middle of a group raid:
- Remote input (FDL dream text boxes, spam text set, etc.)
- All remote functions (excluding disconnection from LCS, and bot disconnection)
- Communications functions (Mass whispering, messaging, inbound whispers)
- Movement functions (1/3/7/9, facing, dream switches)
LCSCONF
Orders a client or all to redownload LCS configuration and/or download it for the first time from the specified URL
LCSBOOT <reason>
Orders a client or all to disconnect from the LCS, displaying the reason as a message.
LCSSOCK (CYCLE, DISCO, SOCKD, SOCKR)
Orders a client or all to do the following connection maintenance actions:
- Cycle all sockets
- Disconnect all sockets
- Selective socket disconnect (followed by socket name)
- Sock reconnect (followed by socket name)
LCSGRNT (BLKUP, ASSGN)
Tells the client:
- /b/lackup request accepted
- Bot assignation request accepted, prompts client to turn on DTS (Not supported in REALbasic LCS)
-- client to server commands --
BLACKUP <current dream URL>
Request full /b/lackup at current dream, sent as message to LCS administrator for review.
LCCMESG <message>
Sends message to LCS administrator.
LCCDISC <message>
Tells server the client is disconnecting, with appropriate message, seen only in log panel by LCS admin.
LCCCONF
Requests an updated configuration. LCS replies with LCSCONF.
LCCMFWD <url>
Sends a URL as a message to the LCS administrator. Meant to be used as showing updates to threads on forums.
LCCILOC (<dreamurl>/<action>)
Sends the current Dream URL and/or action (spinning, etc.) to LCS for statistics.
LCCDTSD
Used for Direct Transfer Support with bots, used to relay movement, DreamURL information, etc to LCS
LCCBSTA (CONN <sockname>/ALLCONN)
Sends current bot status to the server for LCS statistics and remote operations.
LCCSUPT
Requests help from LCS owner in using Blinkenlights.
LCCREPT
Requests current status report. Normally sent transparently as a message if the LCS administrator logs updates.
LCCREQT
Request assignation of more bots for independent missions without sending all 60/80/100 etc.
-- bot transfer protocol --
S: LCSGRNT ASSGN <# of bots in increments of 5>
** LCSPUSH BLIST
C: BOTLIST RECV RDY
S: BOT<#> <name>
** BOTLIST FINISH
C: BOTLIST RECV OK
** LCSDTSD ON
S: LCSDTSD OK
Client and server continue DTS until bots are revoked.
S: LCSGRNT UNASS
** LCSPUSH RLIST
C: REVLIST RECV RDY
S: RBOT<#> <name>
** REVLIST FINISH
C: REVLIST RECV OK
** LCSDTSD OFF
S: LCSDTSD OK
Client and server discontinue DTS traffic.