Collection of tools for the Poke-Emerald decompilation project

This project contains a collection of tools for editing various aspects of the pokeemerald decompilation project.

One available tool allows for editing overworld object events, or "sprites". This tool allows for editing all of the various properties of an event object, and allows for uploading new sprite images directly.

The format used by this tool differs from the default currently present at pokeemerald/master. When loading a project using the default format, the tool will prompt the user with an attempt to auto-convert the format to one usable by this tool. The conversion will automatically handle a majority of the necessary changes to the project directory, but a few need to be handled manually:

• In jsonproc.cpp, add the following event callbacks.

env.add_callback("upperSnakeCase", 1, [](Arguments& args) {
	string value = args.at(0)->get<string>();
	if (value.empty())
		return value;

	string output;
	output.push_back(std::toupper(value.front()));
	for (size_t i = 1, e = value.size(); i != e; ++i) {
		if (std::isupper(value[i]) || (!std::islower(value[i]) && std::isalpha(value[i - 1])))
			output.push_back('_');
		output.push_back(std::toupper(value[i]));
	}
	return output;
});

env.add_callback("add", 2, [](Arguments& args) {
	int lhs = args.at(0)->get<int>();
	int rhs = args.at(1)->get<int>();

	return lhs + rhs;
});

env.add_callback("multiply", 2, [](Arguments& args) {
	int lhs = args.at(0)->get<int>();
	int rhs = args.at(1)->get<int>();

	return lhs * rhs;
});

env.add_callback("divide", 2, [](Arguments& args) {
	int lhs = args.at(0)->get<int>();
	int rhs = args.at(1)->get<int>();

	return lhs / rhs;
});

Note: Depending on the original contents of your event objects files, you may need to add additional make dependencies to ensure the files are generated before they get included. This can also generally be solved by running make a few times, if you don't want/know how to update the makefile.

One available tool allows for editing trainers. This tool allows for editing all of the various properties of a trainer. This includes the party data, available trainer classes, and the front pictures the trainers use in battle.

The format used by this tool differs from the default currently present at pokeemerald/master. When loading a project using the default format, the tool will prompt the user with an attempt to auto-convert the format to one usable by this tool. The conversion will automatically handle a majority of the necessary changes to the project directory, but a few need to be handled manually:

• In jsonproc.cpp, add the following event callbacks.

env.add_callback("CamelCase", 1, [](Arguments& args) {
	string value = args.at(0)->get<string>();
	if (value.empty())
		return value;

	string output;
	output.push_back(std::toupper(value.front()));
	for (size_t i = 1, e = value.size(); i != e; ++i) {
		if (value[i] == '_') {
			if (i != e - 1)
				output.push_back(std::toupper(value[++i]));
			continue;
		}
		output.push_back(std::tolower(value[i]));
	}
	return output;
});

In certain situations the tool may hang or fail to load a project if the format of the necessary project *.c files are different than what the tool expects. This comes with the territory of trying to parse .c textually, but can be difficult to debug. If such a situation arises, the editor keeps a log of events in a decompEditor.log file (generally AppData/Roaming) that can be viewed to see which events, including specific files, are leading to the failure.