atiran/porymap
3
Fork 0
Code Issues Pull requests Projects Releases 1 Packages Wiki Activity Actions

Update project files page

Browse source
This commit is contained in:
GriffinR 2022-10-14 12:38:33 -04:00
parent dd66f967f8
commit 614242f1fe
3 changed files with 50 additions and 40 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

88
docsrc/manual/project-files.rst
View file

@ -6,46 +6,58 @@ Porymap relies on the user maintaining a certain level of integrity with their p
This is a list of files that porymap reads from and writes to. Generally, if porymap writes This is a list of files that porymap reads from and writes to. Generally, if porymap writes
to a file, it probably is not a good idea to edit yourself unless otherwise noted. to a file, it probably is not a good idea to edit yourself unless otherwise noted.
The filepath that Porymap expects for each file can be overridden with config options. The name of each config override is listed in the table, and should begin with ``path/``.
For example if you wanted to rename ``include/constants/items.h`` to ``headers/defines/stuff.h``, you would add ``path/constants_items=headers/defines/stuff.h`` to your project's ``porymap.project.cfg`` file.
.. csv-table:: .. csv-table::
:header: File Name,Read,Write,Notes :header: File Name,Read,Write,Override,Notes
:widths: 20, 5, 5, 30 :widths: 20, 5, 5, 20, 30
data/maps/\*/map.json, yes, yes, data/maps/\*/map.json, yes, yes, ``data_map_folders``,
data/event_scripts.s, no, yes, only appends new script files to end of file data/maps/\*/scripts.[inc|pory], yes, no, ``data_map_folders``, for finding script labels
data/maps/map_groups.json, yes, yes, data/scripts/\*.[inc|pory], yes, no, ``data_scripts_folders``, for finding script labels
data/layouts/layouts.json, yes, yes, also reads border and blockdata files listed in this file data/event_scripts.s, no, yes, ``data_event_scripts``, only appends new script files to end of file
data/tilesets/headers.inc, yes, yes, data/maps/map_groups.json, yes, yes, ``json_map_groups``,
data/tilesets/graphics.inc, yes, yes, also edits palette and tile image files listed in this file data/layouts/layouts.json, yes, yes, ``json_layouts``,
data/tilesets/metatiles.inc, yes, yes, also edits metatile files listed in this file data/layouts/\*/[border|map].bin, yes, yes, ``data_layouts_folders``,
src/data/wild_encounters.json, yes, yes, src/data/tilesets/headers.h, yes, yes, ``tilesets_headers``,
src/data/object_events/object_event_graphics_info_pointers.h, yes, no, src/data/tilesets/graphics.h, yes, yes, ``tilesets_graphics``, also edits palette and tile image files listed in this file
src/data/object_events/object_event_graphics_info.h, yes, no, src/data/tilesets/metatiles.h, yes, yes, ``tilesets_metatiles``, also edits metatile files listed in this file
src/data/object_events/object_event_pic_tables.h, yes, no, data/tilesets/headers.inc, yes, yes, ``tilesets_headers_asm``, only if ``tilesets_headers`` can't be found
src/data/object_events/object_event_graphics.h, yes, no, data/tilesets/graphics.inc, yes, yes, ``tilesets_graphics_asm``, only if ``tilesets_headers`` can't be found
src/data/graphics/pokemon.h, yes, no, for pokemon sprite icons data/tilesets/metatiles.inc, yes, yes, ``tilesets_metatiles_asm``, only if ``tilesets_headers`` can't be found
src/data/heal_locations.h, yes, yes, data/tilesets/[primary|secondary]/\*, yes, yes, ``data_tilesets_folders``, default tileset data location
src/data/region_map/region_map_entries.h, yes, yes, src/data/wild_encounters.json, yes, yes, ``json_wild_encounters``,
include/constants/global.h, yes, no, src/data/object_events/object_event_graphics_info_pointers.h, yes, no, ``data_obj_event_gfx_pointers``,
include/constants/map_groups.h, no, yes, src/data/object_events/object_event_graphics_info.h, yes, no, ``data_obj_event_gfx_info``,
include/constants/items.h, yes, no, src/data/object_events/object_event_pic_tables.h, yes, no, ``data_obj_event_pic_tables``,
include/constants/opponents.h, yes, no, reads max trainers constant src/data/object_events/object_event_graphics.h, yes, no, ``data_obj_event_gfx``,
include/constants/flags.h, yes, no, src/data/graphics/pokemon.h, yes, no, ``data_pokemon_gfx``, for pokemon sprite icons
include/constants/vars.h, yes, no, src/data/heal_locations.h, yes, yes, ``data_heal_locations``,
include/constants/weather.h, yes, no, src/data/region_map/region_map_sections.json, yes, yes, ``json_region_map_entries``,
include/constants/songs.h, yes, no, src/data/region_map/porymap_config.json, yes, yes, ``json_region_porymap_cfg``,
include/constants/heal_locations.h, no, yes, include/constants/global.h, yes, no, ``constants_global``, reads ``OBJECT_EVENT_TEMPLATES_COUNT``
include/constants/pokemon.h, yes, no, reads min and max level constants include/constants/map_groups.h, no, yes, ``constants_map_groups``,
include/constants/map_types.h, yes, no, include/constants/items.h, yes, no, ``constants_items``,
include/constants/trainer_types.h, yes, no, include/constants/opponents.h, yes, no, ``constants_opponents``, reads max trainers constant
include/constants/secret_bases.h, yes, no, pokeemerald and pokeruby only include/constants/flags.h, yes, no, ``constants_flags``,
include/constants/event_object_movement.h, yes, no, include/constants/vars.h, yes, no, ``constants_vars``,
include/constants/event_objects.h, yes, no, include/constants/weather.h, yes, no, ``constants_weather``,
include/constants/event_bg.h, yes, no, include/constants/songs.h, yes, no, ``constants_songs``,
include/constants/region_map_sections.h, yes, no, include/constants/heal_locations.h, yes, yes, ``constants_heal_locations``,
include/constants/metatile_labels.h, yes, yes, include/constants/pokemon.h, yes, no, ``constants_pokemon``, reads min and max level constants
include/constants/metatile_behaviors.h, yes, no, include/constants/map_types.h, yes, no, ``constants_map_types``,
include/fieldmap.h, yes, no, reads tileset related constants include/constants/trainer_types.h, yes, no, ``constants_trainer_types``,
src/event_object_movement.c, yes, no, include/constants/secret_bases.h, yes, no, ``constants_secret_bases``, pokeemerald and pokeruby only
include/constants/event_object_movement.h, yes, no, ``constants_obj_event_movement``,
include/constants/event_objects.h, yes, no, ``constants_obj_events``,
include/constants/event_bg.h, yes, no, ``constants_event_bg``,
include/constants/region_map_sections.h, yes, no, ``constants_region_map_sections``,
include/constants/metatile_labels.h, yes, yes, ``constants_metatile_labels``,
include/constants/metatile_behaviors.h, yes, no, ``constants_metatile_behaviors``,
include/fieldmap.h, yes, no, ``constants_fieldmap``, reads tileset related constants
src/event_object_movement.c, yes, no, ``path_initial_facing_table``, reads ``gInitialMovementTypeFacingDirections``
src/pokemon_icon.c, yes, no, ``path_pokemon_icon_table``, reads files in ``gMonIconTable``

