Paragon 3DS: Difference between revisions

Paragon
Paragon
General
Author	thane98
Type	Hack Utilities
Version	Alpha-2-3-3
License	GPL-3.0
Last Updated	2024/10/21
Links
	mscOS/Win/Linux Download
	Website
	Source

Latest revision as of 00:13, 27 October 2024

Paragon is a toolkit for editing and creating editors for FE13, FE14, and FE15.

It is the next iteration of FEFEditor and FEFNightmare. Unlike its predecessors, Paragon operates on an entire ROM instead of individual files so that it can see common data between files, tables, etc. This leads to a more streamlined editing process. You can edit most data in FE13, FE14, and FE15 using Paragon, though FE14 (Fates) has the most features currently. While Paragon is still in an alpha state, it's already more stable than FEFEditor.

Installation

Paragon releases should require no dependencies. Download the release for your operating system and run.

User guide

Useful links

Paragon wiki - Documentation and usage instructions.
Creating Content in Paragon - A series of tutorials on how to use Paragon.
Exalt - A script/cmb compiler and decompiler for 3DSFE. Created for use with Paragon/3DSFE romhacking.
BCSAR View - An editor for 3DS sound archives. Created for use with Paragon/3DSFE romhacking.
Fire Emblem Echoes Random Class Generator - Randomize classes for characters in Fire Emblem Echoes: Shadows of Valentia. Outputs JSON which can be used to apply changes to your ROM. This tool uses Paragon features, take a look at the if you're interested.

Screenshots

Changelog

Rewrite Alpha 2-3-3

Better handling of the FE8Data file structure. This should fix crashes encountered by some users.
Fixed a bug which caused errors when trying to add new non-standard FE14 supports.
Fixed a bug which prevented adding supports to a character who had no existing support effects in FE15.
Fixed a bug which prevented some script files (ex. Command.cmb) from compiling.

Rewrite Alpha 2-3-2

Fixed a bug with completions in the dialogue editor which caused it to effectively prevent you from making changes to the script.
Added line numbers to the dialogue editor.
Made the drop down in the dialogue editor searchable.
Corrected stat labels in the FE9 item editor (thanks Kalen!).
Switched the scaling policy for high DPI displays to (hopefully) avoid visual artifacts introduced from the Qt 5 to Qt 6 migration.
Added separate x86 and arm builds for MacOS.

Rewrite Alpha 2-3-1

Added a way to create new family supports for FE13.
Added sibling supports to the family support widget for FE13.
Added a missing line for when a character maxes out their stats to the FE14 dialogue editor.
Fixed support dialogue types rendering incorrectly for FE14 and FE15.

Rewrite Alpha 2-3

General:
- Added an editor for scripts.
- Files will now save when you make edits instead of when you open their editors. A new "Store Manager" is available to see what files will be saved and force Paragon to save a file
- FE9 support
- Added a multi-line widget for text/message entries and updated several UIs accordingly
- Compacted several UIs by removing redundant padding
- The dialogue editor will now error if you try to use a blush / sweat modifier without another emotion
- FE13/FE14/FE15: Paragon will automatically create a script for new chapters
- FE13/FE14: Better algorithm for hair recolors (thanks patataofcourse!)
- Upgraded Qt and Python
FE10:
- FE10Battle support
- Added a map / dispos editor
- Better handling of differences between NA and PAL versions
FE13:
- Added renown module
- Added way to edit family supports
- Filled in several unknown fields (thanks Heritor!)
FE14:
- Filled in unknown field for spawns (unknown_1 -> class)
- Retyped in unknown fields for terrain (were marked as bytes, changed to strings)
- The route for a new chapter will be automatically set (was only used for file placement previously)
- Added a few missing lines to the dialogue editor
FE15:
- Reverted event editor changes due to a bug which caused Paragon to corrupt the file

Rewrite Alpha 2-2-1

General:

