TinyTextAdventure_in_ZIL

A tiny text adventure in ZIL

Preamble

This is the code for the ZIL port of TinyTextAdventure, tenline.zil, as written by Jason Compton in the video Tiny Text Adventure: From ZX81 to VIC-20 to Ultimate 64.

As the ZIL code didn't seem to have been made available, I transcribed it and posted it here. Skip to the bottom of the page for the ZIL port code, if you want to avoid having to read about trying to get zilf working on a Mac running Catalina.

One point of note:

Why was it decided to write ZILF in C# and .NET? It was rather frustrating trying to get a version of ZILF to run on macOS Catalina (10.15.8).
- Answer: ZIL Coding

Links

Vaguely related

Notes

Getting started

How does one go about setting up on the Mac? What binaries are required?

Note: I placed all ZIL related files and directories in a directory named ZILF/, under my ~/Downloads/ directory, in order to keep all the files together.

ZILF source code

The readme of zilf was useful for getting started.

Releases – ZILF 0.11.1
- Get the macOS version tarball of zilf
Unzip
cd into bin/
run zilf yourfile.zil

Unfortunately, only Apple Silicon builds of zilf are available, not Intel, so you'll have to compile the source, if you have an older Mac.

Therefore, I downloaded, from the Assets section of ZILF 0.11.1, the Source code (zip), expanded and changed directory.

cd ../../zilf-0.11.1

`dotnet`

You'll also need dotnet. Luckily there is an x86 build of SDK 9.0.310. I downloaded the binaries not the package/installer.

How NOT to do it - The "double click" mistake

(Skip forward to the section Using gunzip and tar below, if you don't want to know what you shouldn't do.)

Then uncompress by double-clicking the .tar.gz file. Drag the dotnet binary into the zilf-0.11.1/ directory.

% ./dotnet build Zilf.sln
Error: [/Users/macbook/Downloads/ZILF/zilf-0.11.1/host/fxr] does not exist
Failed to resolve libhostfxr.dylib [not found]. Error code: 0x80008083
%

Dragging the host directory into the zilf-0.11.1/ directory

% ./dotnet build Zilf.sln
Failed to load /Users/macbook/Downloads/ZILF/zilf-0.11.1/host/fxr/9.0.12/libhostfxr.dylib, error: dlopen(/Users/macbook/Downloads/ZILF/zilf-0.11.1/host/fxr/9.0.12/libhostfxr.dylib, 1): Symbol not found: __ZNSt3__113basic_filebufIcNS_11char_traitsIcEEE4openEPKcj
  Referenced from: /Users/macbook/Downloads/ZILF/zilf-0.11.1/host/fxr/9.0.12/libhostfxr.dylib (which was built for Mac OS X 12.0)
  Expected in: /usr/lib/libc++.1.dylib

The library libhostfxr.dylib was found, but loading it from /Users/macbook/Downloads/ZILF/zilf-0.11.1/host/fxr/9.0.12/libhostfxr.dylib failed
  - Installing .NET prerequisites might help resolve this problem.
     https://go.microsoft.com/fwlink/?linkid=2063366
Failed to resolve libhostfxr.dylib [/Users/macbook/Downloads/ZILF/zilf-0.11.1/host/fxr/9.0.12/libhostfxr.dylib]. Error code: 0x80008082
%

I guess the installer for dotnet might be easier, as it should set the paths? However, the installer requires MacOS 12. Catalina just isn't good enough. So, I gave up. Ponitless!!!!

Trying 9.0.2, and 9.0.0 RC1, resulted in the same issue.

Following these intrructions from install-macos.md

~# curl -Lo dotnet.tar.gz https://builds.dotnet.microsoft.com/dotnet/Sdk/9.0.308/dotnet-sdk-9.0.308-osx-x64.tar.gz
~# mkdir dotnet
~# tar -C dotnet -xf dotnet.tar.gz
~# rm dotnet.tar.gz
~# export DOTNET_ROOT=~/dotnet
~# export PATH=$PATH:~/dotnet
~# dotnet --version

Adjusting the env vars slightly

~# export DOTNET_ROOT=~/downloads/ZILF/dotnet
~# export PATH=$PATH:~/dowloads/ZILF/dotnet

This ended up resulting in the same libc++.1.dylib error:

% dotnet --version
Failed to load /Users/macbook/dotnet/host/fxr/9.0.11/libhostfxr.dylib, error: dlopen(/Users/macbook/dotnet/host/fxr/9.0.11/libhostfxr.dylib, 1): Symbol not found: __ZNSt3__113basic_filebufIcNS_11char_traitsIcEEE4openEPKcj
  Referenced from: /Users/macbook/dotnet/host/fxr/9.0.11/libhostfxr.dylib (which was built for Mac OS X 12.0)
  Expected in: /usr/lib/libc++.1.dylib

The library libhostfxr.dylib was found, but loading it from /Users/macbook/dotnet/host/fxr/9.0.11/libhostfxr.dylib failed
  - Installing .NET prerequisites might help resolve this problem.
     https://go.microsoft.com/fwlink/?linkid=2063366
Failed to resolve libhostfxr.dylib [/Users/macbook/dotnet/host/fxr/9.0.11/libhostfxr.dylib]. Error code: 0x80008082

Then I came across this Github issue, dotnet 9 fails on macOS Catalina due to a missing symbol in libc++ #45382. This issue states that dotnet 8 works on Catalina.

I tried 8.0.417, which resulted in a new, but different, error:

% ./dotnet --version
Failed to load /Users/macbook/Downloads/ZILF/dotnet-sdk-8.0.417-osx-x64/shared/Microsoft.NETCore.App/8.0.23/libhostpolicy.dylib, error: dlopen(/Users/macbook/Downloads/ZILF/dotnet-sdk-8.0.417-osx-x64/shared/Microsoft.NETCore.App/8.0.23/libhostpolicy.dylib, 1): no suitable image found.  Did find:
	/Users/macbook/Downloads/ZILF/dotnet-sdk-8.0.417-osx-x64/shared/Microsoft.NETCore.App/8.0.23/libhostpolicy.dylib: code signature in (/Users/macbook/Downloads/ZILF/dotnet-sdk-8.0.417-osx-x64/shared/Microsoft.NETCore.App/8.0.23/libhostpolicy.dylib) not valid for use in process using Library Validation: library load disallowed by system policy
An error occurred while loading required library libhostpolicy.dylib from [/Users/macbook/Downloads/ZILF/dotnet-sdk-8.0.417-osx-x64/shared/Microsoft.NETCore.App/8.0.23]

Trying dotnet 7, resulted in a similar error:

 % ./dotnet --version
Failed to load /Users/macbook/Downloads/ZILF/dotnet-sdk-7.0.410-osx-x64/shared/Microsoft.NETCore.App/7.0.20/libhostpolicy.dylib, error: dlopen(/Users/macbook/Downloads/ZILF/dotnet-sdk-7.0.410-osx-x64/shared/Microsoft.NETCore.App/7.0.20/libhostpolicy.dylib, 1): no suitable image found.  Did find:
	/Users/macbook/Downloads/ZILF/dotnet-sdk-7.0.410-osx-x64/shared/Microsoft.NETCore.App/7.0.20/libhostpolicy.dylib: code signature in (/Users/macbook/Downloads/ZILF/dotnet-sdk-7.0.410-osx-x64/shared/Microsoft.NETCore.App/7.0.20/libhostpolicy.dylib) not valid for use in process using Library Validation: library load disallowed by system policy
An error occurred while loading required library libhostpolicy.dylib from [/Users/macbook/Downloads/ZILF/dotnet-sdk-7.0.410-osx-x64/shared/Microsoft.NETCore.App/7.0.20]

Trying v6, likewise:

 % ./dotnet --version
Failed to load /Users/macbook/Downloads/ZILF/dotnet-sdk-6.0.428-osx-x64/shared/Microsoft.NETCore.App/6.0.36/libhostpolicy.dylib, error: dlopen(/Users/macbook/Downloads/ZILF/dotnet-sdk-6.0.428-osx-x64/shared/Microsoft.NETCore.App/6.0.36/libhostpolicy.dylib, 1): no suitable image found.  Did find:
	/Users/macbook/Downloads/ZILF/dotnet-sdk-6.0.428-osx-x64/shared/Microsoft.NETCore.App/6.0.36/libhostpolicy.dylib: code signature in (/Users/macbook/Downloads/ZILF/dotnet-sdk-6.0.428-osx-x64/shared/Microsoft.NETCore.App/6.0.36/libhostpolicy.dylib) not valid for use in process using Library Validation: library load disallowed by system policy
An error occurred while loading required library libhostpolicy.dylib from [/Users/macbook/Downloads/ZILF/dotnet-sdk-6.0.428-osx-x64/shared/Microsoft.NETCore.App/6.0.36]

It should be noted that while ./dotnet executes just fine, ./dotnet --version causes the errors.

It should also be noted that v8, v7, and v6 also popped up a dialog saying the following.

"Microsoft.NETCore.App.app" is damaged and can't be opened. You should move it to the Bin.

Is this corruption normal? It seems unlikely. Is the .tar.gz being corrrupted whilst being expanded? Maybe double clicking isn't a good idea and gunzip and tar should be used, instead..?

Using `gunzip` and `tar`

It would appear that v5 was the last version without an Arm64 download. When extracted using gunzip/tar (and not by double clicking), the dotnet binary runs sans problème, on Catalina:

% ./dotnet --version
5.0.408

It works!

Is the file corruption issue, of the previous section, due to the double clicking and the Apple expansion/inflation? Retrying v6, but uncompressing using gunzip and tar, made it work this time:

% gunzip dotnet-sdk-6.0.428-osx-x64.tar.gz
% mkdir dotnet-sdk-6.0.428-osx-x64
% mv dotnet-sdk-6.0.428-osx-x64.tar dotnet-sdk-6.0.428-osx-x64
% cd dotnet-sdk-6.0.428-osx-x64
% tar xvf dotnet-sdk-6.0.428-osx-x64.tar
% ./dotnet --version
6.0.428

Similarly for v7:

% cd ../dotnet-sdk-7.0.410-osx-x64        
% gunzip dotnet-sdk-7.0.410-osx-x64.tar.gz
% tar xvf dotnet-sdk-7.0.410-osx-x64.tar
% ./dotnet --version
7.0.410

Similarly for v8:

% gunzip dotnet-sdk-8.0.417-osx-x64.tar.gz                    
% mkdir dotnet-sdk-8.0.417-osx-x64                           
% mv dotnet-sdk-8.0.417-osx-x64.tar dotnet-sdk-8.0.417-osx-x64
% cd dotnet-sdk-8.0.417-osx-x64                               
% tar xvf dotnet-sdk-8.0.417-osx-x64.tar                      
% ./dotnet --version
8.0.417
% export DOTNET_ROOT=~/Downloads/ZILF/dotnet-sdk-8.0.417-osx-x64
% export PATH=$PATH:~/Downloads/ZILF/dotnet-sdk-8.0.417-osx-x64 
% dotnet --version

