NickMcConnell / FAangband

First Age Angband
http://nickmcconnell.github.io/FAangband/
85 stars 16 forks source link

Readme and Readthedocs suggestions #370

Open bridgesense opened 1 year ago

bridgesense commented 1 year ago

First off, wow - what a gem! It's great to see this still in development. I'm relatively new to Angband in general.

It might be nice to add the documentation link to your readme: https://faangband.readthedocs.io/en/latest/index.html

It might be nice to have links to your site, too: https://rephial.org/

It was when I was able to get this compiled that I found out about either of them. After seeing the forum registration closed, there wasn't any place to ask questions about the compilation process.

Even after following the compilation instructions at https://faangband.readthedocs.io/en/latest/hacking/compiling.html, none of the graphical interface worked well under Linux. Using the CMake option, the additional windows work along with text resizing, which is a plus. I suppose the other terminals can be set up within the game's settings somehow.

Another suggestion for Linux users might be worth noting: the best experience compiling FAangband is using the Makefile.std file. That way, FAangband opens inside the same terminal where text is more easily read with a native font and can be resized on the fly. Most Linux users are likely looking for this more traditional presentation.

cd src
make -f Makefile.std
cd ..
./faangband

For more fun, uncomment lines 51 and 52 in Makefile.std before compiling. When inside the game, press = and turn on the sound. It works.

Here are some useful libraries to install on Ubuntu before compiling:

sudo apt-get install build-essential cmake pkg-config libncurses5 libncurses5-dev libsdl1.2-dev libsdl-mixer1.2-dev libsdl-image1.2-dev libsdl-ttf2.0-dev libsdl-net1.2-dev libsdl-gfx1.2-dev libsdl-sound1.2-dev
NickMcConnell commented 1 year ago

Thanks for this, glad you're enjoying it

bridgesense commented 1 year ago

I finally figured out what I needed to do to compile things the way they were intended, where the -mgcu flag utilizes the system font. I had to install gcc-9.

./autogen.sh
./configure --with-no-install --enable-sdl-mixer --enable-curses CC=gcc-9
make

I'm not sure why the lines 51 and 52 of Makefile.std were commented out, but they might as well be uncommented. The rolling thunder is a nice touch. :)

This is amazing! I love what you did with the wilderness levels. They are super immersive. It's pretty satisfying revisiting them. The difficult starts are challenging.

I'm super curious to find out what plans you have for this next.

bridgesense commented 1 year ago

I'm not sure why the lines 51 and 52 of Makefile.std were commented out, but they might as well be uncommented. The rolling thunder is a nice touch. :)

That's actually not needed. I jus needed to use the right compilation line. My bad.