made inter-BBS mode optional

added exit graphic
included detailed installation instructions
update lobby graphic to fit BBS name

xtrn/uberblox/blox.js

@@ -19,7 +19,8 @@ load("funclib.js");
 load("commclient.js");
  
 var oldpass=console.ctrl_key_passthru;
-var stream=new ServiceConnection("uberblox"); 
+var interbbs=argv[0];
+var stream=interbbs?new ServiceConnection("uberblox"):false;
 
 function blox()
 {
@@ -65,7 +66,7 @@ function blox()
 				{
 					case "\x1b":	
 					case "Q":
-						splashExit();
+						return;
 					case "I":
 						showInstructions();
 						drawLobby();
@@ -169,7 +170,6 @@ function blox()
 		console.ctrlkey_passthru="+ACGKLOPQRTUVWXYZ_";
 		bbs.sys_status|=SS_MOFF;
 		bbs.sys_status|=SS_PAUSEOFF;
-		getFiles("players.ini");
 		console.clear();
 	}
 	function splashExit()
@@ -177,13 +177,28 @@ function blox()
 		console.ctrlkey_passthru=oldpass;
 		bbs.sys_status&=~SS_MOFF;
 		bbs.sys_status&=~SS_PAUSEOFF;
-		players.StorePlayer();
-		sendFiles("players.ini");
+		players.storePlayer();
+		if(interbbs) sendFiles("players.ini");
 		console.clear(ANSI_NORMAL);
-		exit(0);
+		var splash_filename=gameroot + "exit.bin";
+		if(!file_exists(splash_filename)) exit();
+		
+		var splash_size=file_size(splash_filename);
+		splash_size/=2;		
+		splash_size/=80;	
+		var splash=new Graphic(80,splash_size);
+		splash.load(splash_filename);
+		splash.draw();
+		
+		console.gotoxy(1,23);
+		console.center("\1n\1c[\1hPress any key to continue\1n\1c]");
+		while(console.inkey(K_NOECHO|K_NOSPIN)==="");
+		console.clear(ANSI_NORMAL);
+		exit();
 	}
 	function init()
 	{
+		if(interbbs) getFiles("players.ini");
 		logo=new Graphic(18,22);
 		logo.load(gameroot + "blox.bin");
 		lobby=new Graphic(80,23);
@@ -396,7 +411,7 @@ function blox()
 		}
 		current.tiles-=selection.length;
 		if(current.tiles<0) current.tiles=0;
-		points+=CalculatePoints();
+		points+=calculatePoints();
 		selection=[];
 		unselect();
 		showTiles();
@@ -419,7 +434,7 @@ function blox()
 	function showSelection()
 	{
 		console.gotoxy(63,15);
-		console.putmsg(printPadded("\1w\1h" + CalculatePoints(),15));
+		console.putmsg(printPadded("\1w\1h" + calculatePoints(),15));
 	}
 	function showLevel()
 	{
@@ -431,7 +446,7 @@ function blox()
 		console.gotoxy(63,21);
 		console.putmsg(printPadded("\1w\1h" + current.tiles,15));
 	}