However, retrying for v9, as expected, is still broken (for Catalina):

% ./dotnet --version
Failed to load /Users/macbook/Downloads/ZILF/dotnet-sdk-9.0.310-osx-x64/host/fxr/9.0.12/libhostfxr.dylib, error: dlopen(/Users/macbook/Downloads/ZILF/dotnet-sdk-9.0.310-osx-x64/host/fxr/9.0.12/libhostfxr.dylib, 1): Symbol not found: __ZNSt3__113basic_filebufIcNS_11char_traitsIcEEE4openEPKcj
  Referenced from: /Users/macbook/Downloads/ZILF/dotnet-sdk-9.0.310-osx-x64/host/fxr/9.0.12/libhostfxr.dylib (which was built for Mac OS X 12.0)
  Expected in: /usr/lib/libc++.1.dylib

The library libhostfxr.dylib was found, but loading it from /Users/macbook/Downloads/ZILF/dotnet-sdk-9.0.310-osx-x64/host/fxr/9.0.12/libhostfxr.dylib failed
  - Installing .NET prerequisites might help resolve this problem.
     https://go.microsoft.com/fwlink/?linkid=2063366
Failed to resolve libhostfxr.dylib [/Users/macbook/Downloads/ZILF/dotnet-sdk-9.0.310-osx-x64/host/fxr/9.0.12/libhostfxr.dylib]. Error code: 0x80008082

Even earlier versions

Unfortunately, v4 seems to be missing.

Using v3

% gunzip dotnet-sdk-3.0.103-osx-x64.tar.gz
% tar xvf dotnet-sdk-3.0.103-osx-x64.tar
% ./dotnet --version
3.0.103

Installing `dotnet` using `brew`

Attempting to install dotnet using brew:

brew install dotnet

However, this, rather predictably, resulted in an error:

GC: Failed to initialize GCToOSInterface
GC initialization failed with error 0x80004005
Failed to create CoreCLR, HRESULT: 0x80004005

Homebrew would probably have installed the latest (v9?) version anyway, which would have been incompatible. It seems better to continue with the "working" v8.

An alternative option might be to try macports, as it might have a Catalina compatible version of dotnet. However, as revealed below, I did not persue this option.

Compiling Zilf!

Now that dotnet v8 is working, we can move on to finally compiling zilf, or at least try to.

First, ensure that your paths to dotnet are correct:

% export DOTNET_ROOT=~/Downloads/ZILF/dotnet-sdk-8.0.417-osx-x64
% export PATH=$PATH:~/Downloads/ZILF/dotnet-sdk-8.0.417-osx-x64

Now build zilf, following the instructions in the README for zilf:

% cd ../zilf-0.11.1
% dotnet build Zilf.sln

But dotnet v9 is required:

/Users/macbook/Downloads/ZILF/dotnet-sdk-8.0.417-osx-x64/sdk/8.0.417/Sdks/Microsoft.NET.Sdk/targets/Microsoft.NET.TargetFrameworkInference.targets(166,5): error NETSDK1045: The current .NET SDK does not support targeting .NET 9.0.  Either target .NET 8.0 or lower, or use a version of the .NET SDK that supports .NET 9.0. Download the .NET SDK from https://aka.ms/dotnet/download [/Users/macbook/Downloads/ZILF/zilf-0.11.1/src/Zilf.Common/Zilf.Common.csproj]

There were a total of 14 errors.

Target incompatabilities

Is it possible to change the target?

There is no mention of 9.0 in Zilf.sln.
There is no mention of 9.0 in Zilf.sln.DotSettings.

However, in each of the following files there is the line, <TargetFramework>net9.0</TargetFramework>:

src/Analyzers/ZilfAnalyzers.Test/ZilfAnalyzers.Test.csproj
src/Analyzers/ZilfAnalyzers/ZilfAnalyzers.csproj
src/Zilf.Playground/Zilf.Playground.csproj
- Right click and select 'Show Package Contents'
src/Zapf.Parsing/Zapf.Parsing.csproj
src/Zapf/Zapf.csproj
src/Dezapf/Dezapf.csproj
src/Zilf.Common/Zilf.Common.csproj
src/Zilf/Zilf.csproj
src/Zilf.Emit/Zilf.Emit.csproj

After changing the target to net8.0, from net9.0, there are now just 6 build errors, in the test directory, rather that the src/ diretory:

test/Zilf.Tests/Zilf.Tests.csproj
test/Zilf.Emit.Tests/Zilf.Emit.Tests.csproj
test/Dezapf.Tests/Dezapf.Tests.csproj
test/Zilf.Tests.Integration/Zilf.Tests.Integration.csproj
test/Zilf.Common.Tests/Zilf.Common.Tests.csproj
test/Zapf.Tests/Zapf.Tests.csproj

Now the build proceeds..!

More incompatability - `WebAssembly` and `WebUtilites`

% dotnet build Zilf.sln
  Determining projects to restore...
  Restored /Users/macbook/Downloads/ZILF/zilf-0.11.1/src/Zilf.Emit/Zilf.Emit.csproj (in 4.66 sec).
...

but dies with 4 errors:

/Users/macbook/Downloads/ZILF/zilf-0.11.1/src/Zilf.Playground/Zilf.Playground.csproj : error NU1202: Package Microsoft.AspNetCore.Components.WebAssembly 9.0.9 is not compatible with net8.0 (.NETCoreApp,Version=v8.0). Package Microsoft.AspNetCore.Components.WebAssembly 9.0.9 supports: net9.0 (.NETCoreApp,Version=v9.0) [/Users/macbook/Downloads/ZILF/zilf-0.11.1/Zilf.sln]
/Users/macbook/Downloads/ZILF/zilf-0.11.1/src/Zilf.Playground/Zilf.Playground.csproj : error NU1202: Package Microsoft.AspNetCore.WebUtilities 9.0.9 is not compatible with net8.0 (.NETCoreApp,Version=v8.0). Package Microsoft.AspNetCore.WebUtilities 9.0.9 supports: net9.0 (.NETCoreApp,Version=v9.0) [/Users/macbook/Downloads/ZILF/zilf-0.11.1/Zilf.sln]
/Users/macbook/Downloads/ZILF/zilf-0.11.1/src/Zilf.Playground/Zilf.Playground.csproj : error NU1202: Package Microsoft.AspNetCore.Components.WebAssembly 9.0.9 is not compatible with net8.0 (.NETCoreApp,Version=v8.0) / browser-wasm. Package Microsoft.AspNetCore.Components.WebAssembly 9.0.9 supports: net9.0 (.NETCoreApp,Version=v9.0) [/Users/macbook/Downloads/ZILF/zilf-0.11.1/Zilf.sln]
/Users/macbook/Downloads/ZILF/zilf-0.11.1/src/Zilf.Playground/Zilf.Playground.csproj : error NU1202: Package Microsoft.AspNetCore.WebUtilities 9.0.9 is not compatible with net8.0 (.NETCoreApp,Version=v8.0) / browser-wasm. Package Microsoft.AspNetCore.WebUtilities 9.0.9 supports: net9.0 (.NETCoreApp,Version=v9.0) [/Users/macbook/Downloads/ZILF/zilf-0.11.1/Zilf.sln]
    0 Warning(s)
    4 Error(s)

See also Error After Upgrading the Blazor Project WASM to .Net 8 to .Net 9

We need to find the lines of the form:

<PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly" Version="9.0.0" />
<PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly.DevServer" Version="9.0.0" PrivateAssets="all" />

In (right click and select 'Show Package Contents'):

/src/Zilf.Playground/Zilf.Playground.csproj

Changing

    <PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly" Version="9.0.9" />
    <PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly.DevServer" Version="9.0.9" PrivateAssets="all" />
    <PackageReference Include="Microsoft.AspNetCore.WebUtilities" Version="9.0.9" />
    <PackageReference Include="System.Net.Http.Json" Version="9.0.9" />

to

    <PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly" Version="8.0" />
    <PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly.DevServer" Version="8.0" PrivateAssets="all" />
    <PackageReference Include="Microsoft.AspNetCore.WebUtilities" Version="8.0" />
    <PackageReference Include="System.Net.Http.Json" Version="8.0" />

and rebuild.

`langversion` incompatabilities

The rebuild resulted in some new errors:

% dotnet build Zilf.sln
...
CSC : error CS1617: Invalid option '13' for /langversion. Use '/langversion:?' to list supported values. [/Users/macbook/Downloads/ZILF/zilf-0.11.1/test/Dezapf.Tests/Dezapf.Tests.csproj]
CSC : error CS1617: Invalid option '13' for /langversion. Use '/langversion:?' to list supported values. [/Users/macbook/Downloads/ZILF/zilf-0.11.1/src/Zapf.Parsing/Zapf.Parsing.csproj]
CSC : error CS1617: Invalid option '13' for /langversion. Use '/langversion:?' to list supported values. [/Users/macbook/Downloads/ZILF/zilf-0.11.1/src/Zilf.Common/Zilf.Common.csproj]
CSC : error CS1617: Invalid option '13' for /langversion. Use '/langversion:?' to list supported values. [/Users/macbook/Downloads/ZILF/zilf-0.11.1/src/Analyzers/ZilfSourceGenerators/ZilfSourceGenerators.csproj]
CSC : error CS1617: Invalid option '13' for /langversion. Use '/langversion:?' to list supported values. [/Users/macbook/Downloads/ZILF/zilf-0.11.1/src/Analyzers/ZilfAnalyzers/ZilfAnalyzers.csproj]
CSC : error CS1617: Invalid option '13' for /langversion. Use '/langversion:?' to list supported values. [/Users/macbook/Downloads/ZILF/zilf-0.11.1/src/WindowsInstaller/WindowsInstaller.csproj]
    0 Warning(s)
    6 Error(s)

See Compiler Error CS1617

Running

dotnet exec "~/Downloads/ZILF/dotnet-sdk-8.0.417-osx-x64/sdk/8.0.417Roslyn/bincore/csc.dll" -langversion:?

did not work

I could not find any reference to 13 in:

Dezapf.Tests.csproj
Zapf.Parsing.csproj
Zilf.Common.csproj
ZilfSourceGenerators.csproj
ZilfAnalyzers.csproj
WindowsInstaller.csproj
Nor in:
- Zilf.sln
- Zilf.sln.DotSettings

However, there was a reference to 13 in Directory.Build.props (although, going by a recent modified time, this seems to be a build generated file):

    <LangVersion>13</LangVersion>

changing to

    <LangVersion>13.0</LangVersion>

