en:guid:febuildergba:work_support

Work Support

For work support, automatic update of work patches is realized using ROMNAME.supportinfo.txt.
Alternatively, save data can be archived with one click.
i.imgur.com_hpf42tl.jpg

Example:supportinfo.txt FE4Uploader

//
//このファイルはFEBuilderGBAの作品支援で利用する自動アップデートファイルです。
//以下のメニューから自動で最新版に更新するために利用されます。
//MENU->実行->作品支援
//
//This file is an automatic update file used to support FEBuilderGBA works.
//It is used to automatically update to the latest version from the following menu.
//MENU->Run->Work support
//

NAME=怪盗パッチ
AUTHOR=7743
LOGO_FILENAME=fe8kaitou.png
COMMUNITY_URL=https://discordapp.com/channels/145137778710151168/145137778710151168

CHECK_URL=https://ux.getuploader.com/FE4/
CHECK_REGEX=fe8_kaitou.*?MB</td><td>(.+?)</td><td>

UPDATE_URL=https://ux.getuploader.com/FE4/
UPDATE_REGEX=<td><a href="([^"]+)" title="fe8_kaitou.+?">

Example:supportinfo.txt part2 FE Central

//
//このファイルはFEBuilderGBAの作品支援で利用する自動アップデートファイルです。
//以下のメニューから自動で最新版に更新するために利用されます。
//MENU->実行->作品支援
//
//This file is an automatic update file used to support FEBuilderGBA works.
//It is used to automatically update to the latest version from the following menu.
//MENU->Run->Work support
//

NAME=BSFE
AUTHOR=Sme
LOGO_FILENAME=bsfe.png
COMMUNITY_URL=https://fecentral.org/?page=hackinfo&hackid=34

CHECK_URL=https://fecentral.org/?page=hackinfo&hackid=34
CHECK_REGEX=<a onclick="incDL.+?" href="(.+?)">

UPDATE_URL=https://fecentral.org/?page=hackinfo&hackid=34
UPDATE_REGEX=<a onclick="incDL.+?" href="(.+?)">

Example:supportinfo.txt part3 FEUniverse

//
//This file is an automatic update file used to support FEBuilderGBA works.
//It is used to automatically update to the latest version from the following menu.
//MENU->Run->Work support
//
//Document: https://dw.ngmansion.xyz/doku.php?id=en:guid:febuildergba:work_support
//
//このファイルはFEBuilderGBAの作品支援で利用する自動アップデートファイルです。
//以下のメニューから自動で最新版に更新するために利用されます。
//MENU->実行->作品支援
//
//仕様書: https://dw.ngmansion.xyz/doku.php?id=guide:febuildergba:%E4%BD%9C%E5%93%81%E6%94%AF%E6%8F%B4
//

NAME=怪盗パッチ
AUTHOR=7743
LOGO_FILENAME=fe8kaitou.png
COMMUNITY_URL=https://feuniverse.us/t/fe8-kaitou-patch/2984

CHECK_URL=https://feuniverse.us/t/fe8-kaitou-patch/2984
CHECK_REGEX=datetime='(.+?)' class='post-time'>

UPDATE_URL=https://feuniverse.us/t/fe8-kaitou-patch/2984
UPDATE_REGEX=<a href="(.+?)" rel="nofollow noopener">

Example:supportinfo.txt part4 mediafire

//
//This file is an automatic update file used to support FEBuilderGBA works.
//It is used to automatically update to the latest version from the following menu.
//MENU->Run->Work support
//
//Document: https://dw.ngmansion.xyz/doku.php?id=en:guid:febuildergba:work_support
//
//このファイルはFEBuilderGBAの作品支援で利用する自動アップデートファイルです。
//以下のメニューから自動で最新版に更新するために利用されます。
//MENU->実行->作品支援
//
//仕様書: https://dw.ngmansion.xyz/doku.php?id=guide:febuildergba:%E4%BD%9C%E5%93%81%E6%94%AF%E6%8F%B4
//

NAME=Fire Emblem Hiraeth: Legacies
AUTHOR=Zoisite
LOGO_FILENAME=logo.png
COMMUNITY_URL=https://discord.gg/yXU9uRj

CHECK_URL=https://www.mediafire.com/file/guyqyodzpdmiv8s/Fire_Emblem_Hiraeth_-_Legacies.zip/file
CHECK_REGEX=Uploaded: <span>(.+?)</span>

UPDATE_URL=https://www.mediafire.com/file/guyqyodzpdmiv8s/Fire_Emblem_Hiraeth_-_Legacies.zip/file
UPDATE_REGEX=<textarea id="copy".+?>(.+?)</textarea>

Example:supportinfo.txt part5 dropbox

