Function PlayerSetShipPermission

Descent3/Player.cpp:3632–3661

Sets/Clears a permission for a ship on a given player if pnum is -1 then all players will be set, else player is the player number returns true on success

//	if pnum is -1 then all players will be set, else player is the player number
//	returns true on success
bool PlayerSetShipPermission(int pnum, char *ship_name, bool allowed) {
  ASSERT(ship_name);

  if (pnum < -1 || pnum >= MAX_PLAYERS) // illegal value
    return false;

  int ship_index = FindShipName(ship_name);
  if (ship_index == -1) {
    ASSERT(ship_index != -1);
    return false;
  }
  int bit = 0x01;
  bit = bit << ship_index;

  if (pnum == -1) {
    // go through everyone
    for (int i = 0; i < MAX_PLAYERS; i++) {
      if (allowed)
        Players[i].ship_permissions |= bit;
      else
        Players[i].ship_permissions &= ~bit;
    }
  } else {
    if (allowed)
      Players[pnum].ship_permissions |= bit;
    else
      Players[pnum].ship_permissions &= ~bit;
  }
  return true;
}

//	Resets the ship permissions for a given player
//	pass false for set_default if you don't want the default ship allowed