script_server.cpp

Go to the documentation of this file.

/*
 Copyright (c) 1996-2020 Freeciv21 and Freeciv contributors. This file is
 part of Freeciv21. Freeciv21 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, either version 3 of the
 License,  or (at your option) any later version. You should have received
 a copy of the GNU General Public License along with Freeciv21. If not,
 see https://www.gnu.org/licenses/.
 */
 
#include <cstdarg>
#include <ctime>
#include <sys/stat.h>
 
/* dependencies/lua */
extern "C" {
#include "lua.h"
 
/* dependencies/tolua */
#include "tolua.h"
}
// utility
#include "log.h"
#include "registry.h"
#include "registry_ini.h"
 
/* common/scriptcore */
#include "api_game_specenum.h"
#include "luascript.h"
#include "luascript_func.h"
#include "luascript_signal.h"
#include "tolua_game_gen.h"
#include "tolua_signal_gen.h"
// server
#include "console.h"
#include "stdinhand.h"
 
/* server/scripting */
#include "tolua_server_gen.h"
 
#include "script_server.h"
 
static struct fc_lua *fcl_main = nullptr;
static struct fc_lua *fcl_unsafe = nullptr;
 
static char *script_server_code = nullptr;
 
static void script_server_vars_init();
static void script_server_vars_free();
static void script_server_vars_load(struct section_file *file);
static void script_server_vars_save(struct section_file *file);
static void script_server_code_init();
static void script_server_code_free();
static void script_server_code_load(struct section_file *file);
static void script_server_code_save(struct section_file *file);
 
static void script_server_signals_create();
static void script_server_functions_define();
 
static void script_server_cmd_reply(struct fc_lua *fcl, QtMsgType level,
                                    const char *format, ...)
    fc__attribute((__format__(__printf__, 3, 4)));
 
static bool script_server_do_string_shared(struct fc_lua *fcl,
                                           struct connection *caller,
                                           const char *str)
{
  int status;
  struct connection *save_caller;
  luascript_log_func_t save_output_fct;
 
  /* Set a log callback function which allows to send the results of the
   * command to the clients. */
  save_caller = fcl->caller;
  save_output_fct = fcl->output_fct;
  fcl->output_fct = script_server_cmd_reply;
  fcl->caller = caller;
 
  status = luascript_do_string(fcl, str, "cmd");
 
  // Reset the changes.
  fcl->caller = save_caller;
  fcl->output_fct = save_output_fct;
 
  return (status == 0);
}
 
bool script_server_do_string(struct connection *caller, const char *str)
{
  return script_server_do_string_shared(fcl_main, caller, str);
}
 
bool script_server_unsafe_do_string(struct connection *caller,
                                    const char *str)
{
  return script_server_do_string_shared(fcl_unsafe, caller, str);
}
 
bool script_server_load_file(const char *filename, char **buf)
{
  FILE *ffile;
  struct stat stats;
  char *buffer;
 
  fc_stat(filename, &stats);
  ffile = fc_fopen(filename, "r");
 
  if (ffile != nullptr) {
    int len;
 
    buffer = new char[stats.st_size + 1];
    len = fread(buffer, 1, stats.st_size, ffile);
 
    if (len == stats.st_size) {
      buffer[len] = '\0';
 
      *buf = buffer;
    } else {
      delete[] buffer;
    }
    fclose(ffile);
  }
 
  return true;
}
 
static bool script_server_do_file_shared(struct fc_lua *fcl,
                                         struct connection *caller,
                                         const char *filename)
{
  int status = 1;
  struct connection *save_caller;
  luascript_log_func_t save_output_fct;
 
  /* Set a log callback function which allows to send the results of the
   * command to the clients. */
  save_caller = fcl->caller;
  save_output_fct = fcl->output_fct;
  fcl->output_fct = script_server_cmd_reply;
  fcl->caller = caller;
 
  status = luascript_do_file(fcl, filename);
 
  // Reset the changes.
  fcl->caller = save_caller;
  fcl->output_fct = save_output_fct;
 
  return (status == 0);
}
 
