deagsmapmanager 3.25 Beta
Deagles' Map Manager
(aka Nomination_style_voting or Deags_map_manage)
(The information in this file is partially out of date!)
I) INSTALLATION
II) IMPORTANT NOTES
III) USAGE OF OPTIONAL CONFIG FILES
IV) COMMAND LISTING
V) CVAR LISTING
VI) CHANGELOG
*********************************************************************
********** THIS IS AMX MOD X VERISON ONLY!! *************************
*********************************************************************
-----------------------------------------------
I) INSTALLATION OF PLUGIN/CONFIG FILES:
* Put the standardmaps.ini, mapstoban.ini, and mapchoice.ini files in the
<mod>\addons\amxmodx\configs directory (where <MOD> is the path to your Half-life mod)
* Compile deagsmapmanager.sma
* Put the deagsmapmanager.amxx file in the mod\addons\amxmodx\plugins\ directory,
* Add a line in the plugins.ini file of:
deagsmapmanager.amxx
* When in-game, to see a list of commands, use command dmap_help in console.
-----------------------------------------------
II) IMPORTANT NOTES:
* Be sure all other map chooser plugins are turned off, except for the mapmenu default plugin!
* If you run CS 1.6, please define either these config files, or mapcycle.txt, otherwise NO VOTE WILL APPEAR
* Also, if you run Steam and/or CS 1.6, you need to put a line of
mapchangecfgfile server.cfg
in your server.cfg file! Otherwise the timelimit might not be reset every map, if the last map was extended
for a period of time.
-----------------------------------------------
III) USAGE OF MULTIPLE CONFIG FILES:
****for all config files one map per line**All files belong in the addons/amxmodx/configs directory****
**** It is not required that you use any of the map config files, it will enhance your control over maps
if you use them*****
----mapchoice.ini------- (RECOMMENDED):
Insert maps here that will show up for the vote when all 5 nominations are not made. Maps will be randomly selected
from this file to fill up the unused Nomination slots. If you use this file, it needs to have a minimum of 10-15 maps in it,
the more the better! If you don't use this file, mapcycle.txt will be used instead, or allmaps.txt (if it exists)
----standardmaps.ini---- (RECOMMENDED):
Standard maps for the mod goes here, if this file is not created by the user, there will be no "custom" warnings
IT needs to contain at least all of the valid maps for the mod. The purpose of this standardmaps.ini file is
exactly what the purpose of the file was in BugBlatter's map plugin, the words (Custom) will be attached to all
maps in the votemenu that are not listed here
----mapstoban.ini------- (OPTIONAL):
Insert maps that users will never be able to nominate, and will never show up for a vote.
Any map that is not put here can be nominated, if it is not the last <n> maps played
----allmaps.txt--------- (OPTIONAL)
Maps in this file will show up on say "listmaps" command. If this file does not exist, the plugin will use mapcycle.txt instead.
Put all maps that are on your server in this file, even if they are not in your mapcycle
----dmaptags.ini-------- (OPTIONAL)
This file contains tags to show in the vote menu after the map name. The format
of the file is simple:
map_name Tag goes here
The tag for a map can be up to 32 characters (spaces allowed; quotes not
required). Any line starting with a semicolon will be treated as a comment.
-----------------------------------------------
IV) COMMAND LISTING:
Say Commands
currentmap - Show name of the current map
ff - Display friendly fire status
listmaps - Print a list of maps to the client's console
nextmap - Display the next map if a vote does not take place
nominate <map> or vote <map> or <map> Nominate a map for the next vote
nominations or noms - Show names of maps nominated for next vote
recentmaps - Show names of recently played maps
rockthevote or rtv - Let the server know you wish for a vote to take place
Console Commands
Note: These commands should be typed in the console of a client with the appropriate access level. They don't belong in a config file.
User
dmap_help - Show general help and instructions to get detailed help
listmaps - List all maps on the server in your console
ADMIN_LEVEL_A (ADMIN_DMAP)
dmap_cancelvote - Cancel the rocked vote
dmap_nominate <map> - Force nomination of a map by an admin
dmap_rockthevote - Force a map vote instantly
dmap_status - Display current configuration of the plugin
ADMIN_LEVEL_F (ADMIN_SUPER_DMAP)
dmap_banlastmaps <N> - (Default: 4) (Range: 0-100) Ban the last <N> maps played from being voted
dmap_cyclemode - Disable Voting (To restore voting use dmap_votemode)
dmap_default - Restore settings to default
dmap_freeze - (Default for CS: ON) Toggle on/off freeze (only available in CS)
dmap_mapsnum <N> - (Default: 5) (Range: 2-8) How many maps will be in the next vote
dmap_mapsurl <URL|none> - Specify what website to get custom maps from (v3.25+: Must start with http://, https://, ftp://, or www.)
dmap_maxcustom <N> - (Default: 5) (Range: 0-8) Maximum custom maps that can be nominated by all players
dmap_messages <N> - (Default: 3) (Range: 2-20; v3.25+: 2-60) (in minutes) Interval between display of messages
dmap_nominations <N> - (Default: 3) (Range:0-3; v3.25+: 0-8) Maximum nominations that a user can make
dmap_quietmode <OFF|NOSOUND|SILENT> - (Default: OFF) Configure messages: OFF=Sound/text, NOSOUND=Text, SILENT=Minimal text
dmap_rtvpercent <N> - (Default:60) (Range: 3-100) at least this percentage of players have to "rockthevote"
dmap_rtvplayers <N> - (Default:1) (Range: 1-32) This many players have to rockthevote for the vote to start. Note both conditions have to be met: #players, and Percent.
dmap_rtvtoggle - (Default: ON) Enable/disable ability of players to rockthevote. Note that Admins with ADMIN_DMAP can still use dmap_rockthevote to force a vote.
dmap_rtvwait <N> - (Default: 10; v3.25+: 5) (Range: 0-60) Minutes before rockthevote will be accepted. (This does not apply when mp_timelimit = 0.)
dmap_votemode - Enable voting; default
-----------------------------------------------
V) CVAR DESCRIPTION:
amx_emptymap - (Default: "de_dust2") The map used by by the amx_staytime CVAR (CVAR loaded when needed)
amx_extendmap_max - (Default: 90) (in minutes) Max total time a map can be extended (CVAR loaded as needed)
amx_extendmap_step - (Default: 15) (in minutes) Time added to extend current map (CVAR loaded as needed)
amx_idletime - (Default: 5) (in hours) How long a player can be connected to the server before being considered idle (CVAR loaded once per map)
amx_show_activity - (Default: 2) For certain admin actions: 0=Show nothing, 1=Show message, 2=Show message and name (CVAR loaded as needed)
amx_staytime - (Default: 300) (in seconds) How long before changing the map to amx_emptymap if the server is empty (CVAR loaded once per map)
amx_vote_answers - (No default set by plugin) Enable(1)/disable(0) publicly showing each user's vote (CVAR loaded as needed)
dmap_strict - (Default: 0) Enable(1)/disable(0) restricting nominations to maps in the mapcycle (CVAR loaded as needed)
emptymap_allowed - (Default: 0) Enable(1)/disable(0) using a specific map when the server is empty (CVAR loaded as needed)
enforce_timelimit - (Default: 0) Change map STRICTLY on timelimit, when this is set to 1 (CVAR loaded as needed)
mp_timelimit - (No default set by plugin) (in minutes) Time between map changes (CVAR loaded as needed)
nominations_allowed - (Default: 1) Enable(1)/disable(0) accepting nominations (CVAR loaded as needed)
weapon_delay <0|1> - (Default: 1) Enable(1)/disable(0) "Waiting for vote to allow buying of weapons" (CVAR loaded as needed)
-----------------------------------------------
VI) CHANGELOG:
v3.25Beta - 2012-12-28 by DynamicBits
- Added check for enabled conflicting plugin ("Nextmap Chooser 4")
- Added "say noms" as an alias for "say nominations"
- Full status no longer displays when a setting is changed
- Nomination messages no longer display when nominations are disabled
- Sounds no longer play with dmap_quietmode set to SILENT
- Using dmap_status no longer shows "Unknown command: dmap_status" error
- RTV is now allowed on servers with mp_timelimit = 0
- Relaxed dmap_nominations restrictions
- Relaxed dmap_mapsurl restrictions
- Relaxed dmap_messages restrictions
- dmap_rtvwait now defaults to 5 (new installs only)
- Consolidated/removed a number of redundant/unused translations
- Localized a couple of strings (English only)
- Moved lots of formatting/redundant text from dictionary file to code
- Added support for longer strings in the translations (replaced client_print)
- Replaced MOTD help window with better help in the console. (dmap_help)
- Lots of various optimizations were performed
- Added Slovak translation (Thanks to luki1412)
- File logging level is now configurable at compile-time
v3.24 - 2012-01-28 by DynamicBits
- Added check for enabled conflicting plugins
("Nextmap Chooser", "NextMap", "Galileo", and "Crab's Map Manager")
- Added check for incorrect/missing dictionary file
- Added response to "say ff"
- Added "listmaps" command override
- Added "votemap" command override
- Added "currentmap" command
- Added "recentmaps" command
- Relaxed dmap_rtvwait restrictions
- The following commands can no longer (incorrectly) be called from config files:
dmap_rtvpercent, dmap_rtvplayers, dmap_rtvwait, dmap_messages, dmap_mapsnum,
dmap_nominations, dmap_maxcustom, dmap_quietmode, dmap_rtvtoggle, dmap_freeze,
dmap_cyclemode, dmap_votemode, dmap_banlastmaps, dmap_mapsurl
- Removed "now" argument from dmap_rockthevote/amx_rockthevote/amx_rtv. (It never worked)
- Total number of maps is now shown in console for "listmaps" command
- Fixed display of time after successful vote to extend map
- Fixed duplicate task IDs
- Standardized name: "Deagles' Map Manager"
- Minor code optimizations
- Removed unused code
- Updated help
- Corrected various minor issues with all languages
- Put quotes around all commands for all languages
- Added Bosnian translation (Thanks to Superstar Games)
- Added Croation translation (Thanks to tomba2k)
- Added Czech translation (Thanks to RTG)
- Added Hungarian translation (Thanks to kiki33hun)
- Added Serbian translation (Thanks to JinX)
v3.23 - 2009-02-17 by DynamicBits
- Fixed menu vote not working in some situations
- Corrected Swedish Translation
v3.22 - 2009-01-21 by DynamicBits
- Added live voting percentages
- Added dmap_nominate command
- Added Romanian translation (Thanks to dorin2oo7 and georgik57)
- Added Russian translation (Thanks to mozart123)
- Added Brazil-Portuguese translation (Thanks to Warden)
- Added Swedish translation (Thanks to Trut)
- Fixed a handful of strings not getting localized properly
- Fixed a translation that was causing the SVC_BAD error
- Fixed several buffer overflow issues
- Many optimizations
- Updated help
- Added a bunch of comments to source code
v3.21 - 2008-09-17 by DynamicBits
- Added support for extra tags in the vote menu (See details for dmaptags.ini)
- Added two new localized strings (Only English and Polish versions are in the lang file so far)
- Fixed some multilingual code
- Fixed several mistakes in the lang file
- Formatted a few strings to better match AMX Mod X's formatting
- A few small code optimizations
v3.20 - 2008-08-15 by DynamicBits
- Fixed indentation, spacing, semicolons, argument spacing, and missing
curly braces (these things: { }) to mostly match BSD KNF style.
- Fixed return value in client_disconnect(). This may have affected any
other plugin that relied on client_disconnect().
- Added some missing return values
- Removed several sections of redundant code
- New define: DEDICATED_LOG_ENABLED allows logging to be disabled by
commenting out one line (see source).
v3.1 - 4-05-08
- Fixed issue with emptyserver portion giving errors and flooding console
v3.0 - 9-29-07
- Changed txt file for German to supposedly stop the Kicking issue that so many people are having.
- Added cvar weapon_delay to Enable/Disable "Voting for nextmap delayed to allow buying of weapons..."
v2.48 - 9-27-07
- Added command rtv in chat for quick rock the votes (client)
- Added cvar emptymap_allowed (1|0) To enable/disable this feature
- Added cvar emptymap (mapname) For whatever map you want your server to switch to when nobody is on after reading the staytime cvar
- Added cvar amx_staytime(in seconds): How long before the plugin changes the map.
- Added cvar amx_idletime(in hours): How many hours a player can be connected to the server before being considered idle.
- Added cvar nominations_allowed (Enable/Disable Accepting nominations)
-Made the code look much prettier with proper indentation.
-Removed cvar rtv_percent - Useless, when the command saves your settings
v2.47 - Changed a some code for issues occuring randomly
v2.46 - Now uses the file defined from cvar named 'mapcyclefile' and not the hardcoded mapcycle.txt, by _KaszpiR_
v2.45 - Multilingual & Cancel vote
- Multilingual by Vlad
- Cancel Vote command by Lt. Llama
v2.40 - JTP10181 - 3/12/2006
- Major code cleanup
- Added allmaps.txt generating back in and fixed it for linux
- Added support for no nominations allowed
- Fixed all admin commands to check using cmd_access
2.30b: Moved ALL config files to configs/dmap/, if the directory exists otherwise configs/
2.30: Fix so-called "hardcoded paths" and moved config files to config folder.
2.27d : Fix generation of allmaps.txt (removed.)
New in 2.27c
Fixed dmap_maxcustom <N> to allow 0 (no custom maps) in the vote. I'm not sure
why this was limited to being greater or equal to 1 in the first place (call it an oversight).
New in 2.27
Added randomization of "nextmap" when the current map being played does not exist in the server mapcycle.txt
Fixed dmap_maxcustom <N> to strictly control the maximum # of custom maps that appear in the vote
(voted or filled), so that the function does not just control the maximum number of maps that can be nominated.
Config files remain in addons/amxmodx/ directory
New in 2.20 (AMXX)
Release #3 of 2.10j, fixed bugs with strtonum() and warning messages about # arguments.
Config files need to be placed in your <mod>/amxmodx/ Folder!! (not the config folder or anywhere else)
***Added automatic generation of <mod>/amxmodx/allmaps.txt file***
-It will generate this list based on maps in your /MAPS folder, the first time you run this plugin.
Cached maps such as default maps will need to be added *manually* to this file in notepad and to the
standardmaps.ini, if the mod differs from CS 1.6.
Fixed "extra long" waits for map to change in mods other than CS.
Fixed flooding of vote menu in NS, due to the chat messages being displayed at vote time.
Fixed color hudmessage that "map will change in N seconds" when Round Mode is being used.
Changes from AMX version: NO more strtonum() or numtostr() integrated, had to make these 2 functions.
cstrike_running becomes function not variable.
New in 2.10i:
* Fixes bug with being able to nominate recent maps played.
New in 2.10h:
* All map nominations are now automatically changed to lowercase letters.
New in 2.10g:
* FIXED BUG that occured at voting time, where the recently played maps would appear in the vote if mapchoice.ini
was used for favorite map storage.
New in 2.10f:
* FIXED BUG IN BANLASTMAPS...NOW SUPPORTS 20-99 LASTMAPS PLAYED BEING BANNED! =)
New in version 2.10x:
* enforce_timelimit cvar, which will be included in all versions from now on.
-when set to 1, the map will change when timelimit expires, not when the last round is finished after map voting.
* dmap_maxcustom Admin command , which allows admins to control maximum TOTAL custom maps that are nominated.
NOTE: If you define custom maps in your mapcycle, more than the "max" custom can still come up for the vote.
Therefore, I suggest that if you want to control custom map nominations, that you don't declare any in your
mapcycle in the first place.
* standardmaps.ini has been "updated" to include maps that (for some bizarre reason) I forgot to add in the
first place.
New in version 2.02-2.03b:
* Fixed bug where the "nextmap" would be incorrectly set, when the last map in the "mapcycle" was being played.
* Map changes more smoothly at the end of the round, as compared to version 2.00x
* Other minor tweaks.
New in version 2.00:
* Nextmap.amx plugin is no longer required!
* Now Map change will occur only at start of the round, as to allow players to not get frustrated by mapchange during a round.
* Fixed several other things.
* Listmaps and say "listmaps" now support many maps without causing the client to disconnect.
New in version 1.80:
* Map vote will NEVER interfere with buying of weapons at start of a round!!
* HudMessages that appear incorrectly (truncated) in CS 1.6 are now displayed in Chat Area.
* Bug in CS 1.6 where Weapons Drop/Freeze would crash server is now fixed
New in Version 1.70 over versions 1.44 and lower
* added command dmap_nominations <(1-3)> to set max nominations from each player
* added command say "nominations" (seems to work good now)
* fixed rockthevote when players leave, and correct # have rocked, now vote starts correctly
* fixed say "nextmap" bug
* changed messages when user nominates a map and cancels any other person's nomination
* changed dmap_banlastmaps to allow from 0-99 maps to be banned
* added cvar dmap_strict to allow only maps that are seen by say "listmaps" to be nominated
* added command dmap_messages to change amount of time in minutes between messages
* Fixed bug where players say "vote <" and it adds an invalid map to the nomination listing.
* Fixed bug in mp_winlimit (Version 1.4.2.c)
* Changed Command dmap_quietmode to allow OFF, NOSOUND, or SILENT (version 1.5.0)
* Added Command dmap_freeze, to enable/disable freeze/weapons drop at the end of the map
* Numerous other tweaks and improvements over all other versions!