You can now kiss the frog!
[mudsync.git] / README.org
index 42154c19bce68d98b6c70218cac3285fd3751de7..61a414a6eee0623df403304c8a43ec62b9e20060 100644 (file)
@@ -9,22 +9,23 @@ we're getting ahead of ourselves.
 
 ** Installing Mudsync
 
-First of all, you need 8sync from git master (or 8sync 0.2.0, which
-isn't out yet).  Yikes!  That's pretty new.  Luckily, you can get a
-tarball here:
+First of all, you need 8sync (currently 0.4.2, or git master) and
+Guile 2.2.  Install those.
 
-  http://dustycloud.org/misc/8sync-0.2.0-pre.tar.gz
+... Or, if you have Guix, you can set up a "guix environment" which
+should have everything you need all set to go:
 
-Do the usual "./configure && make && sudo make install" there.
+  guix environment -l guix.scm   # optionally add --pure
 
 Next, in mudsync's directory:
 
-  source pre-install-env
+  source pre-inst-env
   guile -l worlds/bricabrac.scm -e run-game
 
-You can then connect:
+You can then connect in your browser:
+
+  http://localhost:8888
 
-  telnet 127.0.0.1 8889
 
 ** Playing
 
@@ -36,15 +37,20 @@ to get started.
 ** Hacking
 
 When you start up the bricabrac demo, it'll by default start up a
-port you can connect over localhost to if you're using emacs + geiser.
+socket you can connect to with emacs + geiser like:
+
+: M-x geiser-connect-local <RET>
+:   guile <RET>
+:   /tmp/8sync-socket <RET>
+
 Then you can live hack away!
 
 If you change something in bricabrac (or whatever) and want to update
 the object you changed, you can "live" put in the new and updated
 version from the game-spec at the REPL with:
 
-  (insert! game-spec 'room:lobby)  ; to replace the lobby, but of course
-                                   ; do what's appropriate for your
-                                   ; object
+  (inject-gameobj! (game-spec) 'room:lobby)  ; to replace the lobby, but of course
+                                             ; do what's appropriate for your
+                                             ; object
 
 That's it for now!