# ️ NinjaBungeeLogger - The Ultimate Logging & Security Suite

NinjaBungeeLogger is a complete, all-in-one logging and security plugin for BungeeCord, Waterfall, and Velocity proxies. It provides server administrators with unparalleled insight into their player base while offering powerful, automated tools to keep the network safe and secure.

From advanced geolocation and client detection to interactive investigation commands and deep Discord integration, NinjaBungeeLogger is the only logging plugin you'll ever need.

---

## ✨ Core Features

- ✅ **Comprehensive Connection Logging**: Logs everything from basic IPs and UUIDs to advanced data points you won't find elsewhere.
- **Advanced Geolocation**: Pinpoints player locations, including Country, State, City, ISP, and ASN data.
- **Deep Discord Integration**: Sends beautiful, detailed, and instant notifications for connections, disconnections, server switches, and security alerts.
- ️ **Powerful Security & Anti-Evasion**: Automatically detects and acts on players using Proxies, VPNs, or known Cheat Clients.
- **Location-Based Restrictions**: Blocks connections from specific countries or states/regions via a simple config change.
- **Multi-Account (Alt) Detection**: Instantly identifies players connecting from the same IP address and alerts staff.
- **Intelligent Client Detection**: Reliably identifies popular game clients (Vanilla, Lunar, Badlion, etc.), mod loaders (Forge, Fabric), and even Bedrock connections (via Geyser).
- ️ **Interactive Admin Commands**: A detailed player information panel with clickable IP addresses to instantly investigate related accounts.
- **Flexible Data Storage**: Supports H2, MySQL, SQLite, and JSON out of the box.

---

## Installation

1. Download the latest release `.jar` file.
2. Place the JAR file in your proxy's `plugins` folder.
3. Start your proxy server. The default configuration files will be generated.
4. Edit `config.yml` to set up your database, Discord webhooks, and other settings.
5. Restart the proxy or use `/bungeelogs reload`.

---

## ⚙️ Commands & Permissions

The main command is `/bungeelogs` (aliases: `/bl`, `/bungeelogin`).

| Command | Description | Permission |
| ------------------------------------- | --------------------------------------------------------------------------- | --------------------------- |
| `/bungeelogs check <player>` | Shows the complete data profile for a player. | `iplogger.admin.check` |
| `/bungeelogs reload` | Reloads the plugin's configuration file. | `iplogger.admin.reload` |
| `/bungeelogs alerts` | Toggles multi-account alerts in-game for the person running the command. | `iplogger.admin.alerts` |
| `/checkip <ip>` | Shows all players who have connected from a specific IP address. | `iplogger.admin.check` |
| `/purgedata <player \| --all>` | Removes player data from the database. | `iplogger.admin.purge` |
| (Receive In-Game Alerts) | Players with this permission will receive in-game security notifications. | `iplogger.notify` |

---

## Configuration

The `config.yml` is designed to be powerful yet easy to understand. You can customize nearly every aspect of the plugin.

<details>
<summary>Click to see the default config.yml</summary>

```yaml
# NinjaBungeeLogger Configuration v1.2
# A powerful BungeeCord/Velocity plugin for logging player information,
# detecting alts, proxies, and more.

# General logging settings for the console.
logging:
status: true
connections: true
disconnections: true
server-switches: true
errors: true
debug:
log-plugin-messages: false

# Enable/disable specific information to be logged for each player.
log-info:
uuid: true
hostname: true
timestamp: true
version: true
virtual-host: true
locale: true
geolocation: true
client-brand: true

# ... and much more, including sections for:
# - multiple-accounts
# - proxy-check
# - cheat-detection
# - restrictions (Country/State blocking)
# - discord (webhooks, embed content)
# - storage (H2, MySQL, SQLite, JSON)
# - messages (customize all user-facing text)
```




Desc written by AI ill rewrite it when I get the time!