SilverMUD/src/gamelogic.h

// gamelogic.h: Function prototypes and data-structures for dealing with game logic.
// Barry Kane, 2022.
#ifndef GAMELOGIC_H
#define GAMELOGIC_H
#include "queue.h"
#include "areadata.h"
#include "constants.h"
#include "playerdata.h"
#include "inputoutput.h"

// ========================
// -=[ Data Structures ]=-:
// ========================

// An event for storing the information
typedef struct commandEvent commandEvent;
typedef struct commandEvent
{
	playerInfo * caller;
	commandEvent * next;
	char * command;
	char * arguments;
} commandEvent;

// A data-structure containing the needed parameters for a main game loop:
typedef struct gameLogicParameters
{
	// Players:
	int * playerCount;
	playerInfo * connectedPlayers;

	// Queues:
	queue * inputQueue;
	queue * outputQueue;

	// Lists:
	list * areaList;
	list * globalSkillList;
} gameLogicParameters;

// ========================
// -=[    Functions    ]=-:
// ========================

// Player movement:
int movePlayerToArea(playerInfo * player, char * requestedPath);

// Thread function which runs the main game loop, given the needed parameters:
void * gameLogicHandler(void * parameters);

// Enqueue a command to a commandQueue:
void queueCommand(queue * queue, char * command, char * arguments,
				 int commandLength, int argumentsLength , playerInfo * callingPlayer);

// Enqueue a messaged command to a commandQueue:
void queueMessagedCommand(queue * queue, inputMessage * messageToQueue);

// Evaluate the next commandEvent:
int evaluateNextCommand(gameLogicParameters * parameters, queue * queue);

// ============================
// -=[ Gameplay Primitives ]=-:
// ============================

// The possible outcomes of a check or challenge:
typedef enum outcome
{
	CRITICAL_FAILURE,
	FAILURE,
	SUCCESS,
	CRITICAL_SUCCESS,
	ERROR
} outcome;

// Player movement:
int movePlayerToArea(playerInfo * player, char * requestedPath);

// Run a stat check:
outcome statCheck(playerInfo * player, int chance, coreStat statToCheck);

// Run a skill check:
outcome skillCheck(playerInfo * player, int chance, char * skillName, size_t skillNameLength, list * globalSkillList);

#endif