bool script_server_do_file(struct connection *caller, const char *filename)
{
  return script_server_do_file_shared(fcl_main, caller, filename);
}
 
bool script_server_unsafe_do_file(struct connection *caller,
                                  const char *filename)
{
  return script_server_do_file_shared(fcl_unsafe, caller, filename);
}
 
void script_server_remove_exported_object(void *object)
{
  luascript_remove_exported_object(fcl_main, object);
  luascript_remove_exported_object(fcl_unsafe, object);
}
 
static void script_server_vars_init()
{ // nothing
}
 
static void script_server_vars_free()
{ // nothing
}
 
static void script_server_vars_load(struct section_file *file)
{
  luascript_vars_load(fcl_main, file, "script.vars");
}
 
static void script_server_vars_save(struct section_file *file)
{
  luascript_vars_save(fcl_main, file, "script.vars");
}
 
static void script_server_code_init() { script_server_code = nullptr; }
 
static void script_server_code_free()
{
  if (script_server_code) {
    delete[] script_server_code;
    script_server_code = nullptr;
  }
}
 
static void script_server_code_load(struct section_file *file)
{
  if (!script_server_code) {
    const char *code;
    const char *section = "script.code";
 
    code = secfile_lookup_str_default(file, "", "%s", section);
    script_server_code = fc_strdup(code);
    luascript_do_string(fcl_main, script_server_code, section);
  }
}
 
static void script_server_code_save(struct section_file *file)
{
  if (script_server_code) {
    secfile_insert_str_noescape(file, script_server_code, "script.code");
  }
}
 
bool script_server_init()
{
  if (fcl_main != nullptr) {
    fc_assert_ret_val(fcl_main->state != nullptr, false);
 
    return true;
  }
 
  fcl_main = luascript_new(nullptr, true);
  if (fcl_main == nullptr) {
    luascript_destroy(fcl_main);
    fcl_main = nullptr;
 
    return false;
  }
 
  luascript_common_a(fcl_main->state);
  api_specenum_open(fcl_main->state);
  tolua_game_open(fcl_main->state);
  tolua_signal_open(fcl_main->state);
 
  tolua_server_open(fcl_main->state);
 
  luascript_common_z(fcl_main->state);
 
  script_server_code_init();
  script_server_vars_init();
 
  luascript_signal_init(fcl_main);
  script_server_signals_create();
 
  luascript_func_init(fcl_main);
  script_server_functions_define();
 
  // Add the unsafe instance.
  fcl_unsafe = luascript_new(nullptr, false);
  if (fcl_unsafe == nullptr) {
    luascript_destroy(fcl_unsafe);
    fcl_unsafe = nullptr;
 
    return false;
  }
 
  luascript_common_a(fcl_unsafe->state);
  api_specenum_open(fcl_unsafe->state);
  tolua_game_open(fcl_unsafe->state);
 
  tolua_server_open(fcl_unsafe->state);
 
  luascript_common_z(fcl_unsafe->state);
 
  luascript_signal_init(fcl_unsafe);
  luascript_func_init(fcl_unsafe);
 
  return true;
}
 
void script_server_free()
{
  if (fcl_main != nullptr) {
    script_server_code_free();
    script_server_vars_free();
 
    // luascript_signal_free() is called by luascript_destroy().
    luascript_destroy(fcl_main);
    fcl_main = nullptr;
  }
 
  if (fcl_unsafe != nullptr) {
    // luascript_signal_free() is called by luascript_destroy().
    luascript_destroy(fcl_unsafe);
    fcl_unsafe = nullptr;
  }
}
 
void script_server_state_load(struct section_file *file)
{
  script_server_code_load(file);
 
  /* Variables must be loaded after code is loaded and executed,
   * so we restore their saved state properly */
  script_server_vars_load(file);
}
 