did not fix the issue. So where is it originating? Seeing as the 13.0 was not changed back to 13, maybe an older language verson is required..?

From Compiler Error CS1617, and looking at the valid values listed for "language", I changed 13.0 to 8.0, but that was probably too far back, as 16 of these issues appeared:

/Users/macbook/Downloads/ZILF/zilf-0.11.1/src/WindowsInstaller/obj/Debug/net8.0-windows/WindowsInstaller.GlobalUsings.g.cs(10,1): error CS8400: Feature 'global using directive' is not available in C# 8.0. Please use language version 10.0 or greater. [/Users/macbook/Downloads/ZILF/zilf-0.11.1/src/WindowsInstaller/WindowsInstaller.csproj]

Changing 8.0 to 10.0, gave 10 errors:

Feature 'collection expressions' is not available in C# 10.0. Please use language version 12.0 or greater. [/Users/macbook/Downloads/ZILF/zilf-0.11.1/test/Zapf.Tests/Zapf.Tests.csproj]

Success?

Changing 10.0 to 12.0 – which is probably the best version, as it is preceding the dotnet v9 correspondance to language 13.0 – resulted in success:

% dotnet build Zilf.sln
  Determining projects to restore...
  All projects are up-to-date for restore.
  Dezapf.Tests -> /Users/macbook/Downloads/ZILF/zilf-0.11.1/bin/Debug/net8.0/Dezapf.Tests.dll
  Zilf.Common -> /Users/macbook/Downloads/ZILF/zilf-0.11.1/bin/Debug/net8.0/Zilf.Common.dll
  WindowsInstaller -> /Users/macbook/Downloads/ZILF/zilf-0.11.1/bin/Debug/net8.0-windows/WindowsInstaller.dll
  Zapf.Parsing -> /Users/macbook/Downloads/ZILF/zilf-0.11.1/bin/Debug/net8.0/Zapf.Parsing.dll
  ZilfAnalyzers -> /Users/macbook/Downloads/ZILF/zilf-0.11.1/bin/Debug/net8.0/ZilfAnalyzers.dll
  ZilfSourceGenerators -> /Users/macbook/Downloads/ZILF/zilf-0.11.1/bin/Debug/netstandard2.0/ZilfSourceGenerators.dll
  Zilf.Emit -> /Users/macbook/Downloads/ZILF/zilf-0.11.1/bin/Debug/net8.0/Zilf.Emit.dll
  Zilf.Common.Tests -> /Users/macbook/Downloads/ZILF/zilf-0.11.1/bin/Debug/net8.0/Zilf.Common.Tests.dll
  Zilf.Emit.Tests -> /Users/macbook/Downloads/ZILF/zilf-0.11.1/bin/Debug/net8.0/Zilf.Emit.Tests.dll
  Zapf -> /Users/macbook/Downloads/ZILF/zilf-0.11.1/bin/Debug/net8.0/zapf.dll
  Successfully created package '/Users/macbook/Downloads/ZILF/zilf-0.11.1/bin/Debug/ZilfAnalyzers.1.0.0.nupkg'.
  Dezapf -> /Users/macbook/Downloads/ZILF/zilf-0.11.1/bin/Debug/net8.0/Dezapf.dll
  Zapf.Tests -> /Users/macbook/Downloads/ZILF/zilf-0.11.1/bin/Debug/net8.0/Zapf.Tests.dll
  ZilfAnalyzers.Test -> /Users/macbook/Downloads/ZILF/zilf-0.11.1/bin/Debug/net8.0/ZilfAnalyzers.Test.dll
  Zilf -> /Users/macbook/Downloads/ZILF/zilf-0.11.1/bin/Debug/net8.0/zilf.dll
  Zilf.Tests.Integration -> /Users/macbook/Downloads/ZILF/zilf-0.11.1/bin/Debug/net8.0/Zilf.Tests.Integration.dll
  Zilf.Tests -> /Users/macbook/Downloads/ZILF/zilf-0.11.1/bin/Debug/net8.0/Zilf.Tests.dll
  Zilf.Playground -> /Users/macbook/Downloads/ZILF/zilf-0.11.1/bin/Debug/net8.0/Zilf.Playground.dll
  Zilf.Playground (Blazor output) -> /Users/macbook/Downloads/ZILF/zilf-0.11.1/bin/Debug/net8.0/wwwroot

Build succeeded.
    0 Warning(s)
    0 Error(s)

Time Elapsed 00:01:25.79

However, does it work? The two UNIX binaries, zilf and zapf, are in bin/debug/net8.0/ A lot of Microsoft and Windows binaries are also created. In all, around 108 MB of code was generated! Who said M$ weren't sparing with their code?!?!

% cp bin/Debug/net8.0/zilf /usr/local/bin
% cp bin/Debug/net8.0/zapf /usr/local/bin
% zilf
The application to execute does not exist: '/usr/local/bin/zilf.dll'.
% cp bin/Debug/net8.0/zilf.dll /usr/local/bin 
% zilf
A fatal error was encountered. The library 'libhostpolicy.dylib' required to execute the application was not found in '/Users/macbook/Downloads/ZILF/dotnet-sdk-8.0.417-osx-x64'.
Failed to run as a self-contained app.
  - The application was run as a self-contained app because '/usr/local/bin/zilf.runtimeconfig.json' was not found.
  - If this should be a framework-dependent app, add the '/usr/local/bin/zilf.runtimeconfig.json' file and specify the appropriate framework.

Hmmm, this could end up moving a lot of files around...

Moving everything?

Attempting to continue with the installation of zilf and moving over the remaining missing files to /usr/local/bin:

% cp bin/Debug/net8.0/zilf.runtimeconfig.json /usr/local/bin
% cp bin/Debug/net8.0/Zilf.Common.dll /usr/local/bin
% cp bin/Debug/net8.0/ReadLine.dll /usr/local/bin

results in a REPL:

 % zilf
ZILF 0.11.1 built 08/02/2026 19:37:13
>

However, trying to compile results in, yet another, missing file:

% zilf tenline.zil 
ZILF 0.11.1 built 08/02/2026 19:37:13
file not found: Zilf.Emit, Version=0.11.1.0, Culture=neutral, PublicKeyToken=null

So, copying over to /usr/local/bin/:

% cp bin/Debug/net8.0/Zilf.Emit.dll /usr/local/bin 
% zilf tenline.zil      
ZILF 0.11.1 built 08/02/2026 19:37:13
[error MDL0604] /Users/macbook/Documents/TandT/ZIL/tenline.zil:27: INSERT-FILE: file not found: parser

1 error

Note: parser.zil is in zillib/.

Summary

You would need to move at least 7 files:

% cp bin/Debug/net8.0/zilf /usr/local/bin
% cp bin/Debug/net8.0/zapf /usr/local/bin
% cp bin/Debug/net8.0/zilf.dll /usr/local/bin 
% cp bin/Debug/net8.0/zilf.runtimeconfig.json /usr/local/bin
% cp bin/Debug/net8.0/Zilf.Common.dll /usr/local/bin
% cp bin/Debug/net8.0/ReadLine.dll /usr/local/bin 
% cp bin/Debug/net8.0/Zilf.Emit.dll /usr/local/bin

Note that parser.zil should be copied to your ZIL port source directory, i.e. the directory containing tenline.zil, and not /usr/local/bin/ [Edit - This is actually incorrect as files from zillib/ need to be placed in /usr/local/bin/zillib/, see below].

However, even then, you get many 'unassigned atom' and missing file errors:

 % zilf tenline.zil
ZILF 0.11.1 built 08/02/2026 19:37:13
[error MDL0604] /Users/macbook/Documents/TandT/ZIL/parser.zil:6: USE: file not found: QQ
  in INSERT-FILE called at /Users/macbook/Documents/TandT/ZIL/tenline.zil:27
[error MDL0604] /Users/macbook/Documents/TandT/ZIL/parser.zil:7: USE: file not found: LIBMSG
  in INSERT-FILE called at /Users/macbook/Documents/TandT/ZIL/tenline.zil:27
[error MDL0604] /Users/macbook/Documents/TandT/ZIL/parser.zil:8: USE: file not found: LIBMSG-DEFAULTS
  in INSERT-FILE called at /Users/macbook/Documents/TandT/ZIL/tenline.zil:27
[error MDL0128] /Users/macbook/Documents/TandT/ZIL/parser.zil:337: DEFMAC: arg 2: expected LIST
  in EVAL called at /Users/macbook/Documents/TandT/ZIL/parser.zil:337
  in MAPF called at /Users/macbook/Documents/TandT/ZIL/parser.zil:335
  in INSERT-FILE called at /Users/macbook/Documents/TandT/ZIL/tenline.zil:27
[error MDL0604] /Users/macbook/Documents/TandT/ZIL/parser.zil:580: INSERT-FILE: file not found: orphan
  in INSERT-FILE called at /Users/macbook/Documents/TandT/ZIL/tenline.zil:27
[error MDL0604] /Users/macbook/Documents/TandT/ZIL/parser.zil:583: INSERT-FILE: file not found: pseudo
  in INSERT-FILE called at /Users/macbook/Documents/TandT/ZIL/tenline.zil:27
[error MDL0604] /Users/macbook/Documents/TandT/ZIL/parser.zil:586: INSERT-FILE: file not found: pronouns
  in INSERT-FILE called at /Users/macbook/Documents/TandT/ZIL/tenline.zil:27
[error MDL0200] /Users/macbook/Documents/TandT/ZIL/parser.zil:588: calling unassigned atom: PRONOUN
  in INSERT-FILE called at /Users/macbook/Documents/TandT/ZIL/tenline.zil:27
[error MDL0200] /Users/macbook/Documents/TandT/ZIL/parser.zil:594: calling unassigned atom: PRONOUN
  in INSERT-FILE called at /Users/macbook/Documents/TandT/ZIL/tenline.zil:27
[error MDL0200] /Users/macbook/Documents/TandT/ZIL/parser.zil:599: calling unassigned atom: PRONOUN
  in INSERT-FILE called at /Users/macbook/Documents/TandT/ZIL/tenline.zil:27
[error MDL0200] /Users/macbook/Documents/TandT/ZIL/parser.zil:605: calling unassigned atom: PRONOUN
  in INSERT-FILE called at /Users/macbook/Documents/TandT/ZIL/tenline.zil:27
[error MDL0200] /Users/macbook/Documents/TandT/ZIL/parser.zil:611: calling unassigned atom: FINISH-PRONOUNS
  in INSERT-FILE called at /Users/macbook/Documents/TandT/ZIL/tenline.zil:27
[error MDL0604] /Users/macbook/Documents/TandT/ZIL/parser.zil:1681: INSERT-FILE: file not found: scope
  in INSERT-FILE called at /Users/macbook/Documents/TandT/ZIL/tenline.zil:27
