Added alternative music plus build instructions.

Author: Feneric

README.rst

@@ -17,6 +17,9 @@ effects, and music that should help one recollect those classics. More important
 it is a fully playable (and winnable) game with its own backstory, plot, setting, and
 characters.
 
+You can play it online on the `Minima at Lexaloffle page`_ or play it directly through
+any PICO-8 environment by using the `splore` utility.
+
 .. image:: MinimaWorld.png
   :alt: Minima world view
   :align: center
@@ -123,6 +126,22 @@ remove pits in dungeons. I've had to remove findable chests in dungeons. I've ha
 remove the tower key. All of these were in order to keep within the space constraints
 we've got.
 
+Building Minima
+---------------
+
+Normally PICO-8 applications are written in a special dialect of Lua and are immediately
+interpreted within the PICO-8 environment without any special build steps. Minima is a
+little larger and more complicated than most PICO-8 applications, and it is too large to
+run directly without a special minimization step. The `picotool`_ utility does most of
+what's needed, but at the moment unless this `special branch of picotool`_ is run with the
+`luamin2` argument, it'll break Minima.
+
+You can also substitute in triplefox's version of the music. It's less like the original
+Commodore versions of the Ultima games but does a better job of making the most of what
+is available within the PICO-8 environment. It's in the `alt_music.p8` file. To use it,
+just copy over the existing `__sfx__` and `__music__` sections in `minima.p8` with the
+corresponding versions found in `alt_music.p8`.
+
 Other Notes
 -----------
 
@@ -151,6 +170,7 @@ The additional `Lua`_ utility script `convert.lua` is used to make it easier to
 a dungeon map and turn it into something the game can use.
 
 
+.. _Minima at Lexaloffle page: https://www.lexaloffle.com/bbs/?tid=31831
 .. _Ultima games: https://en.wikipedia.org/wiki/Ultima_(series)
 .. _Ultima I: https://en.wikipedia.org/wiki/Ultima_I:_The_First_Age_of_Darkness
 .. _Ultima II: https://en.wikipedia.org/wiki/Ultima_II:_The_Revenge_of_the_Enchantress
@@ -165,4 +185,6 @@ a dungeon map and turn it into something the game can use.
 .. _PocketC.H.I.P.: https://en.wikipedia.org/wiki/CHIP_(computer)#Pocket_CHIP_and_Pockulus
 .. _xu4: http://xu4.sourceforge.net/
 .. _PocketInstaller: https://github.com/Feneric/PocketInstaller
+.. _picotool: https://github.com/dansanderson/picotool
+.. _special branch of picotool: https://github.com/Feneric/picotool
 .. _Lua: https://www.lua.org/docs.html

alt_music.p8

