Survival Core

Extends vanilla gameplay with quality-of-life features and custom mechanics.

Quick challenge

How far can you run before the mobs catch you?

Survival Core

![Banner Survival Core](https://cdn.modrinth.com/data/cached_images/a825c154f850fe03dc297a002f577538f643dba5_0.webp)

# 🌟 SurvivalCore

### *Elevate Your Vanilla Survival Experience*

[![Paper](https://img.shields.io/badge/Paper-1.21+-blue?style=for-the-badge&logo=papermc)](https://papermc.io/)
[![Java](https://img.shields.io/badge/Java-21+-orange?style=for-the-badge&logo=openjdk)](https://adoptium.net/)
[![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)](LICENSE)
[![Version](https://img.shields.io/badge/Version-1.0.0--ALPHA-purple?style=for-the-badge)](https://github.com/minekarta/survivalcore)

---

*A premium survival enhancement plugin that adds quality-of-life features while preserving the vanilla Minecraft experience. Designed for performance and fully configurable.*

[Features](#-features) • [Installation](#-installation) • [Commands](#-commands) • [Permissions](#-permissions) • [Configuration](#-configuration)

---

## ✨ Features

### 🌾 Harvest Hoe
**Auto-harvest & replant crops**

- Works with Wheat, Carrots, Potatoes, Beetroot, Nether Wart
- Tier-based radius (Wood: 1x1 → Netherite: 5x5)
- Particle & sound effects
- Respects tool durability

### 🪓 Timber (Tree Feller)
**Fell entire trees instantly**

- Sneak + break to activate
- Tier-based max blocks (up to 512 with Netherite)
- Auto-replant saplings
- Animated block breaking

### ⛏️ Vein Miner
**Mine entire ore veins at once**

- All vanilla ores supported
- Tier-based limits (up to 128 with Netherite)
- XP multiplier support
- Deepslate ores included

### 💀 Custom Mob Drops
**Configure extra drops from any mob**

- Per-mob drop configuration
- Looting enchantment bonus
- Rare drop particle effects
- Boss bonus XP system

### 📊 Player Statistics
**Track comprehensive player stats**

- Blocks mined/placed
- Mobs & players killed
- Deaths, playtime, distance
- Leaderboard system

### � Keep Inventory
**Save a percentage of items on death**

- Tier-based percentages (25% → 100%)
- Priority modes: Armor, Hotbar, Random
- Optional XP preservation
- Permission-based tiers

### 🪑 Sit & Lay
**Immersive sitting and laying system**

- Sit on stairs, slabs, carpets
- `/sit` and `/lay` commands
- Stand on damage option
- Natural pose animations

### 🎒 Portable Utilities
**Open crafting interfaces anywhere**

- 8 portable interfaces
- Per-utility cooldowns
- Sound effects
- Bypass permissions available

---

## 📦 Installation

```
1. Download SurvivalCore-1.0.0-ALPHA.jar
2. Place in your server's plugins/ folder
3. Restart the server
4. Edit config.yml and messages.yml as needed
5. Use /survivalcore reload to apply changes
```

### Requirements

| Requirement | Version |
|------------|---------|
| 📄 Paper/Folia | 1.21+ |
| ☕ Java | 21+ |

---

## 💻 Commands

### Main Commands

| Command | Description | Permission |
|---------|-------------|------------|
| `/survivalcore` | Main plugin command | `survivalcore.admin` |
| `/survivalcore reload` | Reload configuration | `survivalcore.reload` |
| `/survivalcore info` | Show plugin info | `survivalcore.info` |
| `/survivalcore help` | Show help menu | — |

### Statistics

| Command | Description | Permission |
|---------|-------------|------------|
| `/stats` | View your statistics | `survivalcore.stats` |
| `/stats ` | View player statistics | `survivalcore.stats` |
| `/leaderboard [category]` | View leaderboard | `survivalcore.leaderboard` |

**Leaderboard Categories:** `blocks_mined`, `blocks_placed`, `mobs_killed`, `players_killed`, `deaths`, `time_played`, `distance_walked`, `fish_caught`

### Sit & Lay

| Command | Description | Permission |
|---------|-------------|------------|
| `/sit` | Sit down at current location | `survivalcore.sit` |
| `/lay` | Lay down at current location | `survivalcore.sit.lay` |

### Portable Utilities

| Command | Aliases | Description | Permission |
|---------|---------|-------------|------------|
| `/craft` | `/workbench`, `/wb` | Open crafting table | `survivalcore.portable.craft` |
| `/enderchest` | `/ec`, `/echest` | Open ender chest | `survivalcore.portable.enderchest` |
| `/anvil` | — | Open anvil | `survivalcore.portable.anvil` |
| `/grindstone` | — | Open grindstone | `survivalcore.portable.grindstone` |
| `/stonecutter` | — | Open stonecutter | `survivalcore.portable.stonecutter` |
| `/cartography` | — | Open cartography table | `survivalcore.portable.cartography` |
| `/smithing` | — | Open smithing table | `survivalcore.portable.smithing` |
| `/loom` | — | Open loom | `survivalcore.portable.loom` |

---

## 🔐 Permissions

### Admin Permissions

| Permission | Description |
|------------|-------------|
| `survivalcore.admin` | Full admin access |
| `survivalcore.reload` | Reload configuration |
| `survivalcore.info` | View plugin info |

### Feature Permissions

| Permission | Description |
|------------|-------------|
| `survivalcore.harvesthoe` | Use harvest hoe feature |
| `survivalcore.timber` | Use timber/tree feller |
| `survivalcore.veinminer` | Use vein miner |
| `survivalcore.mobdrops` | Receive custom mob drops |
| `survivalcore.keepinventory` | Keep items on death |
| `survivalcore.stats` | View player statistics |
| `survivalcore.leaderboard` | View leaderboard |
| `survivalcore.sit` | Use sit feature |
| `survivalcore.sit.lay` | Use lay feature |

### Portable Permissions

| Permission | Description |
|------------|-------------|
| `survivalcore.portable.*` | All portable utilities |
| `survivalcore.portable.craft` | Portable crafting table |
| `survivalcore.portable.enderchest` | Portable ender chest |
| `survivalcore.portable.anvil` | Portable anvil |
| `survivalcore.portable.grindstone` | Portable grindstone |
| `survivalcore.portable.stonecutter` | Portable stonecutter |
| `survivalcore.portable.cartography` | Portable cartography |
| `survivalcore.portable.smithing` | Portable smithing |
| `survivalcore.portable.loom` | Portable loom |
| `survivalcore.portable.nocooldown` | Bypass all cooldowns |

### Keep Inventory Tiers

| Permission | Keep Percentage |
|------------|-----------------|
| `survivalcore.keepinventory.basic` | 25% |
| `survivalcore.keepinventory.vip` | 50% |
| `survivalcore.keepinventory.mvp` | 75% |
| `survivalcore.keepinventory.elite` | 100% |

---

### 🌐 Connect With Us

[![Website](https://img.shields.io/badge/Website-minekarta.com-blue?style=flat-square)](https://minekarta.com)
[![Discord](https://img.shields.io/badge/Discord-Join%20Us-7289DA?style=flat-square&logo=discord&logoColor=white)](https://discord.gg/minekarta)

---

*Made with ❤️ by Minekarta Studio*

Survival Core

How far can you run before the mobs catch you?

Confirm your run

Survival Core

Gallery