void script_server_state_save(struct section_file *file)
{
  script_server_code_save(file);
  script_server_vars_save(file);
}
 
void script_server_signal_emit(const char *signal_name, ...)
{
  va_list args;
 
  va_start(args, signal_name);
  luascript_signal_emit_valist(fcl_main, signal_name, args);
  va_end(args);
}
 
static void script_server_signals_create()
{
  signal_deprecator *depr;
 
  luascript_signal_create(fcl_main, "turn_begin", 2, API_TYPE_INT,
                          API_TYPE_INT);
 
  /* Deprecated form of the 'turn_begin' signal that counts real turns
   * starting from 0. */
  depr = luascript_signal_create(fcl_main, "turn_started", 2, API_TYPE_INT,
                                 API_TYPE_INT);
  deprecate_signal(depr, "turn_started", "turn_begin", "3.0");
 
  luascript_signal_create(fcl_main, "unit_moved", 3, API_TYPE_UNIT,
                          API_TYPE_TILE, API_TYPE_TILE);
 
  // Includes all newly-built cities.
  luascript_signal_create(fcl_main, "city_built", 1, API_TYPE_CITY);
 
  luascript_signal_create(fcl_main, "city_size_change", 3, API_TYPE_CITY,
                          API_TYPE_INT, API_TYPE_STRING);
 
  /* Deprecated form of the 'city_size_change' signal for the case of growth.
   */
  depr = luascript_signal_create(fcl_main, "city_growth", 2, API_TYPE_CITY,
                                 API_TYPE_INT);
  deprecate_signal(depr, "city_growth", "city_size_change", "2.6");
 
  // Only includes units built in cities, for now.
  luascript_signal_create(fcl_main, "unit_built", 2, API_TYPE_UNIT,
                          API_TYPE_CITY);
  luascript_signal_create(fcl_main, "building_built", 2,
                          API_TYPE_BUILDING_TYPE, API_TYPE_CITY);
 
  /* These can happen for various reasons; the third argument gives the
   * reason (a simple string identifier).  Example identifiers:
   * "pop_cost", "need_tech", "need_building", "need_special",
   * "need_terrain", "need_government", "need_nation", "never",
   * "unavailable". */
  luascript_signal_create(fcl_main, "unit_cant_be_built", 3,
                          API_TYPE_UNIT_TYPE, API_TYPE_CITY,
                          API_TYPE_STRING);
  luascript_signal_create(fcl_main, "building_cant_be_built", 3,
                          API_TYPE_BUILDING_TYPE, API_TYPE_CITY,
                          API_TYPE_STRING);
 
  /* Third argument gives a reason; "landlocked", "cant_maintain",
   * "obsolete", "sold", "disaster", "sabotaged", "razed", "city_destroyed",
   * "conquered" (applicable for small wonders only)
   * Fourth argument gives unit that caused that, applicable for "sabotaged"
   */
  luascript_signal_create(fcl_main, "building_lost", 4, API_TYPE_CITY,
                          API_TYPE_BUILDING_TYPE, API_TYPE_STRING,
                          API_TYPE_UNIT);
 
  /* The third argument contains the source: "researched", "traded",
   * "stolen", "hut". */
  luascript_signal_create(fcl_main, "tech_researched", 3, API_TYPE_TECH_TYPE,
                          API_TYPE_PLAYER, API_TYPE_STRING);
 
  // First player is city owner, second is enemy.
  luascript_signal_create(fcl_main, "city_destroyed", 3, API_TYPE_CITY,
                          API_TYPE_PLAYER, API_TYPE_PLAYER);
 
  // First player is former owner, second new one.
  luascript_signal_create(fcl_main, "city_transferred", 4, API_TYPE_CITY,
                          API_TYPE_PLAYER, API_TYPE_PLAYER, API_TYPE_STRING);
 
  /* Deprecated form of the 'city_transferred' signal for the case of
   * conquest. */
  depr = luascript_signal_create(fcl_main, "city_lost", 3, API_TYPE_CITY,
                                 API_TYPE_PLAYER, API_TYPE_PLAYER);
  deprecate_signal(depr, "city_lost", "city_transferred", "2.6");
 
  luascript_signal_create(fcl_main, "hut_enter", 2, API_TYPE_UNIT,
                          API_TYPE_STRING);
  luascript_signal_create(fcl_main, "hut_frighten", 2, API_TYPE_UNIT,
                          API_TYPE_STRING);
 
  luascript_signal_create(fcl_main, "unit_lost", 3, API_TYPE_UNIT,
                          API_TYPE_PLAYER, API_TYPE_STRING);
 
  luascript_signal_create(fcl_main, "disaster_occurred", 3,
                          API_TYPE_DISASTER, API_TYPE_CITY, API_TYPE_BOOL);
 
  luascript_signal_create(fcl_main, "nuke_exploded", 2, API_TYPE_TILE,
                          API_TYPE_PLAYER);
 
  /* Deprecated form of the 'disaster_occurred' signal without
   * 'had_internal_effct' support. */
  depr = luascript_signal_create(fcl_main, "disaster", 2, API_TYPE_DISASTER,
                                 API_TYPE_CITY);
  deprecate_signal(depr, "disaster", "disaster_occurred", "2.6");
 
  luascript_signal_create(fcl_main, "achievement_gained", 3,
                          API_TYPE_ACHIEVEMENT, API_TYPE_PLAYER,
                          API_TYPE_BOOL);
 
  luascript_signal_create(fcl_main, "map_generated", 0);
 
  luascript_signal_create(fcl_main, "pulse", 0);
 
  luascript_signal_create(fcl_main, "action_started_unit_unit", 3,
                          API_TYPE_ACTION, API_TYPE_UNIT, API_TYPE_UNIT);
 
  luascript_signal_create(fcl_main, "action_started_unit_units", 3,
                          API_TYPE_ACTION, API_TYPE_UNIT, API_TYPE_TILE);
 
  luascript_signal_create(fcl_main, "action_started_unit_city", 3,
                          API_TYPE_ACTION, API_TYPE_UNIT, API_TYPE_CITY);
 
  luascript_signal_create(fcl_main, "action_started_unit_tile", 3,
                          API_TYPE_ACTION, API_TYPE_UNIT, API_TYPE_TILE);
 
  luascript_signal_create(fcl_main, "action_started_unit_self", 2,
                          API_TYPE_ACTION, API_TYPE_UNIT);
}
 
static void script_server_functions_define()
{
  luascript_func_add(fcl_main, "respawn_callback", false, 1, 0,
                     API_TYPE_PLAYER);
}
 
bool script_server_call(const char *func_name, ...)
{
  bool success;
 
  va_list args;
  va_start(args, func_name);
  success = luascript_func_call_valist(fcl_main, func_name, args);
  va_end(args);
 
  return success;
}
 
static void script_server_cmd_reply(struct fc_lua *fcl, QtMsgType level,
                                    const char *format, ...)
{
  va_list args;
  enum rfc_status rfc_status = C_OK;
  char buf[1024];
 
  va_start(args, format);
  fc_vsnprintf(buf, sizeof(buf), format, args);
  va_end(args);
 
  switch (level) {
  case LOG_FATAL:
    // Special case - will quit the server.
    qFatal("%s", buf);
    break;
  case LOG_ERROR:
  case LOG_WARN:
    rfc_status = C_WARNING;
    break;
  case LOG_NORMAL:
    rfc_status = C_COMMENT;
    break;
  case LOG_VERBOSE:
    rfc_status = C_LOG_BASE;
    break;
  }
 
  cmd_reply(CMD_LUA, fcl->caller, rfc_status, "%s", buf);
}