//
//This file is an automatic update file used to support FEBuilderGBA works.
//It is used to automatically update to the latest version from the following menu.
//MENU->Run->Work support
//
//Document: https://dw.ngmansion.xyz/doku.php?id=en:guid:febuildergba:work_support
//
//このファイルはFEBuilderGBAの作品支援で利用する自動アップデートファイルです。
//以下のメニューから自動で最新版に更新するために利用されます。
//MENU->実行->作品支援
//
//仕様書: https://dw.ngmansion.xyz/doku.php?id=guide:febuildergba:%E4%BD%9C%E5%93%81%E6%94%AF%E6%8F%B4
//

NAME=Dragon Herald
AUTHOR=BigMood
LOGO_FILENAME=logo.png
COMMUNITY_URL=https://feuniverse.us/t/fire-emblem-the-dragon-herald-100-02-complete-fe8-hack/7075

CHECK_URL=https://www.dropbox.com/sh/vyi41qmnbl2lr6g/AAAmxs2sXQegdGmwsErEldtWa
CHECK_REGEX=\.ups\\", \\"sjid\\": ([0-9]+),

UPDATE_URL=https://www.dropbox.com/sh/vyi41qmnbl2lr6g/AAAmxs2sXQegdGmwsErEldtWa
UPDATE_REGEX=@DIRECT_URL

Example:supportinfo.txt part6 google drive folder

//
//This file is an automatic update file used to support FEBuilderGBA works.
//It is used to automatically update to the latest version from the following menu.
//MENU->Run->Work support
//
//Document: https://dw.ngmansion.xyz/doku.php?id=en:guid:febuildergba:work_support
//
//このファイルはFEBuilderGBAの作品支援で利用する自動アップデートファイルです。
//以下のメニューから自動で最新版に更新するために利用されます。
//MENU->実行->作品支援
//
//仕様書: https://dw.ngmansion.xyz/doku.php?id=guide:febuildergba:%E4%BD%9C%E5%93%81%E6%94%AF%E6%8F%B4
//

NAME=FEbattle simulator
AUTHOR=Magix
LOGO_FILENAME=logo.png
COMMUNITY_URL=https://feuniverse.us/t/fire-emblem-battle-simulator-auto-battler/7031

CHECK_URL=https://drive.google.com/drive/folders/1xKiLtblha0MdSv_ZuTRJMjeKXSWJm6X8
CHECK_REGEX=FEbattle_simulator_full_control.ups\\x22,\\x22.+?\\x22,0,null,0,0,0,([0-9]+),

UPDATE_URL=https://drive.google.com/drive/folders/1xKiLtblha0MdSv_ZuTRJMjeKXSWJm6X8
UPDATE_REGEX=@DIRECT_URL

Example:supportinfo.txt part6 google drive folder2

//
//This file is an automatic update file used to support FEBuilderGBA works.
//It is used to automatically update to the latest version from the following menu.
//MENU->Run->Work support
//
//Document: https://dw.ngmansion.xyz/doku.php?id=en:guid:febuildergba:work_support
// View Results
//https://docs.google.com/spreadsheets/d/1nG4OhYUs5uL3irGzxXsoroOh5JY71VmyCZI8l63HEMs/edit?usp=drive_web&ouid=104706871484152984133
//
//このファイルはFEBuilderGBAの作品支援で利用する自動アップデートファイルです。
//以下のメニューから自動で最新版に更新するために利用されます。
//MENU->実行->作品支援
//
//仕様書: https://dw.ngmansion.xyz/doku.php?id=guide:febuildergba:%E4%BD%9C%E5%93%81%E6%94%AF%E6%8F%B4
//

NAME=fess
AUTHOR=Eretein
COMMUNITY_URL=YOUR PROJECT WEBSITE https://example.com/
LOGO_FILENAME=fess.logo.png

//If you use auto-update, please provide details of the site where it will be distributed.
CHECK_URL=https://drive.google.com/drive/folders/1nsArLqNzXrALraQ0ewv7tigmuPbkxL_m
CHECK_REGEX=fess_[0-9]+.7z\\x22,\\x22.+?\\x22,0,null,0,0,0,([0-9]+),

UPDATE_URL=https://drive.google.com/drive/folders/1nsArLqNzXrALraQ0ewv7tigmuPbkxL_m
UPDATE_REGEX=fess_[0-9]+.7z\\x22,\\x22.+?\\x22,0,null,0,0,0,.+?(https:\\/\\/drive.google.com\\/file\\/d\\/.+?\\/view)


AUTOFEEDBACK_URL=https://docs.google.com/forms/d/e/1FAIpQLScahQbQza0jLnj99BzLOIfmmLNeMruYfjcRlbeJT1WOHQL8Yw/formResponse
AUTOFEEDBACK_POST_USERHASH=entry.472844841
AUTOFEEDBACK_POST_VERSION=entry.1932423044
AUTOFEEDBACK_POST_CHAPTER=entry.1798786849
AUTOFEEDBACK_POST_DEADUNIT=entry.370946816
AUTOFEEDBACK_POST_BASE64=entry.926226156

