사용자 지정 아이템

존재하지 않는 아이템을 시뮬레이션 하는 방법도 있습니다

Basics

Custom items system is a specific feature made to help big free companies and hardcore crafters with day0 crafting. It is here because the database API isn't updated as soon as the patch drops, as the extraction library has to be updated with new structures etc, this process usually takes 24-48h. During these 24-48h, the new items added by the patch aren't available on Teamcraft, which means that if you want to craft some of them, you might need to use pen & paper again or a Google sheet to track your mats. This is where custom items arrive.

How do they work?

When you create a Teamcraft list, you are adding some items from an api to the list, these items are parsed to create what's called a list row. List rows are basically parsed items with only the informations we need to know to get the item.

Custom items are list rows, but enhanced. You, as user, are providing the parsed rows directly, instead of relying on a third party api.

References

After this point, we'll use some specific words to describe buttons and interactions with the custom items page, we're going to define them here.

  1. Create a new item. This will ask you for the name you want to give to the item and create it.

  2. Create a new folder. This will ask you for a name and create a folder with the given name.

  3. Import custom items. This will open a dialog box allowing you to import custom items.

  4. Export custom items. This will allow you to export multiple items at once, as file.

  5. Item panel. This is the panel where item details will be displayed and handled, panel buttons are detailed below.

    1. Export the item. This will create an export file with only this item and its dependencies inside.

    2. Add the item to a list. This will add the item to a list of your choice.

    3. Delete the item. Removes the item from your account and from the database, this cannot be undone.

  6. Folder panel. This is a folder, you can expand the panel and drag items to organize them. You can't put folders inside folders.

Item details

A custom item can have multiple details entries, each entry is for a specific way to obtain the item, here is the list of all the details and what they mean.

Crafted by

This is an entry saying that the item can be crafted, it is not where you set ingredients. You can specify job, level, stars and the amount of items yielded by the craft.

Gathered by

This is an entry saying that the item can be gathered. You can specify the node type, level, stars, the map, coordinates and slot if it's needed. This is not where you set the alarms.

Alarms

This is an entry saying that the item needs some alarms, created like custom alarms. You can set the name, time, spawn type (once or twice per day), spawn duration, map, coords and slot if it's needed.

To add another alarm, click the "+" button again, and select alarms.

Vendors

This is an entry saying that the item can be bought to a vendor with gil (this doesn't include tomestones, they are handled in the section below). You have to first select a NPC, then you can set the price, map and coords.

To add another alarm, click the "+" button again, and select vendors.

Trade sources

This is an entry detailing a trade to obtain the item. You have to select a NPC and then you can add some trades, specify currencies, HQ or not, and set the item result, HQ or not.

To add another alarm, click the "+" button again, and select trade sources.

Reduced from

This is an entry detailing reduction, you can simply add some items here and they'll be considered as reduction sources.

To add another alarm, click the "+" button again, and select reduced from.

Requirements

This is where you specify requirements, they can be for a recipe or maybe for a quest, or even for anything else (leves, if you name your custom item after a leve, for instance). Requirements can be existing items or custom ones.

The last one is Item ID, located next to the Item name input field. You can specify the item id if you know it so once the item is available inside the api (24-48h after patch), you just have to regenerate the list to have it replaced by the real item, with real details.

To add some details to an item, click the "+" button next to "Item details"' at the top of panel content.

Import/export

Custom items can be exported to a custom format called Teamcraft (default format inside the import dialog box), using the export button inside custom item panel's header or using the mass export button directly (see references above).

It is also possible to import using a saint coinach export CSV file, this format is called CSM-EM. To see more details about how a CSV-EM file is parsed, see TODO Parser code or join the discord server and ping @Miu to ask for more details, or ask for a new format support.

Last updated