Mods / ๐ŸŒŸ ClaimKit Mod

Tags: #Cheat #Simplification #Utility
Author: MelliRunH
Side: Server
Created: Apr 30th at 4:03 AM
Last modified: May 1st at 5:25 PM
Downloads: 135
Follow Unfollow 9

Latest release (for Vintage Story 1.20.7 and 1.20.8 - 1.20.9, outdated):
ClaimkitMelli_1.20.7_v1.0.2.zip  1-click install


๐Ÿ“ฆ ClaimKitMod – Vintage Story
=========================================

A mod for Vintage Story 1.20.7+ that allows you to manage custom starter kits and an administrative jail system for servers.

๐Ÿ› ๏ธ Requirements
------------
- ๐ŸŽฎ Vintage Story v1.20.7 or higher
- โœ… Administrator privileges ("gamemode") for some commands
- ๐Ÿ“ Place the mod in the `Mods/` folder

๐Ÿงฐ Features
------------------

| Feature | Description |
|----------------------|------------------------------------------------------------|
| ๐ŸŽ Custom Kits | Create and deliver kits from the quickbar |
| ๐Ÿšจ Jail System | Punish players with reason and duration |
| ๐Ÿ” Protected Commands | Only admins can use punish/unpunish |
| โณ Real-time | The punishment only counts while the player is online |
| ๐Ÿšท Restrictions | The punished player can only eat and check status |

๐Ÿ‘ค Player Commands
----------------------------------

๐Ÿ“ฆ `/claimkit`
Claim kit if your quickbar is empty.

๐Ÿ” `/carcel list`
Check if you're punished and how much time is left.

๐Ÿ‘ฎ Admin Commands
--------------------------------------------

๐Ÿงฐ `/setkit`
Set the current kit from your quickbar.

๐Ÿšซ `/punish <player> <duration> <reason>`
Punishes a player (does not automatically teleport).
Example: `/punish MelliRunH 2h tap`

๐Ÿ†“ `/release <player>`
Releases a player from prison.

๐Ÿ“œ `/prison list`
Displays all currently grounded players.

โš ๏ธ Restrictions for Grounded Players
-------------------------------

โŒ They cannot chat or use commands
โŒ They cannot use TP or interact with advanced items
โœ… They can only eat fruits and grains
โœ… They can only use `/carcel list`

๐Ÿงช Time System
---------------------
- The grounding timer will only advance if the player is online
- Upon reconnecting, the player will remain grounded until the timer expires

๐Ÿ“ Prison Management
--------------------------------------------
- No automatic teleportation
- The admin must manually take the player to "jail"
- The area must be protected with `/land claim`

๐Ÿ‘ค Author
--------
MelliRunH

๐Ÿ’ฌ Support
--------------------------
You can report bugs or suggestions from the forum or official mod channel.

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
โš™๏ธChanges :
Version 1.0.0: SetKit code
Version 1.0.1: Kit+Prison
Version 1.0.2: Restructuring of the Kit+Prison source code to improve translation and adding the es-es.json and en-en.json files to the assets/ folder.
Future improvements will be posted here:...



--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 

ClaimMod

It allows server admins to configure a custom set of items and let players claim them once via a command. Perfect for survival servers, modpacks, or any community that wants to give players a helpful start.

Features:
Admins can define the kit by placing items in the hotbar and using /setkit

View saved kits with /setkit list

Players can claim the starter kit once using /claimkit

/help setkit shows available commands and usage

Permissions & Setup:
It's recommended to assign the "controlserver" privilege to admin roles in serverconfig.json

Only users with "admin" or "crmod" privileges can configure the kit

All players can use /claimkit once per account

This is a lightweight utility mod aimed at improving the onboarding experience for new players. More admin tools and customization options are planned for future updates. Feedback is welcome!

Source Code Coming Soon:git hub ("under construction")

Mod Version For Game version Downloads Released Changelog Download 1-click mod install*
1.0.2
1.20.8 - 1.20.9
75 May 1st at 5:25 PM ClaimkitMelli_1.20.7_v1.0.2.zip 1-click install

Versión 1.0.2: Reestructuración del código fuente de Kit+Prison para mejorar la traducción y añadir los archivos es-es.json y en-en.json a la carpeta assets/.

1.0.1 32 May 1st at 3:38 AM ClaimkitMelli_1.20.7 v1.0.1.zip 1-click install

An improvement of the mod to add some more useful commands for both administrators and users

๐Ÿ› ๏ธ Requirements

  • ๐ŸŽฎ Vintage Story v1.20.7

  • โœ… Administrator privileges (gamemode) for certain commands

  • ๐Ÿง  Basic understanding of in-game chat commands


โš™๏ธ Features

Feature Description
๐ŸŽ Custom Kits Set and claim a kit from your hotbar
๐Ÿšจ Jail System Punish players with duration, reason, and action restrictions
๐Ÿ›ก๏ธ Command Protection Only admins can punish or release players
โณ Online Time Counting Jail time progresses only when the player is online
๐Ÿšท Prisoner Restrictions Cannot use commands, only allowed to eat and check jail status

