- Vote, unvote, and FoS tallies
- Action and ignored action logs
- Player activity percentages
- Per player vote, unvote, FoS logs
- Output in BBCode, JSON, and plain text
- Save game support
- Kill support
- Player replacements
- Player activity rankings
- Web/GUI interface?
- All around more stats
- Citations/quote records
- Charts and graphs
- Overall player history
If it breaks trying to refresh a saved game, delete the save file and retry. This will be fixed for 0.3.
- Settings are re-imported as dicts, not Settings objects
- Abbreviations are seen as new players
- Junk votes are counted
This is a command line tool. I may make a GUI or web wrapper if I have time. You can specify the moderator, the game, and the start/end points where ScumBait will scan a thread.
ScumBait will always load a saved game (threadnumber.game) if there is one. To create a saved game, run with the --json option and no other reports. Save the output in threadid.game. If you don't wish to use saved data, specify --refresh to start anew or specify --start to continue from a given post. Note that you need to specify these
Kills are currently not accounted for. This makes it harder to use for entire games, thus I'd love suggestions on what a reasonable format to expect for a kill is. I've just joined the fora, after all.
ScumBait is written in Python and you'll need to have BeautifulSoup and SimpleJSON. I've included them for convenience. It should run on any OS supporting Python.
Thanks to Kison for contributing code for post IDs. Also, thanks to Surye for offering hosting. The next release minor release (0.3) will be hosted at scumbait.datamachine.net.
Code: Select all
ScumBait 0.2
Copyright 2008 Rob Crowther <weilawei@gmail.com>
This software is Open Source Software.
Please see the LICENSE for more details.
Available options are:
--help or -h: Display this help message
--version or -v: Display version notice
--refresh or -r: Use new data instead of saved game cache
--game or -g: Specify the thread id of the game
--bbcode or -b: Display output in bbcode
--tally or -t: Tally votes
--fos or -f: Tally FoS's
--log or -l: Log of player actions
--ignored or -i: Log of ignored/unrecognized actions
--json or -j: Dump JSON data.
--mod or -m: Specify the game moderator
--start or -s: The post to begin on (defaults to 0)
--end or -e: The post to end on (defaults to end of thread)
--player or -p: Print a report on a player
Sample usage: ./scumbait.py -b -g 10000 -m weilawei -t
This will display a bbcode tally of votes from thread 10000, run by weilawei.
If there is a file named with the game id and extension '.game',
it will be used to load settings and vote data.
To grab vote tally, FoS tally, action log, and stats for all players in game 1000, with moderator Mod:
Code: Select all
python scumbait.py -g 1000 -m Mod -tflp all
To save game 1000 data for quick report generation:
Code: Select all
python scumbait.py -g 1000 -m Mod -rj > 1000.game
To continue game 1000 from post 136:
Code: Select all
python scumbait.py -g 1000 -m Mod -s 136 -tflp all
To grab fresh data for game 1000:
Code: Select all
python scumbait.py -g 1000 -m Mod -rtflp all
To grab game 2000 being moderated by Mr. Mod:
Code: Select all
python scumbait.py -g 2000 -m "Mr. Mod" -tflp all