Battlezone Color Selector 🎨

Players in Battlezone Combat Commander now have the opportunity to select colors of their choosing before a multiplayer game.

Overview 📖

Since 1999, the default team color for Battlezone Combat Commander MPI (Multiplayer Instant) is red. The only other way is playing other modes like Deathmatch, Free For All, or by changing your preferences file. Beyond that, there was no another way for players to easily pick a team color. As of 2019, this deadlock of being red team color changed. Players in MPI (Multiplayer Instant) can easily select a color choice on the fly before a game starts.

Getting Started 🛠

There are two ways you can use this color selector:

1. Clone this repository

https://github.com/HerndonE/Battlezone-Color-Selector.git

Drag the Battlezone Color Selector folder into your Battlezone Combat Commander addon folder i.e. C:\Users\YourName\Documents\My Games\Battlezone Combat Commander\addon. Then launch Battlezone and create a muliplayer game. Once done, you want to select MPI: CS: Chill. In the options tab you can click the fourth page to select your team colors.

2. Steam

Additional maps that use this color selector feature is posted on the Battlezone Combat Commander Steam Workshop.

F9bomber's Color Selector (Asset)
F9bomber's Color Selector (Config)

Note:
  1. If no colors are selected will result in default red and blue.
  2. Custom RGB values MUST be greater than 0.
  3. No two teams can be the same color UNLESS you use the sliders.
  4. Use the stock AIPs (Artificial Intelligence Planning).

Organization 🚀

Call Color Selector Helper File

start() {  -- start function ie first execution
    Call team_color function as an object
}
update(){
    Call rgb_animation function as an object, pass in mission counter object
}

Code Samples 👨‍💻

--[[
key terms: 
 1. ivar - an integer variable item. ivar 50-127 are free to use, they rest have been used in game.
 2. network.session.ivar# - a set of network-replicated integer variable items (for configuring various network session settings).
]]--

local M = {
	red = 0;
	green = 0;
	blue = 0;	
	Min = 0.0;
	Max = 255.0;
}
-- Random Human Team/Computer Team Color
M.red = GetRandomFloat(M.Min, M.Max) ;
M.green = GetRandomFloat(M.Min, M.Max) ;
M.blue = GetRandomFloat(M.Min, M.Max) ;
-- This will return the value of the specified string if we want random colorg turned on.
if GetVarItemInt("network.session.ivar118") == 1 then
	print("Random Human Team Color is: r =" .. M.red .." g =".. M.green .." b =".. M.blue)
	for i= 4, 1, -1 
		do 
			SetTeamColor(i, SetVector(M.red, M.green, M.blue)); -- Now we set the random team color for the team 1 (player(s)) of a Vector in rgb values
		end
end

--[[
These integer values are declared in the Mission table/constructor set our rgb values at 0. The maps .inf file will set our min/max at 0 and 
255 for the slider.
]]--
local M = {
	red = 0;
	green = 0;
	blue = 0;	
}
-- Human Team RGB Color Selector Slider
M.red = GetVarItemInt("network.session.ivar111"); -- Set 'red value' to an ivar#
M.green = GetVarItemInt("network.session.ivar112");
M.blue = GetVarItemInt("network.session.ivar113");
--[[ Once all values are greater than 0, the game will set team 1 (player) custom rgb selection. Once the game is loaded you can 
press "ctrl ~" to see that your rgb values are loaded.]]--
if (M.red > 0 and M.green > 0 and M.blue > 0)  then
	for i= 4, 1, -1 
		do 
			SetTeamColor(i, M.red, M.green, M.blue);
		end
	print("Player Team Custom RGB: r =" .. M.red .." g =".. M.green .." b =".. M.blue)
end

Results