@@ -0,0 +1,99 @@
+-- alternative music tracks for minima by triplefox
+
+__sfx__
+000100002365024650206501e64000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+00010000245202a6403075034660367703667034770326602f6602d75029650297502a640296402b7402c6502e6502f7502f6502d640296302563022720000000000000000000000000000000000000000000000
+0001000017070160601505016050170501a06021060290702f0700000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+00020000276432f4732f4732f4732f4732f4732f4733b1733b2733b2733b2733b2733b2733b2733b2733b2733b2733b2333851500000000000000000000000000000000000000000000000000000000000000000
+0002000002643024730347305473074730a4730d47311173162731b2731f27324273292732d27331273362733b2733e2333f51500000000000000000000000000000000000000000000000000000000000000000
+001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+012000000742407422074220742502424024220242202425074240742207422074250242402422024220242507424074220742207425024240242202422024250742407422074220742502424024220242202425
+0120000007424074220742207425024240242202422024250742407422074220742502424024220e4240e42207424074220e4240e42202424024220e4240e42207424074220e4240e42202424024220e4240e422
+0120000007420074200e4200e42002420024200e4200e42007420074200e4200e4200242002420024200242007420074200e4200e42002420024200e4200e42007420074200e4200e42002420024200e4200e420
+0120000007420074200e4200e42002420024200e4200e42007420074200e4200e4200242002420024200242007420074200742007420024200242002420024200742007420074200742002420024200242002420
+0120000007420074200742007420024200242002420024200742007420074200742002420024200242002420074200742007420074200242002420024200242007420094200a4200c4200e4200e4200e4200e420
+012000000c4200c4200c4200c420054200542005420054200a4200c4200e4200f42011420114201242012420134201342013420134200c4200c4200c4200c4200e4200a420094200742009420074200942007420
+0120000007420074200e4200e42002420024200e4200e42007420074200e4200e42002420024200e4200e42007420074200e4200e42002420024200e4200e42007420074200e4200e42002420024200242002420
+01200000004200042005420054200a4200a4200b4200b4200c4200e42010420124201342013420114201142014420144201442014420154201442012420104201242012420124201242014420144201a4201a420
+01200000194201542010420154200d4200d4200d4200d420184201542010420154200c4200c4200c4200c42017420134200e420134200b4200b4200b4200b42016420134200e420134200a4200a4200c4200c420
+01200000004200042005420054200a4200a4200b4200b4200c4200e42010420124201342013420124201242014420144201442014420154201442012420104201242012420124201242014420144201a4201a420
+01200000134201342007420074200e4200e4200242002420074200742007420004000040000400004000040000400004000040000400004000040000400004000040000400004000040000400004000040000400
+01200000004000040000400004000040000400004000040000400004000040000400004000040000400264252b4252d4252e4252b4252d4252e425304252d4252e4222e4253242232425304252e4252d42530425
+012000002e4252d4252b4252e4252d4222d4252a4222a4252b4222b4252642226425244002440026422264252b2242d2242e2242b2242d2242e224302242d2242e2242e2223222432222302242e2242d22430224
+012000002e2242d2242b2242e2242d2242d2222a2242a2222b2242b2222622426222244002440026422264252b4252d4252e4222e4252d4252e42530422304252e425304253242232425304252e4252d4222d425
+012000002e4252d4252b4222b4252d4252b4252a4222a4252b4252d4252b4222b425264222642226422264252b4252d4252e4252b4252d4252e425304252d4252e4222e4253242232425304252e4252d42530425
+012000002e4252d4252b4252e4252d4222d4252a4222a4252b4222b4252642226425244002440026224262222d2242b2242d2242b2242a2242a222332243322232224322222e2242e2222e2222a4002e2242e222
+01200000302242e224302242e2242d2242d222332243322232224322222e2242e2222e2222e2222d2242d2222e2242e2222b2242b222292242922227224272222622426222262222622229224292222922229222
+012000002b2242d2242e2242b2242d2242e224302242d2242e2242e2223222432222302242e2242d224302242e2242d2242b2242e2242d2242d2222a2242a2222b2242b222262242622200000000002642226425
+012000002b4252d4252e4222e4252d4252e42530422304252e425304253242232425304252e4252d4222d4252e4252d4252b4222b4252d4252b4252a4222a4252b4252d4252b4222b42526422264222642226425
+012000002742526425244222442526422264222642226425284252642524422244252642226425274222742528422284252f4222f425314252f4252d4252c4252d4222d4222d4222d4252f4222f4252c4222c425
+012000002d425284252542528425214222142221422214252d425284252442528425214222142221422214252b4252642523425264251f4221f4221f4221f4252b4252642522425264251f4221f4251e4221e425
+012000002742526425244222442526422264222642226425284252642524422244252642226425274222742528422284252f4222f425314252f4252d4252c4252d4222d4222d4222d4252f4222f4252c4222c425
+012000002b4252d4252e425304253242533425364253242537422374223742237412374152100022000210001f0001f000210001f0001e0001e00000000000000000000000000000000000000000000000000000
+01200000220051a0051f005220051a0051f005210051e005000000000000000000000000000000000000000022734267342b73422734267342b7342d7342a7342b7342b7322e7342e7322d7342b7342a7342d734
+012000002b7342b73226734267322a7342a73224734247322273426734217341f7341a7341b7341e734247342a734287342a73428734267342673230734307322e7342e7322b7342b7342b7322b7002b7342b732
+012000002d7342b7342d7342b734297342973230734307322e7342e7322973429732297322973226734267322b7342b7322773427732217342173224734247322273422732227322273221734217322173221732
+0120000022734267342b7342e734267342b7342d7342a7342b7342b7322e7342e7322d7342b7342a7342d7342b7342b73226734267322a7342a7322473424732227341a734227341f7341a7341b7341e73424734
+012000002473422734217342173222734227321f7341f732247342373421734217342373423732237342373223734237322373223732287342873228732284002873428732277342773228734287322873228732
+01200000287342573421734257341c7341c7321c7321c732287342473421734247341c7341c7321c7321c73226734237341f734237341a7341a7321a7321a73226732227341f734227341a7341a7321a7341a732
+0120000022734217341f73422734217341f7341e734217341f7341f7321f7321f7221f71500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+011800000924409225102441022515244152251024410225112441122011210112150020000200002000020009244092251024410225152441522518244182251c2441c2201c2101c21500200002000020000000
+011800000924409225102441022515244152251024410225112441122011210112150020000200002000020010244102251124411225102440e2440c2440b2440924409220092100921500200002000020000000
+01180000005001a7241a72521722217252672426725217222172522722227222272500700007000070000700007001a7241a725217222172526724267251d722297252d7222d7222d72500700007000070000500
+01180000007001a7241a725217222172526724267252172221725227222272222725007000070000700007000070021724217252272222725217241f7251d7221c7251a7221a7221a72500700007000070000700
+01180000005000954009545105401054515540155451054010545115401154011545005001152500500115150050009540095451054010545155401554518540185451c5401c5401c545005001c525005001c515
+01180000000000954009545105401054515540155451054010545115401154011545000001152500000115150000010540105451154011545105450e5450c5450b54509540095400954500000000000000000000
+011800002471024720247302474024750247402473024720217402173021720217100070000700007000070024710247202473024740247502474024730247201f7401f7301f7201f7101c700007000070000700
+011800002471024720247302474024750247402473024720217402173021720217100000000000000000000020710207202073020740237502374023730237202474024730247202471000000000000000000000
+01180000247102472028730287402d7502d740287302872027740277302772027710007000070000700007002171024720287302c7402d7502b74028730287202b7402b7302b7202b71000700007000070000000
+011800002471024720287302874024750247402873028720297402973029720297100070000700007000070028710267202873024740267502474026730237202174021730217202171000700007000070000700
+0118000015710157201c7301c74021750217401c7301c7201d7401d7301d7201d7100070000700007000070021710217201c7301c740217502174024730247202874028730287202871000700007000070000000
+0118000015720157201c7201c72021720217201c7201c7201d7201d7201d7201d720007000070000700007001c7201c7201d7201d7201c7201a72018720177201572015720157201572000000000000000000000
+011800000000015120151201c1201c12021120211201c1201c1201d1201d1201d1201d1250000000000000000000015120151201c1201c1202112021120241202412028122281222812228125000000000000000
+011800000010015120151201c1201c12021120211201c1201c1201d1201d1201d1201d125001000010000100001001c1201c1201d1201d1201c1201a120181201712015122151221512215125001000010000100
+01180000007003572435725397223972532724327253972239725367223672236725367000070000700007000070032724357253b7223172532724317253b7223b72530722307223072530700007000070000700
+011800000070035724357253972239725327243272539722397253672236722367253670000700007000070000700397243772539722357253772435725377223472532722327223272532700007000070000700
+011800001800024421244202442024420244202442224412200002142021420204211800000000000000000021000244212442024420244202442024422244121800020421204222041200000000000000000000
+011800001800024421244202442024420244202442224412000002142021420204210000000000000000000000000204202042220422234212342223422244212442024422244222442224412244122441500000
+011800003451434512345123451234512345123451234515335103351033510335150000000000000000000034514345123451234512345123451234512345153451034510345103451500000000000000000000
+011800003451434512345123451234512345123451234515355103551035510355150000000000000000000034514345103451034510385103851038510385103951039510395103951500000000000000000000
+01180000345143451039510395103c5103b510395103951539510395123951239515000000000000000000003051434510395103b5103c5103b51039510395123b5103b5123b5123b51500000000000000000000
+01180000345143451039510395103c5103b510395103951539510395123951239515000000000000000000003c5143b5103c510395103b510395103b510385103951039512395123951500000000000000000000
+011800001c0101c02023010230202801028020230102302024010240202402024015000000000000000000001d0101d020230102302028010280202b0102b0202f0102f0202f0202f01500000000000000000000
+011800001c0101c02023010230202801028020230102302024010240202402024015000000000000000000002301023020240102402023010210101f0101e0101c0101c0201c0201c01500000000000000000000
+01180000000002d1102d11034110341103911039110341103411035110351103511035115000000000000000000002d1102d110341103411039110391103c1103c11034110341103411034115000000000000000
+01180000001002d1102d1103411034110391103911034110341103511035110351103511500100001000010000100341103411035110351103411032110301102f1102d1102d1102d1102d115001000010000100
+011000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+011000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+__music__
+00 06114344
+00 07124344
+00 08134344
+00 09141d44
+00 0a151e44
+00 0b161f44
+00 0c172044
+00 0c182044
+00 0d192144
+00 0e1a2244
+00 06174344
+00 0c172044
+00 0d1b2144
+00 0e1a2244
+00 06182044
+00 0c182044
+02 101c2344
+01 246a4344
+00 25424344
+00 242a3644
+00 252b3744
+00 242c3844
+00 252d3944
+00 242e3a44
+00 252f3b44
+00 24303c44
+00 25313d44
+00 26324344
+00 27334344
+00 28344344
+02 29354344