Skip to content

Commit ce06ce0

Browse files
committed
Update README for 0.1.0 release.
1 parent 2056251 commit ce06ce0

File tree

1 file changed

+41
-1
lines changed

1 file changed

+41
-1
lines changed

README.md

Lines changed: 41 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,42 @@
1+
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
2+
13
# hll-rcon-log-analyzer
2-
A tool to analyze Hell Let Loose RCON logs to identify interesting or suspicious behavior such as admin camera abuse.
4+
5+
A tool to analyze Hell Let Loose RCON logs to identify interesting or suspicious behavior such as admin camera abuse. Only admin camera abuse is currently implemented.
6+
7+
# Introduction
8+
9+
Currently this only works with log files from the community open source version of RCON found here: https://github.com/MarechJ/hll_rcon_tool
10+
11+
If you run a different version of RCON and would like to use it open a github issue or email me and include some sample logs and I'll work on adding support for it.
12+
13+
Configuration is handled by [TOML](https://toml.io/en/) and command line options.
14+
15+
A sample file you can test the tool with is in `./data/sample_abuse.csv`
16+
17+
# Special Considerations
18+
19+
This tool is not guaranteed to be bug free, if this flags suspicious behavior please manually investigate it before starting a witch hunt. This tool is intended to be an investigative tool, not a definitive judgement.
20+
21+
If your log files start part of the way through a match you may get incorrect or misleading results.
22+
23+
# Installation
24+
25+
1. git clone https://github.com/cemathey/hll-rcon-log-analyzer.git
26+
2. cd hll-rcon-log-analyzer/
27+
3. poetry install
28+
29+
# Configuration
30+
31+
Edit `config/hll_rcon_log_analyzer.toml` as desired. This comes with sensible defaults.
32+
33+
# Running It
34+
35+
- Getting help: `poetry run python src/hll_rcon_log_analyzer/console.py --help`
36+
- Checking a log file: `poetry run python src/hll_rcon_log_analyzer/console.py src/sample_abuse.csv`
37+
- Saving results to a csv file: `poetry run python src/hll_rcon_log_analyzer/console.py --output csv --output-path ./output/bad_people.csv data/sample_abuse.csv`
38+
39+
# Contributing
40+
41+
Please run `nox` and do your best to fix any linting/type checking issues before submitting pull requests.
42+
Tests are great and preferred as well, however currently I have none implemented.

0 commit comments

Comments
 (0)