🛡️ ProtectorMod - Advanced Protection System

ProtectorMod is a territory protection mod designed for Fabric servers that offers granular control over protected zones, with full support for Redstone machines and Create.

✨ Main Features

🏰 Protection Cores

Normal Core: For regular players
Admin Core: For administrators with special permissions
Multi-block structure: 2-block tall
Configurable radii: Up to 5 expansion levels
Per-player limit: Server-configurable

🔐 Permission System

Owner: Full control over the zone
Clan/Members: Invitation and role system
Configurable flags:
- build - Building permissions
- interact - Block interaction
- chests - Container access
- use-buckets - Bucket usage
- lighter - Fire usage
- crop-trample - Crop trampling
- pvp - PvP combat
- mob-damage - Mob damage
- explosion - Explosion protection

🤖 Machine Support (NEW v1.5.5)

Smart Marking System

✅ SQLite Persistence: Marks are saved to disk and survive server restarts
✅ Automatic marking: Redstone/Create blocks placed by trusted members are automatically marked
✅ Controlled bypass: Only marked machines can operate in protected zones
✅ Anti-grief protection: Unmarked machines are blocked

Supported Blocks

Vanilla Redstone:

Dispensers, Droppers
Pistons / Sticky Pistons
Observers, Hoppers
Redstone Lamps

Create Mod:

Mechanical Drills
Deployers, Harvesters
Saws, Ploughs
All machines that use FakePlayer

📋 Commands

/clan create <name>    - Create a clan
/clan invite <player>  - Invite a player
/clan accept           - Accept invitation
/clan kick <player>    - Kick member
/clan leave            - Leave clan
/clan list             - View members

🎮 How to Use

Setup Protection Zone

Place a Protection Core
Right-click to open the configuration menu
Configure flags according to your needs
Invite members to your clan
Place Redstone/Create machines - they'll be automatically marked!

Machines Behavior

✅ Marked machines (placed by trusted members) → Work in protected zones
❌ Unmarked machines → Blocked in protected zones
✅ Marks persist through server restarts (SQLite database)
❌ Command-placed blocks (/setblock) → NOT marked (anti-exploit)

🔧 Installation

Requirements

Minecraft: 1.20.1
Fabric Loader: 0.15.0+
Fabric API: Latest version for 1.20.1

Optional Dependencies

Create: For full Create machine support

Steps

Install Fabric Loader
Download Fabric API
Place ProtectorMod JAR in the mods/ folder
Launch Minecraft or your server
Done! Protection cores will be available in the creative inventory

📊 Database

Persistent Storage

Location: world_folder/protector_marked_blocks.db
Format: SQLite 3
Automatic: Database is created on first use
Backup: Regular backups recommended

🐛 Troubleshooting

Machines not working?

✅ Verify you're a trusted member of the protection core
✅ Check that the machine is marked (placed manually by a trusted member)
✅ Review server logs for bypass messages: [ProtectorMod] FakePlayer BYPASS...
✅ Reload the world if you just updated the mod

Commands not responding?

Ensure you have the necessary permissions
Verify the protection core exists and is loaded

🔄 Compatibility

Compatible Mods

✅ Create
✅ Tech Reborn
✅ Applied Energistics 2
✅ Botania
✅ Carpet Mod

Known Limitations

Create contraptions in motion don't maintain marks (restored when stopped)
Blocks placed by commands are not marked (intentional anti-exploit feature)

💬 Support

If you encounter any issues or have suggestions, please report them on the GitHub repository or Discord server.

⚖️ License

This mod is licensed under MIT License. You can freely use it on your server or modpack.

Enjoy secure protection with full machine support! 🛡️✨

🛡️ ProtectorMod - Sistema de Protección Avanzado

ProtectorMod es un mod de protección de territorios diseñado para servidores Fabric que ofrece un control granular sobre zonas protegidas, con soporte completo para máquinas de Redstone y Create.

✨ Características Principales

🏰 Núcleos de Protección

Núcleo Normal: Para jugadores regulares
Núcleo Admin: Para administradores con permisos especiales
Estructura multi-bloque: 2 bloques de altura
Radios configurables: Hasta 5 niveles de expansión
Límite por jugador: Configurable por el servidor

🔐 Sistema de Permisos

Propietario: Control total sobre la zona
Clan/Miembros: Sistema de invitaciones y roles
Banderas configurables:
- build - Permisos de construcción
- interact - Interacción con bloques
- chests - Acceso a contenedores
- use-buckets - Uso de cubos
- lighter - Uso de fuego
- crop-trample - Pisoteo de cultivos
- pvp - Combate PvP
- mob-damage - Daño de mobs
- explosion - Protección contra explosiones

🤖 Soporte de Máquinas (NUEVO v1.5.5)

Sistema de Marcado Inteligente

✅ Persistencia SQLite: Las marcas se guardan en disco y sobreviven reinicios del servidor
✅ Marcado automático: Bloques de Redstone/Create colocados por miembros confiables se marcan automáticamente
✅ Bypass controlado: Solo máquinas marcadas pueden operar en zonas protegidas
✅ Protección anti-grief: Máquinas sin marcar son bloqueadas

Bloques Soportados

Redstone Vanilla:

Dispensers, Droppers
Pistones / Pistones Pegajosos
Observadores, Tolvas
Lámparas de Redstone

Mod Create:

Taladros Mecánicos (Mechanical Drills)
Desplegadores (Deployers), Cosechadoras (Harvesters)
Sierras (Saws), Arados (Ploughs)
Todas las máquinas que usan FakePlayer

📋 Comandos

/clan create <nombre>    - Crear un clan
/clan invite <jugador>   - Invitar a un jugador
/clan accept             - Aceptar invitación
/clan kick <jugador>     - Expulsar miembro
/clan leave              - Abandonar clan
/clan list               - Ver miembros

🎮 Cómo Usar

Configurar Zona de Protección

Coloca un Núcleo de Protección
Click derecho para abrir el menú de configuración
Configura las banderas según tus necesidades
Invita miembros a tu clan
Coloca máquinas de Redstone/Create - ¡se marcarán automáticamente!

Comportamiento de Máquinas

✅ Máquinas marcadas (colocadas por miembros confiables) → Funcionan en zonas protegidas
❌ Máquinas sin marcar → Bloqueadas en zonas protegidas
✅ Las marcas persisten a través de reinicios del servidor (base de datos SQLite)
❌ Bloques colocados con comandos (/setblock) → NO se marcan (anti-exploit)

🔧 Instalación

Requisitos

Minecraft: 1.20.1
Fabric Loader: 0.15.0+
Fabric API: Última versión para 1.20.1

Dependencias Opcionales

Create: Para soporte completo de máquinas Create

Pasos

Instala Fabric Loader
Descarga Fabric API
Coloca el JAR de ProtectorMod en la carpeta mods/
Inicia Minecraft o tu servidor
¡Listo! Los núcleos de protección estarán disponibles en el inventario creativo

📊 Base de Datos

Almacenamiento Persistente

Ubicación: world_folder/protector_marked_blocks.db
Formato: SQLite 3
Automático: La base de datos se crea en el primer uso
Backup: Se recomienda respaldar periódicamente

🐛 Solución de Problemas

¿Las máquinas no funcionan?

✅ Verifica que eres miembro confiable del núcleo de protección
✅ Comprueba que la máquina está marcada (colocada manualmente por un miembro confiable)
✅ Revisa los logs del servidor para mensajes de bypass: [ProtectorMod] FakePlayer BYPASS...
✅ Recarga el mundo si acabas de actualizar el mod

¿Los comandos no responden?

Asegúrate de tener los permisos necesarios
Verifica que el núcleo de protección existe y está cargado

🔄 Compatibilidad

Mods Compatibles

✅ Create
✅ Tech Reborn
✅ Applied Energistics 2
✅ Botania
✅ Carpet Mod

Limitaciones Conocidas

Contraptions de Create en movimiento no mantienen marcas (se restauran al detenerse)
Bloques colocados por comandos no se marcan (característica intencional anti-exploit)

💬 Soporte

Si encuentras algún problema o tienes sugerencias, por favor repórtalos en el repositorio de GitHub o servidor de Discord.

⚖️ Licencia

Este mod está licenciado bajo MIT License. Puedes usarlo libremente en tu servidor o modpack.

¡Disfruta de protección segura con soporte completo de máquinas! 🛡️✨

ProtectionCore