Skip to content

Repository files navigation

minqlx plugins

Collection of plugins for Quake Live - Add to your server's minqlx-plugins folder

afkplus
aliasesplus
autokick
backfire
factoryvote
lastmaps
livescoreboard
mapmanager
motd (replacement)
namesplus

afkplus.py right-click & save

This plugin expands on iouonegirl's AFK plugin found here:
https://github.com/dsverdlo/minqlx-plugins.

qlx_afk_enable_punishment 1 - Works as original
qlx_afk_enable_punishment 0 - Spectates player immediately upon value of:
qlx_afk_detection_seconds

Gives admins the choice of an immediate move to spectate without waiting for a death

aliasesplus.py right-click & save

Modified aliases.py to list player aliases without lagging the server.
Results are displayed in chunks and/or limited (configurable)
CVARS:
qlx_aliasesmode "limit" - limit or chunk
qlx_limitresults "10" - number of results to show
qlx_chunktime "500" - delay in ms between chunk sends

autokick.py right-click & save

This plugin will automatically kick users (after 1 warning) for using words added to the word list.

Commands:
!addword - Adds a word the list
!delword - Removes/deletes word from the list
!listwords - Displays the word list

CVARS:
qlx_autokickWarnings - number of warnings before kick
qlx_autokickMode - Settings:
kick - warn N times then kick (original behavior)
warn - suppress message and notify the player, never kick
silent - suppress message with no notification at all

Optional:
Regex patterns can also be added to autokick_patterns.txt
An autokick.log file is also kept.

backfire.py right-click & save

This is an extension plugin for minqlx to slap/punish players that do team damage
This works similar to a reverse vampiric effect.
Damage can be set to a specific amount per hit or proportional in your server config

Note

Required:

  • Shino's minqlx fork until the master is updated. This is needed for the damage hook. You can get it/compile it from HERE.
  • A factory or server with g_friendlyfire = 1

Fixed slap damage:

qlx_backfireSlapAmount 20

qlx_backfireProportional 1 1 = Use proportional slap damage, 0 = Use fixed damage

qlx_backfireMinHealth 1 Minimum amout of health before punishing further (1 prevents death)

qlx_logDir Optional log directory, default is serverfolder/logs/backfire.log

factoryvote.py right-click & save

Allow the voting of factories you specify in baseq3/factories.txt
Default admin level: 3
Using without a number will list the factories.

Commands:
!fv # - Starts vote for the number selected
!factory - Shows current factory
!check - Checks what factory is set on both the server and plugin
!fvv - Displays plugin version number !restorecfg - Reset cvars back to defaults (restore.cfg)

ql_restorecfg_perm 2 (default: 2) Permission Level to use !restorecfg

PER-FACTORY CONFIG SUPPORT:
When a factory vote passes, the plugin will look for a matching .cfg file in the minqlx-plugins folder.

Example:
factory "ctf" → looks for <plugins_dir>/ctf.cfg
factory "ca" → looks for <plugins_dir>/ca.cfg

If the file exists, it is executed as a server console command before the map change/factory update.
This is useful for updating things like sv_mappoolfile to change the rotating maps for that mode.

lastmaps.py right-click & save

Shows a lists of the last 5 played maps
Useful to avoid voting overplayed maps.

Commands:
!lm - Lists the last 5 played maps
!lmv - Displays plugin version number

livescoreboard.py right-click & save

Outputs a simple scoreboard to HTML
Made this for a quick and dirty way to import scores from other games into OBS.

Commands:
!lscheck - Check if plugin is running
!lsv - Displays plugin version number
!lsstyle - Set scoreboard style, Default: 1 , One-line: 2
!lstitle - Set scoreboard title, blank to clear
!lsredname - Set Red team name
!lsbluename - Set Blue team name
!lscolor - Set font color
!lsbgcolor - Set background color
!lsupdate - Force update of scoreboard
!lspath - Set your own output path, such as: /var/www/html/server2, leave blank to see current value, clear to clear
!lscustom - Add your own custom text to end of Style 2, blank to clear.

CVARS for configs:
qlx_scorerefresh "20" - time in seconds to auto-refresh
qlx_livescorecolor
qlx_livescorebgcolor
qlx_lstitle
qlx_lsredname
qlx_lsbluename
qlx_lspath
qlx_lscustom

mapmanager.py right-click & save

Manages map rotation, enforces cooldowns on recently played maps, and tracks off-pool callvotes too. Also replaces/includes features of lastmaps.py

Commands:
!lm - Lists the last 5 played maps
!mappool - Shows the next maps in rotation, marking which will be offered as vote candidates. Notes if the current map is off-pool.
!skipmaps - Advance the rotation pointer by n steps (default 1). Useful for skipping unwanted upcoming maps. (Admin only)
!resetrotation - Reload mappool.txt from disk and resync the rotation pointer to the current map. Use after editing mappool.txt without restarting. (Admin only)

!mmv - Display the plugin version.
!mmdebug - Dump full plugin state: pool contents, rotation index, map history, off-pool maps, cvar path, and internal flags. Useful for diagnosing issues.

CVARS for configs:
mapmanager_mappool - Full path to mappool.txt including filename
mapmanager_history_size "5" - Number of recently played maps to block from voting
mapmanager_vote_maps "3" - Number of maps shown as candidates in end-of-game votemap
manager_allownewvotes "1" - Allow callvote map after a vote already passed this round, 0 = block it

motd.py (replacement) right-click & save

Extended motd to multiple lines to overcome character length and format limitations/ease of use

Commands:
!setmotd <line #> <message> - Set specific line of MOTD (1-10).
!addmotd <message> - Adds a new line to the next free slot.
!clearmotd - Clears all MOTD lines.
!reloadmotd - Reloads MOTD lines from motd.cfg in /baseq3

Use set qlx_motd1, set qlx_motd2, etc to set from config file.
Add /exec motd.cfg to config.cfg or simply !reloadmotd
Config settings will not override existing motd (use !clearmotd and restart server).

namesplus.py (replaces names.py) right-click & save

Added ability for admins to change players names
Useful for those with blank names or lazy aliasing guys during tournaments :)
Existing !name still functions for players
Names now persist between reconnects until a !clear <player ID #> is performed.

Note

qlx_plugins must not contain "DEFAULT" as this includes the original "names" and will break namesplus
Therefore, add all default plugin names and/or your other plugins:
set qlx_plugins "plugin_manager, essentials, motd, permission, ban, silence, clan, namesplus, log, workshop"

Additional settings:
qlx_enforceAdminName
qlx_enforceSteamName

Commands:
!name <name> - Player sets their own name
!setname <player ID #> OR <steam ID #> <New Name> - Admin sets a players name
!clear <player ID #> - Removes Admin set name
!listnames - Shows a list of Admin-set names
!npv - Show version number

About

Collection of plugins for Quake Live

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages