Skip to content
Legends Browser is an multi-platform, open source, java-based legends viewer for dwarf fortress 0.42.
Java JavaScript CSS
Branch: master
Clone or download

Latest commit

robertjanetzko Merge pull request #61 from McArcady/add-details-for-guilds-and-merce…
…naries

Add details for Entities guilds and mercenaries
Latest commit efd34f5 Mar 16, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.settings change reflections library for java 11 compatibility Jan 5, 2020
src adapt icons to font-awesome v5 Mar 15, 2020
.classpath release 1.18, fixes for 0.47.02, new events Feb 7, 2020
.gitignore Added IntelliJ IDEA project files to .gitignore Mar 10, 2018
.project init Jan 1, 2016
LICENSE.md #9 Add License May 22, 2016
README.md removed deprecated note for exportlegends.lua Feb 25, 2018
pom.xml release 1.18.1 Feb 9, 2020

README.md

Legends Browser

Legends Browser is an multi-platform, open source, java-based legends viewer for dwarf fortress 0.44.

Features

  • Works in the browser of your choice (just launch an open http://localhost:58881)
  • Recreates Legends Mode from dwarf fortress, with objects being accessible as links
  • Add several statistics and overviews
  • supports LNP processed and archived legends_archive.zip

Using Legends Browser

  • Download the latest release from the downloads page https://github.com/robertjanetzko/LegendsBrowser/releases
  • Run the application
  • On Windows run the .exe
  • On MacOS open the .dmg and run the application
  • On other operating systems run java -jar legendsbrowser-x.x.x.jar
  • An browser window should open, if not navigate to http://localhost:58881
  • Open a legends export by navigating your file system
  • ready to load exports should show up in green
  • after loading finished you should see an overview over all civilizations

Command Line Options

-p,--port <arg>     use specific port
-s,--serverMode     run in server mode (disables file chooser)
-u,--subUri <arg>   run on /<subUri>
-w,--world <arg>    path to legends.xml or archive

Important Note

  • some features require the legends_plus.xml from dfhack (run 'exportlegends info')

OutOfMemoryError

  • some legends export can be very large (over 400MB) and require approx twice the amount of memory when loaded
  • if you get an OutOfMemoryError displayed in the console you can manually increase the amount of memory legends browser gets assigned
  • to do so create an file called LegendsBrowser-X.X.X.l4j.ini (the name of your .exe where you replace the ending with .l4j.ini)
  • open that file in an editor and insert -Xmx1024M (you can change the numbers to set the amount of memory you want to assign)

Troubleshooting

You can’t perform that action at this time.