Help - Submit Resources

This part of SWGAide provides the means for semi-automated resource data submission, useful for the heroes that update SWGCraft manually with for example creature resources. No more need for copy & paste, just a few mouse clicks and some editing of an in-game notes file.

This feature writes to the notes file the resources which age are over a selectable number of days, and filtered on a selected resource class or planet. Resources that are missing at SWGCraft are automatically added to the written list for selected resource class. Only resources that do spawn and are possible to harvest naturally are handled. This way you can concentrate on a limited, manageble set of resources and need only take action if a resource is new or missing.

Single input / Editing

The uppermost panel has two functions:

  • Submitting a single resource to SWGCraft
  • Editing an entry selected at the main GUI list of multiple resources

Possible errors are read just above these input fields.

The input fields for planets and for a resource class accept abbreviations and the result is presented just under the input fields.

Be very careful with the name of the resource as a spelling error will temporarily block a future submission for that name.

Stats are optional; errors will be presented. Common errors are: stats outside the caps for that resource class, too few or too many stats, or, not a number (any typo).

Once the resource data are entered and no error is shown, then click Submit to upload the single resource to SWGCraft. This button changes its name to "Apply" when you are editing from the list of multiple resources.

Multiple resources

The middle, main area is for submitting several resources in one batch, using an in-game notes file named "rem.txt" ("re" for resources, "m" for manual, alluding on "res.txt" used for ISDroid handling).

Click on a line and its content is parsed and added to the fields at the panel "Single input / Editing". Edit the content until it is correct and press Apply, the second form of the button.

Right click an entry for the option to delete that entry from the list. Editing/deletion does not affect the notes file, just what will be submitted to SWGCraft.

Once all resources are correct, click the Submit button for the main area, found in the lower right corner.

Colors for the main area:

White Valid resource
Red Some error
Yellow No stats
Blue Depleted

Manage the notes file

This handles writing current resources (known at SWGCraft) to the in-game notes file named "rem.txt". The entries have two looks:

Resourcename , Res Class, age (days)
 , Res Class,

The first kind is for current resources and their age. These may have despawned and been replaced.
The second kind is for resource classes that are always spawning but are missing at SWGCraft. More on this later on.

Filter on resource class, for example Wild Meat, to reduce the set of resources to check up on. It is possible to append to what is already written to the notes file, hence you can filter for class by class, would you want that.

Filter on age. Default is 6 days, which is the minimum lifespan for any resource class, but you can choose any number of days between 0 and 15 days.

Write to notes file. It will warn if file is not empty, with the options to Erase, Append, and Cancel. The button "Load from notes file" is described after the section about editing the in-game notes file.

Editing the notes file

Open the notes file in game with the command /notes rem (notice that you do not type the file suffix TXT).

Topmost the notes file has a header with a brief help text, do not edit the header. Then follows a list of resources.

You want to do the following actions, further described in the following text:

  • Unchanged resources, no action necessary.
  • Replaced resources, edit its name and add the stats.
  • New resources, add them line by line.
  • Complete missing resources.
  • Depleted resources, just write "depl, Resourcename"

Unchanged resources, resources that are still in spawn. Erase them or simply leave them, either way is OK for SWGAide.

Replaced resources: for Fiberplast and all Organics, if a resource is replaced with a new, you just need to edit the name of the resource, and add stats (optionally).

New resources for other resource classes, add a new line with planets, name, resource class, and stats.

The format for new resources is identical to what is used at SWGCraft:
planet(s), name, resource class, stats
Valid delimiters are ".,:; ", quotes excluded. Exception: U>spaces are not allowed inside and next to the resource class since spaces are part of resource classes.

Missing resource is a resource class that always is in spawn but currently not reported at SWGCraft. Just add their name and stats for the resource. Planet is added automagically since only planetarian resource classes are always in spawn.

Notice:
Planet names and class names can be abbreviated.
Planetarian resource classes are given a planet automagically.
Names are capitalized automagically.

Examples:

Corellia Rori Yavin 4, Amaraz, Lubricating Oil, 789 963
c r y, amaraz, lu oil, 789 963
Evilsoup, dat wa, 987 456
depl, restinpeace
The first two entries are identical, the third entry is Dathomir Water Vapor which is planetarian so no need for a planet, and the last example is a depleted resource.

Edit and Submit

Load from notes file reads from notes file and replaces the content of the GUI´s main list of resources.

Entries in error are highlighted in red and presented as is, while correct entries are more neatly presented on white background. Resources without stats are presented at a yellow background. They will be submitted as is to SWGCraft unless you add the stats by editing them.

These three kinds can be edited at the topmost area, just select the entry you want to edit, by clicking it, and it is added to the upper panel, edit the data and click Apply.

Depleted resources are presented as is on a blue background.

Delete an entry in the GUI from the popup dialog from a right mouse click.

No change at the GUI list of entries affects the notes file, hence any "reload" from the notes file will overwrite edits.

Submit in the lower right corner; this button starts submitting the resources you have marked as depleted, then resources understood as depleted (derived from fiberplast and organic resource classes that are new), and finally the new resources are uploaded. Any connection error is best read in the log files.

Verify at SWGCraft that the submission was successful.

Tips

Use the 30k resource deed (a veteran reward at 6 months). Almost always the current resource is listed bottommost, easy to compare if it is a new name or not. The deed also reads the stats at the next page.

Be very careful at the page where you can read the stats, do not type chat or anything that makes you accidentally claim some lousy resource. Carefully back out from the page where the stats are read by hitting the keyboard´s ESC-ape key, or by clicking Cancel.

The list of resources written in the in-game notes file is sorted in the same order as the 30k deed lists the resource classes.

Misc

Optionally you can use a blacklist for resource classes you never want to have in the notes file. The blacklist must be named "submit_blacklist.txt" and must be saved into the folder named "misc" found in the folder for SWGAide. One resource class each line, named exactly as the resource classes are read in the resource class tree at the panel Current Resources. An example:
Seafood
Horn
Egg

Summation

This feature makes it possible to collect resource data in game, directly at the notes file, then submitting it as is to SWGCraft. One resource, or many, it is more smoothly done this way.

What I did in the past was to write a number of selected resource classes to the file, only those over 6 days old. Using the 30k deed I found out which were replaced and I edited these entries only. Next day I did the same for a few more resource classes. A few days later the circle started over again. This way it was easy to keep creature resources up to date.