Skip to content

robertjanetzko/LegendsBrowser

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published