<p align="center">
  <h1 align="center">RS-MobStand</h1>
  <p align="center">
    Automated Mob Farming for Modern Minecraft Servers
  </p>
</p>

<p align="center">

![Minecraft](https://img.shields.io/badge/Minecraft-1.21%2B-green)
![Platform](https://img.shields.io/badge/Platform-Paper-orange)
![Storage](https://img.shields.io/badge/Storage-SQLite-blue)
![Status](https://img.shields.io/badge/Status-Stable-success)
![Development](https://img.shields.io/badge/Development-Active-brightgreen)
![RS Ecosystem](https://img.shields.io/badge/RS-Ecosystem-purple)

</p>

---

## Overview

**RS-MobStand** is a powerful automated mob farming plugin designed for Minecraft servers that want reliable resource generation without the performance impact of traditional mob farms.

Players place and configure Mob Stands to generate mob drops while server owners maintain full control through configurable settings, permissions, filters, upgrades, and administrative tools.

Built from the ground up with performance, scalability, and long-term server operation in mind.

---

## Why RS-MobStand?

Traditional mob farms often create:

- Excessive entity counts
- Server lag
- Chunk-loading issues
- Complex redstone systems
- Difficult balancing

RS-MobStand replaces those systems with a clean, configurable, database-backed solution that is easy for players to use and easy for administrators to manage.

---

# Features

### Automated Mob Farming

Generate mob drops without traditional mob grinders.

### Dynamic GUI Menus

Simple and intuitive inventory-based interfaces.

### Advanced Filtering

Control mob behavior with configurable options.

### Radius Controls

Fine-tune stand operation and efficiency.

### Leave Alive Support

Maintain mobs while still controlling automation.

### SQLite Storage

Reliable persistent data storage.

### Chunk-Safe Design

Built to behave correctly across chunk loads and unloads.

### Performance Focused

Designed to minimize server impact while maximizing functionality.

### Administrative Tools

Powerful management tools for staff and server operators.

---

# RS Ecosystem

RS-MobStand is the resource generation component of the growing **RS Ecosystem**.

```text
┌─────────────┐
│ RS-MobStand │
└──────┬──────┘
       │ Generate
       ▼
┌──────────────┐
│ RS-ItemMagnet│
└──────┬───────┘
       │ Collect
       ▼
┌───────────┐
│ RS-Auger  │
└─────┬─────┘
      │ Transport
      ▼
┌─────────────┐
│ RS-Warehouse│
└─────────────┘
       Store
```

Together these plugins create a complete automated resource collection and logistics system.

---

# Screenshots

### Main Menu

*Coming Soon*

### Mob Stand Interface

*Coming Soon*

### Administrative Menu

*Coming Soon*

### In-World Mob Stand

*Coming Soon*

---

# Commands

| Command | Description |
|----------|-------------|
| `/rsms` | Open the Mob Stand menu |
| `/rsms admin` | Open administrative controls |

---

# Permissions

| Permission | Description |
|------------|-------------|
| `rs.mobstand.use` | Allows use of Mob Stands |
| `rs.mobstand.admin` | Administrative access |

---

# Installation

1. Download the latest release.
2. Place the jar into your server's `plugins` folder.
3. Restart the server.
4. Configure settings as desired.
5. Enjoy automated mob farming.

---

# Performance

RS-MobStand was designed with long-term server operation in mind.

Features include:

- SQLite persistence
- Chunk-safe processing
- Efficient task management
- Optimized stand handling
- Minimal entity overhead

---

# Development Status

| Component | Status |
|------------|---------|
| Core System | ✅ Complete |
| GUI System | ✅ Complete |
| SQLite Storage | ✅ Complete |
| Administrative Tools | ✅ Complete |
| Optimization | ✅ Complete |
| Public Release | 🚧 Pending |

---

# Contributors

### Big Pappa

Project Creator  
Founder of RSScripting

### Atlas

Architecture, Design & Development Support

---

# Support

If you encounter a bug or have a feature request, please open an issue in the GitHub repository.

---

# License

Copyright © 2026 RSScripting

All rights reserved.

This project may not be copied, modified, redistributed, or sold without explicit written permission from RSScripting.

---

<p align="center">
  Built by RSScripting
</p>

<p align="center">
  Generate • Collect • Transport • Store
</p>
