Skip to content

tjone270/minqlxtended-plugins

 
 

Repository files navigation

minqlxtended-plugins

This is a collection of plugins for minqlx. The Python dependencies are included in requirements.txt. Make sure you run python3 -m pip install -r requirements.txt first.

This repository contains original plugins from the minqlx-plugins repository which have been improved or further documented.

CVAR Reference

This is a list of plugins and their CVARs. Set the CVARs by passing them as a command line argument or using server.cfg like you would with any other QLDS CVAR.

  • plugin_manager: Adds commands to load, reload and unload plugins at run-time.
  • essentials: Adds commands for the regular QLDS commands and some more. Adds functionality to restrict teamsize voting and to pass votes before it fails if the majority votes yes.
    • qlx_votepass: A boolean deciding whether or not it should automatically pass votes before they fail if the majority voted yes.
      • Default: 1
    • qlx_votepassThreshold: If qlx_votepass is 1, determines the percentage (in decimal) of in-game players required to vote before it automatically passes any votes.
      • Default: 0.33
    • qlx_teamsizeMinimum: The minimum teamsize allowed to vote for. !teamsize can override this.
      • Default: 1
    • qlx_teamsizeMaximum: The maximum teamsize allowed to vote for. !teamsize can override this.
      • Default: 8 (if teams are full and teamsize is above 8, players will not be visible on the scoreboard)
  • ban: Adds command to ban people for a set amount of time. Also adds functionality to ban for automatically for leaving too many games.
    • qlx_leaverBan: A boolean deciding whether or not it should automatically ban players for leaving.
      • Default: 0
    • qlx_leaverBanThreshold: If qlx_leaverBan is 1, determines the percentage of games (in decimal) a player has to go below before automatic banning takes place.
      • Default: 0.63
    • qlx_leaverBanWarnThreshold: If qlx_leaverBan is 1, determines the percentage of games (in decimal) a player has to go below before a player is warned about his/her leaves.
      • Default: 0.78
    • qlx_leaverBanMinimumGames: If qlx_leaverBan is 1, determines the minimum number of games a player has to player before automatic banning takes place. If it determines a player cannot possibly recover even if they were to not leave any future games before the minimum, the player will still be banned.
      • Default: 15
    • qlx_statOtherPlayersPermission: The permission level required for players to use the !leaves command to obtain other player statistics.
      • Default: 1
  • balance: Adds commands and CVARs to help balance teams in team games using ratings provided by third-party services (like QLStats).
    • qlx_balanceAuto: A boolean determining whether or not we should automatically try to balance teams if a shuffle vote passes.
      • Default: 1
    • qlx_balanceUseLocal: A boolean determining whether or not it should use local ratings set by the !setrating command.
      • Default: 1
    • qlx_balanceLocalExpires: Time in seconds before a locally-set rating value is removed from the database. Use "0" to disable expiration of locally-set ratings.
      • Default: 0
    • qlx_balanceMinimumSuggestionDiff: The minimum rating difference before it suggests a switch when !teams is executed.
      • Default: 25
    • qlx_balanceUrl: The address to the site hosting an instance of PredatH0r's XonStat fork, which is currently the only supported rating service.
      • Default: qlstats.net:8080, which is hosted by PredatH0r himself.
    • qlx_balanceApi: The endpoint to use for ratings calls.
      • Default: elo
      • Alternative: elo_b
  • silence: Adds commands to mute a player for an extended period of time. This persists across player reconnections, as opposed to the default mute behavior of qzeroded. Silencing a player has additional effects, such as preventing name changes and vote calling.
  • clan: Adds commands to let players have persistent clan tags without having to change the name on Steam.
  • motd: Adds commands to set a message of the day.
    • qlx_motdSound: The path to a sounds that is played when players connect and have the MOTD printed to them.
      • Default: sound/vo/crash_new/37b_07_alt.wav
    • qlx_motdHeader: The header printed right before the MOTD itself.
      • Default: ^6======= ^7Message of the Day ^6=======
  • permission: Adds commands to set player permissions.
  • names: Adds a command to change names without relying on Steam.
    • qlx_enforceSteamName: A boolean deciding whether or not it should force players to use Steam names, but allowing colors, or to allow the player to set any name.
      • Default: 1
  • raw: Adds commands to interact with the Python interpreter directly. Useful for debugging.
  • log: A plugin that logs chat and commands. All logs go to fs_homepath/chatlogs.
    • qlx_chatlogs: The maximum number of logs to keep around. If set to 0, no maximum is enforced.
      • Default: 0
    • qlx_chatlogsSize: The maximum size of a log in bytes before it starts with a new one.
      • Default: 5000000 (5 MB)
  • solorace: A plugin that starts the game and keeps it running on a race server without requiring a minimum of two players, like you usually do with race.
  • docs: A plugin that generates a command list of all the plugins currently loaded, in the form of a Markdown file.
  • workshop: A plugin that allows the use of custom workshop items that the server might not reference by default, and thus not have the client download them automatically.
    • qlx_workshopReferences: A comma-separated list of workshop IDs for items you want to force the client to download. Use this for custom resources; the referenced PK3's filesystem will be superimposed upon the pak00.pk3 filesystem.

About

A collection of plugins for minqlxtended.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%