1
include/config.h
View file

@ -163,7 +163,6 @@ enum ProjectFilePath {
data_obj_event_gfx, data_obj_event_gfx,
data_pokemon_gfx, data_pokemon_gfx,
data_heal_locations, data_heal_locations,
data_region_map_entries,
constants_global, constants_global,
constants_map_groups, constants_map_groups,
constants_items, constants_items,

1
src/config.cpp
View file

@ -39,7 +39,6 @@ const QMap<ProjectFilePath, std::pair<QString, QString>> defaultPaths = {
{ProjectFilePath::data_obj_event_gfx, { "data_obj_event_gfx", "src/data/object_events/object_event_graphics.h"}}, {ProjectFilePath::data_obj_event_gfx, { "data_obj_event_gfx", "src/data/object_events/object_event_graphics.h"}},
{ProjectFilePath::data_pokemon_gfx, { "data_pokemon_gfx", "src/data/graphics/pokemon.h"}}, {ProjectFilePath::data_pokemon_gfx, { "data_pokemon_gfx", "src/data/graphics/pokemon.h"}},
{ProjectFilePath::data_heal_locations, { "data_heal_locations", "src/data/heal_locations.h"}}, {ProjectFilePath::data_heal_locations, { "data_heal_locations", "src/data/heal_locations.h"}},
{ProjectFilePath::data_region_map_entries, { "data_region_map_entries", "src/data/region_map/region_map_entries.h"}},
{ProjectFilePath::constants_global, { "constants_global", "include/constants/global.h"}}, {ProjectFilePath::constants_global, { "constants_global", "include/constants/global.h"}},
{ProjectFilePath::constants_map_groups, { "constants_map_groups", "include/constants/map_groups.h"}}, {ProjectFilePath::constants_map_groups, { "constants_map_groups", "include/constants/map_groups.h"}},
{ProjectFilePath::constants_items, { "constants_items", "include/constants/items.h"}}, {ProjectFilePath::constants_items, { "constants_items", "include/constants/items.h"}},