๐Ÿ‘ค Commands for Players

๐Ÿ“ฆ /claimkit

Claim the current kit if your hotbar is empty.

โ— Can only be claimed once per kit version.

๐Ÿ” /carcel list

Check if you're in jail and see the remaining time.

Example output:

Reason: breaking protected crops Time remaining: 0.75 hours

๐Ÿ‘ฎ Commands for Administrators

๐Ÿงฐ /setkit

Set the current kit from your hotbar.

๐Ÿšซ /castigar <player> <duration> <reason>

Punish a player.

โ— The player will not be teleported automatically. You must manually move them to the protected jail area.

Duration format: 1d2h30m, or just 10m, 5h, etc.

โœ… Example

arduino
 
/castigar MelliRunH 1h15m griefing in protected zone

๐Ÿ†“ /liberar <player>

Release a player from jail if they are currently punished.

Displays a notification to the released player.

โœ… Example

 
/liberar MelliRunH

๐Ÿ“œ /prision list

List all currently punished players, including reason and remaining time.


โš ๏ธ Punishment Restrictions

  • โŒ Cannot use commands (except /carcel list)

  • โŒ Cannot use chat

  • โŒ Cannot use /tp, /bring, or other teleport-related commands

  • โœ… Can only eat (fruits, cereals, food)


๐Ÿงช Time System

  • Jail time progresses only while the player is online

  • When reconnecting, the punished player will be relocated automatically (if needed)


๐Ÿงฑ Jail & Area

  • Players are not automatically teleported when punished.

  • Admins must manually move them to a protected jail area.

  • Ensure the jail area is secured using /land claim


๐Ÿ“ฅ Installation

  1. Place the compiled .dll into your Mods/ folder

  2. Restart the server

  3. Use /help setkit or /help castigar to view commands


โœจ Author

MelliRunH


๐Ÿ’ฌ Support

If you find bugs or have suggestions, open an issue in the repository or contact me directly.

1.0.0 28 Apr 30th at 4:08 AM ClaimkitMelli_1.20.7.zip 1-click install

Por ahora está versión si necesitas que lo actualize enviame mp¡


13 Comments (oldest first | newest first)

💬 iTTz_Rook, Aug 13th at 1:55 AM

Also confirming.  After server reset, all items in kit are wiped and have to be set again.  Running on a server with no active mods so there can't be a conflict.  As someone else asked earlier, where is the data for the items that are being set in the kit being stored?  

💬 DejFidOFF, Jul 27th at 2:48 PM

MelliRunH

Confirmed.. This mod Is useless, until every server reset, kit is reseting and not working

disapointed

💬 Grendelbiter, May 26th at 3:24 PM

Where does it save the kit? Maybe the save location is the problem. I tried poking around myself but I can't find any json or .db file in Moddata or anywhere else.

💬 MelliRunH , May 25th at 3:31 PM

@Grendelniter It's strange that I can keep it there correctly on this server and it doesn't restart at any time... everything is still as it was saved, maybe you have a problem with the server configuration, or some file or other mod that is causing something like this, but I can tell you that normally it always stays saved, I don't know what the error you're telling me about could be.

💬 Grendelbiter, May 24th at 4:41 PM

No that's the problem, it always says it's empty after a restart and I have to define it again.

💬 MelliRunH , May 23rd at 10:12 PM

@Grendelbiter Hello, even if you restart the server, the kit you have established is still there predefined, it is saved when you press the command /claimkit you will see a message if you have it loaded or not

💬 Grendelbiter, May 23rd at 11:43 AM

Hi, the claimkit resets every time the server resets, where exactly is the kit saved?

💬 MelliRunH , May 2nd at 3:30 AM

DejFidOFF

Si yes

💬 DejFidOFF, May 1st at 8:09 PM

MelliRunH

 

Thank you. I mean if it´s compatible with Th3essentials mod´s kit system ( command /starterkit ).

💬 MelliRunH , May 1st at 1:33 PM

Senkiu @C4BR3R4

💬 MelliRunH , May 1st at 1:31 PM

@DejFidOFF

Hello. I have some questions. How many kits can I configure? You can only configure one kit. /setkit sets the kit you have in the bar below the belt, but you can change it as many times as necessary. Each time you change it, users can claim it again, not just one. Can I reset the kit for everyone or for a single player? Do I have my own JSON configuration to manage kit items? It's not necessary, since the belt below configures the pack, and you make it functional when you use /setkit. The normal player will have to press /claimkit to claim it only once until the admin updates it again. Do I have my own kit system? Is it possible to work with the Th3essentials mod (Where is /starterkit?)? (I hope to have answered your questions and sorry if my English isn't good, I only speak Spanish :))

💬 C4BR3R4, May 1st at 9:10 AM

Hi, I created language file es-es.json HERE.

💬 DejFidOFF, May 1st at 7:48 AM

MelliRunH

Hello. Few questions. How many kits I can set up? Can I reset kit dor everyone / one player?  Have this own json config where I manage items in the kit? Have this own kit system? Is it possible to work alongside Th3essentials mod ( where is /starterkit )?

 (edit comment delete)