Added a compact zoom option to the map editor.
The icon combo box will load even if Paragon is unable to parse the icons texture.

FE13:

Added a WIP endings editor.
Added more lines to the character dialogue editor.
Added a faction name field to the FE13 dispos multi.
Fixed a bug which prevented Paragon from persisting changes to GameData.bin.lz in the chapter editor

FE14:

Fixed a bug with adding / deleting entries in path bonuses, battle bonuses, etc.

FE15:

Identified unknown JobCC fields (thanks Algo!)
Fixed a bug which prevented Paragon from persisting dungeon data changes

Rewrite Alpha 2-2

FE10:

FE10Intro module.
Fixed a bug with conditionally present data (item stat bonuses).
Switched from wide to regular icons.

FE13:

Portrait previews will colorize hair for gen2 and Robin.

FE14:

The chapter editor will correctly identify a character from a handover PID.
Fixed a bug with adding new asset specs?

FE15:

New editor for dungeons + enemy encounters.
Added an editor for supports.
Reworked event editor. Now uses a basic scripting language.
Added UIs for several modules that were missing them.
Reworked / compacted class and character UIs.

Rewrite Alpha 2-1

Fix syntax errors in the dialogue editor crashing Paragon.
Add FE14 CastlePerson module.
Fix casing issues with FE15 chapters.
Add several missing fields to the FE10 character UI.
Correct type of unknown field in FE14 tile module (thanks Sierra).
Support language specific UIs and type definitions (needed for FE10).
Don't open landscape files automatically in FE13 chapter module.
Add support type field in FE13 reliance list module (thanks sejong).
Identify fields in FE15 support bonuses (thanks Algo).
Fix FE15 health display (unsigned, not signed).
Fix support key generation for Corrin (_PCM1/_PCF1 prefix).
Support for Corrin in the Quick Dialogue Generator.

Rewrite Alpha 2

General:

Dialogue editor improvements:
- Auto-save when the editor loses focus.
- Added a way to view available emotions.
- Added a character/line counter.
- Fixed panicked dialogue command.
- Support for Wf/Flip command.
- FE13/FE14: emulate text cutoff when a line is too long.
- Fixed a bug with loading portraits with overlapping names (ex. multiple portrait entries which use Camilla in the name field).
Faction reordering in the chapter editor.
Made most UIs more compact.
Reduced windows executable size.
Fixed a silent failure issue when copying items in a list widget.

Radiant Dawn / FE10:

Modules for FE10Data, FE10Conversation, FE10Effect, FE10Epilogue, FaceData, SoundData, shop data, and dispos.
Very rough editors for chapter scripts and dialogue.

Awakening / FE13:

RelianceList module.
Correct handling of the blush modifier in FE13 dialogue.
Updated the UI for FE13 character sprite data - now supports adding entries for new classes.
Updated the emotions list in the dialogue simulator (thanks nini).
Added tab for character dialogue / one off lines in the character editor.

Fates / FE14:

Added a quick dialogue generator for supports.
Improved loading speeds in the character editor.
Converted on_hit_effects in the assets editor from a float to bitflags.
New modules:
- Animation Sets / aset.
- DiningData.
- CastleButlerVoice.

Shadows of Valentia / FE15:

Filled in fields in the support condition module (thanks brian_alien).

Release notes.

Credits

lazy for texture parsing as well as completion support for dialogue.
Moonling for writing most of the modules.
RainThunder for the original FE14 Nightmare modules.
Einstein95 for DSDecmp.
Hextator for Nightmare 2 which was a major inspiration for Paragon.
FontAwesome for icons. NOTE: Most icons were colorized to work better with light and dark modes.
3dstools and xDaniel for etc1a4 decompression.
FEAT and Ohana3DS for bch parsing references.

External links

