# SorekillTeams<\/p>\n
**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.<\/p>\n
Designed for modern servers and future proxy networks, SorekillTeams focuses on **core team mechanics** without bloated clan systems, claims, or RPG features.<\/p>\n
—<\/p>\n
## \ud83c\udd95 Latest Release \u2014 1.2.0<\/p>\n
### Changelog<\/p>\n
– Team chat toggle persists across servers
\n– Team invites toggle<\/p>\n
> \u26a0\ufe0f Cross-server features are **opt-in** and require SQL + Redis.
\n> Single-server setups work out of the box.<\/p>\n
—<\/p>\n
## Overview<\/p>\n
SorekillTeams allows players to form persistent teams that feel natural and intuitive.<\/p>\n
Players can:
\n– Create and manage teams
\n– Invite and accept members
\n– Chat privately with teammates
\n– Set and teleport to team homes
\n– Prevent accidental PvP with friendly-fire protection<\/p>\n
Server owners retain **full control** through permissions and a detailed configuration system, with safety-focused defaults and future-proofed architecture.<\/p>\n
—<\/p>\n
## Features<\/p>\n
– **Team creation & management**
\n – Create, rename, transfer ownership, kick members, leave, or disband teams
\n– **Advanced invite system**
\n – Expiring invites, cooldowns, invite caps, re-invite refresh support
\n– **Team chat**
\n – `\/tc` command or toggle mode
\n – Admin spy support with separate formatting
\n– **Friendly-fire control**
\n – Block or scale teammate damage
\n – Supports melee, projectiles, potions, explosions, and tridents
\n – Per-team toggle and admin bypass
\n– **Team homes**
\n – Set and teleport to team homes
\n – Warmups, cooldowns, and max-home limits
\n – Network-aware metadata for proxy environments
\n– **GUI menu system**
\n – Team management menus
\n – Team browsing and member viewing
\n – Invite management
\n – Offline player heads with skin support
\n– **Update checker**
\n – Spigot history-based update detection
\n – Optional in-game OP notifications
\n– **Safe storage system**
\n – YAML or SQL storage
\n – Autosave, atomic writes, and rolling backups
\n– **Paper & Spigot compatible**
\n– **Optional placeholder support**
\n – PlaceholderAPI and MiniPlaceholders
\n– **Lightweight and focused**
\n – No economy, claims, or RPG systems<\/p>\n
—<\/p>\n
## Requirements<\/p>\n
– **Java 21**
\n– **Paper or Spigot 1.21.x**
\n– *(Optional)* PlaceholderAPI 2.11.0+
\n– *(Optional)* MiniPlaceholders 3.0+<\/p>\n
—<\/p>\n
## Installation<\/p>\n
### \ud83d\udd39 Single-Server Setup (Most Servers)<\/p>\n
This is the default and simplest setup.<\/p>\n
1. Download `SorekillTeams-1.2.0.jar`
\n2. Place it in your server\u2019s `plugins\/` directory
\n3. Start or restart the server
\n4. Configure permissions (**LuckPerms recommended**)
\n5. Adjust `config.yml`, `messages.yml`, and `menus.yml` as needed<\/p>\n
**Notes:**
\n– Uses YAML storage by default
\n– Redis and proxy features are **not required**
\n– Team homes work normally on this server only<\/p>\n
—<\/p>\n
### \ud83d\udd39 Multi-Server \/ Proxy Setup (Advanced)<\/p>\n
Use this if you run **Velocity or BungeeCord** with multiple backend servers.<\/p>\n
**Requirements:**
\n– Shared SQL database (MySQL, MariaDB, PostgreSQL, etc.)
\n– Redis server for real-time sync
\n– Proxy (Velocity or BungeeCord)<\/p>\n
**Steps:**
\n1. Set `storage.type` to a SQL backend
\n2. Enable Redis in `config.yml`
\n3. Give each backend server a **unique** `redis.server_id`
\n4. Set `homes.server_name` to match the **proxy server name**
\n – \u26a0\ufe0f This must exactly match the name used by the proxy
\n5. Enable `homes.proxy_mode` if using cross-server home teleports
\n6. Restart all backend servers<\/p>\n
**What you get:**
\n– Network-wide team membership
\n– Cross-server invites and chat
\n– Team events synced instantly
\n– Network-aware team homes (teleport routing ready)<\/p>\n
> SQL is the **source of truth**
\n> Redis is the **real-time notification layer**<\/p>\n
—<\/p>\n
Reload configs anytime with:
\n‘\/sorekillteams reload’<\/p>\n
—<\/p>\n
## Commands<\/p>\n
### Player Commands ### Owner-Only Team Commands ### Team Homes ### Team Chat ### Admin Commands —<\/p>\n ## Permissions<\/p>\n ### Wildcard ### Base ### Team Management ### Team Homes ### Admin \/ Moderation ### Team Size Overrides —<\/p>\n ## Planned Features<\/p>\n – Team roles and internal permissions<\/p>\n Suggestions are appreciated!<\/p>\n —<\/p>\n ## License<\/p>\n Licensed under the **Apache License, Version 2.0** —<\/p>\n ## Credits<\/p>\n – Developed by **Sorekill** \u00a9 2025 Sorekill \u2014 Apache-2.0 License<\/p>\n","protected":false},"excerpt":{"rendered":" Lightweight teams plugin with invites, team chat, and friendly-fire control \u2014 no bloat, no gimmicks.<\/p>\n","protected":false},"featured_media":145524,"template":"","meta":{"_minecraft_slug":"sorekillteams","_minecraft_project_id":"x682V7AA","_minecraft_author":"Sorekill","_minecraft_license":"Apache-2.0","_minecraft_downloads":135,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"sorekillteams.zip","_minecraft_size_bytes":1480057,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-15T18:57:30.044603Z","_minecraft_date_created":"2026-01-13T21:12:48.744250Z","_minecraft_date_modified":"2026-01-05T17:42:06.041375Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/sorekillteams","_minecraft_icon_attachment_id":145524,"_minecraft_imported_at":"2026-06-08T17:06:18+00:00","_minecraft_import_hash":"f53265a6b07b8eb1b59160c848cd2603","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,89,126,127,867,129,92],"mod_loader":[130,132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-145523","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n| Command | Description | Permission |
\n|——-|————-|————|
\n| `\/team` | Base team command | `sorekillteams.use` |
\n| `\/team create
\n| `\/team invite
\n| `\/team invites` | View pending invites | `sorekillteams.invites` |
\n| `\/team accept [team]` | Accept an invite | `sorekillteams.accept` |
\n| `\/team deny [team]` | Deny an invite | `sorekillteams.deny` |
\n| `\/team leave` | Leave your team | `sorekillteams.leave` |
\n| `\/team info` | View team info | `sorekillteams.info` |
\n| `\/team ff
\n| Command | Description | Permission |
\n|——-|————-|————|
\n| `\/team kick
\n| `\/team transfer
\n| `\/team rename
\n| `\/team disband` | Disband your team | `sorekillteams.disband` |
\n| `\/team sethome` | Set a team home | `sorekillteams.sethome` |
\n| `\/team delhome` | Delete a team home | `sorekillteams.delhome` |<\/p>\n
\n| Command | Description | Permission |
\n|——-|————-|————|
\n| `\/team homes` | List team homes | `sorekillteams.homes` |
\n| `\/team home` | Teleport to a team home | `sorekillteams.home` |<\/p>\n
\n| Command | Description | Permission |
\n|——-|————-|————|
\n| `\/tc [message]` | Team chat or toggle mode | `sorekillteams.teamchat` |<\/p>\n
\n| Command | Description | Permission |
\n|——-|————-|————|
\n| `\/sorekillteams reload` | Reload configs and storage | `sorekillteams.admin.reload` |
\n| `\/sorekillteams version` | Show plugin version | `sorekillteams.admin.version` |
\n| `\/sorekillteams disband
\n| `\/sorekillteams setowner
\n| `\/sorekillteams kick
\n| `\/sorekillteams info
\n| Permission | Description | Default |
\n|———–|————-|———|
\n| `sorekillteams.*` | Grants all permissions | op |<\/p>\n
\n| Permission | Description | Default |
\n|———–|————-|———|
\n| `sorekillteams.use` | Use `\/team` | false |
\n| `sorekillteams.teamchat` | Use team chat | false |
\n| `sorekillteams.chat` | Legacy alias (maps to teamchat) | false |<\/p>\n
\n| Permission | Description |
\n|———–|————-|
\n| `sorekillteams.create` | Create teams |
\n| `sorekillteams.invite` | Invite players |
\n| `sorekillteams.invites` | View pending invites |
\n| `sorekillteams.invitetoggle` | Toggle invites |
\n| `sorekillteams.accept` | Accept invites |
\n| `sorekillteams.deny` | Deny invites |
\n| `sorekillteams.leave` | Leave team |
\n| `sorekillteams.disband` | Disband team |
\n| `sorekillteams.info` | View team info |
\n| `sorekillteams.kick` | Kick members |
\n| `sorekillteams.transfer` | Transfer ownership |
\n| `sorekillteams.rename` | Rename team |
\n| `sorekillteams.ff` | Toggle friendly fire |<\/p>\n
\n| Permission | Description |
\n|———–|————-|
\n| `sorekillteams.homes` | List team homes |
\n| `sorekillteams.home` | Teleport to team home |
\n| `sorekillteams.sethome` | Set a team home |
\n| `sorekillteams.delhome` | Delete a team home |
\n| `sorekillteams.home.bypasscooldown` | Bypass home cooldown |<\/p>\n
\n| Permission | Description |
\n|———–|————-|
\n| `sorekillteams.admin` | Admin command access |
\n| `sorekillteams.admin.reload` | Reload plugin |
\n| `sorekillteams.admin.version` | View version |
\n| `sorekillteams.admin.disband` | Force disband teams |
\n| `sorekillteams.admin.setowner` | Force set owner |
\n| `sorekillteams.admin.kick` | Force kick players |
\n| `sorekillteams.admin.info` | View any team info |
\n| `sorekillteams.spy` | Spy on team chat |
\n| `sorekillteams.friendlyfire.bypass` | Bypass FF protection |<\/p>\n
\n| Permission | Description |
\n|———–|————-|
\n| `sorekillteams.max.
\nSee `LICENSE` for details.<\/p>\n
\n– Built for the **Chumbucket Network** \u2014 https:\/\/www.chumbucket.net<\/p>\n