Yang's Starter Kit

<p style="text-align: center;"><strong><span style="font-family: book antiqua, palatino, serif; font-size: 24pt;">Yang's Starter Kit</span></strong></p> <p style="text-align: center;">A simple mod that allows servers to define a list of items to be given to players when they first spawn.<br />They won't be given again on re-spawn to avoid starter kit farming.</p> <hr /> <p style="text-align: center;"><strong><br />How to Use:</strong></p> <p style="text-align: center;">First, start the server once with the mod enabled. This will create <code>VintagestoryData/ModConfig/yangstartkit.json</code> in the server files.</p> <p style="text-align: center;">Once you have verified that the file exists, stop the server and add inside your list of items, something like...</p> <p style="text-align: center;">&nbsp;</p> <div style="text-align: center;"> <pre style="display: inline-block; text-align: left; padding: 1em; border-radius: 6px; background: #1e1e1e; color: #dcdcdc; overflow-x: auto;"><code> [ "game:knife-generic-iron", "game:torch-basic-lit-up", "game:basket-normal-reed", "game:clothes-face-malefactor-mask", "game:poultice-linen-horsetail" ] </code></pre> </div> <p style="text-align: center;"><br />After your list of items has been written and saved, start the server again.<br />The mod should work right away, triggering automatically when a player joins the server for the first time.<br />The mod&nbsp;<em>will not</em> give starter kits to previously existing characters in that world. Admins can force send starter kits via the <code>/yangstartkit (playername)</code> command.</p> <p style="text-align: center;">&nbsp;</p> <p style="text-align: center;">It is&nbsp;<em>strongly recommended</em> that any backpack items are listed&nbsp;<em>first</em> so that players<br />have the inventory space necessary to fit the rest of the starter kit.<br />The mod will automatically try to give backpacks first as a safety measure.</p> <p style="text-align: center;">&nbsp;</p> <p style="text-align: center;">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),<br />as well as defining how large of a stack (how many of that item) the player should receive. Here is a more advanced example:</p> <div class="spoiler"> <div class="spoiler-toggle" style="text-align: center;" spellcheck="false" data-lt-tmp-id="lt-480898" data-gramm="false">Advanced Example (blocks, random item choices, lists within lists)</div> <div class="spoiler-text" style="text-align: center;" spellcheck="false" data-lt-tmp-id="lt-544770" data-gramm="false">You can explicitly define blocks, stack sizes, pick one item from a list at random, and bundle multiple items inside random lists.<br />If you can't read or write JSON5, I recommend finding someone with amateur experience with modding VS to write it for you.</div> <div style="text-align: center;"> <pre style="display: inline-block; text-align: left; padding: 1em; border-radius: 6px; background: #1e1e1e; color: #dcdcdc; overflow-x: auto;"><code> [ "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 } ] </code></pre> </div> </div> <p style="text-align: center;">That's all there is to the mod. It's fairly simple, but I think it's useful.</p> <p style="text-align: center;">&nbsp;</p> <p style="text-align: center;"><a title="Join the Yangmods Discord!" href="https://discord.gg/s5YrYn7YcE" target="_blank" rel="noopener"><img style="border-style: outset;" src="https://raw.githubusercontent.com/HugoCortell/VS_Modding_Coop_Tools/refs/heads/main/scrolling-banner-svg-maker/scrolling_banner_example.svg" alt="" width="1280" height="384" /></a></p> <p style="text-align: center;">&nbsp;</p> <p style="text-align: center;">This mod is brought to you by...</p> <p style="text-align: center;"><img src="https://github.com/HugoCortell/vs_rptts/blob/main/media/coopinvite.png?raw=true" alt="" width="643" height="178" /></p> <p style="text-align: center;"><a href="https://discord.gg/XggWcvAqG9" target="_blank" rel="noopener"><span style="color: #3598db;"><span style="color: #2880b9;">The Unofficial Vintage Story Modding Co-op, click here to join.</span></span></a><br /><em>As modders, we can help each other make even better stuff. Plus we have dedicated channels for better organization.</em></p>