GitHub - https://github.com/thane98/paragon
GBAtemp - https://gbatemp.net/threads/wip-paragon-fire-emblem-fates.457799
Serenes Forest Forums - https://forums.serenesforest.net/index.php?/topic/94469-paragon-3dsfe-hacking-toolkit

@@ Line 1: / Line 1: @@
 {{Infobox 3DS Homebrews
 |title=Paragon
+|image=paragon3ds2.png
 |description=Toolkit for editing and creating editors for FE13, FE14, and FE15. Successor to FEFEditor.
 |author=thane98
-|lastupdated=2021/08/30
+|lastupdated=2024/10/21
 |type=Hack Utilities
-|version=Alpha-2
+|version=Alpha-2-3-3
-|license=Mixed
+|license=GPL-3.0
-|download=https://dlhb.gamebrew.org/3dshomebrew/paragonvalpha2.7z
+|download=https://dlhb.gamebrew.org/3dshomebrews/paragon3ds.7z mscOS/Win/Linux
-|website=https://github.com/thane98/paragon/
+|website=https://github.com/thane98/paragon
-|source=https://github.com/thane98/paragon/
+|source=https://github.com/thane98/paragon
 }}
-<youtube>uXu-dHnTiJA</youtube>
 Paragon is a toolkit for editing and creating editors for FE13, FE14, and FE15.
-== Installation ==
+It is the next iteration of FEFEditor and FEFNightmare. Unlike its predecessors, Paragon operates on an entire ROM instead of individual files so that it can see common data between files, tables, etc. This leads to a more streamlined editing process. You can edit most data in FE13, FE14, and FE15 using Paragon, though FE14 (Fates) has the most features currently. While Paragon is still in an alpha state, it's already more stable than FEFEditor.
+==Installation==
 Paragon releases should require no dependencies. Download the release for your operating system and run.
