SorekillTeams

SorekillTeams

Paper and Spigot 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

- Lightweight and focused - Create, rename, transfer ownership, kick members, leave, or disband teams - Lightweight and focused - Expiring invites, cooldowns, invite caps, re-invite refresh support - Lightweight and focused - `/tc` command or toggle mode - Admin spy support with separate formatting - Lightweight and focused - Block or scale teammate damage - Supports melee, projectiles, potions, explosions, and tridents - Per-team toggle and admin bypass - Lightweight and focused - Set and teleport to team homes - Warmups, cooldowns, and max-home limits - Network-aware metadata for proxy environments - Lightweight and focused - Team management menus - Team browsing and member viewing - Invite management - Offline player heads with skin support - Lightweight and focused - Spigot history-based update detection - Optional in-game OP notifications - Lightweight and focused - YAML or SQL storage - Autosave, atomic writes, and rolling backups - Lightweight and focused - Lightweight and focused - PlaceholderAPI and MiniPlaceholders - Lightweight and focused - No economy, claims, or RPG systems

---

Requirements

- Paper or Spigot 1.21.x - 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

not required - 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)

proxy server name 1. Set `storage.type` to a SQL backend 2. Enable Redis in `config.yml` 3. Give each backend server a proxy server name `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 real-time notification layer > 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 [team]` | Accept an invite | `sorekillteams.accept` | | `/team deny [team]` | 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` |

Team Homes

| Command | Description | Permission | |-------|-------------|------------| | `/team homes` | List team homes | `sorekillteams.homes` | | `/team home` | Teleport to a team home | `sorekillteams.home` |

Team Chat

| Command | Description | Permission | |-------|-------------|------------| | `/tc [message]` | Team chat or toggle mode | `sorekillteams.teamchat` |

Admin Commands

| Command | Description | Permission | |-------|-------------|------------| | `/sorekillteams reload` | Reload configs and storage | `sorekillteams.admin.reload` | | `/sorekillteams version` | Show plugin version | `sorekillteams.admin.version` | | `/sorekillteams disband <team>` | Force disband a team | `sorekillteams.admin.disband` | | `/sorekillteams setowner <team> <player>` | Force set team owner | `sorekillteams.admin.setowner` | | `/sorekillteams kick <team> <player>` | Force kick a member | `sorekillteams.admin.kick` | | `/sorekillteams info <team>` | View any team info | `sorekillteams.admin.info` |

---

Permissions

Wildcard

| Permission | Description | Default | |-----------|-------------|---------| | `sorekillteams.*` | Grants all permissions | op |

Base

| Permission | Description | Default | |-----------|-------------|---------| | `sorekillteams.use` | Use `/team` | false | | `sorekillteams.teamchat` | Use team chat | false | | `sorekillteams.chat` | Legacy alias (maps to teamchat) | false |

Team Management

| Permission | Description | |-----------|-------------| | `sorekillteams.create` | Create teams | | `sorekillteams.invite` | Invite players | | `sorekillteams.invites` | View pending invites | | `sorekillteams.invitetoggle` | Toggle invites | | `sorekillteams.accept` | Accept invites | | `sorekillteams.deny` | Deny invites | | `sorekillteams.leave` | Leave team | | `sorekillteams.disband` | Disband team | | `sorekillteams.info` | View team info | | `sorekillteams.kick` | Kick members | | `sorekillteams.transfer` | Transfer ownership | | `sorekillteams.rename` | Rename team | | `sorekillteams.ff` | Toggle friendly fire |

Team Homes

| Permission | Description | |-----------|-------------| | `sorekillteams.homes` | List team homes | | `sorekillteams.home` | Teleport to team home | | `sorekillteams.sethome` | Set a team home | | `sorekillteams.delhome` | Delete a team home | | `sorekillteams.home.bypasscooldown` | Bypass home cooldown |

Admin / Moderation

| Permission | Description | |-----------|-------------| | `sorekillteams.admin` | Admin command access | | `sorekillteams.admin.reload` | Reload plugin | | `sorekillteams.admin.version` | View version | | `sorekillteams.admin.disband` | Force disband teams | | `sorekillteams.admin.setowner` | Force set owner | | `sorekillteams.admin.kick` | Force kick players | | `sorekillteams.admin.info` | View any team info | | `sorekillteams.spy` | Spy on team chat | | `sorekillteams.friendlyfire.bypass` | Bypass FF protection |

Team Size Overrides

| Permission | Description | |-----------|-------------| | `sorekillteams.max.<number>` | Override max team size (e.g. `sorekillteams.max.6`) |

---

Planned Features

- Team roles and internal permissions

Suggestions are appreciated!

---

License

Licensed under the Apache License, Version 2.0 See `LICENSE` for details.

---

Credits

- Developed by Chumbucket Network - Built for the Chumbucket Network — https://www.chumbucket.net

© 2025 Sorekill — Apache-2.0 License