//Enable AUTOFEEDBACK if you want to give benefits to players who have it enabled.
//MapID:0x0 will enable Flag: 0x25
//AUTOFEEDBACK_ENABLE_FLAG=0x25
//AUTOFEEDBACK_ENABLE_FLAG_MAPID=0x0

CHECK_URL

Write the URL to get the latest version date.

CHECK_REGEX

Write a regular expression to parse the HTML obtained by CHECK_URL and extract the date.
Interpret the string in the first capture as a date.
For websites without dates, please extract the URL.
Send HTTP HEAD request to URL and get Last-Modified.

UPDATE_URL

Write the URL to update.

UPDATE_REGEX

Parse the HTML obtained by UPDATE_URL and write a regular expression to extract the download destination.
Download supports ups, 7z, rar, zip.
In addition, it supports several websites besides Rin Rin.

getuploader, dropbox ,google drive

AutoFeedback

This feature provides automatic feedback to the author on the progress of the player's game.
Until now, you could only find out how your game was being played through game play videos and play reports.
With this feature, you can know how your game is progressing, although only if the player runs the game via FEBuilderGBA.
Whenever a chapter is cleared (flag 0x03 is enabled) or a unit lost (death of a player unit) occurs, the play data is automatically fed back to the author.
The following data can be obtained
i.imgur.com_chx53nl.jpg

UserHash is a sum of user names. In short, it is a hash.
It cannot identify an individual, but it can suggest that the data was sent by someone who seems to be the same person.

Version is the version of the game.
It is the name of the game file, the date of the file, and the size of the file (kb).

Chapter is the data of the chapter in which the event occurred.
In addition to the chapter title, the number of turns, difficulty level, and top 10 unit list will be written.

DeadUnit is the data sent when a unit dies.
If the chapter is clear, this field will be left blank.
You can see who was killed by which enemy and where.

If a village is destroyed by bandits, the “VillageDestory: Village Coordinates” will be added, with the coordinates of the destroyed village and information about the bandit who destroyed the village.

Base64(sav.7z.base64) is the saved data compressed to 7z, converted to base64, and converted to text.
You can decrypt it with “FEBuilderGBA→Tools→LZ77 tool Base64 tab”.
If you load it in an emulator, you can reproduce the game.

Knowing how the game is being played can give you hints on how to improve the game.

How to set up automatic feedback

1.
To use google form, please get a google account.
You will need an appropriate email address, but there are many free email address acquisition services available, so make sure it's a good one.

2.
https://docs.google.com/forms/create

Please use google form to create a survey.
The content should have “descriptive” fields where you can freely write text.
The choices are by default “radio buttons,” so please change them to “descriptive” where you can freely apply text.

Please create “5” descriptive fields.
The names of the items can be anything.
It is recommended to use numbers or alphabetical characters to make it easier to understand.

i.imgur.com_kzrkqcl.jpg

Example of making five descriptive selections
i.imgur.com_bmm9w5d.jpg

3.
Test your form by pressing the preview button in the upper right corner.

i.imgur.com_a0uc3zt.jpg

At this time, press the F12 key in chrome to start the debugger.
Look at the data sent when you answer the form.
This is very important.

i.imgur.com_7baoivh.jpg

4.
Look at the first data sent to you when you answer the form.

By looking at the Payload of the formResponse, we can see what kind of data is being sent at the time of the answer.
All that remains is to put this item and this URL in “.updateinfo.txt”.

i.imgur.com_claof2n.jpg

5.
Setting Example.

AUTOFEEDBACK_URL=https://docs.google.com/forms/d/e/1FAIpQLSe5vn-ZxMZWrKASSctr09LfJPXJjfHi2PpYqZOk3yVT07hyZQ/formResponse
AUTOFEEDBACK_POST_USERHASH=entry.1603795113
AUTOFEEDBACK_POST_VERSION=entry.1599223667
AUTOFEEDBACK_POST_CHAPTER=entry.1016351841
AUTOFEEDBACK_POST_DEADUNIT=entry.1957504988
AUTOFEEDBACK_POST_BASE64=entry.816508310

AUTOFEEDBACK_ENABLE_FLAG=0x25
AUTOFEEDBACK_ENABLE_FLAG_MAPID=0x0

6.
After you have applied the settings, test the game by starting it with the F5 key on the FEBuilderGBA.
For now, try Ctrl + U to end the chapter, or set the player unit to 1 HP and let the enemy suicide attack and kill it.
If the answers to the survey are automatically submitted, it is a success.
If not, it is a failure. There is something wrong.

