Starter Kit

<center><a href="https://serilum.com/"><img src="https://github.com/Serilum/.cdn/raw/main/description/header/header.png" alt="" width="838" height="400" /></a><a href="https://curseforge.com/members/serilum/projects" target="_blank" rel="noopener noreferrer"><img src="https://raw.githubusercontent.com/Serilum/.data-workflow/main/badges/svg/curseforge.svg" width="200" /></a> <a href="https://modrinth.com/user/Serilum" target="_blank" rel="noopener noreferrer"><img src="https://raw.githubusercontent.com/Serilum/.data-workflow/main/badges/svg/modrinth.svg" width="200" /></a> <a href="https://patreon.com/serilum" target="_blank" rel="noopener noreferrer"><img src="https://raw.githubusercontent.com/Serilum/.data-workflow/main/badges/svg/patreon.svg" width="200" /></a> <a href="https://youtube.com/@serilum" target="_blank" rel="noopener noreferrer"><img src="https://raw.githubusercontent.com/Serilum/.data-workflow/main/badges/svg/youtube.svg" width="200" /></a></center>Requires the library mod <a style="font-size:24px" href="https://modrinth.com/mod/collective" target="_blank" rel="nofollow">Collective</a>.    This mod is part of <a style="color:#008000" href="https://modrinth.com/modpack/the-vanilla-experience" target="_blank" rel="nofollow">The Vanilla Experience</a> modpack and <a style="color:#666" href="https://modrinth.com/mod/serilums-customization-bundle" target="_blank" rel="nofollow">Serilum's Customization Bundle</a> mod. Starter Kit is a mod which allows players who join a world for the first time to receive items set in a config file. It's possible to set items to any specific slot in the inventory, to the offhand and to the armour slots. The mod can detect which players have never joined before. If another mod adds items, such as guide books, they can either be removed completely or added after the kit has been set. This is configurable via the addExistingItemsAfterKitSet config option. Can be used in a server for all new players or in singleplayer to start off with a default inventory of your choosing. There is also optional support for FTB's Team Island mod after the create island command. The mod can be used server-side only. If you want players to be able to use the "Choose Kit GUI", it has to be installed on the client as well. Alternatively, they can choose kits via server commands. Features:  •  A guide here in the description. Difficulty ranging from Simple, Intermediate and Advanced.  •  Give players joining the world for the first time custom starter items and/or potion effects.  •  Support for multiple kits. Can be given randomly or chosen by the player.  •  There is custom tracking to determine who are new players, compatible with existing worlds.  •  Lots of commands! For creating, adding, managing and choosing starter kits.  •  If installed on the client, kits can be chosen via a custom GUI screen. If not, commands can be used.  •  Add descriptions to your kits. RPG modpack, anyone?  •  Remove other modded starter items, such as guide books. Or add them after the starter kit. Configurable: <a style="color:#008000" href="https://github.com/Serilum/.information/wiki/how-to-configure-mods" rel="nofollow">( how do I configure? )</a> randomizeMultipleKitsToggle (default = true): When multiple starter kits are added via /starterkit add, there are two ways to distribute them. With this enabled, one is chosen at random. When disabled, players can choose one on first join. addExistingItemsAfterKitSet (default = true): Whether items that existed in the inventory, such as books added by other mods, should be added back to the inventory after the kit was set. If disabled, they'll be removed. You can still manually set them via the kit. usePotionEffectsInStarterKit (default = true): If potion/mob effect functionality should be enabled. This means that when creating a kit via /sk (add/set), it also saves the active effects the player has. And when handing out the starter kits, it adds the effects to new players. formatKitNames (default = true): If kit names should be formatted. Each word will be capitalized. chooseKitScreenHeader (default = "%s, you can choose a starter kit!"): The text used above the kit choice screen, or if the mod is not installed in the chat. %s will be replaced with the player's name. announcePlayerKitChoiceInDedicatedServer (default = true): Whether an announcement should be broadcasted to the server whenever a new player makes a kit choice. 'randomizeMultipleKitsToggle' must be disabled, and there must be at least 2 starter kits available. enableFTBIslandCreateCompatibility (default = true): Whether the starter kit should be re-set after the '/ftbteamislands create' command from FTB Team Islands. Does nothing when it's not installed. Commands: Both '/starterkit' and '/sk' can be used. Admin Commands: /sk add (kit_name) - Adds your current inventory to the active kits. /sk set (kit_name) - Sets your current inventory as the only active kit. /sk give <player> (kit_name) - Give a player a random (or specific) starter kit. /sk activate <kit_name>/_all - Moves kit_name or all kits from inactive to active. /sk deactivate <kit_name>/_all - Moves kit_name or all kits from active to inactive. /sk list (inactive) - Lists all active (or inactive) kits. /sk reset - Resets all tracking. Players receive another kit on join. /sk reload - Reloads starter kit changes from the config folder. User Commands: /sk choose <kit_name> - Allows players to choose a starter kit via commands. This is only needed when Starter Kit is not installed on the client and the server enabled kit choices. /sk info <kit_name> - Shows the description and items of kit_name. /sk help - Shows the Starter Kit commands in-game. Usage Guide: The mod can be configured in many different ways. To keep a better overview, I've divided the difficulty into three different sections. Simple, Intermediate and Advanced. Simple: Set a custom starter kit. Add/Remove starter items from other mods. And giving players a starter kit via commands. Intermediate: Add an extra starter kit. Deactivate a kit via commands. Add a starter kit with potion effects, and setting the level and duration. Advanced: Make players choose a kit on first join. Move the inactive default kits to active. Show the choose kit GUI screen. Create a starter kit with a custom description. Section 1: Simple This is the default starter kit, which will be given when the mod is installed without any configuration: <img src="https://github.com/Serilum/.cdn/raw/main/projects/starter-kit/0.png"> You can set your own starter kit by using the '/starterkit set (kit_name)' (or '/sk set (kit_name)') command. The kit name is optional. After using this command, all other active starter kits are moved to the inactive folder. <img src="https://github.com/Serilum/.cdn/raw/main/projects/starter-kit/1.png"> Here you can see the new starter kit data file that was created with the previous command. It's located in './config/starterkit/kits/': <img src="https://github.com/Serilum/.cdn/raw/main/projects/starter-kit/2.png"> That's it! All new players will now receive the "Upgraded" kit when they first join the world: <img src="https://github.com/Serilum/.cdn/raw/main/projects/starter-kit/3.png"> Inside the config file, located at './config/starterkit.json5', you can ch

Starter Kit

About

Versions

Download

Links

Tags