Script directory

From Boktai Hacking Wiki

The script directory (contained in the master file table) contains both bytecode scripts and strings used in the game. It's layout is different than the other directories in the MFT:

struct script_directory {
  u32 unknown;                   // 0x3ea8eae6 in Boktai 1 (U)
  script_entry script_entries[];

  directory_offsets offsets;

  // string_index contains the start index (in string_data) for each string
  // NOTE: offsets.string_index points here
  u32 string_index[];
  // NOTE: offsets.string_data points here
  char string_data[];

  // NOTE: offsets.script_data points here
  u32 special_script_offset; // unknown...

  // NOTE: script_entry.offset is relative to here
  u8 bytecode[];

  // Unknown data, including the "special script"
  u8 unknown[?];
};

// Use one of these two structs for script_entry, depending on the game:

// script_entries[] array is null-terminated (ends when all fields are 0)
struct script_entry_boktai_1 {
  u32 id;     // script id
  u32 offset; // top 8 bits unknown (not part of offset)
};

// script_entries[] array is -1 terminated (ends when all fields are -1)
struct script_entry_boktai_2_and_3 {
  // id is implied (id = array index + 1), meaning the 1st script has ID 1, not ID 0!
  u32 offset; // top 8 bits unknown (not part of offset)
};

struct directory_offsets {
  // all offsets here are relative to the start of this struct
  u32 script_data;
  u32 string_index;
  u32 string_data;
  u32 unknown;     // offset to unknown data
};

Example code (Boktai 1)

script_entry_boktai_1* script_index;
int script_count;
u8* script_data;

char* string_data;
u32* string_index;

// ptr = pointer to script_directory
void open_script_directory(u8* ptr) {
  // skip "unknown" field
  ptr += 4;

  script_index = (script_entry_boktai_1*) ptr;
  // skip over script index
  while (true) {
    script_entry_boktai_1* entry = (script_entry_boktai_1*) ptr;
    ptr += 8;
    if (entry->id == 0 && entry->offset == 0) {
      break;
    }
    script_count++;
  }

  script_data = (u8*)(ptr + *(uint32_t*)ptr);
  string_index = (u32*)(ptr + *(uint32_t*)(ptr + 4));
  string_data = (char*)(ptr + *(uint32_t*)(ptr + 8));
}

char* get_string(int id) {
  // top bit is unknown, always seems to be 1?
  u32 offset = string_index[id] & 0x7fffffff;
  return string_data + offset;
}

u8* get_script(int id) {
  // NOTE: you should use a binary search (script_index is sorted by id)
  for (int i=0; i<script_count; i++) {
    script_entry_boktai_1* entry = script_index + i;
    if (entry->id == id) {
      // +4 to skip over the "special_script_offset" field
      return script_data + 4 + (entry->offset & 0x00ffffff);
    }
  }
  return NULL;
}

Example code (Boktai 2 & 3)

u32* script_index;
char* string_data;
u8* script_data;

int script_count;
u32* string_index;

// ptr = pointer to script_directory
void open_script_directory(u8* ptr) {
  // skip "unknown" field
  ptr += 4;

  script_index = (u32*) ptr;
  // skip over script index
  while (true) {
    u32 script_offset = *(u32*)ptr;
    ptr += 4;
    if (script_offset == 0xffffffff) {
      break;
    }
    script_count++;
  }

  script_data = (u8*)(ptr + *(uint32_t*)ptr);
  string_index = (u32*)(ptr + *(uint32_t*)(ptr + 4));
  string_data = (char*)(ptr + *(uint32_t*)(ptr + 8));
}

char* get_string(int id) {
  // top bit is unknown, always seems to be 1?
  u32 offset = string_index[id] & 0x7fffffff;
  return string_data + offset;
}

u8* get_script(int id) {
  if (id <= 0 || id > script_count) {
    return NULL;
  }
  u32 offset = script_index[id - 1];
  return script_data + 4 + (offset & 0x00ffffff);
}

See also