HLDS logger 💣
HLDS log is nodejs package for advanced usage of remote HLDS server logging.
HLDS log provides you:
- safe text parsing from remote host
- usage of server native events like bomb plants, defuse etc
- event based system
Example of server event invoked by client chat:
log L 05/31/2020 - 11:08:13: "kalle<1><STEAM_ID_LAN><CT>" say "hello"
event: 'say' player: name: 'kalle' id: '1' steamid: 'STEAM_ID_LAN' side: 'CT' message: 'hello' time: ss: '13' mm: '08' hh: '11' date: dd: '31' mm: '05' yy: '2020' Installation
HLDS log requires Node.js v6+ to run.
$ npm install hlds-logOn the server side type
log onlogaddress 127.0.0.1 27050; [remote ip] [port]And thats it.
Supported events
| Event | Supported | Note |
|---|---|---|
| hlds_connect | ✅ | Event fires on first log message from remote server, can be used with Event.once() |
| raw | ✅ | Prints raw server message (default false) |
| kill | ✅ | Event with information about killer and victim |
| say | ✅ | Chat event with sender message and information |
| say_team | ✅ | Team chat event with =|= |
| enter | ✅ | Player connected to server |
| connect | ✅ | Player is fully connected to the server |
| join | ✅ | Player is switching team sides |
| leave | ✅ | Player left the server |
| round_end | ✅ | Indicates that round is over with specific reason ex. mission fail time, bomb explode, hostages rescued, other team is dead... |
| end_score | ✅ | Last message before level is changed, contains team scores. |
| server_action | ✅ | Actions triggered by server which affects every player ex. bomb explode, bomb defused etc |
| player_action | ✅ | Action by player ex bomb pickup, drop, start defusing, stop defusing etc |
| map_change | ✅ | Info who changed map and which map is next |
| map_start | ✅ | Info when map is fully loaded |
| suicide | ✅ | Player makes suicide (some plugins dont respect this type, but it will be implemented) |
| shutdown | ✅ | Signal server shutdown |
| log_off | ✅ | Server stopped logging |
| kick | ✅ | Kick from the server |
| cvarsDone | ✅ | All map cvars on map start (emit after specific time because game server sends randomly cvar values). Also cvars are always availble in Logger.cvarList property to get values. |
Development
Want to contribute? Great! Also leave a ⭐️ if you like this project.
Known bugs
See issues.
Todos
- Write tests
- Write more examples
- Add TypeScript support
License
MIT