HLL_CRCON_Forbid_role

A plugin for Hell Let Loose (HLL) CRCON (https://github.com/MarechJ/hll_rcon_tool) that blocks role(s) access to defined players.

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.

Some Ubuntu Linux distributions disable the root user and /root folder by default.
In these, your default user is ubuntu, using the /home/ubuntu folder.
You should then find your CRCON in /home/ubuntu/hll_rcon_tool.

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 ElGuillermo, you can skip this part.
  (though it's always a good idea to redownload the files, as they could have been updated)

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

  Second part

  cd /root/hll_rcon_tool/custom_tools
  wget https://raw.githubusercontent.com/ElGuillermo/HLL_CRCON_Forbid_role/refs/heads/main/hll_rcon_tool/custom_tools/automod_forbid_role.py
  wget https://raw.githubusercontent.com/ElGuillermo/HLL_CRCON_Forbid_role/refs/heads/main/hll_rcon_tool/custom_tools/automod_forbid_role_config.py

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

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

Config

• Edit /root/hll_rcon_tool/custom_tools/automod_forbid_role_config.py and set the parameters to fit your needs.
• Restart CRCON :

  cd /root/hll_rcon_tool
  sh ./restart.sh

Limitations

⚠️ 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/common_translations.py
• /root/hll_rcon_tool/custom_tools/automod_forbid_role.py
• /root/hll_rcon_tool/custom_tools/automod_forbid_role_config.py

⚠️ This plugin requires a modification of the /root/hll_rcon_tool/config/supervisord.conf file, which originates from the official CRCON depot.
If any CRCON upgrade implies updating this file, the usual upgrade procedure, as given in official CRCON instructions, 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