Multi-Mod Manager v1.1-release_candidate1.hotfix1
Release: 10.10.2015 | Last Update: 21.01.2016
Contents' Table
Basic differences between the original Joropito's MultiMod and addons_zz's Multi-Mod Manager
addons_zz's Multi-Mod Manager can:- display colored text messages.
- easily implemented any new feature that you want, as it is a fully documented plugin.
- improve its code as it is well software engineered.
- easily manage extremely big mod plugins files and mods configurations files.
- easily manage extremely big mods amount.
- to have unlimited MODS installed.
- install the fully compatible "multimod_daily_changer" provided here.
- install the fully compatible and new "Galileo" provided here.
- unload metamod csdm modules automatically after disable the csdm mod, or before enable any another mod, as long as you configure it.
- restore server's cvars and server's commands automatically after disable any mod, or before enable another mod, as long as you configure it.
- install/use every mod that exists and will exists in the universe, without any special plugin or any "Multi-Mod Manager" modification,
as long as this mod you wanna install runs at an AMXX very own default install.
- if you want to, you can have any mod activated never ever at you server, even if there is more then 10 installed and fully working mods.
- use the command "amx_setmod help 1" display the acceptable inputs and loaded mods
from the file "yourgamemod/addons/amxmodx/configs/multimod/voting_list.ini".
- automatically execute late configuration file execution to built-in AMXX per map configurations.
- automatically to restaure the first mapcycle used.
- freeze the game and show the scoreboard when activating a mod silently, using the command "amx_setmods".
- use the command 'amx_setmod modShortName <1 or 0>', to enable the mod "modShortName" as csdm,
starting a vote map (1) or not (0), right after. This command can only active mods loaded from
"voting_list.ini" file, and needs an admin level ADMIN_CFG.
- use the command 'amx_setmods modShortName <1 or 0>', to enable the mod "modShortName" as surf,
restarting (1) or not (0) the server immediately, silently. This command can active any mod installed at the server
despite it is or it is not at the "voting_list.ini" server configuration file. And most important, it needs an admin level ADMIN_IMMUNITY.
- use the cvar amx_multimod_endmapvote <0 - 1> to enable (1) or disable (0) end map automatic multi-mod voting.
- waits as long as you want to choose to activate one mod or not, by vote menu and by command line.
- at voting keep the current mod, if less than 30% voted, or keep it disabled if there is no mod enabled.
- see the voting results details at server's console.
- keep the server's current mod at voting as the vote menu's first option is always: "1. Keep Current Mod".
- disable the server's current mod at voting as the vote menu's second option is always: "2. No mod - Disable Mod".
- see that are any mod currently activated, when you type "say currentmod" and there is no mod active.
- execute a special server's configuration file at the comment you active a server's mod. That is executed only and only at the
mod first activation time by the command "amx_setmod" (the silence one, "amx_setmods" has not this feature, because it is silent).
- receive a clear and self-explanatory error message when you mis-configure the mod plugins file name/location.
- server's admins with right flag can change the server's current mod without needing direct access like ftp, to the server's files.
See its current development at: Github
https://github.com/addonszz/MultiMod_Manager
(look for the developer and feature branches)
The original plugin "
multimod.sma" is originally written by
JoRoPiTo. This "
Multi-Mod Manager" works
differently from the original "
MultiMod Manager". See
Credits for information.
This is a release candidate, which is a beta version with potential to be a final product, which is ready to be
released unless
significant bugs emerge. In this stage of product stabilization, all product
features have been
designed, coded and tested through one or more beta cycles with no known show stopper-class bug.
This plugin
is not compatible with the AMXX's very own
Map Chooser or "
Daily Maps", but yes with its
modification "
multimod_daily_changer" provided
here. The new
Galileo
which is a different Galileo version,
is ready to be used with this
Multi-Mod Manager".
The "
Multi-Mod Daily Maps" is a modified version of "
Daily Maps" to work with this "
Multi-Mod Manager".
This plugin only works with "
Multi-Mod Manager", alone the "
Multi-Mod Daily Maps" does nothing. Its allows
you to specify a different "
mapcycles" and "
server cfg" files rotation, for every day. These daily mapcycles are
only active when you are not using any mod, or your current mod does not specifies a special mapcycle. The
"
mapcycles" and "
server cfg" files respectively, are located at "
yourgamemod/mapcycles/day" and
"
yourgamemod/mapcycles/day/cfg".
Click here to see all servers using this plugin.
**********************
Introduction Go Top *******************************
This is a multi-mod server manager, that controls which mod is, or will be activated.
A mod can be activated by vote (
say votemod), or by force (
amx_setmod or
amx_setmods).
There is a list of mods (
voting_list.ini) that decides which mods will show up at a mod vote.
The vote mod supports a multi-page menu, that display
unlimited Mods loaded from “
voting_list.ini” file.
The "
multimod_manager.sma" waits the user choose to activate one mod, by vote menu,
or by command line. It
saves the current active mod and
keep it active forever or until some
other mod is
activated or your disable the active mod by the "
amx_setmod disable 1" command.
Features' list:
Quote:
* Changes the default mapcycle, if and only if a custom mod mapcycle was created.
* The vote menu's first to options always are: "1. Keep Current Mod" and "2. No mod - Disable Mod".
* The vote mod keep the current mod, when less than 30% of players voted.
* When the min vote mod time is not reached/disabled, display a message informing it.
* Command 'amx_votemod', to start force start a vote mod, even if it is disabled. This command can
only active mods loaded from "voting_list.ini" file, and needs an admin level ADMIN_MAP.
* Command 'amx_setmod modShortName <1 or 0>', to enable the mod "modShortName" as csdm,
starting a vote map (1) or not (0), right after. This command can only active mods loaded from
"voting_list.ini" file, and needs an admin level ADMIN_CFG.
* Command 'amx_setmods modShortName <1 or 0>', to enable the mod "modShortName" as surf,
restarting (1) or not (0) the server immediately, silently. This command can active any mod installed
at the server despite it is or not at the "voting_list.ini" server's configuration file. And most important,
it needs an admin level ADMIN_IMMUNITY.
OBS: A mod can only to be/get activated after a restart.
|
The command "
amx_setmod help 1" display the acceptable inputs and loaded mods
from the file "
yourgamemod/addons/amxmodx/configs/multimod/voting_list.ini". There is
2 built-in operations beyond mods activation: "
amx_setmod help 1" and "
amx_setmod disable 1",
respectively to shows
help and
disable any active mod.
If enabled (
default disabled), when remaining
5 minutes to end current map, this plugins launches a vote to
choose which mod will be played at the
next map. If less than 30% voted, the game
keep the current mod
or
keep it disabled if there is no mod enabled.
Example of "
amx_setmod help 1":
Code:
amx_setmod help 1 | To show this help.
amx_setmod disable 1 | To deactivate any active Mod.
amx_votemod | To force a votemod.
say_team nextmod | To see which is the next mod.
say currentmod | To see which is the current mod.
say votemod | To try start a vote mod.
say_team votemod | To try start a vote mod.
amx_setmod csdm 1 | to use CS-DM (DeathMatch)
amx_setmod catch 1 | to use Catch Mod
amx_setmod dragon 1 | to use Dragon Ball Mod
amx_setmod gungame 1 | to use Gun Game Mod
amx_setmod hiden 1 | to use Hide N Seek Mod
amx_setmod jctf 1 | to use Just Capture The Flag
amx_setmod knife 1 | to use Knife Arena Mod
amx_setmod predator 1 | to use Predator Mod_b2
amx_setmod shero 1 | to use Super Heros
amx_setmod surf 1 | to use Surf Mod
amx_setmod warcraft 1 | to use Warcraft Ultimate Mod 3
amx_setmod zp50Money 1 | to use Zombie Mod with Money
amx_setmod zp50Ammo 1 | to use Zombie Mod with AmmoPacks
amx_setmod ttt 1 | to use Trouble in Terrorist Town
amx_setmod deathrun 1 | to use Deathrun Mod
**********************
Requirements and Commands Go Top ******
Amx Mod X
1.8.2 or
higher only
Cvars:
Quote:
// Minimum time to play before players can make MOD voting.
amx_mintime 10
// enable (1) or disable (0) end map automatic multi-mod voting.
amx_multimod_endmapvote 0
// enable (1) or disable (0) multi-mod voting (say votemod).
amx_multimod_voteallowed 1
|
Commands:
Quote:
//Command line control of multimod system
amx_setmod
amx_setmods
//Admin only command to launch MOD voting
amx_votemod
//Check which MOD will be running in next map
say nextmod
say_team nextmod
//Check which MOD is running in the current map
say currentmod
say_team currentmod
//Player command to launch MOD voting
say votemod
say_team votemod
|
There is a Multi-Mod Server Configuration with: - CS-DM (DeathMatch)
- Catch Mod
- Dragon Ball Mod
- Gun Game Mod
- Hide N Seek Mod
- Just Capture The Flag
- Knife Arena Mod
- Predator Mod_b2
- Super Heros
- Surf Mod
- Warcraft Ultimate Mod 3
- Zombie Money Mod
- Zombie Pack Ammo Mod
Is available here.
********************************
Installation Go Top **********************
1. Download the files "
multimod_manager.sma", "
configuration_files.zip",
"
galileo.sma" and "
multimod_daily_changer.sma"(this is optional), at
Downloads section.
2. Then take the contents of "
yourgamemod" from "
configuration_files.zip", to your gamemod folder.
3. Compile the files and put the
compiled files to your plugins folder at
"
yourgamemod/addons/amxmodx/plugins" folder.
4. Put the next lines to your "
plugins.ini" file at "
yourgamemod/addons/amxmodx/configs" and
disable the original "
mapchooser.amxx":
Quote:
multimod_manager.amxx
multimod_daily_changer.amxx
; Choose
galileo.amxx
|
5. Put the next line to your "
amxx.cfg" file at "
yourgamemod/addons/amxmodx/configs":
Quote:
|
exec addons/amxmodx/configs/multimod/multimod.cfg
|
6. Configure your own mods at "
yourgamemod/addons/amxmodx/configs/multimod/voting_list.ini"
file as follow (the short mod name cannot be longer than 15 characters neither have spaces):
---
Example of: yourgamemod/addons/amxmodx/configs/multimod/voting_list.ini ------
Quote:
[Gun Game]:[gungame]:
;[mode name]:[shortModName]:
|
-------------- And you have
to create the files:----------------------------
Quote:
yourgamemod/addons/amxmodx/configs/multimod/plugins/gungame.ini
(Optinal files)
yourgamemod/addons/amxmodx/configs/multimod/cfg/gungame.cfg
yourgamemod/addons/amxmodx/configs/multimod/latecfg/gungame.cfg
yourgamemod/addons/amxmodx/configs/multimod/msg/gungame.cfg
yourgamemod/mapcycles/gungame.txt
|
--------------
Explanations Go Top -------------------------
1. The file "
yourgamemod/addons/amxmodx/configs/multimod/plugins/gungame.ini",
contains the plugins that compose the Mod like:
2. The file (
opcional) "
yourgamemod/addons/amxmodx/configs/multimod/cfg/gungame.cfg",
contains yours special configuration used at the mod activation, like:
Quote:
amxx pause amx_adminmodel
sv_gravity 600
|
3. The file (
opcional) "
yourgamemod/addons/amxmodx/configs/multimod/cfg/gungame.cfg",
contains
yours special configuration used after the mod deactivation, like:
Quote:
amxx unpause amx_adminmodel
sv_gravity 800
|
4. The file (
opcional) "
yourgamemod/addons/amxmodx/configs/multimod/msg/gungame.cfg" contains
commands that are executed when a mod is activated by the command line "
amx_setmod".
Usually it contains a command
to restart the server.
Example of "
yourgamemod/addons/amxmodx/configs/multimod/msg/gungame.cfg":
Quote:
amx_execall speak ambience/ratchant
amx_tsay ocean GUN-GAME will be activated at next server restart!!!!
amx_tsay blue GUN-GAME will be activated at next server restart!!!!
amx_tsay cyan GUN-GAME will be activated at next server restart!!!!
amx_tsay ocean GUN-GAME will be activated at next server restart!!!!
//amx_countdown 5 restart
exec addons/amxmodx/configs/multimod/votingfinished.cfg
|
5. The file (
opcional) "
yourgamemod/mapcycles/gungame.txt" contains the mapcycle used when
gungame mod is active.
********************************
TODO Go Top *********************************
- Create a new folder called cvars, to list the cvars to autosave to the latecfg file name. An give an option to autodetect the changed cvars from the './multimod/cfg' folder.
- Create a option to automatically create a file at '.configs/maps' folder, to autoload a mod on its maps types, as deathrun on deathrun_/zm_ prefixes maps names. To do this, add at the voting_list, a last parameter specifing the map_prefix where that mod must be autoloaded.
********************************
Change Log Go Top ***********************
Code:
2015-10-10 | v1.0-release_candidate1
* Initial release candidate.
2015-10-10 | v1.0-release_candidate1.hotfix1
* Add exception handle when the currentmod_id.ini or currentmod_shortname.ini is not found.
2015-10-12 | v1.0-release_candidate2
* Removed unused function get_firstmap() and variable g_nextmap.
* Replaced unnecessary functions configMapManager and configDailyMaps.
* Removed unnecessary MULTIMOD_MAPCHOOSER compiler constant.
* Added to multimod_daily_changer.sma compatibility with Galileo.
2015-10-13 | v1.0-release_candidate2.hotfix1
* Added missing format parameter at messageModActivated function.
2015-10-13 | v1.0-release_candidate2.hotfix2
* Added missing MM_CHOOSE line at multilingual file.
2015-10-19 | v1.0-release_candidate2.hotfix3
* Translated to english lost code variables.
* Replaced a implemented switch by a native switch.
* Replaced another implemented switch by a native switch.
* Improved variables names meaningful.
2015-10-21 | v1.0-release_candidate2.hotfix4
* Fixed mapcycle not setting when a mod was activated by command line or voting.
2015-10-25 | v1.1-alpha1
* Added late configuration file execution to built-in AMXX per map configurations.
* Added to restaure the first mapcycle used.
* Improved code clearness.
* Added path coders to every multi-generated string.
* Added immutable strings paths as global variables.
* Removed passing an integer value to a function by string.
* Removed unnecessary variables like g_messageFileNames and g_pluginsFileNames.
2015-10-30 | v1.1-alpha1.hotfix1
* Fixed the mod map cycle not changing.
2016-01-16 | v1.1-release_candidate1
* Replaced wrong color chat system with correct one.
* Use the actual current mod map cycle, right after a vote mod, instead the previous one.
* Updated modification type to all GoldSrc engine games.
* Fixed LANG_PLAYER misuse.
* Fixed server_print overuse.
* Fixed printing info to the client in a for loop can cause an overflow.
* Implemented dynamic arrays, to have unlimited models.
* Fixed bug, where was enabled to set a invalid mapcycle.
2016-01-21 | v1.1-release_candidate1.hotfix1
* Fixed voting reset bug.
********************************
Credits Go Top *******************************
fysiks: The first to realize the idea of "multimod.sma" and various code improvements.
joropito: The idea/program developer of "
multimod.sma".
crazyeffect: Colaborate with multilangual support of "multimod.sma".
dark vador 008: Time and server for testing under czero "multimod.sma".
Brad: The original
Galileo developer.
Th3822: For find a error from map_nominate.
Addons zz: This plugin developer.
ConnorMcLeod: For the [Dyn Native] ColorChat v0.3.2 (04 jul 2013) functions.
JustinHoMi & JGHG: For the "
Daily Maps" plugin.
HamletEagle: For some code improvements as unlimited mods number.
********************************
Source Code and Support Go Top ***
For any problems with this plugin visit this own page for support:
https://forums.alliedmods.net/showthread.php?t=273020
If you are
posting because the plugin or a
feature of the plugin isn't working for you,
please do
all of the following, so we can
more efficiently figure out what's going on:
Quote:
If you have access to your game server's console, type the following in the server console:- status
- meta list
- amxx list
- amxx cvars
If you don't have access the your game server's console, join your server and type the
following in your game console:
- status
- rcon_password your_rcon_password
- rcon meta list
- rcon amxx list
- rcon amxx cvars
- Paste here everything from the status command *except* the player list.
- Paste here the entire result from the meta list and amxx plugins commands.
- Paste here *only* the CVARs that contain "multimod_manager.amxx" in the last column
from the amxx cvars command. They will be grouped together.
|
********************************
Downloads Go Top ********************
- Old versions downloads:
- v1.1-alpha1.hotfix1: (multimod_manager.sma - 72 views - 66.8 KB)
- galileo.sma
.jpg)
Threaded Mode