The data you submitted is written in the log, so you can check it there as well.

AutoFeedback Readme

When incorporating automatic feedback, you may wish to add the following text to the readme.

*FEBuillderGBA WorkSupport
This work supports the FEBuilderGBA work support feature, which allows for automatic updates by playing with FEBuilderGBA.
It also supports the automatic feedback function.
Feedback can be given completely anonymously, using only the information in the game.
Your feedback will help us improve the game, so please help us.
You can change this setting at any time from "FEBuilderGBA Menu->Run->Work Support".

AUTOFEEDBACK_DEFAULT_SETTING

This additional option has three states.

AUTOFEEDBACK_DEFAULT_SETTING=1
Enabled by default

AUTOFEEDBACK_DEFAULT_SETTING=0
Disabled by default

AUTOFEEDBACK_DEFAULT_SETTING=2
Default is to ask the player at the first startup.

However, if the parameter AUTOFEEDBACK_DEFAULT_SETTING is not written, it is set to 1.

AUTOFEEDBACK_ENABLE_FLAG=0x25
Specify flags to be enabled.
Can be either local or global flags.
Default is 0, which means that none of the flags are enabled.

AUTOFEEDBACK_ENABLE_FLAG_MAPID=0x0
Specifies the chapter ID to process to enable the flag.
Default is the prologue chapter.
It is recommended to do this only in the prologue chapter, as doing it in all chapters would be scary if there are unexpected side effects.

AutoFeedback's Version to be sent

Add the emulator name to the VERSION field.
Only mGBA displays the version number correctly.
The others display the date of the emulator exe as yyyyMMDD.

fe8kaitou  //ROM Name
20230611   //ROM file time yyyyMMDD
32750      //ROM capacity kb       32750kb(32MB)
VisualBoyAdvance-M //Emulator Name
20150526   //Emulator version or time yyyyMMDD
fe8kaitou  //ROM名
20230611   //ROM file time yyyyMMDD
32750      //ROM capacity kb       32750kb(32MB)
mGBA       //Emulator Name
0.10.1.0   //Emulator version or time yyyyMMDD
AutoFeedback's Event to be sent

DeadUnit
Notification is sent when a player unit dies.
Information on the dead player unit and the enemy unit that killed the player will be included.

VillageDestory
Notified when a village is destroyed by bandits.
The coordinates of the destroyed village and the information of the enemy unit that destroyed it will be shown.

EndEvent
Sent when a chapter is cleared.
Clearing a chapter means when Flag 0x03 is enabled.

ReloadGame
Sent when the game is reset and the chapter is resumed or restarted.

Hang-up detection
Notified when the game hangs up.
In this case, a hang-up refers to the GBA crashing with a strange cry.
It is not a forced reset or an infinite loop.
In most cases, it occurs when the stack is broken.
It is sent when the connection to the emulator is suddenly broken and it lasts for 3 seconds.

DISABLE CHEAT

```
DISABLE_CHEAT=1
```

If you include this in the updateinfo, it will disable the cheat function in FEBuilderGBA.
The default is DISABLE_CHEAT=0, which enables the cheat function.

Users are seeing the FEBuilderGBA debugger more and more often, e.g., via autofeedback.
It is human nature to want to press the cheat button when it is present.
For this reason, we have added a function to disable the cheat function.
It is a simple lock, so it can be removed quickly if you want to, but I think it is sufficient for casual users.

Public Auto Feedback

Setting up auto-feedback is difficult, so for those who want to try it out anyway, there is a simple mechanism you can try.

Save this file as a txt file.
https://cdn.discordapp.com/attachments/725478895226191892/1116339537937969212/YOURROMNAME.updateinfo.txt

The file name should be the same as the ROM.
For example, if the ROM is fe8kaitou.gba, the file name will be fe8kaitou.updateinfo.txt.

ROM: fe8kaitou.gba
TXT: fe8kaitou.updateinfo.txt

Once you have placed the ROM in the same location as the ROM, open the ROM in FEBuilderGBA and press the F5 key to test play.
When an event occurs, such as the death of a unit, it will be appended to the end of the following sheet.
https://docs.google.com/spreadsheets/d/1nG4OhYUs5uL3irGzxXsoroOh5JY71VmyCZI8l63HEMs/edit?usp=drive_web&ouid=104706871484152984133

After that, make ups, zip them up with updateinfo.txt, or distribute them.
It's that easy.

UPS: fe8kaitou.ups
TXT: fe8kaitou.updateinfo.txt

If you want to use your own sheets instead of shared sheets, you need to create your own google form as described on this page.

en/guid/febuildergba/work_support.txt · 最終更新: 2023/07/05 23:00 by 220.100.55.84