# MexicanlandCore

The core plugin for Minecraft networks. MexicanlandCore provides a complete
suite of essential modules that any serious server needs, built with modern
APIs and optimized for performance.

## ✨ Features

- 💰 **Economy** — Cash & bank system, salary, Vault compatible
- 💬 **Chat** — Custom format, private messages, emoji support, command whitelist
- 📋 **Scoreboard** — Fully configurable, PlaceholderAPI support, per-player types
- ✨ **Holograms** — TextDisplay-based, persistent, scalable (Premium)
- 🏠 **Homes** — Set, teleport, rename and delete homes with LuckPerms limit support
- 🌀 **RTP** — Safe random teleport with configurable cooldown and worlds
- 🤝 **TPA** — Teleport requests with auto-accept, block list and cooldowns
- 📢 **Announcements** — Scheduled and manual announcements, network-wide support
- 🏛️ **Lobby** — Lobby/spawn management, PvP zone, AFK kick system

## ⚙️ Technical Highlights

- Java 21 · Paper 1.21.4
- Folia compatible
- Adventure API (no legacy ChatColor)
- HikariCP connection pool (MySQL or YML fallback)
- 9 languages: `es` `en` `de` `fr` `it` `pt` `ru` `ja` `ko`
- bStats metrics
- Module system — enable/disable any module without restart

## 📦 Dependencies

**Required:** None — works standalone

**Soft dependencies (optional):**
Vault · LuckPerms · PlaceholderAPI · WorldGuard · Citizens · Multiverse-Core

## 🔧 Commands

| Command | Description |
|---|---|
| `/ml menu` | Open module manager GUI |
| `/ml reload <module>` | Reload a module |
| `/eco <set\|add\|remove>` | Manage player balance |
| `/money` | View your balance |
| `/holo <create\|edit\|remove>` | Manage holograms |
| `/rtp` | Random teleport |
| `/tpa <player>` | Teleport request |
| `/sethome` · `/home` | Home management |

## 📋 Requirements

- Paper 1.21.4+
- Java 21+