Nanoforge xtbl editing - Revision history

Goober at 15:44, 28 January 2024

2024-01-28T15:44:28Z

← Older revision		Revision as of 15:44, 28 January 2024
Line 1:		Line 1:
	{{RFGTutorial\|Moneyl}}		{{RFGTutorial\|Moneyl}}

	==Introduction==		==Introduction==
	This tutorial shows how to edit xtbl files for RFG using [[Nanoforge (Tool)\|Nanoforge]]. Xtbls are xml files used for configure the game. Many things in game such as vehicle and NPC stats are configured via xtbls. There are nearly 500 of them to edit. You can download the latest release [https://github.com/Moneyl/Nanoforge/releases on github]. See [[Nanoforge basics]] for an intro to some of its other features.		This tutorial shows how to edit xtbl files for RFG using [[Nanoforge (Tool)\|Nanoforge]]. Xtbls are xml files used for configure the game. Many things in game such as vehicle and NPC stats are configured via xtbls. There are nearly 500 of them to edit. You can download the latest release [https://github.com/Moneyl/Nanoforge/releases on github]. See [[Nanoforge basics]] for an intro to some of its other features.

Moneyl: Update images and info

2021-07-28T02:41:10Z

Update images and info

← Older revision		Revision as of 02:41, 28 July 2021
Line 7:		Line 7:
	The first step of using Nanoforge is to create a project. A project tracks the changes made for a mod. You should create a different project for each mod. To do so, open Nanoforge and click the <code>New project</code> button. When you do you'll see the following popup.		The first step of using Nanoforge is to create a project. A project tracks the changes made for a mod. You should create a different project for each mod. To do so, open Nanoforge and click the <code>New project</code> button. When you do you'll see the following popup.

	[[File:~~Nanoforge_ProjectCreationExample1~~.png\|frameless\|~~512px~~]]		[[File:Nanoforge_ProjectCreationExample2.png\|frameless\|768px]]

	* Name: The name of your mod. This is the name that your mod will show in the mod manager.		* Name: The name of your mod. This is the name that your mod will show in the mod manager.
Line 25:		Line 25:
	Things to note:		Things to note:
	* If you mouse over some values you'll see a tooltip describing what the value does. This feature relies on descriptions added to xtbls by the developers so many values don't have no description or very vague ones.		* If you mouse over some values you'll see a tooltip describing what the value does. This feature relies on descriptions added to xtbls by the developers so many values don't have no description or very vague ones.
	* There's a manual save button at the top of the xtbl document. Xtbls also get auto saved if you package your mod or close the xtbl. A future update will have better indicators on if a file has unsaved progress.
	* Some values like <code>Vehicle group</code> in the image reference entries in other xtbls. You can click the button next to the entries name to jump to that xtbl in a new tab.		* Some values like <code>Vehicle group</code> in the image reference entries in other xtbls. You can click the button next to the entries name to jump to that xtbl in a new tab.

	==Packaging your mod==		==Packaging your mod==
	The final step of editing xtbls is to package your mod. Packaging generates a modinfo.xml file for the mod manager and updates any game files that were changed with your texture edits. To package your mod use <code>File > Package mod</code> on the main menu bar. Once packaging is done you can use your mod. To get the output go to the project folder you chose earlier and look inside it's <code>Output</code> folder. This should have a mod manager mod ready for use. Copy the files to a new folder in your mods folder and it should be visible in the mod manager and ready to go.		The final step of editing xtbls is to package your mod. Packaging generates a modinfo.xml file for the mod manager and updates any game files that were changed with your texture edits. To package your mod use <code>File > Package mod</code> on the main menu bar. Once packaging is done you can use your mod. To get the output go to the project folder you chose earlier and look inside it's <code>Output</code> folder. This should have a mod manager mod ready for use. Copy the files to a new folder in your mods folder and it should be visible in the mod manager and ready to go.

Moneyl: Remove step of editing data path. As of v0.16.0 this is done automatically and the user will get a warning on the welcome screen if it's invalid.

2021-06-06T15:04:33Z

Remove step of editing data path. As of v0.16.0 this is done automatically and the user will get a warning on the welcome screen if it's invalid.

← Older revision		Revision as of 15:04, 6 June 2021
Line 2:		Line 2:

	==Introduction==		==Introduction==
	This tutorial shows how to edit xtbl files for RFG using [[Nanoforge (Tool)\|Nanoforge]]. Xtbls are xml files used for configure the game. Many things in game such as vehicle and NPC stats are configured via xtbls. There are nearly 500 of them to edit. You can download the latest release [https://github.com/Moneyl/Nanoforge/releases on github]~~. Once downloaded unzip it and make sure the data path in Settings.xml is the path of your copy of RFG~~. See [[Nanoforge basics]] for an intro to some of its other features.		This tutorial shows how to edit xtbl files for RFG using [[Nanoforge (Tool)\|Nanoforge]]. Xtbls are xml files used for configure the game. Many things in game such as vehicle and NPC stats are configured via xtbls. There are nearly 500 of them to edit. You can download the latest release [https://github.com/Moneyl/Nanoforge/releases on github]. See [[Nanoforge basics]] for an intro to some of its other features.

	==Create a project==		==Create a project==

Moneyl: Created page with "{{RFGTutorial|Moneyl}} ==Introduction== This tutorial shows how to edit xtbl files for RFG using Nanoforge. Xtbls are xml files used for configure the ga..."

2021-05-24T22:32:59Z

Created page with "{{RFGTutorial|Moneyl}} ==Introduction== This tutorial shows how to edit xtbl files for RFG using Nanoforge. Xtbls are xml files used for configure the ga..."

New page

{{RFGTutorial|Moneyl}}

==Introduction==
This tutorial shows how to edit xtbl files for RFG using [[Nanoforge (Tool)|Nanoforge]]. Xtbls are xml files used for configure the game. Many things in game such as vehicle and NPC stats are configured via xtbls. There are nearly 500 of them to edit. You can download the latest release [https://github.com/Moneyl/Nanoforge/releases on github]. Once downloaded unzip it and make sure the data path in Settings.xml is the path of your copy of RFG. See [[Nanoforge basics]] for an intro to some of its other features.

==Create a project==
The first step of using Nanoforge is to create a project. A project tracks the changes made for a mod. You should create a different project for each mod. To do so, open Nanoforge and click the <code>New project</code> button. When you do you'll see the following popup.

[[File:Nanoforge_ProjectCreationExample1.png|frameless|512px]]

* Name: The name of your mod. This is the name that your mod will show in the mod manager.
* Path: The folder path where you want to save your project files. I created a folder on my desktop called <code>Nanoforge Projects</code> for this purpose for easy access.
* Description: The description of your mod that's shown in the mod manager.
* Author: Your username, shown in the mod manager.

==Finding xtbls==
Most .xtbl files are in misc.vpp_pc. Table.vpp_pc has duplicates of the xtbls in misc.vpp_pc, but you shouldn't edit those as the mod manager disables table.vpp_pc. To see all xtbl files type <code>*.xtbl</code>
in the Nanoforge file explorer search bar. To open an xtbl file double click it in the file explorer.

==Editing xtbls==
Once you open an xtbl you should see something like this. Xtbls consist of one or many entries which can be organized into categories. In the image below you can see vehicles.xtbl. The left side lists all the entries and the right side lists all the values of the selected entry.

[[File:Nanoforge_XtblEdit_Vehicles_0_cropped.jpg|frameless|512px]]

Things to note:
* If you mouse over some values you'll see a tooltip describing what the value does. This feature relies on descriptions added to xtbls by the developers so many values don't have no description or very vague ones.
* There's a manual save button at the top of the xtbl document. Xtbls also get auto saved if you package your mod or close the xtbl. A future update will have better indicators on if a file has unsaved progress.
* Some values like <code>Vehicle group</code> in the image reference entries in other xtbls. You can click the button next to the entries name to jump to that xtbl in a new tab.

==Packaging your mod==
The final step of editing xtbls is to package your mod. Packaging generates a modinfo.xml file for the mod manager and updates any game files that were changed with your texture edits. To package your mod use <code>File > Package mod</code> on the main menu bar. Once packaging is done you can use your mod. To get the output go to the project folder you chose earlier and look inside it's <code>Output</code> folder. This should have a mod manager mod ready for use. Copy the files to a new folder in your mods folder and it should be visible in the mod manager and ready to go.