-	function CalculatePoints()
+	function calculatePoints()
 	{
 		if(selection.length)
 		{

xtrn/uberblox/exit.bin

+                                                                                                                               
+                                                   THE BROKEN BUBBLE BBS      T
+H
+A
+N
+K
+S
+ 
+F
+O
+R
+ 
+P
+L
+A
+Y
+I
+N
+G
+!
+                                         o
      .
                                                       o
    o
 .
           
   o
  .  If you enjoyed playing this game, please      .  
     o
            feel free to try out the other originals,         .   .
   . o
  and if you have your own BBS, please consider .
    ;;3         setting them up for your users.                     ;; 33 3333333;                                                      .
  ; ;33333333;  
   All javascript games by Matt Johnson are           3333    free and available for download from the       
  >333333;;;? o
     Synchronet CVS repository at:                     . ; ; ; ;3;;;;     .
                                                     ; ;3;;;;;   .
    h
+t
+t
+p
+:
+/
+/
+c
+v
+s
+.
+s
+y
+n
+c
+h
+r
+o
+.
+n
+e
+t
+/
+                       
  o
    ; ; ; ;;;;;;;?       o
                                                .   o
;;;;;;? 
 .
  .     -or-                                                          
                                                   
               o
   
   .
  h
+t
+t
+p
+:
+/
+/
+w
+w
+w
+.
+t
+h
+e
+b
+r
+o
+k
+e
+n
+b
+u
+b
+b
+l
+e
+.
+c
+o
+m
+:
+8
+0
+0
+0
+/
+           .
    .  o
    o
       
                                                      http://www.thebrokenbubble.com                                               
\ No newline at end of file

xtrn/uberblox/interbbs.doc

+*****UPDATING YOUR LOCAL LIBRARIES******
+
+Before you attempt to install the inter-BBS service, it is recommended that you
+update your relative 'EXEC/' and 'EXEC/LOAD/' paths (typically '/SBBS/EXEC' and '/SBBS/EXEC/LOAD')
+with the latest files from the Synchronet CVS repository at:
+	
+	http://cvs.synchro.net/cgi-bin/viewcvs.cgi/
+	
+	RECOMMENDED UPDATES:
+	
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/exec/load/funclib.js
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/exec/load/calendar.js
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/exec/load/timer.js
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/exec/load/clock.js
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/exec/load/msgwndw.js
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/exec/load/scrollbar.js
+		
+	NOTE:	Replace any outdated local copies with the latest release from the links.
+
+*****SETTING UP INTER-BBS SERVICE WITH SYNCHRONET*****
+
+The inter-BBS features of this program require that the appropriate services be configured, 
+and that all of your files are up to date. The following files are needed to operate 
+this program in inter-BBS mode, and can be downloaded from the Synchronet CVS repository at:
+
+	http://cvs.synchro.net/cgi-bin/viewcvs.cgi/
+
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/exec/commservice.js
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/exec/load/commclient.js
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/exec/load/chateng.js
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/exec/load/filesync.js
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/ctrl/filesync.ini
+	
+	NOTE: 	Placing these files in their corresponding local equivalent locations
+			will make configuration much easier.
+
+[COMMSERVICE.JS]
+
+	This is a static service that must be included in /ctrl/services.ini in order to 
+	accept connections and relay information to and from the main hub. It is critical
+	for this to be set up properly, for the programs that depend on it will not function
+	properly without it.
+
+	This file must be placed in your relative 'EXEC/' or 'MODS/' path (typically '/SBBS/EXEC/').
+	Once the file is in place, you must add the following to your 'CTRL/SERVICES.INI' file:
+
+		[Commserv]
+		Port=10088
+		MaxClients=20
+		Options=STATIC
+		Command=commservice.js thebrokenbubble.com 10088
+
+	NOTE:	there are two arguments on the command line that tell the service the address and 
+			port of the main hub, which by default is the Broken Bubble BBS, on port 10088. If
+			you wish to act as your own hub (e.g. start your own league), simple remove both
+			arguments from the command line, and direct league nodes to add your URL and port
+			to their SERVICES.INI file. If your system operates on multiple machines and you wish 
+			to share data between local nodes ONLY, setting up this service as a hub makes
+			this possible as well.
+
+	NOTE:	You should also double check to make sure that your services are running
+
+[COMMCLIENT.JS]
+
+	This is the dedicated client that connects to the inter-BBS service. This file handles
+	the transmission of data to and from the service, as well as managing file synchronization
+	for the client (this program). This file is critical for the successful operation of this program 
+	in inter-BBS mode.
+	
+	The file must be placed in your relative 'EXEC/LOAD/' or 'MODS/LOAD/' path (typically '/SBBS/EXEC/LOAD/').
+	There is no further setup required for this to work (unless you changed the default 'Port' setting for the service 
+	in SERVICES.INI). 
+
+[CHATENG.JS]
+
+	This handles all inbound/outbound chat messages, and packages them for delivery via the client and service.
+	this also contains the necessary objects to implement a chat room (windowed or fullscreen). 
+	
+	NOTE:	while this particular program may not have chat features, the service itself still may
+			require this file to be present.
+	
+[FILESYNC.JS]
+
+	This works in conjunction with the service, handling file synchronization requests from clients
+	and routing them, if necessary, to the main hub. File synchronization for inter-BBS programs will not
+	function if this file is missing.
+	
+	The file must be placed in your relative 'EXEC/LOAD/' or 'MODS/LOAD/' path (typically '/SBBS/EXEC/LOAD/').
+	There is no further setup required for this to work.
+	
+[FILESYNC.INI]
+
+	This file tells FILESYNC.JS and COMMCLIENT.JS where to store/retrieve inbound/outbound transfers
+	coming from the client and the service. 
+	
+	This file is critical for the service to operate properly. If you have installed the programs that 
+	use this service to their default locations, no additional configuration should be required.
+	
+Please report any bugs, issues or questions to: mcmlxxix at bbs dot thebrokenbubble dot com
+	

xtrn/uberblox/lobby.bin

-                                   Player Name         High Score  Last On                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     OPTIONS:            All-Time High Score:               [P] Play Game                                                                [I] Instructions                                       [R] Refresh Screen                                                           [Q] Quit Game                                                                           
\ No newline at end of file
+              Player          System Name              Top Score  Last On                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           GAME MENU:                                All-Time High Score:    [P] Play Game                                                   M
a
t
t
  [I] Instructions                                                J
o
h
n
s
o
n
  [R] Refresh Screen                                              2
0
0
9
  [Q] Quit Game                                                                 
\ No newline at end of file

xtrn/uberblox/sysop.doc

-Configuration in Synchronet:
+Sample configuration in Synchronet (SBBSCFG.EXE):
 
-[Uber Blox]
- 1: Name                       Uber Blox
+[Bubble Boggle]
+ 1: Name                       Uber Blox!
  2: Internal Code              UBERBLOX
  3: Start-up Directory         
- 4: Command Line               *../xtrn/uberblox/blox.js
+ 4: Command Line               *../xtrn/uberblox/blox.js INTERBBS <SEE INTERBBS.DOC>
  5: Clean-up Command Line      
  6: Execution Cost             None
  7: Access Requirements        
@@ -19,3 +19,56 @@ Configuration in Synchronet:
 16: BBS Drop File Type         None
 17: Place Drop File In         Node Directory
 18: Time Options...
+	
+NOTE:	The command line contains an OPTIONAL argument 'INTERBBS'
+		specifying whether the game is to operate in local
+		or inter-BBS mode. To operate local only, remove the 
+		argument from the command line, otherwise it will attempt
+		to use the inter-BBS service, as described in INTERBBS.DOC.
+		
+NOTE:	It is recommended that you check frequently for updates 
+		from the Synchronet CVS repository located at:
+		
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/xtrn/uberblox/
+		
+		LINKS:
+		
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/xtrn/uberblox/blox.js
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/xtrn/uberblox/blox.bin
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/xtrn/uberblox/exit.bin
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/xtrn/uberblox/lobby.bin
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/xtrn/uberblox/sysop.doc
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/xtrn/uberblox/help.doc
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/xtrn/uberblox/interbbs.doc
+		
+		Replace any outdated local copies with the latest releases from these links.
+		(by default, these files are to be located in your 'XTRN/UBERBLOX/' path)
+	
+*****UPDATING YOUR LOCAL LIBRARIES******
+
+Before you attempt to install the inter-BBS service, it is recommended that you
+update your relative 'EXEC/' and 'EXEC/LOAD/' paths (typically '/SBBS/EXEC' and '/SBBS/EXEC/LOAD')
+with the latest files from the Synchronet CVS repository at:
+	
+	http://cvs.synchro.net/cgi-bin/viewcvs.cgi/exec/load/
+	
+	RECOMMENDED UPDATES:
+	
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/exec/load/funclib.js
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/exec/load/calendar.js
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/exec/load/timer.js
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/exec/load/clock.js
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/exec/load/msgwndw.js
+		http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/exec/load/scrollbar.js
+		
+	NOTE:	Replace any outdated local copies with the latest releases from these links.
+
+Please report any bugs, issues or questions to: mcmlxxix at bbs dot thebrokenbubble dot com
+
+
+
+
+
+
+
+