Files @ r25958:603d75b53498
Branch filter:

Location: cpp/openttd-patchpack/source/src/goal.cpp - annotation

Patric Stout
Doc: update multiplayer documentation with latest changes (#9552)

Although several places were fixed during the PR making the change,
not all made it in this document.

While at it, removed all kinds of Markdown warnings by an excessive
usage of spacebar in this document.
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r20947:e99af07846a3
r18772:80ffc4ed8122
r18872:35e831d058c7
r18872:35e831d058c7
r22831:2d7a323f310a
r22831:2d7a323f310a
r18772:80ffc4ed8122
r21383:942c32fb8b0e
r21383:942c32fb8b0e
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r25562:30716ba6a396
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r25562:30716ba6a396
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r20947:e99af07846a3
r20947:e99af07846a3
r23674:a5bafa1a02c5
r20947:e99af07846a3
r20947:e99af07846a3
r20947:e99af07846a3
r20947:e99af07846a3
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r25562:30716ba6a396
r23607:36c15679007d
r20289:1f623493c20d
r18772:80ffc4ed8122
r21293:73e1e2f0d8f4
r21293:73e1e2f0d8f4
r21293:73e1e2f0d8f4
r21293:73e1e2f0d8f4
r21293:73e1e2f0d8f4
r20722:e079a68ef179
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r25562:30716ba6a396
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r21293:73e1e2f0d8f4
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r21293:73e1e2f0d8f4
r21293:73e1e2f0d8f4
r21293:73e1e2f0d8f4
r21293:73e1e2f0d8f4
r21293:73e1e2f0d8f4
r20722:e079a68ef179
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18772:80ffc4ed8122
r18872:35e831d058c7
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r25562:30716ba6a396
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r25562:30716ba6a396
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r25562:30716ba6a396
r20289:1f623493c20d
r21293:73e1e2f0d8f4
r21293:73e1e2f0d8f4
r21293:73e1e2f0d8f4
r21293:73e1e2f0d8f4
r21293:73e1e2f0d8f4
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r25562:30716ba6a396
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r25562:30716ba6a396
r23607:36c15679007d
r20289:1f623493c20d
r25562:30716ba6a396
r20289:1f623493c20d
r20289:1f623493c20d
r21293:73e1e2f0d8f4
r21293:73e1e2f0d8f4
r21293:73e1e2f0d8f4
r21293:73e1e2f0d8f4
r21293:73e1e2f0d8f4
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r25562:30716ba6a396
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r21293:73e1e2f0d8f4
r21293:73e1e2f0d8f4
r21293:73e1e2f0d8f4
r21293:73e1e2f0d8f4
r21293:73e1e2f0d8f4
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r20289:1f623493c20d
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r23780:2fc4e08e27f6
r23780:2fc4e08e27f6
r23780:2fc4e08e27f6
r23780:2fc4e08e27f6
r23780:2fc4e08e27f6
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r25562:30716ba6a396
r18872:35e831d058c7
r24146:d1bd964d9e65
r18872:35e831d058c7
r23780:2fc4e08e27f6
r23780:2fc4e08e27f6
r24521:57ec498b9221
r23780:2fc4e08e27f6
r23780:2fc4e08e27f6
r23780:2fc4e08e27f6
r18872:35e831d058c7
r18872:35e831d058c7
r25562:30716ba6a396
r22831:2d7a323f310a
r24968:089fed249fe7
r24968:089fed249fe7
r24968:089fed249fe7
r24968:089fed249fe7
r22831:2d7a323f310a
r22831:2d7a323f310a
r22831:2d7a323f310a
r24808:e7cb02d1ad0d
r24808:e7cb02d1ad0d
r24808:e7cb02d1ad0d
r18872:35e831d058c7
r18872:35e831d058c7
r22831:2d7a323f310a
r23780:2fc4e08e27f6
r22831:2d7a323f310a
r22831:2d7a323f310a
r22831:2d7a323f310a
r22831:2d7a323f310a
r25562:30716ba6a396
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r25562:30716ba6a396
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r25565:6a5de7df7ea1
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r25565:6a5de7df7ea1
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
r18872:35e831d058c7
/*
 * This file is part of OpenTTD.
 * OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.
 * OpenTTD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
 */

/** @file goal.cpp Handling of goals. */

#include "stdafx.h"
#include "company_func.h"
#include "industry.h"
#include "town.h"
#include "window_func.h"
#include "goal_base.h"
#include "core/pool_func.hpp"
#include "game/game.hpp"
#include "command_func.h"
#include "company_base.h"
#include "story_base.h"
#include "string_func.h"
#include "gui.h"
#include "network/network.h"
#include "network/network_base.h"
#include "network/network_func.h"

#include "safeguards.h"


GoalID _new_goal_id;

GoalPool _goal_pool("Goal");
INSTANTIATE_POOL_METHODS(Goal)

/**
 * Create a new goal.
 * @param tile unused.
 * @param flags type of operation
 * @param p1 various bitstuffed elements
 * - p1 = (bit  0 -  7) - GoalType of destination.
 * - p1 = (bit  8 - 15) - Company for which this goal is.
 * @param p2 GoalTypeID of destination.
 * @param text Text of the goal.
 * @return the cost of this operation or an error
 */
CommandCost CmdCreateGoal(TileIndex tile, DoCommandFlag flags, uint32 p1, uint32 p2, const std::string &text)
{
	if (!Goal::CanAllocateItem()) return CMD_ERROR;

	GoalType type = (GoalType)GB(p1, 0, 8);
	CompanyID company = (CompanyID)GB(p1, 8, 8);

	if (_current_company != OWNER_DEITY) return CMD_ERROR;
	if (text.empty()) return CMD_ERROR;
	if (company != INVALID_COMPANY && !Company::IsValidID(company)) return CMD_ERROR;

	switch (type) {
		case GT_NONE:
			if (p2 != 0) return CMD_ERROR;
			break;

		case GT_TILE:
			if (!IsValidTile(p2)) return CMD_ERROR;
			break;

		case GT_INDUSTRY:
			if (!Industry::IsValidID(p2)) return CMD_ERROR;
			break;

		case GT_TOWN:
			if (!Town::IsValidID(p2)) return CMD_ERROR;
			break;

		case GT_COMPANY:
			if (!Company::IsValidID(p2)) return CMD_ERROR;
			break;

		case GT_STORY_PAGE: {
			if (!StoryPage::IsValidID(p2)) return CMD_ERROR;
			CompanyID story_company = StoryPage::Get(p2)->company;
			if (company == INVALID_COMPANY ? story_company != INVALID_COMPANY : story_company != INVALID_COMPANY && story_company != company) return CMD_ERROR;
			break;
		}

		default: return CMD_ERROR;
	}

	if (flags & DC_EXEC) {
		Goal *g = new Goal();
		g->type = type;
		g->dst = p2;
		g->company = company;
		g->text = stredup(text.c_str());
		g->progress = nullptr;
		g->completed = false;

		if (g->company == INVALID_COMPANY) {
			InvalidateWindowClassesData(WC_GOALS_LIST);
		} else {
			InvalidateWindowData(WC_GOALS_LIST, g->company);
		}
		if (Goal::GetNumItems() == 1) InvalidateWindowData(WC_MAIN_TOOLBAR, 0);

		_new_goal_id = g->index;
	}

	return CommandCost();
}

/**
 * Remove a goal.
 * @param tile unused.
 * @param flags type of operation
 * @param p1 GoalID to remove.
 * @param p2 unused.
 * @param text unused.
 * @return the cost of this operation or an error
 */
CommandCost CmdRemoveGoal(TileIndex tile, DoCommandFlag flags, uint32 p1, uint32 p2, const std::string &text)
{
	if (_current_company != OWNER_DEITY) return CMD_ERROR;
	if (!Goal::IsValidID(p1)) return CMD_ERROR;

	if (flags & DC_EXEC) {
		Goal *g = Goal::Get(p1);
		CompanyID c = g->company;
		delete g;

		if (c == INVALID_COMPANY) {
			InvalidateWindowClassesData(WC_GOALS_LIST);
		} else {
			InvalidateWindowData(WC_GOALS_LIST, c);
		}
		if (Goal::GetNumItems() == 0) InvalidateWindowData(WC_MAIN_TOOLBAR, 0);
	}

	return CommandCost();
}

/**
 * Update goal text of a goal.
 * @param tile unused.
 * @param flags type of operation
 * @param p1 GoalID to update.
 * @param p2 unused
 * @param text Text of the goal.
 * @return the cost of this operation or an error
 */
CommandCost CmdSetGoalText(TileIndex tile, DoCommandFlag flags, uint32 p1, uint32 p2, const std::string &text)
{
	if (_current_company != OWNER_DEITY) return CMD_ERROR;
	if (!Goal::IsValidID(p1)) return CMD_ERROR;
	if (text.empty()) return CMD_ERROR;

	if (flags & DC_EXEC) {
		Goal *g = Goal::Get(p1);
		free(g->text);
		g->text = stredup(text.c_str());

		if (g->company == INVALID_COMPANY) {
			InvalidateWindowClassesData(WC_GOALS_LIST);
		} else {
			InvalidateWindowData(WC_GOALS_LIST, g->company);
		}
	}

	return CommandCost();
}

/**
 * Update progress text of a goal.
 * @param tile unused.
 * @param flags type of operation
 * @param p1 GoalID to update.
 * @param p2 unused
 * @param text Progress text of the goal.
 * @return the cost of this operation or an error
 */
CommandCost CmdSetGoalProgress(TileIndex tile, DoCommandFlag flags, uint32 p1, uint32 p2, const std::string &text)
{
	if (_current_company != OWNER_DEITY) return CMD_ERROR;
	if (!Goal::IsValidID(p1)) return CMD_ERROR;

	if (flags & DC_EXEC) {
		Goal *g = Goal::Get(p1);
		free(g->progress);
		if (text.empty()) {
			g->progress = nullptr;
		} else {
			g->progress = stredup(text.c_str());
		}

		if (g->company == INVALID_COMPANY) {
			InvalidateWindowClassesData(WC_GOALS_LIST);
		} else {
			InvalidateWindowData(WC_GOALS_LIST, g->company);
		}
	}

	return CommandCost();
}

/**
 * Update completed state of a goal.
 * @param tile unused.
 * @param flags type of operation
 * @param p1 GoalID to update.
 * @param p2 completed state. If goal is completed, set to 1, otherwise 0.
 * @param text unused
 * @return the cost of this operation or an error
 */
CommandCost CmdSetGoalCompleted(TileIndex tile, DoCommandFlag flags, uint32 p1, uint32 p2, const std::string &text)
{
	if (_current_company != OWNER_DEITY) return CMD_ERROR;
	if (!Goal::IsValidID(p1)) return CMD_ERROR;

	if (flags & DC_EXEC) {
		Goal *g = Goal::Get(p1);
		g->completed = p2 == 1;

		if (g->company == INVALID_COMPANY) {
			InvalidateWindowClassesData(WC_GOALS_LIST);
		} else {
			InvalidateWindowData(WC_GOALS_LIST, g->company);
		}
	}

	return CommandCost();
}

/**
 * Ask a goal related question
 * @param tile unused.
 * @param flags type of operation
 * @param p1 various bitstuffed elements
 * - p1 = (bit  0 - 15) - Unique ID to use for this question.
 * - p1 = (bit 16 - 31) - Company or client for which this question is.
 * @param p2 various bitstuffed elements
 * - p2 = (bit 0 - 17) - Buttons of the question.
 * - p2 = (bit 29 - 30) - Question type.
 * - p2 = (bit 31) - Question target: 0 - company, 1 - client.
 * @param text Text of the question.
 * @return the cost of this operation or an error
 */
CommandCost CmdGoalQuestion(TileIndex tile, DoCommandFlag flags, uint32 p1, uint32 p2, const std::string &text)
{
	uint16 uniqueid = (uint16)GB(p1, 0, 16);
	CompanyID company = (CompanyID)GB(p1, 16, 8);
	ClientID client = (ClientID)GB(p1, 16, 16);

	static_assert(GOAL_QUESTION_BUTTON_COUNT < 29);
	uint32 button_mask = GB(p2, 0, GOAL_QUESTION_BUTTON_COUNT);
	byte type = GB(p2, 29, 2);
	bool is_client = HasBit(p2, 31);

	if (_current_company != OWNER_DEITY) return CMD_ERROR;
	if (text.empty()) return CMD_ERROR;
	if (is_client) {
		/* Only check during pre-flight; the client might have left between
		 * testing and executing. In that case it is fine to just ignore the
		 * fact the client is no longer here. */
		if (!(flags & DC_EXEC) && _network_server && NetworkClientInfo::GetByClientID(client) == nullptr) return CMD_ERROR;
	} else {
		if (company != INVALID_COMPANY && !Company::IsValidID(company)) return CMD_ERROR;
	}
	uint min_buttons = (type == GQT_QUESTION ? 1 : 0);
	if (CountBits(button_mask) < min_buttons || CountBits(button_mask) > 3) return CMD_ERROR;
	if (type >= GQT_END) return CMD_ERROR;

	if (flags & DC_EXEC) {
		if (is_client) {
			if (client != _network_own_client_id) return CommandCost();
		} else {
			if (company == INVALID_COMPANY && !Company::IsValidID(_local_company)) return CommandCost();
			if (company != INVALID_COMPANY && company != _local_company) return CommandCost();
		}
		ShowGoalQuestion(uniqueid, type, button_mask, text.c_str());
	}

	return CommandCost();
}

/**
 * Reply to a goal question.
 * @param tile unused.
 * @param flags type of operation
 * @param p1 Unique ID to use for this question.
 * @param p2 Button the company pressed
 * @param text Text of the question.
 * @return the cost of this operation or an error
 */
CommandCost CmdGoalQuestionAnswer(TileIndex tile, DoCommandFlag flags, uint32 p1, uint32 p2, const std::string &text)
{
	if (p1 > UINT16_MAX) return CMD_ERROR;
	if (p2 >= GOAL_QUESTION_BUTTON_COUNT) return CMD_ERROR;

	if (_current_company == OWNER_DEITY) {
		/* It has been requested to close this specific question on all clients */
		if (flags & DC_EXEC) CloseWindowById(WC_GOAL_QUESTION, p1);
		return CommandCost();
	}

	if (_networking && _local_company == _current_company) {
		/* Somebody in the same company answered the question. Close the window */
		if (flags & DC_EXEC) CloseWindowById(WC_GOAL_QUESTION, p1);
		if (!_network_server) return CommandCost();
	}

	if (flags & DC_EXEC) {
		Game::NewEvent(new ScriptEventGoalQuestionAnswer(p1, (ScriptCompany::CompanyID)(byte)_current_company, (ScriptGoal::QuestionButton)(1 << p2)));
	}

	return CommandCost();
}