Mods / [Infinitum] Trader Editor
- Tags:
- Author:
- unicorn_ares
- Side:
- Both
- Created:
- Jul 20th at 1:27 AM
- Last modified:
- Jul 20th at 2:06 AM
- Downloads:
- 433
-
Latest release (for Vintage Story 1.22.3, potentially outdated):
infinitumtraderinventory_1.0.0.zip 1-click install
🧑💼 Infinitum Trader Editor
A graphical editor for individual Vintage Story traders — customize vanilla traders and traders added by other mods without modifying trader type definitions or introducing custom trader entities.
🇺🇦 Український опис
Infinitum Trader Editor — це графічний редактор окремих торговців у Vintage Story. Він працює як із ванільними торговцями, так і з торговцями, доданими іншими модами. Звичайні гравці можуть переглядати дані торговця, а адміністратори з привілеєм controlserver — змінювати його профіль, зовнішність, одяг, торговий каталог, активні пропозиції та параметри оновлення товарів.
Мод не змінює визначення ванільних або сторонніх типів торговців, не додає власних класів сутностей і не застосовує зміни одразу до всіх торговців певного типу. Він лише додає графічний інтерфейс для редагування кожного конкретного торговця окремо.
Завдяки цьому торговці зберігають свій початковий тип сутності — ванільний або наданий іншим модом. Infinitum Trader Editor не підміняє їх власними сутностями, що суттєво зменшує ризик проблем зі світом після його видалення.
🎮 Vintage Story 1.22.3
🌐 Universal-мод: встановлюється на сервер і клієнт
❗ Серверна частина є обов’язковою
🔌 Підтримка торговців з інших модів
Мод також підтримує торговців, доданих іншими модами. У більшості випадків вони доступні для редагування так само, як ванільні торговці. Винятки можливі, якщо сторонній мод реалізує торговця кардинально інакше за ванільну систему; у такому разі окремі функції редактора можуть бути недоступними або працювати не повністю.
🖱️ Як користуватися
Наведіть приціл на торговця та натисніть середню кнопку миші.
Для створення нового ванільного торговця використовуйте /tradercreate. Сутність з’явиться лише після збереження профілю.
✨ Основні можливості
- Підтримка ванільних торговців і торговців, доданих іншими модами
- Перегляд торговців усіма гравцями та серверно перевірене редагування адміністраторами
- Редагування імені, професії, статі, кліматичного варіанта, характеру, голосу та здоров’я
- Редактор зовнішності й одягу з живим попереднім переглядом, збереженням, скасуванням і автоматичним rollback
- Експериментальна можливість використовувати для торговців звичайний одяг і броню; за замовчуванням вимкнена
- Повний каталог купівлі та продажу, активні пропозиції, ціни, запас, поповнення та параметри попиту
- Налаштування грошей, лімітів пропозицій та інтервалу оновлення торгівлі
- Створення торговців через
/tradercreate - Захист від конфліктів ревізій, невалідних asset-кодів і небезпечної заміни сутностей
🪟 Вікна редактора
- Торгівля — каталог, активні пропозиції та налаштування
- Персонаж — модель, зовнішність, одяг, аксесуари та броня
- Профіль — ім’я, професія, стать, характер, голос і здоров’я
🛡️ Права, перевірки та безпека редагування
- Для змін потрібен привілей
controlserverі відстань до торговця не більше 10 блоків - Застаріла форма не може перезаписати новіші зміни іншого адміністратора
- Редагування торгівлі блокується, поки торговець взаємодіє з іншим гравцем
- Одночасно зовнішність одного торговця може редагувати лише один адміністратор
- Зміна статі, професії або клімату виконується через контрольовану заміну на сумісний ванільний варіант сутності зі збереженням стану
- У разі помилки старий торговець залишається, а неповна заміна видаляється
👕 Звичайний одяг і броня (експериментально)
Функція дозволяє одягати на торговців звичайні предмети одягу й броні, які використовують серафими. Вона вимкнена за замовчуванням, оскільки для довільних комбінацій предметів неможливо гарантувати відсутність візуальних артефактів або інших проблем сумісності.
Конфігурація сервера:
ModConfig/Infinitum/TraderInventory/server.json
{
"AllowOrdinaryClothing": false
}
Коли параметр вимкнений, нові предмети встановити не можна, але вже встановлені можна зняти.
🧹 Видалення моду та збереження світу
Після видалення моду торговці залишаються працездатними сутностями, а внесені зміни, зокрема профіль, зовнішність, торговий каталог, активні пропозиції та налаштування торгівлі, залишаються збереженими у світі. Видаляється лише графічний інтерфейс і можливість надалі редагувати ці дані за допомогою Infinitum Trader Editor. Після повторного встановлення моду збережені налаштування знову можна буде редагувати.
⚠️ Після видалення моду звичайний одяг і броня серафимів перестануть відображатися на торговцях, оскільки ванільна гра не підтримує такий одяг для них. Самі дані предметів залишаться збереженими у світі, а після повторного встановлення моду одяг знову відобразиться. Перед видаленням рекомендується зняти такі предмети з усіх торговців.
Для важливих світів обов’язково зробіть резервну копію та перевірте видалення на копії світу.
🚫 Чого мод не робить
- Не редагує діалоги, AI, пересування, активності чи емоції
- Не змінює визначення ванільних або сторонніх типів торговців і не створює власні типи сутностей
- Не застосовує налаштування одразу до всіх торговців певної професії або типу
- Працює виключно з кожним конкретним підтримуваним торговцем окремо
- Не дозволяє звичайним гравцям змінювати торговців без
controlserver - Не має масової команди очищення metadata
🧭 Заплановані аддони
У майбутньому планується окремий аддон для експорту торговців у контентні моди. Він дозволить створити й налаштувати торговця безпосередньо в грі, наприклад у Creative, а потім експортувати його конфігурацію у власний мод або серверний контент-пак.
Також планується аддон із гравецькими торговцями: звичайні гравці зможуть орендувати послуги торговця або створювати власного за визначену плату. Такий торговець продаватиме лише предмети, передані йому гравцями, утворюючи більш зручну, гнучку та налаштовувану альтернативу класичним аукціонам.
💬 Спільнота та фідбек
Маєте пропозиції або знайшли проблему? Приєднуйтесь до спільноти Eternal Seraph.
Infinitum Trader Editor is a graphical editor for individual traders in Vintage Story. It works with both vanilla traders and traders added by other mods. Regular players can inspect trader data, while administrators with the controlserver privilege can edit a trader’s profile, appearance, clothing, trade catalog, active offers, and refresh settings.
The mod does not modify vanilla or third-party trader type definitions, add custom entity classes, or apply changes globally to every trader of a given type. It only provides an in-game interface for editing each individual trader entity separately.
Because traders retain their original entity type — either vanilla or provided by another mod — Infinitum Trader Editor does not replace them with its own entities. This considerably reduces the risk of world-loading issues after the editor is removed.
🎮 Vintage Story 1.22.3
🌐 Universal mod: install on both server and client
❗ The server component is required
🔌 Support for traders from other mods
The mod also supports traders added by other mods. In most cases, they can be edited in the same way as vanilla traders. Exceptions may occur when a third-party mod implements its trader in a way that differs substantially from the vanilla trader system; in that case, some editor features may be unavailable or only partially functional.
🖱️ How to use
Aim at a trader and press the middle mouse button to open the editor.
Use /tradercreate to configure a new vanilla trader. The entity is created only after the profile is saved.
✨ Main features
- Support for vanilla traders and traders added by other mods
- Read-only trader inspection for regular players and server-validated editing for administrators
- Edit name, profession, gender, climate variant, personality, voice, and health
- Appearance and clothing editor with live preview, Save/Cancel behavior, and automatic rollback
- Experimental support for equipping ordinary clothing and armor; disabled by default
- Complete buying and selling catalogs with active offers, prices, stock, restocking, and supply-demand settings
- Configure trader money, offer limits, and trade refresh intervals
- Create traders with
/tradercreate - Revision conflict protection, asset validation, and safe entity replacement
🪟 Editor windows
- Trading — catalog, active offers, and trader settings
- Character — model, appearance, clothing, accessories, and armor
- Profile — name, profession, gender, personality, voice, and health
🛡️ Permissions, validation, and editing safety
- Changes require
controlserverand a maximum distance of 10 blocks from the trader - Revision checks prevent stale forms from overwriting newer administrator changes
- Trade editing is blocked while the trader is interacting with another player
- Only one administrator can edit a trader’s appearance at a time
- Changing gender, profession, or climate performs a controlled replacement with a compatible vanilla entity variant while preserving supported state
- If replacement fails, the original trader remains intact and the incomplete replacement is removed
👕 Ordinary clothing and armor (experimental)
This feature allows traders to wear the same ordinary clothing and armor items used by seraphs. It is disabled by default because arbitrary item combinations may produce visual artifacts or other compatibility issues.
Server configuration:
ModConfig/Infinitum/TraderInventory/server.json
{
"AllowOrdinaryClothing": false
}
When disabled, new items cannot be equipped, but previously equipped items can still be removed.
🧹 Removing the mod and world safety
After the mod is removed, traders remain functional entities and the changes already made to them — including their profile, appearance, trade catalog, active offers, and trade settings — remain stored in the world. Removing the mod only removes the graphical editor and the ability to continue editing this data through Infinitum Trader Editor. If the mod is installed again, the saved settings can be edited again.
⚠️ Ordinary seraph clothing and armor will stop rendering on traders after the mod is removed, because vanilla Vintage Story does not support this equipment system for traders. The item data remains stored in the world, and the clothing will appear again if the mod is reinstalled. It is recommended to remove these items from all traders before uninstalling.
Always create a world backup and test removal on a copy before uninstalling from an important production world.
🚫 What the mod does not do
- Does not edit dialogue, AI, movement, aggression, activities, or emotions
- Does not modify vanilla or third-party trader type definitions or introduce custom trader entity types
- Does not apply settings globally to every trader of the same profession or type
- Works exclusively with each individual supported trader entity
- Does not allow regular players to edit traders without
controlserver - Does not currently include a bulk metadata cleanup command
🧭 Planned add-ons
A future trader export add-on is planned. It will allow creators to build and configure a trader directly in-game, for example in Creative mode, and then export that trader into a standalone content mod or a server content pack.
Another planned add-on will introduce player-operated traders. Regular players will be able to rent trader services or create their own trader for a configurable fee. These traders will sell only items supplied by players, providing a more convenient, flexible, and highly configurable alternative to traditional auction systems.
💬 Community and feedback
Have a suggestion or found an issue? Join the Eternal Seraph community.
| Mod Version | Mod Identifier | For Game version | Downloads | Released | Changelog | Download | 1-click mod install* |
|---|---|---|---|---|---|---|---|
| 1.0.0 | infinitumtraderinventory | 433 | Jul 20th at 2:06 AM | infinitumtraderinventory_1.0.0.zip | 1-click install | ||
📦 Changelogv1.0.0 - Initial Release | |||||||






