Simple Groups And Claims

SimpleGroupsAndClaims

SimpleGroupsAndClaims is a lightweight yet powerful group and land-claiming plugin designed for Minecraft servers running Spigot or Paper. It provides an intuitive system for players to form groups, claim land, manage alliances, and engage in controlled PvP with an intuitive combat timer system. Perfect for SMP and faction-like gameplay without the complexity, this plugin emphasizes simplicity, performance, and customization.

Features
Group Management

Create and Manage Groups: Players can create groups, invite members, and assign moderators to help manage the group.

Leadership Roles: Each group has a leader who can perform administrative tasks like renaming the group, transferring leadership, or deleting the group.

Moderator Role: Leaders can promote members to moderators, granting them permissions to invite players and manage claims.

Inactivity System: Automatically removes inactive members, moderators, and entire groups based on configurable inactivity periods to keep your server clean.

Land Claiming

Chunk-Based Claims: Groups can claim chunks to protect their territory, with claim limits based on group age and configurable growth rates.

Claim Visualization: A dynamic 9x9 chunk map displayed via scoreboard shows claimed, safe, neutral, and wilderness areas, updating based on player movement and rotation.

Protection: Prevents unauthorized block breaking and placing on player owned claims, and environmental changes (e.g., explosions, piston movement) in safe zone and neutral chunks.

Safe and Neutral Zones: Admins can designate spawn safe zones (No claiming, explosions or PvP unless in combat) and neutral zones (no claiming or explosions) for specific gameplay areas.

Alliances

Alliance System: Groups can form alliances to prevent friendly fire.

Request and Approval Process: Leaders can send and accept alliance requests, ensuring mutual diplomacy.

PvP Combat Timer

Combat Tagging: Engages a configurable combat timer when players attack each other, preventing combat logging by killing players who disconnect during combat.

Boss Bar Feedback: Displays a visual timer to players in combat, warning them not to log out.

Safe Zone Restrictions: PvP is disabled in spawn safe zones unless players are already in combat, adding strategic depth.

Chat and Visual Enhancements

Group Chat Prefixes: Displays group names and roles ([L] for Leader, [M] for Moderator, [G] for Member) in chat for easy identification.

Action Bar Notifications: Informs players when they enter different zones (e.g., group land, wilderness, safe zones).

Scoreboard Map: Toggles a real-time map showing nearby chunks with color-coded ownership (green for own group, purple for allies, yellow for enemies, blue for safe zones, gold for neutral zones).

Configuration and Administration

Highly Configurable: Adjust claim limits, PvP timer duration, group name rules, and inactivity periods via config.yml.

Admin Commands: Tools for setting safe and neutral zones, reloading configurations, and managing server-wide settings.

Persistent Data: Group and claim data are saved in groups.yml for reliability across server restarts.

Commands & Descriptions

/g create
Creates a new group with the specified name.

/g rename
Renames the group (leader only).

/g setcolor
Sets your group name color in chat (leader only).

/g invite
Invites a player to the group (leader or moderator only).

/g uninvite
Revokes group invite to the group (leader or moderator only).

/g accept
Accepts a pending group invitation.

/g kick
Kicks a member or moderator from the group (leader only, cannot kick self).

/g promote
Promotes a member to moderator (leader only).

/g demote
Demotes a moderator to member (leader only).

/g transfer
Transfers group leadership to another member or moderator (leader only).

/g leave
Leaves the current group (not allowed for leaders).

/g delete
Deletes the group (leader only).

/g allyrequest
Sends an alliance request to another group (leader only).

/g acceptally
Accepts a pending alliance request (leader only).

/g denyally
Denies a pending alliance request (leader only).

/g unally
Ends an alliance with another group (leader only).

/g claim
Claims the current chunk for the group (leader or moderator only).

/g unclaim
Unclaims the current chunk (leader or moderator only).

/g map
Toggles the chunk map scoreboard.

/g info
Displays detailed group information (members, moderators, leader, claims, allies, creation date).

Admin (OP) Commands & Descriptions

/g setsafezone
Sets the current chunk as a spawn safe zone.

/g removesafezone
Removes the current chunk from spawn safe zones.

/g setneutralzone
Sets the current chunk as a neutral zone.

/g removeneutralzone
Removes the current chunk from neutral zones.

/g reload
Reloads the plugin configuration.

Permissions

SimpleGroupsAndClaims.admin: Grants access to admin commands (setsafezone, removesafezone, setneutralzone, removeneutralzone, reload). Typically assigned to server operators.

Default Permissions: All players can use non-admin commands without additional permissions.

Configuration
The plugin uses two configuration files: config.yml and groups.yml.

config.yml
group:
starting-claims: 10 # Initial claim limit for new groups
claim-growth-per-week: 2 # Additional claims per week of group age
name:
min-length: 3 # Minimum group name length
max-length: 20 # Maximum group name length
blacklist: [] # List of banned group names
inactivity-days: 30 # Days before inactive members/moderators are kicked or groups are deleted

pvp:
timer-duration-seconds: 15 # Duration of PvP combat timer

groups.yml
Stores group data, claims, pending invites, alliances, and zone information. Automatically managed by the plugin; manual editing is not recommended.

Installation

Download the SimpleGroupsAndClaims.jar file.

Place it in your server's plugins folder.

Restart the server or use /plugman load SimpleGroupsAndClaims.

Configure config.yml to your preferences.

Use /g reload to apply changes without restarting.

Compatibility

Minecraft Versions: Tested on 1.16–1.21 (Spigot/Paper).

Dependencies: None; standalone plugin.

Support

Issues: Report bugs or request features on the SpigotMC Discussion Thread.

Suggestions: We welcome feedback to improve the plugin on the SpigotMC Discussion Thread.

Documentation: Full command and configuration details are available in-game via /g and in this description.

Planned Features

More group ranks and custom permissions.

Defining group colors according to your groups relation.

API for developers to extend functionality.

SimpleGroupsAndClaims brings SMP/Faction-style gameplay to your server with minimal setup and maximum flexibility. Create a thriving community with protected lands, alliances, and controlled PvP today!