whiteshell

A repository for a shell with Whitehack RPG tools.

Clone the repository and softlink it in your quicklisp/local-projects directory. Then:

(ql:quickload :whiteshell)
(in-package :whiteshell)

Now you can use the functions in the REPL:

whiteshell-2023-05-12_19.57.07.mp4

In the above video, Whiteshell runs from an advanced SLIME repl in Emacs. That isn't necessary. You can just as well simply install sbcl (http://sbcl.org/) and quicklisp (https://www.quicklisp.org/beta/) and then use rlwrap to run Whiteshell comfortably in your regular shell:

rlwrap sbcl
; In sbcl:
(ql:quickload :whiteshell)
(in-package :whiteshell)
(whiteshell)

Alternatively, make a simple script to use via bash from the command line. For example:

1. Install sbcl somewhere (default /usr/local).
2. Put a tool file where you want it (like in your $HOME).
3. Make a bash-script like the below example:

#!/usr/local/bin/sbcl --script

(setf *random-state* (make-random-state t))
(load "/home/your-user/simple-maps.lisp")
(print-map)

Then make the script executable and run it:

chmod +x yourscript.lisp
./yourscript.lisp

In this case it will give you something like:

                                           ########                             
                                           #......#                  #######    
                                           #......##############     #.....#    
        ######      ########################...................#######.....#    
        #....#      #......................................................#    
        #....########.########################################.#########.###    
        #................................#         ###########.#####   #.#      
        #....########.##########.....#...#         #......##.......#   #.#      
        ###.##      #.......#  #.....#...#         #......##.......#####.####   
          #.#       #.......####.........######    #........................### 
######    #.#       #.........................#    #......##.......####.......# 
#....#    #.#    ####.......######.......####.#########.####.......####.......# 
#....######.######......#.....................................................# 
#............................#########..........#####...######.#.######.......# 
###.............................................#   #...######.#.#    ######### 
  ################......#############################............#              
                 #......................................###......#              
                 #......#############################............#              
                 #......#                           #######......#              
                 ########                                 ########   

A third alternative is to generate a stand-alone executable. Launch sbcl and do:

• (ql:quickload :whiteshell)
• (sb-ext:save-lisp-and-die #p"name-of-executable" :toplevel #'whiteshell:bot :executable t)

Once an executable has been generated, you can call it like so: ./name-of-executable whiteshell::command arg1 arg2 etc