Simple Groups And Claims

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

Leaders & moderators

Leaders only

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

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.