-== Building ==
+==User guide==
+===Useful links===
+* [https://github.com/thane98/paragon/wiki Paragon wiki] - Documentation and usage instructions.
+* [https://gamebanana.com/tuts/13170 Creating Content in Paragon] - A series of tutorials on how to use Paragon.
+* [[Exalt 3DS|Exalt]] - A script/cmb compiler and decompiler for 3DSFE. Created for use with Paragon/3DSFE romhacking.
+* [https://github.com/thane98/BCSAR-View/releases BCSAR View] - An editor for 3DS sound archives. Created for use with Paragon/3DSFE romhacking.
+* [https://evinjaff.github.io/FESOV-randomizer/ Fire Emblem Echoes Random Class Generator] - Randomize classes for characters in Fire Emblem Echoes: Shadows of Valentia. Outputs JSON which can be used to apply changes to your ROM. This tool uses Paragon features, take a look at the if you're interested.
-Paragon requires Rust and Python 3.8.x. You will also need to install the python packages listed in <code>requirements.txt</code>. More on this below. If you want to build a standalone executable, you should also install PyInstaller.
+==Screenshots==
+https://dlhb.gamebrew.org/3dshomebrews/paragon3ds3.png
+https://dlhb.gamebrew.org/3dshomebrews/paragon3ds4.png
-# Install the virtualenv package for Python. This is used to create an environment for building.
+https://dlhb.gamebrew.org/3dshomebrews/paragon3ds5.png
-# If you have not already done so, create a virtual environment for the project by running <code>virtualenv venv</code> in the root directory of the project. This should produce a folder named &quot;venv&quot;.
-# Enter the virtual environment by running the appropriate command for your operating system. In Windows Powershell, for example, the command is &quot;./venv/Scripts/activate.ps1&quot;.
-# Install the required python packages. You can do this conveniently by running <code>pip install -r requirements.txt</code> from the root directory of the project.
-# To build the Rust backend, run <code>maturin develop --release</code> from the root directory of the project. This will produce a &quot;target&quot; folder and a &quot;pyd&quot; file in the paragon folder.
-# If the install succeeds, you can run the main script with the command <code>python paragon/ui/main.py</code>.
-== Tools Using Paragon ==
+https://dlhb.gamebrew.org/3dshomebrews/paragon3ds7.png
-The following tools use Paragon features like import/export to edit FE13, FE14, and FE15. Take a look at the if you're interested!
+==Changelog==
+'''Rewrite Alpha 2-3-3'''
+* Better handling of the FE8Data file structure. This should fix crashes encountered by some users.
+* Fixed a bug which caused errors when trying to add new non-standard FE14 supports.
+* Fixed a bug which prevented adding supports to a character who had no existing support effects in FE15.
+* Fixed a bug which prevented some script files (ex. Command.cmb) from compiling.
+'''Rewrite Alpha 2-3-2'''
+* Fixed a bug with completions in the dialogue editor which caused it to effectively prevent you from making changes to the script.
+* Added line numbers to the dialogue editor.
+* Made the drop down in the dialogue editor searchable.
+* Corrected stat labels in the FE9 item editor (thanks Kalen!).
+* Switched the scaling policy for high DPI displays to (hopefully) avoid visual artifacts introduced from the Qt 5 to Qt 6 migration.
+* Added separate x86 and arm builds for MacOS.
+'''Rewrite Alpha 2-3-1'''
+* Added a way to create new family supports for FE13.
+* Added sibling supports to the family support widget for FE13.
+* Added a missing line for when a character maxes out their stats to the FE14 dialogue editor.
+* Fixed support dialogue types rendering incorrectly for FE14 and FE15.
+'''Rewrite Alpha 2-3'''
+*General:
+** Added an editor for scripts.
+** Files will now save when you make edits instead of when you open their editors. A new &quot;Store Manager&quot; is available to see what files will be saved and force Paragon to save a file
+** FE9 support
+** Added a multi-line widget for text/message entries and updated several UIs accordingly
+** Compacted several UIs by removing redundant padding
+** The dialogue editor will now error if you try to use a blush / sweat modifier without another emotion
+** FE13/FE14/FE15: Paragon will automatically create a script for new chapters
+** FE13/FE14: Better algorithm for hair recolors (thanks patataofcourse!)
+** Upgraded Qt and Python
+*FE10:
+** FE10Battle support
+** Added a map / dispos editor
+** Better handling of differences between NA and PAL versions
+*FE13:
+** Added renown module
+** Added way to edit family supports
+** Filled in several unknown fields (thanks Heritor!)
+*FE14:
+** Filled in unknown field for spawns (unknown_1 -&gt; class)
+** Retyped in unknown fields for terrain (were marked as bytes, changed to strings)
+** The route for a new chapter will be automatically set (was only used for file placement previously)
+** Added a few missing lines to the dialogue editor
+*FE15:
+** Reverted event editor changes due to a bug which caused Paragon to corrupt the file
-=== Fire Emblem Echoes Random Class Generator ===
+'''Rewrite Alpha 2-2-1'''
-Randomize classes for characters in Fire Emblem Echoes: Shadows of Valentia. Outputs JSON which can be used to apply changes to your ROM.
+General:
+*Added a compact zoom option to the map editor.
+*The icon combo box will load even if Paragon is unable to parse the icons texture.
-[https://evinjaff.github.io/FESOV-randomizer/ https://evinjaff.github.io/FESOV-randomizer/]
+FE13:
+*Added a WIP endings editor.
+*Added more lines to the character dialogue editor.
+*Added a faction name field to the FE13 dispos multi.
+*Fixed a bug which prevented Paragon from persisting changes to GameData.bin.lz in the chapter editor
-== Credits ==
+FE14:
+*Fixed a bug with adding / deleting entries in path bonuses, battle bonuses, etc.
+FE15:
+*Identified unknown JobCC fields (thanks Algo!)
+*Fixed a bug which prevented Paragon from persisting dungeon data changes
+'''Rewrite Alpha 2-2'''
+FE10:
+* FE10Intro module.
+* Fixed a bug with conditionally present data (item stat bonuses).
+* Switched from wide to regular icons.
+FE13:
+* Portrait previews will colorize hair for gen2 and Robin.
+FE14:
+* The chapter editor will correctly identify a character from a handover PID.
+* Fixed a bug with adding new asset specs?
+FE15:
+* New editor for dungeons + enemy encounters.
+* Added an editor for supports.
+* Reworked event editor. Now uses a basic scripting language.
+* Added UIs for several modules that were missing them.
+* Reworked / compacted class and character UIs.
+'''Rewrite Alpha 2-1'''
+* Fix syntax errors in the dialogue editor crashing Paragon.
+* Add FE14 CastlePerson module.
+* Fix casing issues with FE15 chapters.
+* Add several missing fields to the FE10 character UI.
+* Correct type of unknown field in FE14 tile module (thanks Sierra).
+* Support language specific UIs and type definitions (needed for FE10).
+* Don't open landscape files automatically in FE13 chapter module.
+* Add support type field in FE13 reliance list module (thanks sejong).
+* Identify fields in FE15 support bonuses (thanks Algo).
+* Fix FE15 health display (unsigned, not signed).
+* Fix support key generation for Corrin (_PCM1/_PCF1 prefix).
+* Support for Corrin in the Quick Dialogue Generator.
+'''Rewrite Alpha 2'''
+General:
+* Dialogue editor improvements:
+** Auto-save when the editor loses focus.
+** Added a way to view available emotions.
+** Added a character/line counter.
+** Fixed panicked dialogue command.
+** Support for Wf/Flip command.
+** FE13/FE14: emulate text cutoff when a line is too long.
+** Fixed a bug with loading portraits with overlapping names (ex. multiple portrait entries which use Camilla in the name field).
+* Faction reordering in the chapter editor.
+* Made most UIs more compact.
+* Reduced windows executable size.
+* Fixed a silent failure issue when copying items in a list widget.
+Radiant Dawn / FE10:
+* Modules for FE10Data, FE10Conversation, FE10Effect, FE10Epilogue, FaceData, SoundData, shop data, and dispos.
+* Very rough editors for chapter scripts and dialogue.
+Awakening / FE13:
+* RelianceList module.
+* Correct handling of the blush modifier in FE13 dialogue.
+* Updated the UI for FE13 character sprite data - now supports adding entries for new classes.
+* Updated the emotions list in the dialogue simulator (thanks nini).
+* Added tab for character dialogue / one off lines in the character editor.
+Fates / FE14:
+* Added a quick dialogue generator for supports.
+* Improved loading speeds in the character editor.
+* Converted on_hit_effects in the assets editor from a float to bitflags.
+* New modules:
+** Animation Sets / aset.
+** DiningData.
+** CastleButlerVoice.
+Shadows of Valentia / FE15:
+* Filled in fields in the support condition module (thanks brian_alien).
+[https://github.com/thane98/paragon/releases Release notes.]
+==Credits==
 * lazy for texture parsing as well as completion support for dialogue.
 * Moonling for writing most of the modules.
@@ Line 51: / Line 185: @@
 * [https://github.com/SciresM/FEAT FEAT] and [https://github.com/gdkchan/Ohana3DS-Rebirth Ohana3DS] for bch parsing references.
-== License ==
+==External links==
+* GitHub - https://github.com/thane98/paragon
-Unless explicitly stated in a file, this project is licensed under the GNU General Public License 3.0.
+* GBAtemp - https://gbatemp.net/threads/wip-paragon-fire-emblem-fates.457799
+* Serenes Forest Forums - https://forums.serenesforest.net/index.php?/topic/94469-paragon-3dsfe-hacking-toolkit
-BCH parsing code (stored under src/bch.rs) was created by referencing code from FEAT and Ohana. This portion is licensed under the GNU General Public License 3.0.