🛡️ 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

1. Place a Protection Core
2. Right-click to open the configuration menu
3. Configure flags according to your needs
4. Invite members to your clan
5. 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

1. Install Fabric Loader
2. Download Fabric API
3. Place ProtectorMod JAR in the mods/ folder
4. Launch Minecraft or your server
5. 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?

1. ✅ Verify you're a trusted member of the protection core
2. ✅ Check that the machine is marked (placed manually by a trusted member)
3. ✅ Review server logs for bypass messages: [ProtectorMod] FakePlayer BYPASS...
4. ✅ 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

1. Coloca un Núcleo de Protección
2. Click derecho para abrir el menú de configuración
3. Configura las banderas según tus necesidades
4. Invita miembros a tu clan
5. 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

1. Instala Fabric Loader
2. Descarga Fabric API
3. Coloca el JAR de ProtectorMod en la carpeta mods/
4. Inicia Minecraft o tu servidor
5. ¡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?

1. ✅ Verifica que eres miembro confiable del núcleo de protección
2. ✅ Comprueba que la máquina está marcada (colocada manualmente por un miembro confiable)
3. ✅ Revisa los logs del servidor para mensajes de bypass: [ProtectorMod] FakePlayer BYPASS...
4. ✅ 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! 🛡️✨