HLL_CRCON_watch_roles

A plugin for HLL CRCON (https://github.com/MarechJ/hll_rcon_tool) that inform players about the role they took.

• Give general guidance about the current role
• Display a warning to officers who abandon their squad
• Suggest infantry players to take "support" if there isn't enough of them in the team
• You can set a minimum immune level : experienced players won't get any message
• You can send reports about quitting officers in a Discord channel
• Available in 🇫🇷 French, 🇬🇧 English, 🇪🇸 Spanish and 🇩🇪 German

Install

Note

The shell commands given below assume your CRCON is installed in /root/hll_rcon_tool.
You may have installed your CRCON in a different folder.

If so, you'll have to adapt the commands below accordingly.

Log into your CRCON host machine using SSH and enter these commands (one line at at time) :

First part

If you already have installed any other "custom tools" from me, you can may already have :

• a restart.sh file
• a custom_tools/ folder
• a custom_tools/common_functions.py file

If so, please redownload them, as they may have been updated

cd /root/hll_rcon_tool
wget https://raw.githubusercontent.com/ElGuillermo/HLL_CRCON_restart/refs/heads/main/restart.sh

mkdir /root/hll_rcon_tool/custom_tools
cd /root/hll_rcon_tool/custom_tools
wget https://raw.githubusercontent.com/ElGuillermo/HLL_CRCON_custom_common_functions.py/refs/heads/main/common_functions.py

Second part

cd /root/hll_rcon_tool/custom_tools
wget https://raw.githubusercontent.com/ElGuillermo/HLL_CRCON_watch_roles/refs/heads/main/custom_tools/watch_roles.py
wget https://raw.githubusercontent.com/ElGuillermo/HLL_CRCON_watch_roles/refs/heads/main/custom_tools/watch_roles_config.py

Third part

Edit /root/hll_rcon_tool/config/supervisord.conf to add this bot section :

[program:watch_roles]
command=python -m custom_tools.watch_roles
environment=LOGGING_FILENAME=watch_roles_%(ENV_SERVER_NUMBER)s.log
startretries=100
startsecs=10
autostart=true
autorestart=true

Config

Edit /root/hll_rcon_tool/custom_tools/watch_roles_config.py and set the parameters to fit your needs.

Restart CRCON :

cd /root/hll_rcon_tool
sh ./restart.sh

Limitations

⚠️ Plugin config

Any change to these files requires a CRCON rebuild and restart (using the restart.sh script) to be taken in account :

• /root/hll_rcon_tool/custom_tools/common_functions.py
• /root/hll_rcon_tool/custom_tools/watch_roles.py
• /root/hll_rcon_tool/custom_tools/watch_roles_config.py

⚠️ CRCON upgrade

This plugin requires a modification of the /root/hll_rcon_tool/config/supervisord.conf original CRCON file.
If any CRCON upgrade implies updating this file, the usual CRCON upgrade procedure will FAIL.

To successfully upgrade your CRCON, you'll have to revert the changes back, then reinstall this plugin.
To revert to the original file :

cd /root/hll_rcon_tool
git restore config/supervisord.conf