[error MDL0604] /Users/macbook/Documents/TandT/ZIL/parser.zil:3134: INSERT-FILE: file not found: events
  in INSERT-FILE called at /Users/macbook/Documents/TandT/ZIL/tenline.zil:27
[error MDL0604] /Users/macbook/Documents/TandT/ZIL/parser.zil:3136: INSERT-FILE: file not found: verbs
  in INSERT-FILE called at /Users/macbook/Documents/TandT/ZIL/tenline.zil:27
15 errors

For this reason, I stopped trying to move the files to /usr/local/bin/, and just used the zilf binary in place within the bin/debug/net8.0/ directory, as is.

However, in order to fix the errors above, you need to make a zillib/ directory in /usr/local/bin/, and copy over all of the .zil files, and a .mud file, from the zillib/ directory in the zilf-0.11.1 source directory:

mkdir -p /usr/local/bin/zillib
cp /Users/macbook/Downloads/ZILF/zilf-0.11.1/zillib/parser.zil /usr/local/bin/zillib
cp /Users/macbook/Downloads/ZILF/zilf-0.11.1/zillib/verbs.zil /usr/local/bin/zillib
cp /Users/macbook/Downloads/ZILF/zilf-0.11.1/zillib/scope.zil /usr/local/bin/zillib
cp /Users/macbook/Downloads/ZILF/zilf-0.11.1/zillib/events.zil /usr/local/bin/zillib
cp /Users/macbook/Downloads/ZILF/zilf-0.11.1/zillib/orphan.zil /usr/local/bin/zillib
cp /Users/macbook/Downloads/ZILF/zilf-0.11.1/zillib/pseudo.zil /usr/local/bin/zillib
cp /Users/macbook/Downloads/ZILF/zilf-0.11.1/zillib/pronouns.zil /usr/local/bin/zillib
cp /Users/macbook/Downloads/ZILF/zilf-0.11.1/zillib/libmsg.zil /usr/local/bin/zillib
cp /Users/macbook/Downloads/ZILF/zilf-0.11.1/zillib/libmsg-defaults.zil /usr/local/bin/zillib
cp /Users/macbook/Downloads/ZILF/zilf-0.11.1/zillib/qq.mud /usr/local/bin/zillib

Plese refer to the Makefile at the bottom of the page, for a list of all files that need to be copied to /usr/local/bin.

Running `zilf` from its build directory

Running zilf from the zilf-0.11.1/ directory yields much better results, and a REPL:

% bin/debug/net8.0/zilf
ZILF 0.11.1 built 08/02/2026 19:37:13
> quit
QUIT
> exit
exit
>

and finally compiling the TinyTextAdventure ZIL code:

% ~/Downloads/ZILF/zilf-0.11.1/bin/debug/net8.0/zilf  tenline.zil 
ZILF 0.11.1 built 08/02/2026 19:37:13

This results in

% ls ten*
tenline.zap		tenline_data.zap	tenline_str.zap
tenline.zil		tenline_freq.zap

However, the readme states that there should be a .z3 file, which I do not have.

What that readme is missing, is the following step which is shown in ZIL - Where to start - Quick Code Guide @ 8:15,

% zapf tenline.zap
The application to execute does not exist: '/usr/local/bin/zapf.dll'.

There seems to be a hardcoded path to /usr/local/bin as zapf.dll is in the PATH:

 % echo $PATH
/usr/local/opt/llvm/bin:/opt/local/bin:/opt/local/sbin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/X11/bin:/Library/Apple/usr/bin:/Library/Frameworks/Mono.framework/Versions/Current/Commands:/Users/macbook/.cargo/bin:/Users/macbook/Downloads/ZILF/zilf/zilf-0.11.1/bin/Debug/net8.0:/Users/macbook/Downloads/ZILF/zilf/dotnet-sdk-8.0.417-osx-x64
% ls /Users/macbook/Downloads/ZILF/zilf/zilf-0.11.1/bin/Debug/net8.0/zapf.*
zapf.dll                 zapf.runtimeconfig.json
zapf.deps.json           zapf.pdb

That is rather unfortunate. Manually copying zapf.dll to /usr/local/bin/,

% cp /Users/macbook/Downloads/ZILF/zilf/zilf-0.11.1/bin/Debug/net8.0/zapf.dll /usr/local/bin
macbook@Macbooks-MacBook-Pro ZIL % zapf tenline.zap
A fatal error was encountered. The library 'libhostpolicy.dylib' required to execute the application was not found in '/Users/macbook/Downloads/ZILF/zilf/dotnet-sdk-8.0.417-osx-x64'.
Failed to run as a self-contained app.
  - The application was run as a self-contained app because '/usr/local/bin/zapf.runtimeconfig.json' was not found.
  - If this should be a framework-dependent app, add the '/usr/local/bin/zapf.runtimeconfig.json' file and specify the appropriate framework.

This really does seem rather unfortunate, especially as I had previously given up on trying to move everything to /usr/local/bin.

Nowevertheless, soldiering on, regardless,

% cp /Users/macbook/Downloads/ZILF/zilf/zilf-0.11.1/bin/Debug/net8.0/zapf.runtimeconfig.json /usr/local/bin
% zapf tenline.zap
Unhandled exception. System.IO.FileNotFoundException: Could not load file or assembly 'Zapf.Parsing, Version=0.11.1.0, Culture=neutral, PublicKeyToken=null'. The system cannot find the file specified.

File name: 'Zapf.Parsing, Version=0.11.1.0, Culture=neutral, PublicKeyToken=null'
zsh: abort      zapf tenline.zap
% cp /Users/macbook/Downloads/ZILF/zilf/zilf-0.11.1/bin/Debug/net8.0/Zapf.Parsing.dll /usr/local/bin
% zapf tenline.zap
Unhandled exception. System.IO.FileNotFoundException: Could not load file or assembly 'Zilf.Common, Version=0.11.1.0, Culture=neutral, PublicKeyToken=null'. The system cannot find the file specified.

