Skip to content

CleyFaye/FOS_View

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Simple Fallout Shelter file viewer in Python.

This is a mere prototype. It allows rendering a vault rooms layout, and a vault family tree.
The original goal was to set up a webservice were people could upload their vault, get a nice URL to show it off and compete in a score-based ladder.
This project might or might not progress according to time constraints and public interest :)

Example of family trees output (sorry, I only have messed up Vaults to test on):
https://imgur.com/a/AS90e

Known bugs:
 * The parser is extremely rigid and is known to work for sure on two test files. Anything more than that is pure luck...
 * Room layout rendering is very primitive, done as a PoC.
 * Family tree rendering is limited by two factors: 
   - families in the vault can be quite messy
   - the save file can actually "lose" some dwellers and replace them with other dwellers having the same ID, causing invalid parents to be picked. There's some safeguard around that that will just show a DEAD dweller...

Known issues (less than a bug, but more than an annoyance):
 * The DEAD dweller thing mentionned above... doesn't show actual relationship between childs sharing a disappeared dweller parent.
 * The code is already very old, and written as a PoC in mere minutes. It quickly derailed in an exercise in doing funky stuff with JSON.
 * Direct consequence is that it's dirty. Like, have a barf bag ready before reading.
 * Other direct consequence is that things kinda stopped in their tracks; while it *works* (sometimes), most of the vault parsing stopped after getting dwellers relationships and room layout.

Requirements:
 * python 2.7 (or more, but no 3.0)
 * python-crypto stuff
 * PIL for the room layout thingy
 * pydot for PNG rendering of the family tree (can otherwise output Graphviz DOT files without any extra dependency)

Usages:
imager.py draws a rough layout of the rooms.
familyplotter.py produce either a graphviz file or a png file. Both takes at least an "--input" parameter indicating the path to the vault file; other than that they have sensible defaults. Full help can be seen using "--help".

About

A prototype of a file viewer for Fallout Shelter vault files in python

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages