A logger for the Helix roleplaying framework written in Node.js with Typescript.
- Steam login
- Usergroup whitelist
- MySQL and SQLite support
- SAM, Serverguard and ULX support
- Search filters
- Messages
- Before and after dates
- Steam ID's
- HTTP and HTTPS support
- Mobile friendly
- Download logs contextually
- Docker support
- Rate limiting support
- Contextual logs
- Node.js
- Helix updated since May 11th, 2021
- SQL Helix Plugin
- Redis
- An admin addon. SAM, ServerGuard and ULX are supported.
- Clone the repository
git clone --depth=1 https://github.com/willardnetworks/logs.git <project_name>
- Install dependencies
cd <project_name>
npm install
- Configuration
Rename the .env.example file to .env and fill out the environment variables
| Environment Variable | Description |
|---|---|
| NODE_ENV (production/dev) | Whether we are running in development or production. Enables error logger and sets the domain to localhost in dev. |
| SESSION_SECRET | Secret used for keeping sessions. You should use a random generator for this. |
| WEBSITE_DOMAIN | Your website's domain, used for redirecting to steam. |
| PORT | The port your server listens on. |
| SSL (true/false) | Whether you want the server to use HTTPS, you will need this if you have your SSL mode to full (strict) in cloudflare. |
| SSL_CERT, SSL_KEY | The absolute path of your SSL certificate and key if you are using HTTPS. You can create these with openssl. |
| DATABASE (mysql) | What type of database you have. |
| MYSQL_USER, MYSQL_PASS, MYSQL_HOST, MYSQL_DB |
Login credentials for mysql. |
| MYSQL_SAM | The database name for SAM. |
| ADMIN_MOD (serverguard/ulx) | The admin mod your server uses, currently only ULX and Serverguard are supported. |
| STEAM_KEY | Steam API key, get yours at https://steamcommunity.com/dev/apikey. |
| ALLOWED_RANKS | List of allowed usergroups that can access the server logs, separated by semicolons. |
- Build and run the project
npm run build
npm start
Finally, navigate to http://localhost:3000 and you should see the template being served and rendered locally!
To deploy the app to a web server, simply set it to production and add your own website domain.
IP addresses work too, but you should use a domain to be able to use Cloudflare's DDoS protection).
SSL is strongly recommended, you can combine Cloudflare's full (strict) HTTPS with a self signed certificate using openssl for full end-to-end encryption.
Type npm run debug in your terminal to perform a full build and then server the app in watch mode. npm run watch if you are not using static assets.
VS Code lets you easily run npm scripts from the editor
This is a fork of Helix Logs by itz-coffee