File name: 'Zilf.Common, Version=0.11.1.0, Culture=neutral, PublicKeyToken=null'
   at Zapf.Context..ctor()
   at Zapf.Program.TryParseArgs(IReadOnlyList`1 args, Context& ctx)
   at Zapf.Program.Main(String[] args)
zsh: abort      zapf tenline.zap
% cp /Users/macbook/Downloads/ZILF/zilf/zilf-0.11.1/bin/Debug/net8.0/Zilf.Common.dll /usr/local/bin 
% zapf tenline.zap
ZAPF 0.11.1
Reading tenline.zap
Reading tenline_freq.zap
Reading tenline_data.zap
Reading tenline_str.zap
Measuring..
Assembling
Wrote 23074 bytes to tenline.z3
% ls ten*
tenline.z3		tenline.zil		tenline_freq.zap
tenline.zap		tenline_data.zap	tenline_str.zap

Success!!! You can see the .z3 file.

Summary

Even though you may be running zilf from the build directory, you will still need to copy the following files to usr/local/bin/, in order for zapf to work:

% cp /Users/macbook/Downloads/ZILF/zilf/zilf-0.11.1/bin/Debug/net8.0/zapf.dll /usr/local/bin
% cp /Users/macbook/Downloads/ZILF/zilf/zilf-0.11.1/bin/Debug/net8.0/zapf.runtimeconfig.json /usr/local/bin
% cp /Users/macbook/Downloads/ZILF/zilf/zilf-0.11.1/bin/Debug/net8.0/Zapf.Parsing.dll /usr/local/bin
% cp /Users/macbook/Downloads/ZILF/zilf/zilf-0.11.1/bin/Debug/net8.0/Zilf.Common.dll /usr/local/bin

Using the online toolchain

I tried installing an Ubuntu 24.04.3 LTS VM on VirtualBox, but my Mac slowed to a crawl.

Before I managed to get dotnet v8 working (see above), I ended up just using the online parser at zilf.io - New Project, which works well. At least the code below is now typo free!

Code

(If you have read everything this far, very well done!)

This is the ZIL port of the TinyTextAdventure, tenline.zil:

"A reasonably faithful ZIL port of the impressively compact
TENLINER CAVE ADVENTURE by Einar Saukas, originally published
in ZX81 BASIC, later translated to BASIC 2.0 by Robin Harbron.
The 0/0 RUN bit is a throwback to the ZX81 experience. Some
efforts made to keep the game authentic, but modern conveniences
like being able to see the chest and corpse wothout searching
the room are allowed. The fanciest bit of coding by far
(thank you Jesse) is the DESCFCN used to suppress display of
the key, which is later cleared so that any item ut back on the 
corpse doesn't vanish from sight. I hope that you find this useful.
- Jason"

"Tenliner Cave Adventure main file"

<VERSION ZIP>
<CONSTANT RELEASED 1>

"Main loop"

<CONSTANT GAME-BANNER
"Tenliner Cave Adventure|
A ZILF learning experience in way more than 10 lines.|
Original game by Einar Saukas|
ZIL conversion by jcompton"
>

<INSERT-FILE "parser">

<ROUTINE GO ()
    <CRLF> <CRLF>
    <TELL "0/0 RUN" CR CR>
    <INIT-STATUS-LINE>
    <V-VERSION> <CRLF>
    <SETG HERE ,CAVE>
    <MOVE ,PLAYER ,HERE>
    <V-LOOK>
    <MAIN-LOOP>
>

"Objects"
   
<OBJECT SWORD
    (DESC "sword")
    (SYNONYM SWORD)
    (IN CHEST)
    (FLAGS TAKEBIT)>
    
<OBJECT CHEST
    (DESC "chest")
    (IN PIT)
    (SYNONYM CHEST)
    (ACTION CHEST-R)
    (FLAGS CONTBIT OPENABLEBIT LOCKEDBIT)>
    
<OBJECT KEY
    (DESC "key")
    (SYNONYM KEY)
    (IN CORPSE)
    (FLAGS TAKEBIT)
    (ACTION KEY-R)
    >
    
<OBJECT CORPSE
    (DESC "corpse")
    (IN LAKE)
    (SYNONYM CORPSE)
    (FLAGS SURFACEBIT CONTBIT OPENBIT)
    (DESCFCN CORPSE-DESC-F)>
    
<OBJECT DRAGON
    (DESC "dragon")
    (SYNONYM DRAGON)
    (IN HALL)
    (ACTION DRAGON-R)>
    
"Rooms. In the original BASIC room descriptions were constant, and minimlaist,
so let's replicate that behaviour. These do look weird in the status line if
you're an experienced player, but they get the point across."

<ROOM CAVE
    (DESC "you are in a cave.")
    (IN ROOMS)
    (NORTH TO HALL)
    (FLAGS LIGHTBIT)>
    
<ROOM HALL
    (DESC "You are in a hall.")
    (IN ROOMS)
    (SOUTH TO CAVE)
    (FLAGS LIGHTBIT)
    (EAST TO PIT)>
    
<ROOM PIT
    (DESC "You are in a pit.")
    (IN ROOMS)
    (WEST TO HALL)
    (NORTH TO LAKE)
    (FLAGS LIGHTBIT)>
    
<ROOM LAKE
    (DESC "You are in a lake.")
    (IN ROOMS)
    (SOUTH TO PIT)
    (FLAGS LIGHTBIT)>
    
"Routines. We have to do a few things to make it a game."

"You win by killing the dragon with the sword. If you  try killing him without, he kills you."

<ROUTINE DRAGON-R ()
    <COND (<VERB? ATTACK>
      <COND (<HELD? ,SWORD>
        <SETG SCORE <+ ,SCORE 10>>
        <TELL "You won." CR>
        <REMOVE ,DRAGON>
        <TELL "Your score is " N ,SCORE " of a possible 10, in " N ,MOVES " moves.">
          <V-QUIT>
        <TELL "Too bad." CR> <QUIT> <RFALSE>
            )
            (ELSE <JIGS-UP "You died.">
                  <TELL CR>
                  <V-QUIT>
            )
        >
    ) >   
>

"The key unlocks the chest, so we'll clear the lockedbit and get out of here."
    

<ROUTINE CHEST-R ()
        <COND (<VERB? OPEN>
               <COND (<HELD? ,KEY>
                      <FCLEAR , CHEST ,LOCKEDBIT>
                      <RFALSE>
                     )
                >
              )
        >
>

"In the original game, you had to LOOK in a room to notice the dragon, chest,
an the corpse and then you had to LOOK CORPSE to see the key and LOOK CHEST
after opeing it to notice tht it contins a sword. The default behaviouer of the ZILF libraries will display all of these objects as part of the room
description. I ecided that it was okay to display the dragon, chest, corpse,
and sword, but I wanted the key to stay hiden untuil the player expressly
exmined the corpse, while also allowing it to just be taken blindly, since the
BASIC game allowed that. To accomplish all this, we use a DESCFCN to force the 
game to only tell use that there's a corpse, even though it starts with a key
on it."

<ROUTINE CORPSE-DESC-F (ARG)
    <COND (<EQUAL? .ARG ,M-OBJDESC?> <RTRUE>)>
    <TELL "There is a corpse here." CR>
>

"When we get the key, we know the corpse can hold objects. So, let's stop
hiding objects with that DESCFCN by cleaing that property to False <>. Now
the game will decribe any objects we put back on the corpse."

<ROUTINE KEY-R ()
<COND (<VERB? TAKE>
<COND (<NOT <EQUAL? <GETP ,CORPSE ,P?DESCFCN> <> > >
<PUTP ,CORPSE ,P?DESCFCN <> >
<RFALSE>
) > ) > >

"And that's all there is to it."

`zilf` for Catalina

The working `zilf`

I made a compressed split tar file, of the built zilf-0.11.1/bin/Debug/net8.0/ directory:

tar cvzf - net8.0/ | split -b 20m - zilf_net8.0.tar.gz

To extract

cat zilf_net8.0.tar.gz.* | tar xzvf -

However, the zilf-0.11.1/zillib/ directory is also required. So...? There may be other files/directories required, so it is probably better to use the provided tools to create a package instead...

Reference

Create a tar archive split into blocks of a maximum size.

Making a package

There is a PowerShell script make-macos-package.ps1, to create a Mac package. I installed pwsh via brew as this page recommends, Install PowerShell on macOS

Taking the code from zilf-0.11.1/.github/workflows/build-packages.yml:

cd zilf-0.11.1
sudo gem install fpm
pwsh ./tools/package-all.ps1 -RuntimeIdentifiers osx-arm64 -Configuration Release
pwsh ./tools/make-macos-package.ps1 -Source Package/Release/Stage/zilf-$env:ZILF_LONG_VERSION-osx-arm64 -Destination Package/Release/Packages -Version $env:ZILF_LONG_VERSION -Arch arm64

However pwsh gives an error:

Failed to load /usr/local/microsoft/powershell/7/libhostfxr.dylib, error: dlopen(/usr/local/microsoft/powershell/7/libhostfxr.dylib, 1): Symbol not found: __ZNSt3__113basic_filebufIcNS_11char_traitsIcEEE4openEPKcj
  Referenced from: /usr/local/microsoft/powershell/7/libhostfxr.dylib (which was built for Mac OS X 12.0)
  Expected in: /usr/lib/libc++.1.dylib

The library libhostfxr.dylib was found, but loading it from /usr/local/microsoft/powershell/7/libhostfxr.dylib failed
  - Installing .NET prerequisites might help resolve this problem.
     https://go.microsoft.com/fwlink/?linkid=2063366
Failed to resolve libhostfxr.dylib [/usr/local/microsoft/powershell/7/libhostfxr.dylib]. Error code: 0x80008082

It's the ol' "built for macOS 12" issue raising its ugly head, yet again. An earlier build of pwsh might work, instead of using the brew version. Or macports could provide a still supported version.

I gave up at this point. At least zilf is working and building .zil files.

Fixed source code

The easiest solution seemed to be to just fix the source code, to make it compatible with dotnet v8, instead of v9.

I have placed this modified source code in xtras/src as both a .zip and as a .tar.gz.

You can compress it and build it, using dotnet v8, with the following command:

dotnet build Zilf.sln

You will still need to set the three environment variables first, though (as well as installing dotnet):

% export DOTNET_ROOT=~/Downloads/ZILF/zilf/dotnet-sdk-8.0.417-osx-x64
% export PATH=$PATH:~/Downloads/ZILF/zilf/dotnet-sdk-8.0.417-osx-x64
% export PATH=$PATH:~/Downloads/ZILF/zilf/zilf-0.11.1/bin/debug/net8.0

Reference

How do I tar a directory of files and folders without including the directory itself?

Creating, compressing and extracting the zilf tar file:

# Creation
% tar cvvf zilf-0.11.1.catalina_dotnet8.1.tar -C zilf-0.11.1.catalina_dotnet8.1 .
% gzip -9 zilf-0.11.1.catalina_dotnet8.1.tar
# Extraction
% mkdir zilf-0111
% tar -C zilf-0111 -xf zilf-0.11.1.catalina_dotnet8.1.tar.gz

Makefile

This makefile does the following:

installs, or removes, dotnet in your home directory, ~/
installs, or removes, the ZILF source code for Catalina
builds the ZILF/ZAPF binaries
installs, or removes, all of the required ZILF and ZAPF files to /usr/local/bin

PROGRAM               = zilf

#INSTALL_DIR           = ~/
INSTALL_DIR           = ~/ZILF/
#INSTALL_DIR           = ~/Downloads/
#INSTALL_DIR           = ~/Downloads/ZILF/

DOTNET                = dotnet

DOTNET_DIR            = $(INSTALL_DIR)$(DOTNET)/

ZIL                   = zil

#ZIL_VERSION           = 0.11.1
ZIL_VERSION           = 1.4

ZIL_DIR               = $(INSTALL_DIR)$(ZIL)/

SRCS                  = Zilf.sln

RM                    = rm

CURL                  = curl

TAR                   = tar

UNZIP                 = unzip

MAKE                  = make

DEST                  = /usr/local/bin/

#ZILF_SRC_DIR          = /Users/macbook/Downloads/ZILF/zilf-0.11.1
ZILF_SRC_DIR          = $(ZIL_DIR)

DOTNET_BUILD          = $(ZILF_SRC_DIR)/bin/Debug/net8.0/

ZILF_SRC_DIR_ZILLIB   = $(ZILF_SRC_DIR)/zillib/

DEST_ZILLIB           = $(DEST)/zillib

all:            
		$(MAKE) install

everything:            
		$(MAKE) install_dotnet8
		$(MAKE) install_zil
		$(MAKE) $(PROGRAM)
		$(MAKE) install
		$(MAKE) install_zilf14

$(PROGRAM):	$(ZIL_DIR)$(SRCS)
		$(DOTNET) build $(ZIL_DIR)$(SRCS)
		$(DOTNET_BUILD)$(PROGRAM) --version

install:         
		$(MAKE) install_zilf
		$(MAKE) install_zapf
		$(MAKE) install_common
		$(MAKE) install_zillib

clean:         
		$(MAKE) clean_zilf
		$(MAKE) clean_zapf
		$(MAKE) clean_common
		$(MAKE) clean_zillib

path_msg:         
		@echo 'Remeber to set .NET paths'
		export DOTNET_ROOT=$(DOTNET_DIR)
		export PATH=$$PATH:$(DOTNET_DIR)
		export PATH=$$PATH:$(ZIL_DIR)bin/Debug/net8.0

install_zil_zip:
		$(CURL) -JLo $(ZIL).zip https://github.com/greenonline/TinyTextAdventure_in_ZIL/raw/refs/heads/main/xtras/src/zilf-0.11.1.catalina_dotnet8.1.zip
		mkdir -p $(ZIL_DIR)
		$(UNZIP) -d $(ZIL_DIR) $(ZIL).zip
		$(RM) $(ZIL).zip

install_zil:
		#$(CURL) -JLo $(ZIL).tar.gz https://github.com/greenonline/TinyTextAdventure_in_ZIL/raw/refs/heads/main/xtras/src/zilf-0.11.1.catalina_dotnet8.1.tar.gz
		$(CURL) -JLo $(ZIL).tar.gz https://github.com/greenonline/TinyTextAdventure_in_ZIL/raw/refs/heads/main/xtras/src/zilf-$(ZIL_VERSION).catalina_dotnet8.1.tar.gz
		mkdir -p $(ZIL_DIR)
		$(TAR) -C $(ZIL_DIR) -xf $(ZIL).tar.gz
		$(RM) $(ZIL).tar.gz

clean_zil:
		$(RM) -rf $(ZIL_DIR)

install_dotnet8:
		$(CURL) -Lo $(DOTNET).tar.gz https://builds.dotnet.microsoft.com/dotnet/Sdk/8.0.417/dotnet-sdk-8.0.417-osx-x64.tar.gz
		mkdir -p $(DOTNET_DIR)8
		$(TAR) -C $(DOTNET_DIR)8 -xf $(DOTNET).tar.gz
		$(RM) $(DOTNET).tar.gz
		export DOTNET_ROOT=$(DOTNET_DIR)8
		export PATH=$$PATH:$(DOTNET_DIR)8
		$(DOTNET) --version

install_dotnet7:
		$(CURL) -Lo $(DOTNET).tar.gz https://builds.dotnet.microsoft.com/dotnet/Sdk/7.0.410/dotnet-sdk-7.0.410-osx-x64.tar.gz
		mkdir -p $(DOTNET_DIR)7
		$(TAR) -C $(DOTNET_DIR)7 -xf $(DOTNET).tar.gz
		$(RM) $(DOTNET).tar.gz
		export DOTNET_ROOT=$(DOTNET_DIR)7
		export PATH=$$PATH:$(DOTNET_DIR)7
		$(DOTNET) --version

install_dotnet6:
		$(CURL) -Lo $(DOTNET).tar.gz https://builds.dotnet.microsoft.com/dotnet/Sdk/6.0.428/dotnet-sdk-6.0.428-osx-x64.tar.gz
		mkdir -p $(DOTNET_DIR)6
		$(TAR) -C $(DOTNET_DIR)6 -xf $(DOTNET).tar.gz
		$(RM) $(DOTNET).tar.gz
		export DOTNET_ROOT=$(DOTNET_DIR)6
		export PATH=$$PATH:$(DOTNET_DIR)6
		$(DOTNET) --version

install_dotnet5:
		$(CURL) -Lo $(DOTNET).tar.gz https://builds.dotnet.microsoft.com/dotnet/Sdk/5.0.408/dotnet-sdk-5.0.408-osx-x64.tar.gz
		mkdir -p $(DOTNET_DIR)5
		$(TAR) -C $(DOTNET_DIR)5 -xf $(DOTNET).tar.gz
		$(RM) $(DOTNET).tar.gz
		export DOTNET_ROOT=$(DOTNET_DIR)5
		export PATH=$$PATH:$(DOTNET_DIR)5
		$(DOTNET) --version

install_dotnet3:
		$(CURL) -Lo $(DOTNET).tar.gz https://builds.dotnet.microsoft.com/dotnet/Sdk/3.0.103/dotnet-sdk-3.0.103-osx-x64.tar.gz
		mkdir -p $(DOTNET_DIR)3
		$(TAR) -C $(DOTNET_DIR)3 -xf $(DOTNET).tar.gz
		$(RM) $(DOTNET).tar.gz
		export DOTNET_ROOT=$(DOTNET_DIR)3
		export PATH=$$PATH:$(DOTNET_DIR)3
		$(DOTNET) --version

clean_dotnet:
		$(RM) -rf $(DOTNET_DIR)

clean_dotnet7:
		$(RM) -rf $(DOTNET_DIR)7

clean_dotnet6:
		$(RM) -rf $(DOTNET_DIR)6

clean_dotnet5:
		$(RM) -rf $(DOTNET_DIR)5

clean_dotnet3:
		$(RM) -rf $(DOTNET_DIR)3

install_zilf:
		cp $(DOTNET_BUILD)zilf $(DEST)
		cp $(DOTNET_BUILD)zilf.dll $(DEST)
		cp $(DOTNET_BUILD)zilf.runtimeconfig.json $(DEST)
		cp $(DOTNET_BUILD)Zilf.Emit.dll $(DEST)
		cp $(DOTNET_BUILD)ReadLine.dll $(DEST)

install_zilf14:
		cp $(DOTNET_BUILD)System.CommandLine.dll $(DEST)

install_zapf:
		cp $(DOTNET_BUILD)/zapf $(DEST)
		cp $(DOTNET_BUILD)/zapf.dll $(DEST)
		cp $(DOTNET_BUILD)/zapf.runtimeconfig.json $(DEST)
		cp $(DOTNET_BUILD)/Zapf.Parsing.dll $(DEST)

install_common:
		cp $(DOTNET_BUILD)/Zilf.Common.dll $(DEST)

install_zillib:
		mkdir -p $(DEST_ZILLIB)
		cp $(ZILF_SRC_DIR_ZILLIB)/parser.zil $(DEST_ZILLIB)
		cp $(ZILF_SRC_DIR_ZILLIB)/verbs.zil $(DEST_ZILLIB)
		cp $(ZILF_SRC_DIR_ZILLIB)/scope.zil $(DEST_ZILLIB)
		cp $(ZILF_SRC_DIR_ZILLIB)/events.zil $(DEST_ZILLIB)
		cp $(ZILF_SRC_DIR_ZILLIB)/orphan.zil $(DEST_ZILLIB)
		cp $(ZILF_SRC_DIR_ZILLIB)/pseudo.zil $(DEST_ZILLIB)
		cp $(ZILF_SRC_DIR_ZILLIB)/pronouns.zil $(DEST_ZILLIB)
		cp $(ZILF_SRC_DIR_ZILLIB)/libmsg.zil $(DEST_ZILLIB)
		cp $(ZILF_SRC_DIR_ZILLIB)/libmsg-defaults.zil $(DEST_ZILLIB)
		cp $(ZILF_SRC_DIR_ZILLIB)/qq.mud $(DEST_ZILLIB)

install_zillib14:
		mkdir -p $(DEST_ZILLIB)
		cp $(ZILF_SRC_DIR_ZILLIB)/hooks.zil $(DEST_ZILLIB)
		cp $(ZILF_SRC_DIR_ZILLIB)/scoring.zil $(DEST_ZILLIB)
		cp $(ZILF_SRC_DIR_ZILLIB)/status.zil $(DEST_ZILLIB)
		cp $(ZILF_SRC_DIR_ZILLIB)/template.zil $(DEST_ZILLIB)

clean_zilf:
		rm $(DEST)/zilf
		rm $(DEST)/zilf.dll
		rm $(DEST)/zilf.runtimeconfig.json
		rm $(DEST)/Zilf.Emit.dll
		rm $(DEST)/ReadLine.dll

clean_zilf14:
		rm $(DEST)System.CommandLine.dll

clean_zapf:
		rm $(DEST)/zapf
		rm $(DEST)/zapf.dll
		rm $(DEST)/zapf.runtimeconfig.json
		rm $(DEST)/Zapf.Parsing.dll

clean_common:
		rm $(DEST)/Zilf.Common.dll

clean_zillib:
		rm $(DEST_ZILLIB)/parser.zil
		rm $(DEST_ZILLIB)/verbs.zil
		rm $(DEST_ZILLIB)/scope.zil
		rm $(DEST_ZILLIB)/events.zil
		rm $(DEST_ZILLIB)/orphan.zil
		rm $(DEST_ZILLIB)/pseudo.zil
		rm $(DEST_ZILLIB)/pronouns.zil
		rm $(DEST_ZILLIB)/libmsg.zil
		rm $(DEST_ZILLIB)/libmsg-defaults.zil
		rm $(DEST_ZILLIB)/qq.mud
		rmdir $(DEST_ZILLIB)

clean_zillib14:
		rm $(DEST_ZILLIB)/hooks.zil
		rm $(DEST_ZILLIB)/scoring.zil
		rm $(DEST_ZILLIB)/status.zil
		rm $(DEST_ZILLIB)/template.zil

To install dotnet v8

make install_dotnet

To remove dotnet v8

make clean_dotnet

To install zilf v0.11.1 source code for Catalina

make install_zil

To remove zilf v0.11.1 source code for Catalina

make clean_zil

To build zilf binaries

make zilf

To install the built files to /usr/local/bin/, enter one of the following lines:

make
make all
make install

To remove:

make clean

References

Additional issues?

Upon attempting to compile Collosal Caves, AKA advent, i.e. advent.zil, I found some new issues, when using a /usr/local/bin install, rather than the build directory:

% zilf advent.zil
ZILF 0.11.1 built 08/02/2026 19:37:13
[error MDL0200] /Users/macbook/Documents/TandT/ZIL/advent.zil:217: calling unassigned atom: SCORING-ACHIEVEMENTS

[error MDL0112] /Users/macbook/Documents/TandT/ZIL/advent.zil:4066: too many prepositions in syntax definition
    [info MDL0101] did you mean to separate them with OBJECT?

[error MDL0604] /Users/macbook/Documents/TandT/ZIL/hints.zil:3: USE: file not found: HOOKS
  in INSERT-FILE called at /Users/macbook/Documents/TandT/ZIL/advent.zil:4787
[error MDL0200] /Users/macbook/Documents/TandT/ZIL/hints.zil:74: calling unassigned atom: ADD-FINISHER
  in INSERT-FILE called at /Users/macbook/Documents/TandT/ZIL/advent.zil:4787
4 errors

Possibly due to missing zillib/ files?

Maybe not, as I also got the same errors if using the build directory

% /Users/macbook/Downloads/ZILF/zilf-0.11.1/bin/Debug/net8.0/zilf advent.zil
ZILF 0.11.1 built 08/02/2026 19:37:13
[error MDL0200] /Users/macbook/Documents/TandT/ZIL/advent.zil:217: calling unassigned atom: SCORING-ACHIEVEMENTS

[error MDL0112] /Users/macbook/Documents/TandT/ZIL/advent.zil:4066: too many prepositions in syntax definition
    [info MDL0101] did you mean to separate them with OBJECT?

[error MDL0604] /Users/macbook/Documents/TandT/ZIL/hints.zil:3: USE: file not found: HOOKS
  in INSERT-FILE called at /Users/macbook/Documents/TandT/ZIL/advent.zil:4787
[error MDL0200] /Users/macbook/Documents/TandT/ZIL/hints.zil:74: calling unassigned atom: ADD-FINISHER
  in INSERT-FILE called at /Users/macbook/Documents/TandT/ZIL/advent.zil:4787
4 errors

Likewise, cloak.zil gave me an error:

[error MDL0200] /Users/macbook/Documents/TandT/ZIL/cloak.zil:64: calling unassigned atom: SCORING-ACHIEVEMENTS

However, dragon.zil built with no errors, and resulted in a .z4 file.

From the Change log there are five releases after 0.11.1, so I just have an out-of-date build of the zilf source code:

Scoring was added in v1.4
QQ was in v0.10

As will be seen below, installing zilf v1.4 allows the other sample code to be compiled without issue.

Playing a game

For Catalina, Gargoyle, v2023.1, use gargoyle-2023.1-mac-x64-mojave.dmg. However, it made the fans of my MBP race within seconds of launching.

I found Spatterlight to be a lot more lightweight, w.r.t. the fan speed. Spatterlight v1.4.6 is my go-to ZILF runner.

Fixing Zilf 1.4

Making Zilf 1.4 "compatible" with dotnet v8...

15 errors:

Change target from net10.0 to net8.0 in the following files:

Zilf.Common.csproj
Zilf.Tests.Integration.csproj
Dezapf.csproj
Zilf.Emit.csproj
Zilf.Emit.Tests.csproj
Zapf.Parsing.csproj
ZilfAnalyzers.csproj
Zilf.Playground.csproj
Zilf.Tests.csproj
Dezapf.Tests.csproj
Zilf.csproj
Zapf.Tests.csproj
WindowsInstaller.csproj
Zilf.Common.Tests.csproj
Zapf.csproj
ZilfAnalyzers.Test.csproj

4 errors:

The entries for WebAssembly, WebAssembly.DevServer and WebUtilities refer to 10.0. Change to 8.0 in the following files:

Zilf.Playground.csproj

4 errors:

LangVersion needs to change from 13 to 12, in the following files:

Directory.Build.props

Builds with zero errors, but one (supressed) warning:

/Users/macbook/Downloads/ZILF/zilf-1.4/test/Zilf.Tests.Integration/FyreHelper.cs(351,28): warning CS1998: This async method lacks 'await' operators and will run synchronously. Consider using the 'await' operator to await non-blocking API calls, or 'await Task.Run(...)' to do CPU-bound work on a background thread. [/Users/macbook/Downloads/ZILF/zilf-1.4/test/Zilf.Tests.Integration/Zilf.Tests.Integration.csproj]
    1 Warning(s)

Fortunately, dragon.zil still builds, and now cloak.zil and advent.zil do too, without the errors seen with zilf 0.11.1

Moving v1.4 to `/usr/local/bin/`

`zilf`

zilf v1.4 requires an additonal file, System.CommandLine.dll, to be copied over to /usr/local/bin/

cp ~/ZILF/zil//bin/Debug/net8.0/System.CommandLine.dll /usr/local/bin/

Makefile

install_zilf14:
		cp $(DOTNET_BUILD)System.CommandLine.dll $(DEST)

clean_zilf14:
		rm $(DEST)System.CommandLine.dll

`zillib`

Additional files in zillib for v1.4: hooks.zil, scoring.zil, status.zil

template.zil

cp

Makefile

install_zillib14:
		mkdir -p $(DEST_ZILLIB)
		cp $(ZILF_SRC_DIR_ZILLIB)/hooks.zil $(DEST_ZILLIB)
		cp $(ZILF_SRC_DIR_ZILLIB)/scoring.zil $(DEST_ZILLIB)
		cp $(ZILF_SRC_DIR_ZILLIB)/status.zil $(DEST_ZILLIB)
		cp $(ZILF_SRC_DIR_ZILLIB)/template.zil $(DEST_ZILLIB)

clean_zillib14:
		rm $(DEST_ZILLIB)/hooks.zil
		rm $(DEST_ZILLIB)/scoring.zil
		rm $(DEST_ZILLIB)/status.zil
		rm $(DEST_ZILLIB)/template.zil

Issues with Zork1

However, building zork1.zil fails against zilf v1.4:

% /Users/macbook/Downloads/ZILF/zilf-1.4/bin/Debug/net8.0/zilf zork1.zil 
ZILF 1.4 built 10/02/2026 05:16:48
Renovated ZORK I: The Great Underground Empire
[warning ZIL0410] /Users/macbook/Documents/TandT/ZIL/zilf-branch-default-sample-zork1/sample/zork1/1DUNGEON.zil:1011: ZSCII 9 (tab) cannot safely be printed in Z-machine version 3
[warning ZIL0410] /Users/macbook/Documents/TandT/ZIL/zilf-branch-default-sample-zork1/sample/zork1/1DUNGEON.zil:1073: ZSCII 9 (tab) cannot safely be printed in Z-machine version 3
28 warnings (26 suppressed)
ZAPF 1.4
Reading zork1.zap
Reading zork1_freq.zap
Reading zork1_data.zap
Reading zork1_str.zap
Measuring..
error: required global symbol 'WORDS' is missing

Failed (1 error)

Although it seems to build for 0.11.1

% zilf zork1.zil                                                        
ZILF 0.11.1 built 08/02/2026 19:37:13
Renovated ZORK I: The Great Underground Empire
[warning ZIL0410] /Users/macbook/Documents/TandT/ZIL/zilf-branch-default-sample-zork1/sample/zork1/1DUNGEON.zil:1011: ZSCII 9 (tab) cannot be safely printed in Z-machine version 3
[warning ZIL0410] /Users/macbook/Documents/TandT/ZIL/zilf-branch-default-sample-zork1/sample/zork1/1DUNGEON.zil:1073: ZSCII 9 (tab) cannot be safely printed in Z-machine version 3
28 warnings (26 suppressed)

Although it had failed previously against 0.11.1. A combination of 0.11.1, then 1.4 and then 0.11.1 again, seems to make it build(???):

% zilf zork1.zil 
ZILF 0.11.1 built 08/02/2026 19:37:13
Renovated ZORK I: The Great Underground Empire
[warning ZIL0410] /Users/macbook/Documents/TandT/ZIL/zilf-branch-default-sample-zork1/sample/zork1/1DUNGEON.zil:1011: ZSCII 9 (tab) cannot be safely printed in Z-machine version 3
[warning ZIL0410] /Users/macbook/Documents/TandT/ZIL/zilf-branch-default-sample-zork1/sample/zork1/1DUNGEON.zil:1073: ZSCII 9 (tab) cannot be safely printed in Z-machine version 3
file not found: FastHashSet, Version=0.1.0.0, Culture=neutral, PublicKeyToken=null
% /Users/macbook/Downloads/ZILF/zilf-1.4/bin/Debug/net8.0/zilf zork1.zil 
ZILF 1.4 built 10/02/2026 05:16:48
Renovated ZORK I: The Great Underground Empire
[warning ZIL0410] /Users/macbook/Documents/TandT/ZIL/zilf-branch-default-sample-zork1/sample/zork1/1DUNGEON.zil:1011: ZSCII 9 (tab) cannot safely be printed in Z-machine version 3
[warning ZIL0410] /Users/macbook/Documents/TandT/ZIL/zilf-branch-default-sample-zork1/sample/zork1/1DUNGEON.zil:1073: ZSCII 9 (tab) cannot safely be printed in Z-machine version 3
28 warnings (26 suppressed)
ZAPF 1.4
Reading zork1.zap
Reading zork1_freq.zap
Reading zork1_data.zap
Reading zork1_str.zap
Measuring..
error: required global symbol 'WORDS' is missing

Failed (1 error)
% zilf zork1.zil                                                        
ZILF 0.11.1 built 08/02/2026 19:37:13
Renovated ZORK I: The Great Underground Empire
[warning ZIL0410] /Users/macbook/Documents/TandT/ZIL/zilf-branch-default-sample-zork1/sample/zork1/1DUNGEON.zil:1011: ZSCII 9 (tab) cannot be safely printed in Z-machine version 3
[warning ZIL0410] /Users/macbook/Documents/TandT/ZIL/zilf-branch-default-sample-zork1/sample/zork1/1DUNGEON.zil:1073: ZSCII 9 (tab) cannot be safely printed in Z-machine version 3
28 warnings (26 suppressed)
%

The required global symbol 'WORDS' is missing issue is mentioned here, ZILCH-How-to:

error: required global symbol 'WORDS' is missing

Failed (1 error)

OK, create an empty frequent words file:

C:\storage\project\if\zilch.github\out># type zork2word.xzap


;word frequency table of 96 most common words

WORDS:: .TABLE
        .ENDT

        .ENDI

Add a new first line to ZORK2.ZAP:

        .INSERT "ZORK2WORD"

The file zillib/tests/testing.zil contains the line

    <SET WORDS

However, copying over the contents of zillib/tests/ to /usr/local/bin/zillib/ did not resolve the 'WORDS' issue.

However, following the quoted instructions above by creating a words4zork1.zap file and putting in it

;word frequency table of 96 most common words

WORDS:: .TABLE
        .ENDT

        .ENDI

and adding the following line to the start of zork1.zap

        .INSERT "words4zork1"

actually works and zork1.z3 was created:

% zapf zork1.zap 
ZAPF 1.4
Reading zork1.zap
Reading words4zork1.zap
Reading zork1_freq.zap
Reading zork1_data.zap
Reading zork1_str.zap
Measuring..
Assembling
Wrote 96972 bytes to zork1.z3

It would be nice to add a .zil file containing a fix for the missing 'WORDS', rather than having to "hack" a compiled .zap file. After some random experimentation, and seeing the contents of gmain.zil, I found that adding the following line in zork1.zil fixed the issue:

<GLOBAL WORDS <>>

`sed` script to change the `dotnet` target

#!/bin/sh

# Name: sed_for_zilf1.4.sh
# Works on zilf *source code* version 1.4
# Changes the "target framework" VERSION from 10 to whatever value you want:
#VERSION="8"   # Works well
VERSION="7"   # Some bugs
#VERSION="6"   # Not tested
#VERSION="5"   # Not tested
#VERSION="3"   # Not tested



subst () {
  FILE=$1
  sed -i -e "s/<TargetFramework>net.\{1,\}\.0<\/TargetFramework>/<TargetFramework>net${VERSION}.0<\/TargetFramework>/" "${FILE}"
} 

subst_s () {
  FILE=$1
  sed -i -e "s/<TargetFrameworks>net.\{1,\}\.0<\/TargetFrameworks>/<TargetFrameworks>net${VERSION}.0<\/TargetFrameworks>/" "${FILE}"
} 

subst_src () {
  PART=$1
  FILE="${ZILF_SRC_DIR}src/${PART}/${PART}.csproj"
  subst "${FILE}"
} 

subst_src_analyzers () {
  PART=$1
  FILE="${ZILF_SRC_DIR}src/Analyzers/${PART}/${PART}.csproj"
  subst "${FILE}"
} 

subst_test () {
  PART=$1
  FILE="${ZILF_SRC_DIR}test/${PART}/${PART}.csproj"
  subst "${FILE}"
} 

# <TargetFramework>net8.0</TargetFramework>

ZIL="zil"
#LANG_VERSION="12"  # For dotnet v8
LANG_VERSION="11"  # For dotnet v7
INSTALL_DIR="~/ZILF/"
INSTALL_DIR="/Users/macbook/ZILF/"
DOTNET="dotnet"
DOTNET_DIR="${INSTALL_DIR}${DOTNET}/"
ZILF_SRC_DIR="${INSTALL_DIR}${ZIL}/"
DOTNET_BUILD="${ZILF_SRC_DIR}/bin/Debug/net${VERSION}.0/"

#FILE="ZilfAnalyzers.csproj"

#sed -i -e 's/<TargetFramework>net8.0<\/TargetFramework>/<TargetFramework>net${VERSION}.0<\/TargetFramework>/' ZilfAnalyzers.csproj
#sed -i -e "s/<TargetFramework>net.\{1,\}\.0<\/TargetFramework>/<TargetFramework>net${VERSION}.0<\/TargetFramework>/" "${FILE}"

#
# Start here - src
#

PART="Zilf.Common"
#FILE="${ZILF_SRC_DIR}src/${PART}/${PART}.csproj"
#sed -i -e "s/<TargetFramework>net.\{1,\}\.0<\/TargetFramework>/<TargetFramework>net${VERSION}.0<\/TargetFramework>/" "${FILE}"

subst_src "${PART}"

PART="Dezapf"
#FILE="${ZILF_SRC_DIR}src/${PART}/${PART}.csproj"
#sed -i -e "s/<TargetFramework>net.\{1,\}\.0<\/TargetFramework>/<TargetFramework>net${VERSION}.0<\/TargetFramework>/" "${FILE}"

subst_src "${PART}"

PART="Zilf.Emit"
#FILE="${ZILF_SRC_DIR}src/${PART}/${PART}.csproj"
#sed -i -e "s/<TargetFramework>net.\{1,\}\.0<\/TargetFramework>/<TargetFramework>net${VERSION}.0<\/TargetFramework>/" "${FILE}"

subst_src "${PART}"

PART="Zapf.Parsing"
#FILE="${ZILF_SRC_DIR}src/${PART}/${PART}.csproj"
#sed -i -e "s/<TargetFramework>net.\{1,\}\.0<\/TargetFramework>/<TargetFramework>net${VERSION}.0<\/TargetFramework>/" "${FILE}"

subst_src "${PART}"

PART="Zilf.Playground"
#FILE="${ZILF_SRC_DIR}src/${PART}/${PART}.csproj"
#sed -i -e "s/<TargetFramework>net.\{1,\}\.0<\/TargetFramework>/<TargetFramework>net${VERSION}.0<\/TargetFramework>/" "${FILE}"

subst_src "${PART}"

PART="Zilf"
#FILE="${ZILF_SRC_DIR}src/${PART}/${PART}.csproj"
#sed -i -e "s/<TargetFramework>net.\{1,\}\.0<\/TargetFramework>/<TargetFramework>net${VERSION}.0<\/TargetFramework>/" "${FILE}"

subst_src "${PART}"

PART="WindowsInstaller"
FILE="${ZILF_SRC_DIR}src/${PART}/${PART}.csproj"
sed -i -e "s/<TargetFramework>net.\{1,\}\.0-windows<\/TargetFramework>/<TargetFramework>net${VERSION}.0-windows<\/TargetFramework>/" "${FILE}"

#subst_src "${PART}"

PART="Zapf"
#FILE="${ZILF_SRC_DIR}src/${PART}/${PART}.csproj"
#sed -i -e "s/<TargetFramework>net.\{1,\}\.0<\/TargetFramework>/<TargetFramework>net${VERSION}.0<\/TargetFramework>/" "${FILE}"

subst_src "${PART}"

#
# Start here - src/Analyzers
#

PART="ZilfAnalyzers"
#FILE="${ZILF_SRC_DIR}src/Analyzers/${PART}/${PART}.csproj"
#sed -i -e "s/<TargetFramework>net.\{1,\}\.0<\/TargetFramework>/<TargetFramework>net${VERSION}.0<\/TargetFramework>/" "${FILE}"

subst_src_analyzers "${PART}"

PART="ZilfAnalyzers.Test"
FILE="${ZILF_SRC_DIR}src/Analyzers/${PART}/${PART}.csproj"
#sed -i -e "s/<TargetFrameworks>net.\{1,\}\.0<\/TargetFrameworks>/<TargetFrameworks>net${VERSION}.0<\/TargetFrameworks>/" "${FILE}"

#subst_src_analyzers "${PART}"
subst_s "${FILE}"

#
# Start here - test
#

PART="Zilf.Tests.Integration"
#FILE="${ZILF_SRC_DIR}test/${PART}/${PART}.csproj"
#sed -i -e "s/<TargetFramework>net.\{1,\}\.0<\/TargetFramework>/<TargetFramework>net${VERSION}.0<\/TargetFramework>/" "${FILE}"

subst_test "${PART}"

PART="Zilf.Emit.Tests"
#FILE="${ZILF_SRC_DIR}test/${PART}/${PART}.csproj"
#sed -i -e "s/<TargetFramework>net.\{1,\}\.0<\/TargetFramework>/<TargetFramework>net${VERSION}.0<\/TargetFramework>/" "${FILE}"

subst_test "${PART}"

PART="Zilf.Tests"
#FILE="${ZILF_SRC_DIR}test/${PART}/${PART}.csproj"
#sed -i -e "s/<TargetFramework>net.\{1,\}\.0<\/TargetFramework>/<TargetFramework>net${VERSION}.0<\/TargetFramework>/" "${FILE}"

subst_test "${PART}"

PART="Dezapf.Tests"
#FILE="${ZILF_SRC_DIR}test/${PART}/${PART}.csproj"
#sed -i -e "s/<TargetFramework>net.\{1,\}\.0<\/TargetFramework>/<TargetFramework>net${VERSION}.0<\/TargetFramework>/" "${FILE}"

subst_test "${PART}"

PART="Zapf.Tests"
#FILE="${ZILF_SRC_DIR}test/${PART}/${PART}.csproj"
#sed -i -e "s/<TargetFramework>net.\{1,\}\.0<\/TargetFramework>/<TargetFramework>net${VERSION}.0<\/TargetFramework>/" "${FILE}"

subst_test "${PART}"

PART="Zilf.Common.Tests"
#FILE="${ZILF_SRC_DIR}test/${PART}/${PART}.csproj"
#sed -i -e "s/<TargetFramework>net.\{1,\}\.0<\/TargetFramework>/<TargetFramework>net${VERSION}.0<\/TargetFramework>/" "${FILE}"

subst_test "${PART}"

#
# Start here - WebAssembly
#

PART="Zilf.Playground"
FILE="${ZILF_SRC_DIR}src/${PART}/${PART}.csproj"

sed -i -e "s/<PackageReference Include=\"Microsoft\.AspNetCore\.Components\.WebAssembly\" Version=\".\{1,\}\.0\.0\" \/>/<PackageReference Include=\"Microsoft.AspNetCore.Components.WebAssembly\" Version=\"${VERSION}.0.0\" \/>/" "${FILE}"

sed -i -e "s/<PackageReference Include=\"Microsoft\.AspNetCore\.Components\.WebAssembly\.DevServer\" Version=\".\{1,\}\.0\.0\" PrivateAssets=\"all\" \/>/<PackageReference Include=\"Microsoft.AspNetCore.Components.WebAssembly.DevServer\" Version=\"${VERSION}.0.0\" PrivateAssets=\"all\" \/>/" "${FILE}"

sed -i -e "s/<PackageReference Include=\"Microsoft\.AspNetCore\.WebUtilities\" Version=\".\{1,\}\.0\.0\" \/>/<PackageReference Include=\"Microsoft.AspNetCore.WebUtilities\" Version=\"${VERSION}.0.0\" \/>/" "${FILE}"


#
# Start here - lang
#

FILE="${ZILF_SRC_DIR}Directory.Build.props"
sed -i -e "s/<LangVersion>.\{1,\}<\/LangVersion>/<LangVersion>${LANG_VERSION}.0<\/LangVersion>/" "${FILE}"


exit;

src/Zilf.Common/Zilf.Common.csproj
src/Dezapf/Dezapf.csproj
src/Zilf.Emit/Zilf.Emit.csproj
src/Zapf.Parsing/Zapf.Parsing.csproj
src/Zilf.Playground/Zilf.Playground.csproj
src/Zilf/Zilf.csproj
src/WindowsInstaller/WindowsInstaller.csproj
src/Zapf/Zapf.csproj
src/Analyzers/ZilfAnalyzers/ZilfAnalyzers.csproj
src/Analyzers/ZilfAnalyzers.Test/ZilfAnalyzers.Test.csproj
test/Zilf.Tests.Integration/Zilf.Tests.Integration.csproj
test/Zilf.Emit.Tests/Zilf.Emit.Tests.csproj
test/Zilf.Tests/Zilf.Tests.csproj
test/Dezapf.Tests/Dezapf.Tests.csproj
test/Zapf.Tests/Zapf.Tests.csproj
test/Zilf.Common.Tests/Zilf.Common.Tests.csproj

Gotchas and conclusion

Use dotnet 8, as it works on Catalina. I used version 8.0.417.

To expand the dotnet compressed file, do not double click the .tar.gz file for dotnet, i.e. dotnet-sdk-8.0.417-osx-x64.tar.gz, as it corrupts the contents. Use gunzip and tar instead. However, you can just double click the zilf-0.11.1.zip file, to expand it.

Remember to set the path to dotnet v8, if compiling, or just using, zilf:

% export DOTNET_ROOT=~/Downloads/ZILF/dotnet-sdk-8.0.417-osx-x64
% export PATH=$PATH:~/Downloads/ZILF/dotnet-sdk-8.0.417-osx-x64

Note: Even when compiled, you still have to set the path and root environment variables of DOTNET, in order to use zilf.

To use zilf in the directory where it was created, rather than /usr/local/bin, update the PATH environment variable:

% export PATH=$PATH:~/Downloads/ZILF/zilf-0.11.1/bin/debug/net8.0

However, to finish off a build, by using zapf, you will need to copy some files to /usr/local/bin/:

% cp /Users/macbook/Downloads/ZILF/zilf/zilf-0.11.1/bin/Debug/net8.0/zapf.dll /usr/local/bin
% cp /Users/macbook/Downloads/ZILF/zilf/zilf-0.11.1/bin/Debug/net8.0/zapf.runtimeconfig.json /usr/local/bin
% cp /Users/macbook/Downloads/ZILF/zilf/zilf-0.11.1/bin/Debug/net8.0/Zapf.Parsing.dll /usr/local/bin
% cp /Users/macbook/Downloads/ZILF/zilf/zilf-0.11.1/bin/Debug/net8.0/Zilf.Common.dll /usr/local/bin

Or just use the makefile to install both zilf and zapf correctly, into /usr/local/bin/.

Name		Name	Last commit message	Last commit date
Latest commit History 40 Commits
xtras		xtras
README.md		README.md
tenline.zil		tenline.zil

Folders and files

Latest commit

History

Repository files navigation

TinyTextAdventure_in_ZIL

Preamble

Links

Vaguely related

Notes

Getting started

ZILF source code

dotnet

How NOT to do it - The "double click" mistake

Using gunzip and tar

Even earlier versions

Installing dotnet using brew

Compiling Zilf!

Target incompatabilities

More incompatability - WebAssembly and WebUtilites

langversion incompatabilities

Success?

Moving everything?

Summary

Running zilf from its build directory

Summary

Using the online toolchain

Code

zilf for Catalina

The working zilf

Reference

Making a package

Fixed source code

Reference

Makefile

References

Additional issues?

Playing a game

Fixing Zilf 1.4

Moving v1.4 to /usr/local/bin/

zilf

zillib

Issues with Zork1

sed script to change the dotnet target

Gotchas and conclusion

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

`dotnet`

Using `gunzip` and `tar`

Installing `dotnet` using `brew`

More incompatability - `WebAssembly` and `WebUtilites`

`langversion` incompatabilities

Running `zilf` from its build directory

`zilf` for Catalina

The working `zilf`

Moving v1.4 to `/usr/local/bin/`

`zilf`

`zillib`

`sed` script to change the `dotnet` target

Packages