Back to NxLabs

NxLabs / Vintage Story

Yang's Starter Kit

YBy YangWenLi

Server-defined starter kits for players, given automatically during initial spawn.

Description

<span style="font-family: book antiqua, palatino, serif; font-size: 24pt;">Yang's Starter Kit</span>

A simple mod that allows servers to define a list of items to be given to players when they first spawn.
They won't be given again on re-spawn to avoid starter kit farming.



How to Use:

First, start the server once with the mod enabled. This will create VintagestoryData/ModConfig/yangstartkit.json in the server files.

Once you have verified that the file exists, stop the server and add inside your list of items, something like...

&nbsp;

<pre style="display: inline-block; text-align: left; padding: 1em; border-radius: 6px; background: #1e1e1e; color: #dcdcdc; overflow-x: auto;"> [ "game:knife-generic-iron", "game:torch-basic-lit-up", "game:basket-normal-reed", "game:clothes-face-malefactor-mask", "game:poultice-linen-horsetail" ] </pre>


After your list of items has been written and saved, start the server again.
The mod should work right away, triggering automatically when a player joins the server for the first time.
The mod&nbsp;will not give starter kits to previously existing characters in that world. Admins can force send starter kits via the /yangstartkit (playername) command.

&nbsp;

It is&nbsp;strongly recommended that any backpack items are listed&nbsp;first so that players
have the inventory space necessary to fit the rest of the starter kit.
The mod will automatically try to give backpacks first as a safety measure.

&nbsp;

The mod also supports more advance setups, such as picking one item out of a list at random (perfect for random starting weapons or food),
as well as defining how large of a stack (how many of that item) the player should receive. Here is a more advanced example:

Advanced Example (blocks, random item choices, lists within lists)
You can explicitly define blocks, stack sizes, pick one item from a list at random, and bundle multiple items inside random lists.
If you can't read or write JSON5, I recommend finding someone with amateur experience with modding VS to write it for you.
<pre style="display: inline-block; text-align: left; padding: 1em; border-radius: 6px; background: #1e1e1e; color: #dcdcdc; overflow-x: auto;"> [ "game:knife-generic-iron", { "type": "block", "code": "game:oillamp-brown-up" }, { "code": "game:backpack-normal", "stacksize": 2 }, "game:saw-iron", "game:pickaxe-iron", "game:axe-felling-iron", "game:prospectingpick-copper", "game:hammer-bismuthbronze", "game:shovel-tinbronze",

{ "oneof": [ "game:knife-dagger-ruined", "game:knife-khanjar-ruined", "game:knife-baselard-ruined", "game:axe-bearded-ruined", "game:axe-battle-ruined", "game:blade-gladius-ruined", "game:blade-arming-ruined", "game:blade-claymore-ruined", "game:blade-sabre-ruined", [ "game:bow-simple", { "code": "game:arrow-flint", "stacksize": 32 } ], "game:club-scrap-scrap" ] },

{ "code": "game:bread-rice-charred", "stacksize": 48 },

{ "oneof": [ "game:clothes-head-straw-hat", "game:clothes-head-bamboo-conehat", "game:clothes-head-bamboo-conehat-large", "game:clothes-head-tophat", "game:clothes-head-alchemist", "game:clothes-head-bucket", "game:clothes-head-bycocket", "game:clothes-head-bycocketfeather", "game:clothes-head-hide", "game:clothes-head-litham", "game:clothes-head-capotain", [ "game:clothes-head-wimple", "game:clothes-face-bandageright" ] ] },

{ "code": "game:bandage-clean", "stacksize": 8 }, "game:chisel-bismuthbronze", { "code": "game:firewood", "stacksize": 16 }, { "type": "block", "code": "game:ladder-rope-north", "stacksize": 24 } ] </pre>

That's all there is to the mod. It's fairly simple, but I think it's useful.

&nbsp;

&nbsp;

This mod is brought to you by...

<span style="color: #3598db;"><span style="color: #2880b9;">The Unofficial Vintage Story Modding Co-op, click here to join.</span></span>
As modders, we can help each other make even better stuff. Plus we have dedicated channels for better organization.

Ratings & reviews

No ratings yet

Sign in to leave a rating or comment.