Donut Teams is a Folia-first team plugin for Paper SMPs. Players create a team, invite friends, talk in team chat, share one home, and toggle friendly fire from a GUI. It is a modular Nightbeam suite companion next to Donut Auction, Orders, RTP, and Shards. Optional DonutCore. Not an all-in-one Donut replica.

Features

Donut Teams Pro (Redis live sync, extra member slots, extra homes, and cosmetics) is coming later on BuiltByBit. Lite is the full single-server team layer.

Team GUI

/team with no arguments opens the team menu. Players do not need the full command tree to run a team.

The main GUI covers:

• Create a team
• Member list and per-member permission editor
• Pending invites
• Team info
• Home and friendly-fire controls
• Settings, including locked Pro stubs

Chat aliases still work for power users: /teams, /dt. Admin alias: /dteams.

Commands

Permissions

donutteams.use, donutteams.create, donutteams.chat, and donutteams.home default true. donutteams.admin defaults to op. donutteams.slots.8 is the lite member cap.

Placeholders

Identifier donutteams. No team returns none (or 0 for counts).

• %donutteams_name% (aliases team, team_name)
• %donutteams_tag%
• %donutteams_count% (aliases size, members)
• %donutteams_home_world% (aliases homeworld, home)
• %donutteams_leader% (alias owner)

Team Home

Lite includes one shared team home. Teleport uses a warmup with cancel-on-move. Personal homes are a separate Nightbeam SKU and are not in this plugin.

Friendly Fire

When friendly fire is off, melee and projectile damage between teammates is cancelled on the victim's region thread.

Storage

SQLite

Default. Works out of the box at plugins/DonutTeams/teams.db.

MySQL

Optional for larger networks. HikariCP pooling. Tables: teams, members, invites, homes, settings. SQL runs off-thread. Teams are cached in memory.

Performance & Safety

• Asynchronous database operations
• Folia entity, region, and global schedulers (no BukkitScheduler)
• Warmup teleports that cancel on move
• Friendly-fire checks that do not hop regions to mutate the attacker

Why Choose Donut Teams?

1. Easy setup — Drop DonutTeams-1.0.0.jar in plugins/. SQLite works immediately. No extra plugins required.
2. Low overhead — Folia-first scheduling and async SQL keep chat, homes, and invites off the wrong threads.
3. Player-friendly UI — Inventory GUI for create, invite, perms, home, and PvP.
4. Safe defaults — Confirm-to-disband, warmup cancel-on-move, region-safe friendly fire.
5. Optional hooks — PlaceholderAPI, DonutCore, LuckPerms, and MySQL. Works on a single Paper box or Folia.
6. Suite companion — Modular Nightbeam plugin next to Donut Auction, Orders, RTP, and Shards. Not an all-in-one DonutSMP replica.

Compatibility

• Paper
• Folia
• Purpur
• Minecraft 1.20+
• SQLite
• MySQL
• PlaceholderAPI (optional)
• DonutCore (optional)
• LuckPerms (optional)

Requirements

Donut Teams requires a supported Paper or Folia server and Java 21.

DonutCore is optional. Vault is optional and is not required for lite.

Community & Support

• Discord: https://discord.gg/TJc3CxR4jK
• GitHub: https://github.com/MeherBenSalem
• Website: https://nightbeam.dev
• Store: https://nightbeam.dev/store
• CurseForge: https://www.curseforge.com/members/nightbeamstudio/projects
• Modrinth: https://modrinth.com/organization/nightbeam

If you encounter a bug or have a feature request, join Discord or report it on the project page.

License

Donut Teams is licensed under the Apache License 2.0.

You are free to use, modify, and redistribute Donut Teams in accordance with the terms of the Apache License 2.0.