Simple Groups and Claims

A lightweight groups, land-claiming and PvP plugin for SMP and faction-style servers, with no confusing GUIs.

Players form groups, claim chunks, lock their chests and doors, make alliances and fight under a fair combat-logging system, all through one simple /g command. Everything is configurable, every message can be edited, and it's built to stay light on server performance.

---

✨ Features

👥 Groups

• Create a group, invite players and promote trusted members to moderator
• Leaders can rename the group, pick its color, transfer leadership or disband it
• Group & ally chat: /g chat and /g allychat, toggled or for a single message
• Group homes with a configurable warmup and cooldown (cancelled by moving, damage or combat)
• Group tags show in chat and the tab list, e.g. [Wolves] [L] Steve
• Inactivity cleanup removes inactive players. If a leader goes inactive, leadership passes to the most active moderator or member.

🗺️ Land Claiming

• Chunk-based claims, with a claim limit that grows as the group gets older
• Live 9×9 claim map in the sidebar that rotates as you turn
• /g border shows nearby claim edges with colored particles
• Action bar messages when you enter group land, wilderness or a zone
• Claims show on BlueMap, squaremap or Dynmap automatically if one is installed

🛡️ Protection

Outsiders can't build, break or use anything in your land. Claims are also protected from:

• Fire burning or being lit, and lava or water flowing in
• Explosions (configurable), and pistons pushing across borders
• Hoppers stealing from outside the claim
• Breaking armor stands, paintings, item frames, boats and minecarts
• Trampled farmland, endermen and withers
• Hurting animals and villagers (each configurable)

🔒 Locks

• Lock chests, doors, furnaces, shulkers and other interactive blocks with /g lock
• Double chests and doors lock both halves automatically, including copper chests
• Share a lock with players from your group or allied groups
• More senior members (leader > moderator > member) can still open junior members' locks
• Hoppers and copper golems can't pull items out of locked containers

🤝 Alliances

• Leaders send and accept alliance requests. Both sides must agree.
• No friendly fire between allies
• /g allyperm lets you choose whether allies can use your doors, containers, or build

⚔️ PvP & Combat Logging

• Hitting another player starts a combat timer, shown as a boss bar
• Logging out during combat kills you, and the server is told why
• No PvP between group members or allies, or in safe zones (unless you're already in combat)

🏛️ Safe & Neutral Zones

• Safe zones: no claiming, griefing or PvP. Perfect for spawn.
• Neutral zones: no claiming or griefing

---

📜 Commands

Command	Description
/g create <name>	Create a group
/g accept <group>	Accept an invite
/g leave	Leave your group
/g info [group]	Show members, claims, allies and more
/g map	Toggle the claim map
/g border	Show nearby claim borders
/g home	Teleport to your group's home
/g chat [message]	Group chat
/g allychat [message]	Chat with your group and allies
/g lock / /g unlock	Lock or unlock the block you're looking at
/g lockinfo	See who owns a lock and who can use it
/g lockadd <player> / /g lockremove <player>	Share your lock

Leaders & moderators

Command	Description
/g invite <player> / /g uninvite <player>	Invite a player, or cancel an invite
/g claim / /g unclaim	Claim or unclaim the chunk you're in
/g sethome / /g delhome	Set or remove the group home

Leaders only

Command	Description
/g rename <name>	Rename the group
/g setcolor <color>	Set the group's color
/g kick <player>	Remove a player (works while they're offline)
/g promote <player> / /g demote <player>	Change a player's role
/g transfer <player>	Make someone else leader
/g delete	Disband the group
/g allyrequest <group> / /g acceptally <group> / /g denyally <group> / /g unally <group>	Manage alliances
/g allyperm <doors|containers|build> <on|off>	Choose what allies can do in your land

Admins (GroupsAndClaims.admin, given to OPs by default)

Command	Description
/g setsafezone / /g removesafezone	Add or remove a safe zone chunk
/g setneutralzone / /g removeneutralzone	Add or remove a neutral zone chunk
/g setgroupcolor <group> <color>	Set any group's color
/g admin delete <group>	Delete any group
/g admin unclaim	Unclaim the chunk you're in from any group
/g admin bypass	Ignore claim protection and locks
/g reload	Reload config.yml and messages.yml

All other commands are available to every player, with no extra permissions needed.

---

⚙️ Configuration

• config.yml: claim limits and growth, lock limits, group name rules, inactivity days, homes, explosion/fire/fluid rules, animal and villager protection, combat timer, chat and tab-list tags, web map display and autosave interval
• messages.yml: every message the plugin sends, with & color codes
• groups.yml: group data, saved automatically (no need to edit)

Apply changes with /g reload, no restart needed.

---

📦 Installation

1. Put the jar in your server's plugins folder
2. Restart the server
3. Adjust config.yml and messages.yml if you like, then run /g reload

Updating from an older version? Your groups.yml is converted automatically, and a backup of the original is kept.

---

✅ Compatibility

• Paper 26.3+ (and Paper forks like Purpur)
• Java 25
• Optional: BlueMap, squaremap or Dynmap for web map claims
• Not compatible with plain Spigot. For Minecraft 1.21, use version 1.7.

---

💬 Support

Found a bug or have an idea? Let me know in the comments or discussion section. Feedback is always appreciated!

Planned: a developer API for other plugins.