Mods / Starter Kit

Tags:
Utility
Author:
Chain
Side:
Server
Created:
Mar 23rd 2025 at 9:01 PM
Last modified:
May 4th at 6:55 AM
Downloads:
954
Follow Unfollow 44
Latest release (for Vintage Story 1.22.0 - 1.22.2, potentially outdated):
StarterKit-2.0.0.zip  1-click install

Starter Kit


 

Adds a configurable starter kit with a few simple commands to modify it.

 

Commands


 

  • /starterkit - Receive the items in the starter kit.
  • /starterkit uses [player] - Checks how many uses you have left for the starter kit. Administrators can check someone else's uses.
  • /starterkit set-uses <player> - Sets the amount of times a player can use the starter kit. 
  • /starterkit reset-uses - Sets ALL PLAYER'S uses left to whatever is set in maxKitUses in the configuration.
  • /starterkit add <item> [amount] - Adds an item/block or modifies an existing item/block in the starter kit.
  • /starterkit remove <item> - Removes an item/block from the starter kit.
  • /starterkit clear - Removes all items/blocks from the starter kit.
  • /starterkit list - List all the items/blocks in the starter kit.
  • /starterkit reload - Reloads the config file. (Only necessary if you modify config manually, which is not recommended)
  • /starterkit modify_config - Modifies a value in config. Keys available: requiresPrivilege, privilege, maxKitUses.

 

You can find a raw list of all the items and blocks here and here. Alternatively, you can check an item/block's id using the .edi command ingame and hovering over your desired item/block.

For anyone freshly installing the mod or updating, I suggest setting requiresPrivilege to false as you don't really need it. I also recommend not touching the configuration manually unless you know what you are doing. The mod should be able to add custom modded items/blocks to the kit, but if not, let me know as I haven't tested too thoroughly. 

For any issues, please make an issue in github. If you have a quick question, you can leave it in the comments, and if I can answer it I will...eventually

Mod Version Mod IdentifierFor Game version Downloads Released Changelog Download 1-click mod install*
2.0.0 starterkit
1.22.0 - 1.22.2
116 May 4th at 6:55 AM StarterKit-2.0.0.zip 1-click install

- Removed removedPrivilegesOnUse from the config

+ Added maxKitUses to the config
+ Added /starterkit uses [player] command (allows you yourself to check how many uses you have on the kit or if administrator how many uses a player has left)
+ Added /starterkit set-uses <player> command (allows an administrator to set the amount of times a player can use a kit)
+ Added /starterkit reset-uses command (allows an administrator to reset EVERY PLAYER'S current uses left to whatever maxKitUses is set to in config)
+ Added /starterkit clear command (removes all items from the kit, so you can do a clean slate)

= Renamed /starterkit modify_config to /starterkit configure and added maxKitUses as a changeable key. (Obviously removePrivilegeOnKitUse has been removed)

FOR ANYONE UPDATING TO THIS VERSION OR INSTALLING IT FOR THE FIRST TIME:
I recommend setting requiresPrivilege to false as privileges are a bit of a hassle to work with imo, and just using uses/set-uses/reset-uses might be sufficient to do everything with the mod without privileges.

1.1.0 starterkit
1.20.6 - 1.20.7 1.20.8 - 1.20.10 1.20.11 - 1.20.12
753 Mar 25th 2025 at 4:33 AM StarterKit-1.1.0.zip 1-click install

Added two new commands, reload and modify_config, and also fixed removePrivilegeOnKitUse not working before. Seems to work with the latests version.

1.0.0 starterkit 85 Mar 23rd 2025 at 9:06 PM StarterKit-1.0.0.zip 1-click install

Initial upload, only tested on latest version but should work on earlier versions as well.


23 Comments (oldest first | newest first) (threaded | flat)

AwitaRefreskante, Mar 15th at 11:10 PM

Hi! Nice mod! I just need one per user. How can i get it?

Chain , Nov 17th 2025 at 12:37 AM

HaMeRoN Not currently, sorry

Chain , Nov 17th 2025 at 12:35 AM

cjc813 The mod should be able to use blockcodes, but I may need to check the api again and see if they changed something in recent updates that may be causing it not to work.

Honestly, I agree with you, the way I did the whole config and kit reusing part is a bit messy. The way I intended the mod to be used is for removePrivilegeOnKitUse to be set to true, the privilege to be set to something like "starterkit", and the requiresPrivilege value to be set to true. If you are to add the permission for "starterkit" to the default player group, this can allow them to only use it once because the privilege is then removed from the player but not the group. This can also allow for individual kit resets if necessary. It was mostly made for me to use in a server I am currently hosting, and I put it out there for others to use as well, but I may need to redo some of the commands to make it simpler for others to use. Also the fact that you have to look up itemcodes and blockcodes manually kind of bothers me, but it is a lot of extra work to add something extra to the mod to fix that, so I may just add a link to an up to date list somewhere in this mod page soon.

cjc813, Nov 16th 2025 at 11:33 PM

Ok, upon installation, this mod is not terribly useful, unless I'm overlooking something.

None of my players are able to use it without me modifying the config/permissions.

But, if I *do* modify the config, they can use it as many times as they want.

Not being able to just use it only once defeats the whole purpose of the mod.

I appreciate all your effort, and it's a great idea. It just doesn't seem fully implemented yet.

cjc813, Nov 16th 2025 at 10:56 PM

pretty neat mod, but does it only work with itemcodes?

i'm trying to give people an oil lamp to start with, and it doesn't seem to work. the block code is oillamp-blue-up.

doesn't seem to work?

HaMeRoN, Nov 1st 2025 at 1:51 AM

can i add 5 of kits?

Pagan_Sunburn, Oct 19th 2025 at 2:22 PM

I am having trouble adding items to the starter kit. Whenever I use "/starterkit add Flint knife 1" it returns and error of "Error in argument 2 (amount): Not a number
For help, type /help starterkit 
Please explain how to use this. I would like to have this working on my server.

Chain , Jul 11th 2025 at 3:03 AM

Palorh Unfortunately, the way the mod is now does not allow that. I would need to either add a way to do it through a command which I think would be quite difficult or add a way to add an item from your own inventory that retains all attributes to the kit which would take a while. It will probably stay as is for now.

Palorh, Jul 9th 2025 at 2:05 PM

Hey Chain :) Nice mod