Hello, is it possible to have a feature that allows to simply slide an item from our hotbar to apply the item ID and its attributes when adding or editing trades (say slide it into the item preview)? Right now it is super clunky to work with because you need to know the exact code of the item you want, and god forbid any attributes you want. I just want to setup simple custom traders for my server, but it is a pain to work with.
Edit: I also want to mention some kind of bug, but it keeps preventing me from editing, adding or removing trades on certain traders because it says "A catalog entry refers to an item or block that does not exist. Entry: [sell|buy-#]" except that everything is in order and there's no missing items or catalog entry with missing reference
Besides rusty gear, can you add your own currency?
Yes, I’ve already partially implemented this functionality, but it will be released as a separate add-on mod because it isn’t compatible with vanilla mechanics.
This is awesome to hear! :D Using something like coinage for traders will allow us to really embrace the pre-rust RP on our server :)
Can't wait for that add-on. Thanks for such great work!
strange question, but is there a plan to potentially spawn NOT traders? like just npcs with the default dialogue tree but no trading? I want to spawn a bunch of custom npcs for my village but them being traders would feel like cheating 😬
Setit Not a strange question at all!
For now, it is already possible to remove all of a trader’s goods. Trading will still technically be available, but the trader will have nothing to buy or sell, so this can work as a temporary solution.
Within this mod, I also plan to add dialogue editing, quests, item exchanges, and support for the other mechanics vanilla traders already have. The mod itself is focused entirely on existing vanilla systems without fundamentally changing them, with maximum compatibility as the main goal.
I also plan to make a few separate add-ons that can go beyond vanilla trader behavior. Those may introduce other types of NPCs, new mechanics, and additional integrations.
YOoo incredible work, ok im downloading the mod, can't wait for more features! and I can finally have my guards and villagers without tanking performance (just for looks and to not feel lonely, I know they wont do anything)
why don't you try Tailored Society ?
Tailored Society created 1 day ago )
yeah, i haven't ha the time to test Tailored Society yet, but seems promising
Is this mod comptable with coinage perchance?
I'm interested in this. Do you have any reason to ask this? Are you having a bug of some sort?
I was curious since a server i play on is thinking of haveing diffrent types of traders, some that are associated to diffrent ingame factions, and said factions liketo use their own currency! coinage is one of those things that is useful for that kind of roleplay
this would make coinage useful when playing solo survival 😀
What exactly do you mean by compatibility in this case?
At the moment, this mod does not allow changing a trader’s currency, but I do plan to investigate whether that can be implemented without going beyond the intended scope of the mod.
If Coinage already changes trader currencies without replacing or deeply modifying the vanilla trader mechanics, then the two mods may already be compatible. However, the interface of this mod might still visually display rusty gears as the currency, even if the trader actually uses a different item.
I haven’t used Coinage myself, so I can’t say for certain yet. When I have some time, I’ll definitely look into how it works and try to add proper compatibility if needed.
Ah coinage lets players create items that are often treated as currency, like chiseled block but scaled down to make a fancy 1 dollar coin or spike or even make players trade using dave's left foot.
it does not change traders currency or touch traders whatsoever, was hoping to use this mod to bridge that gap so the ability to use customize them with these custom player currencies is avalible!
Thank you so much for awsnering! this mode is a delight for Roleplay servers!
Being able to set a certain item as a trader currency would make this mod next level
This looks awesome! I'm currently working on a small mod with story content, and once I figure out how to get maps working, the last thing to will be the trader with custom dialogue. Any chance you might add support for implementing custom dialogue and giving/taking/exchanging lore related items?
Thanks!
I’m planning to explore custom dialogue, quests, item exchanges, and all the other mechanics that vanilla traders already have. Hopefully, I’ll be able to make these systems editable within this mod.
However, if doing so would require deeply reworking the fundamental vanilla trader mechanics and breaking compatibility, these features will most likely be implemented through separate add-ons. Everyone would then be free to decide whether they want to install them. These add-ons would not necessarily preserve full vanilla compatibility and could introduce new mechanics, integrations, or even entirely new types of NPCs.
Oh awesome!!!! 🙏 Blessed art thou! I look forward to the future releases!