SimpleGroupsAndClaims

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 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!