You know if it's possible to add a book with text, etc ... ?
Like a guide book for new player on my server ?

Thx for your reply

Chain , Jul 8th 2025 at 11:21 PM

Khana There is no different command for testing if its working correctly or not right now, just know that just using /starterkit mc requiresPrivilege false should be enough, as the reload command is only there if you make changes to the config file itself.

 

Khana, Jul 8th 2025 at 10:21 AM

as the admin il be needin to re get the starter kit to make sure its workincorrectly, do i need to reset the command with the /starterkit mc requiresPrivilege false command n reload or is there another command? 

 

DilanRona, Apr 26th 2025 at 2:06 PM

Tbh, unless specified in the config, a kit is supposed to only be received once per player, or unless an admin decides to gift an extra kit to a player.

Chain , Apr 26th 2025 at 8:31 AM

DilanRona Since you set it so getting the kit doesn't require a privilege, then it will always allow anyone to get the kit regardless of whether 'removePrivilegeOnKitUse' is set to true or false. I may add a setting to allow someone to only get the kit a certain amount of times in the future but for now that is not a feature.

DilanRona, Apr 20th 2025 at 8:51 AM

When 'requiresPrivilege' is set to false, I get the kit as expected. However, the Privilege is not removed, even though 'removePrivilegeOnKitUse' is set to true. So another kit can be requested immediately.

Chain , Apr 13th 2025 at 11:02 PM

LokieJohn Sorry its taking me a while to respond, been busy. You would use "/starterkit mc requiresPrivilege false" or you would change that to false in the config manually and then "/starterkit reload", that disables the permissions, deleting the privilege string outright I have not tested so I am not sure how that works out.

LokieJohn, Apr 11th 2025 at 2:22 AM

I hadn't done anything except add an item to the kit, I tried removing any privilege there might have been but maybe I used the wrong command? What would I use to turn off privileges? 

Chain , Apr 11th 2025 at 12:02 AM

LokieJohn Did you turn off permissions through the modify_config command or through the file?

LokieJohn, Apr 9th 2025 at 2:59 AM

Having trouble accessing the starter kit, I have an item added but when I type /starterkit it says I don't have permissions and I've tried turning permissions off but no luck. Any idea what I'm doing wrong?

Chain , Apr 2nd 2025 at 3:36 AM

I haven't tested it with modded items, but for items with multiple words it would depend on how the mod developer implemented the item. Usually people add -'s in between words but it can change depending on the person.I will need to test with mods to be able to tell you anything.

Ok, so for a cart lantern in Cartwrights it would be "/starterkit add cartwrightscaravan:cartsmetalextra-cartlantern-base-lit-oak-copper 1" for a copper latern. It works just fine with modded items. For getting any modded item ids you can use the command /debug itemcodes (or /debug blockcodes for blocks) and look in Logs/server-main.log and everything should be there. Alternatively use the .edi command to enable the tooltip that shows the name of the item but sometimes its too long to see.

SimplyRobotic, Mar 30th 2025 at 8:23 AM

how do i formulate item names with multiple words. specifically modded items? I'm trying to add a Cart Lantern from Cartwrights

Chain , Mar 25th 2025 at 8:18 AM

no items by default, meant for it to be different for each server so whoever installs it sets the items.

HariSeldon, Mar 25th 2025 at 7:41 AM

Interesting, does it come already with some items by default?

Aurailen, Mar 25th 2025 at 5:09 AM

Excellent
Simple and useful :)