Paragon 3DS: Difference between revisions

From GameBrew
(Created page with "{{Infobox 3DS homebrew | title = Paragon | image = https://dlhb.gamebrew.org/3dshomebrew/Paragon.jpg|250px | type = Hack Utilities | version = Alpha-1-6 | licence = Mixed | au...")
 
m (Text replacement - "Category:3DS homebrew rom hacks" to "")
 
(18 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Infobox 3DS homebrew
{{Infobox 3DS Homebrews
| title = Paragon
|title=Paragon
| image = https://dlhb.gamebrew.org/3dshomebrew/Paragon.jpg|250px
|image=paragon3ds2.png
| type = Hack Utilities
|description=Toolkit for editing and creating editors for FE13, FE14, and FE15. Successor to FEFEditor.
| version = Alpha-1-6
|author=thane98
| licence = Mixed
|lastupdated=2022/04/06
| author = thane98
|type=Hack Utilities
| website = https://github.com/thane98/paragon/
|version=Alpha-2-2-1
| download = https://dlhb.gamebrew.org/3dshomebrew/Paragon.rar
|license=GPL-3.0
| source = https://dlhb.gamebrew.org/3dshomebrew/Paragon.rar
|download=https://dlhb.gamebrew.org/3dshomebrews/paragon3ds.7z mscOS & Win
|website=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.


= Paragon =
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.


Paragon is a toolkit for editing and creating editors for FE13, FE14, and FE15.
==Installation==
Paragon releases should require no dependencies. Download the release for your operating system and run.
 
==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.
 
==Screenshots==
https://dlhb.gamebrew.org/3dshomebrews/paragon3ds3.png
https://dlhb.gamebrew.org/3dshomebrews/paragon3ds4.png
 
https://dlhb.gamebrew.org/3dshomebrews/paragon3ds5.png
 
https://dlhb.gamebrew.org/3dshomebrews/paragon3ds7.png
 
==Changelog==
'''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.


== Installation ==
FE13:
* Portrait previews will colorize hair for gen2 and Robin.


Paragon releases should require no dependencies. Download the release for your operating system and run.
FE14:
* The chapter editor will correctly identify a character from a handover PID.
* Fixed a bug with adding new asset specs?


== Building ==
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.


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.
'''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.


# Install the virtualenv package for Python. This is used to create an environment for building.
'''Rewrite Alpha 2'''
# 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 ==
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.


The following tools use Paragon features like import/export to edit FE13, FE14, and FE15. Take a look at the if you're interested!
Radiant Dawn / FE10:
* Modules for FE10Data, FE10Conversation, FE10Effect, FE10Epilogue, FaceData, SoundData, shop data, and dispos.
* Very rough editors for chapter scripts and dialogue.


=== Fire Emblem Echoes Random Class Generator ===
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.


Randomize classes for characters in Fire Emblem Echoes: Shadows of Valentia. Outputs JSON which can be used to apply changes to your ROM.
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.


[https://evinjaff.github.io/FESOV-randomizer/ https://evinjaff.github.io/FESOV-randomizer/]
Shadows of Valentia / FE15:
* Filled in fields in the support condition module (thanks brian_alien).


== Credits ==
[https://github.com/thane98/paragon/releases Release notes.]


==Credits==
* lazy for texture parsing as well as completion support for dialogue.
* lazy for texture parsing as well as completion support for dialogue.
* Moonling for writing most of the modules.
* Moonling for writing most of the modules.
Line 52: Line 141:
* [https://github.com/SciresM/FEAT FEAT] and [https://github.com/gdkchan/Ohana3DS-Rebirth Ohana3DS] for bch parsing references.
* [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.

Latest revision as of 06:15, 6 May 2024

Paragon
Paragon3ds2.png
General
Authorthane98
TypeHack Utilities
VersionAlpha-2-2-1
LicenseGPL-3.0
Last Updated2022/04/06
Links
mscOS & Win Download
Website
Source

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

paragon3ds3.pngparagon3ds4.png

paragon3ds5.png

paragon3ds7.png

Changelog

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

Advertising: