🌟 ClaimKit Mod

📦 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")