+- Hero Fighter Empire - Forums (https://hf-empire.com/forum)
+-- Forum: Hero Fighter Zone (https://hf-empire.com/forum/forumdisplay.php?fid=10)
+--- Forum: Projects (https://hf-empire.com/forum/forumdisplay.php?fid=37)
+--- Thread: [Tool] HF Workshop (/showthread.php?tid=317)
HF Workshop - MangaD - 30-07-2019
![[Image: logo.png]](https://gitlab.com/MangaD/hf-workshop/raw/master/resources/logo.png){kind=logo}
Download: (17 August 2019)
Windows (32-bit)
Windows (64-bit)
Windows XP (32-bit)
Windows XP (64-bit)
Linux (32-bit)
Linux (64-bit)
Language files:
zh (16 August 2019) (Chinese Simplified)
zh_TW (16 August 2019) (Chinese Traditional)
de (16 August 2019)
pt (16 August 2019)
These .mo files should be placed in "locale/XX/LC_MESSAGES/hfworkshop.mo", where "XX" is the respective language code (eg. zh_TW). This "locale" folder should be in the same path as HF Workshop. Chinese players from HK, Taiwan, Singapore... probably need the zh_TW language file. The language is activated based on your OS's regional settings.
Video tutorial
English (Click to View)
Chinese (Click to View)
Introduction
HF Workshop is a tool that aims to allow editing HF data. This includes images, sounds, stage files, character data and background data. At the moment of this writing, there is only a console version, very basic, but does the job. There are no tutorials yet, I leave this task to you. The program has not been extensively tested yet so there may be latent bugs, please report any that you find (and make sure it is not your fault).
Please note that with great power comes great responsibility. There are two important things that you must have in consideration if you do not wish to harm the game and its author:
Another thing to consider is that your mods will be uploaded and downloaded on the internet, so you should resize / compress your sounds, images and executables as much as possible for smaller file sizes.
Story editing
Story editing is a whole chapter of its own and has its own forum here. With the release of HF Workshop, the HF Story Editor program becomes obsolete. There are 2 major reasons for this:
Stories are created using XML format and tutorials can be found in its due forum.
Sound editing
Only MP3 files are allowed, and only sample rates of 5512 Hz, 11025 Hz, 22050 Hz and 44100 Hz (note: sample rates and bit rates are not the same thing). HF Workshop will tell you if the MP3 file that you're trying to replace with doesn't meet the requirements. In this case, you may find a converter online for your MP3 file. It is also recommended that you find an MP3 compressor to reduce the size of your MP3 files.
Image editing
Only PNG files are supported. It is recommended that you resize and compress your PNG files.
Note: Images get slightly changed during the process of extracting and replacing because of premultiplied alpha.
Data editing
I don't have any tutorials on this but here's what you have to keep in mind:
Exporting EXE
You may export the modified Hero Fighter in SWF or EXE formats. When exporting, you'll be given the option to compress the SWF file using Zlib or LZMA algorithms. It is highly recommended that you use one of these because a smaller file size will be easier to transfer on the internet. Zlib compression is the most common, whilst LZMA is more recent and won't work on Flash Player versions below 11.
If you're using a Flash Player projector (i.e. an EXE file) it is recommended that you compress it using UPX.
Last but not least, not all HF exe files work with HF Workshop. The official HF exe from HF installer won't work. The HF portable exe file provided at this site before won't work either. So it is recommended that you use the new HF exe provided here.
Translating HFW
You may find it useful to translate HFW's interface to your native language in case your community doesn't know English very well.
Change log
Thanks
HF Workshop is a tool that aims to allow editing HF data. This includes images, sounds, stage files, character data and background data. At the moment of this writing, there is only a console version, very basic, but does the job. There are no tutorials yet, I leave this task to you. The program has not been extensively tested yet so there may be latent bugs, please report any that you find (and make sure it is not your fault).
Please note that with great power comes great responsibility. There are two important things that you must have in consideration if you do not wish to harm the game and its author:
- Hero Fighter has premium account. With data changing it is eventually possible to play with premium characters without buying them. However, keep in mind that the game's future depends on the support that it gets, that means popularity and income. Therefore, you shall not use your powers to unlock premium characters for everyone.
If you really wish to support the game, you can replace premium characters with characters that you make, in order to encourage players to buy premium. But this is not necessary of course.
Now you may ask if I'm not being an hypocrite, since I'm giving people the power to play with premium characters without buying them. But after much thought and consideration, I believe that what I'm doing helps the game more than it harms. That is because the game barely has any new player population at this moment, and continuing abandoned as it is, the future doesn't look bright. In other words, people are not buying premium. With all these new tools, the game at least has a chance to make a comeback and who knows new players may join and support the game.
- Copyrighted content. Please do not make public any mods that contain copyrighted content (sounds, images...). This could get us into trouble if you share them here. Make sure that you only use free sounds and pictures in your modifications.
Another thing to consider is that your mods will be uploaded and downloaded on the internet, so you should resize / compress your sounds, images and executables as much as possible for smaller file sizes.
Story editing
Story editing is a whole chapter of its own and has its own forum here. With the release of HF Workshop, the HF Story Editor program becomes obsolete. There are 2 major reasons for this:
- HF Workshop allows replacing stories, sounds, pictures, characters and backgrounds, whilst HFSE only allows replacing stories.
- HFSE is heavy on resources and its interface not very useful. That is because HFSE was programmed in NodeJS and also uses Electron. Its interface only features a basic editor which isn't any better than editors such as Notepad++.
Stories are created using XML format and tutorials can be found in its due forum.
Sound editing
Only MP3 files are allowed, and only sample rates of 5512 Hz, 11025 Hz, 22050 Hz and 44100 Hz (note: sample rates and bit rates are not the same thing). HF Workshop will tell you if the MP3 file that you're trying to replace with doesn't meet the requirements. In this case, you may find a converter online for your MP3 file. It is also recommended that you find an MP3 compressor to reduce the size of your MP3 files.
Image editing
Only PNG files are supported. It is recommended that you resize and compress your PNG files.
Note: Images get slightly changed during the process of extracting and replacing because of premultiplied alpha.
Data editing
I don't have any tutorials on this but here's what you have to keep in mind:
- Don't change the names of the extracted zip files and files inside the zip files if you wish to use them to replace data. That is because the program verifies if you're replacing the right data file ID (and corresponding name), and also expects the file names inside the zip to be in a specific format so it knows how to replace them.
- Data values are in JSON format. Be careful with what you change in them because you can break the game completely.
- The numbers in the file names specify their order and should not be changed. The exception is for PNG files in LMI data, in case you add or remove PNG files, make sure they correspond to an existing LimbPic JSON file.
Exporting EXE
You may export the modified Hero Fighter in SWF or EXE formats. When exporting, you'll be given the option to compress the SWF file using Zlib or LZMA algorithms. It is highly recommended that you use one of these because a smaller file size will be easier to transfer on the internet. Zlib compression is the most common, whilst LZMA is more recent and won't work on Flash Player versions below 11.
If you're using a Flash Player projector (i.e. an EXE file) it is recommended that you compress it using UPX.
Last but not least, not all HF exe files work with HF Workshop. The official HF exe from HF installer won't work. The HF portable exe file provided at this site before won't work either. So it is recommended that you use the new HF exe provided here.
Translating HFW
You may find it useful to translate HFW's interface to your native language in case your community doesn't know English very well.
- Download this file.
- Open the file with notepad++ and change the language code.
- Open the PO file with Poedit and add the translated strings. If you open the PO file with a text editor, don't change the
msgids, change only themsgstrs! Make sure that the file is saved with UTF-8 encoding. Open it with notepad++ and convert the encoding to UTF-8 w/o BOM.
Change log
17 August 2019 (Click to View)
16 August 2019 - 2nd revision (Click to View)
16 August 2019 (Click to View)
05 August 2019 (Click to View)
31 July 2019 (Click to View)
Thanks
RE: HF Workshop - Runningcake - 30-07-2019
Hi MD, I encountered a problem while using HFW.
I followed the guidance of HFW but received an "Error loading zip file!" error.
The following is what happened in the interface of HFW.
Hello there, hero!
Which file do you wish to modify?
File path: D:\onedrive\Games\HeroFighter\hfe+.swf
What do you wish to do?
1. Help
2. Edit stages
3. Edit sounds
4. Edit images
5. Edit data
6. Export SWF
7. Export EXE
0. Exit
5
What do you wish to do?
1. List data files
2. Export data file(s)
3. Replace data file
0. Back
3
Which data file do you wish to replace?
Data ID: 136
Which data file do you wish to replace with? (zip format)
File name: "D:\onedrive\Games\HeroFighter\hf_data_files\Spt\136 - Data.Global_sinanSpt.zip"
Error loading zip file!
P.S.
Several people in our group(China) have encountered the same problem.
RE: HF Workshop - MangaD - 30-07-2019
Hi @Runningcake,
First of all, apologies for the late reply. Remove the quotes around the path and it should work.
Thank you for participating!
RE: HF Workshop - Runningcake - 01-08-2019
(30-07-2019, 09:37 PM)MangaD Wrote: Hi @Runningcake,Problem solved, thx~
First of all, apologies for the late reply. Remove the quotes around the path and it should work.
Thank you for participating!
RE: HF Workshop - MangaD - 05-08-2019
HF Workshop has been updated. Current known issues are Chinese language not displaying on Windows.
Changelog:
- HF v0.7+ was updated and it is recommended you download it.
- Multi-lingual support. (problem with Chinese characters on Windows)
- Released tutorial video on how to use HFW.
- Zip for replacing doesn't need a strict filename.
- Solved HUGE issue with transparent images. If you exported / replaced images before, do it again because they were not correct.
- Quotes around the file path/name are allowed.
- File path auto-completion with tab key and input history now works on Windows.
- Use up arrow key for getting previous inputs.
- Use tab key for auto-completion, clicking twice will show you available paths/names.
- CTRL+A will move to the beginning of the line.
- CTRL+E will move to the end of the line.
- CTRL+U will erase everything before the cursor position.
- CTRL+K will erase everything after the cursor position.
- CTRL+L will clear the screen. (not sure)
- Use up arrow key for getting previous inputs.
- Optimizations.
- Bug fixes.
- Released Windows 64-bit version.
RE: HF Workshop - MangaD - 16-08-2019
A new update to fix Chinese language on Windows has released.
Current known issues are:
- On Windows, autocomplete with unicode characters (e.g. Chinese) does not work.
- On Windows, reading / writing unicode file names doesn't work unless the correct locale and chcp page are set. Which may not be possible if there's a mix of unicode characters from different locales.
- On Windows XP:
- If you're using language files on this OS you may need to change the console font to a true type font (e.g. Lucida Console).
- If the language file changes the order of the strings in some sentence, that sentence won't work on Win XP.
- If you're using language files on this OS you may need to change the console font to a true type font (e.g. Lucida Console).
- Most error messages are not translated.
Changelog:
- All language files updated, including the English template.
- Chinese language now works on Windows, BUT:
- Auto-complete with Chinese characters does not work on Windows.
- May need to set
chcp 936 - for Chinese simplified or
chcp 950 - for Chinese traditional on Windows command line.
- Auto-complete with Chinese characters does not work on Windows.
- Read and write files with unicode characters in filename now works on Windows, BUT:
- May need to set
chcp 936 - for Chinese simplified or
chcp 950 - for Chinese traditional on Windows command line.
- May need to set
- Optimizations.
- Bug fixes.
RE: HF Workshop - Doximi - 31-07-2021
Whenever i try and open the file path or something like that it says permission denied
RE: HF Workshop - MangaD - 31-07-2021
@Doximi
It is likely that you are trying to save the EXE file to a file that is open. Close the game and try again.
RE: HF Workshop - Doximi - 31-07-2021
(31-07-2021, 05:09 PM)MangaD Wrote: @Doximi
It is likely that you are trying to save the EXE file to a file that is open. Close the game and try again.
Thank You a lot! Is there anyway to make your account premium with HF Workshop?
RE: HF Workshop - MangaD - 31-07-2021
(31-07-2021, 05:45 PM)Doximi Wrote: Is there anyway to make your account premium with HF Workshop?
No. You are advised to not pursue this path and buy premium account if you wish to see a future for this game.