SorekillTeams

# SorekillTeams **SorekillTeams** is a lightweight teams plugin for **Paper and Spigot** that provides clean team management, private team chat, team homes, and configurable friendly-fire protection. Designed for modern servers and future proxy networks, SorekillTeams focuses on **core team mechanics** without bloated clan systems, claims, or RPG features. --- ## 🆕 Latest Release — 1.2.0 ### Changelog - Team chat toggle persists across servers - Team invites toggle > ⚠️ Cross-server features are **opt-in** and require SQL + Redis. > Single-server setups work out of the box. --- ## Overview SorekillTeams allows players to form persistent teams that feel natural and intuitive. Players can: - Create and manage teams - Invite and accept members - Chat privately with teammates - Set and teleport to team homes - Prevent accidental PvP with friendly-fire protection Server owners retain **full control** through permissions and a detailed configuration system, with safety-focused defaults and future-proofed architecture. --- ## Features - **Team creation & management** - Create, rename, transfer ownership, kick members, leave, or disband teams - **Advanced invite system** - Expiring invites, cooldowns, invite caps, re-invite refresh support - **Team chat** - `/tc` command or toggle mode - Admin spy support with separate formatting - **Friendly-fire control** - Block or scale teammate damage - Supports melee, projectiles, potions, explosions, and tridents - Per-team toggle and admin bypass - **Team homes** - Set and teleport to team homes - Warmups, cooldowns, and max-home limits - Network-aware metadata for proxy environments - **GUI menu system** - Team management menus - Team browsing and member viewing - Invite management - Offline player heads with skin support - **Update checker** - Spigot history-based update detection - Optional in-game OP notifications - **Safe storage system** - YAML or SQL storage - Autosave, atomic writes, and rolling backups - **Paper & Spigot compatible** - **Optional placeholder support** - PlaceholderAPI and MiniPlaceholders - **Lightweight and focused** - No economy, claims, or RPG systems --- ## Requirements - **Java 21** - **Paper or Spigot 1.21.x** - *(Optional)* PlaceholderAPI 2.11.0+ - *(Optional)* MiniPlaceholders 3.0+ --- ## Installation ### 🔹 Single-Server Setup (Most Servers) This is the default and simplest setup. 1. Download `SorekillTeams-1.2.0.jar` 2. Place it in your server’s `plugins/` directory 3. Start or restart the server 4. Configure permissions (**LuckPerms recommended**) 5. Adjust `config.yml`, `messages.yml`, and `menus.yml` as needed **Notes:** - Uses YAML storage by default - Redis and proxy features are **not required** - Team homes work normally on this server only --- ### 🔹 Multi-Server / Proxy Setup (Advanced) Use this if you run **Velocity or BungeeCord** with multiple backend servers. **Requirements:** - Shared SQL database (MySQL, MariaDB, PostgreSQL, etc.) - Redis server for real-time sync - Proxy (Velocity or BungeeCord) **Steps:** 1. Set `storage.type` to a SQL backend 2. Enable Redis in `config.yml` 3. Give each backend server a **unique** `redis.server_id` 4. Set `homes.server_name` to match the **proxy server name** - ⚠️ This must exactly match the name used by the proxy 5. Enable `homes.proxy_mode` if using cross-server home teleports 6. Restart all backend servers **What you get:** - Network-wide team membership - Cross-server invites and chat - Team events synced instantly - Network-aware team homes (teleport routing ready) > SQL is the **source of truth** > Redis is the **real-time notification layer** --- Reload configs anytime with: '/sorekillteams reload' --- ## Commands ### Player Commands | Command | Description | Permission | |-------|-------------|------------| | `/team` | Base team command | `sorekillteams.use` | | `/team create <name>` | Create a team | `sorekillteams.create` | | `/team invite <player>` | Invite a player | `sorekillteams.invite` | | `/team invites` | View pending invites | `sorekillteams.invites` | | `/team accept ` | Accept an invite | `sorekillteams.accept` | | `/team deny ` | Deny an invite | `sorekillteams.deny` | | `/team leave` | Leave your team | `sorekillteams.leave` | | `/team info` | View team info | `sorekillteams.info` | | `/team ff <on|off|toggle>` | Toggle friendly fire | `sorekillteams.ff` | ### Owner-Only Team Commands | Command | Description | Permission | |-------|-------------|------------| | `/team kick <player>` | Kick a member | `sorekillteams.kick` | | `/team transfer <player>` | Transfer ownership | `sorekillteams.transfer` | | `/team rename <name>` | Rename your team | `sorekillteams.rename` | | `/team disband` | Disband your team | `sorekillteams.disband` | | `/team sethome` | Set a team home | `sorekillteams.sethome` | | `/team delhome` | Delete a team home | `sorekillteams.delhome` | ### Tea